reportlab/README
author rgbecker
Wed, 25 Oct 2000 08:57:46 +0000
changeset 494 54257447cfe9
parent 404 2b1bac113dfb
child 790 4960f2a12eab
permissions -rw-r--r--
Changed to indirect copyright
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
494
54257447cfe9 Changed to indirect copyright
rgbecker
parents: 404
diff changeset
     1
#copyright ReportLab Inc. 2000
54257447cfe9 Changed to indirect copyright
rgbecker
parents: 404
diff changeset
     2
#see license.txt for license details
54257447cfe9 Changed to indirect copyright
rgbecker
parents: 404
diff changeset
     3
#history http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/reportlab/README?cvsroot=reportlab
54257447cfe9 Changed to indirect copyright
rgbecker
parents: 404
diff changeset
     4
#$Header: /tmp/reportlab/reportlab/README,v 1.2 2000/10/25 08:57:44 rgbecker Exp $
54257447cfe9 Changed to indirect copyright
rgbecker
parents: 404
diff changeset
     5
404
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
     6
Release 1.0
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
     7
===========
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
     8
This is release 1.0 or the ReportLab toolkit. It includes usable if
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
     9
rough documentation as PDF documents and has a solid layout API
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    10
in reportlab.platypus (which if not frozen is certainly not totally
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    11
fluid).
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    12
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    13
Installation
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    14
============
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    15
Either unpack reportlab.zip or reportlab.tgz to some directory say
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    16
d:\ReportLab. If you can, ensure that the  line terminator style is
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    17
correct for your OS (man zip programs have a text mode option eg -a).
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    18
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    19
Create a .pth file, say reportlab.pth in your Python
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    20
home directory.  It should have one line:
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    21
d:/ReportLab.
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    22
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    23
Alternatively unpack the archive into a directory which is already on your
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    24
python path.
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    25
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    26
Then reportlab.pdfbase, reportlab.pdfgen and reportlab.platypus are
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    27
available packages.
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    28
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    29
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    30
Existing PDFGEN Code
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    31
=============
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    32
Modifying existing code to work with the package structure:
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    33
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    34
import pdfmetrics   ->  from reportlab.pdfbase import pdfmetrics
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    35
import pdfutils     ->  from reportlab.pdfbase import pdfutils
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    36
import pdfdoc       ->  from reportlab.pdfbase import pdfdoc
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    37
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    38
import pdfgeom      ->  from reportlab.pdfgen import pdfgeom
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    39
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    40
import pdfgen       ->  from reportlab.pdfgen import canvas
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    41
                    ->  from reportlab.pdfgen import pathobject
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    42
                    ->  from reportlab.pdfgen import textobject
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    43
                        then pdfgen.Canvas   -> canvas.Canvas
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    44
                        pdfgen.PDFPathObject -> pathobject.PDFPathObject
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    45
                        pdfgen.PDFTextObject -> textobject.PDFTextObject
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    46
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    47
import platypus     ->  from report.platypus import Flowable, Table
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    48
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    49
Testing
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    50
=======
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    51
You can run all python scripts in directories named test or tests.
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    52
At present there are tests in reportlab/pdfgen/test, reportlab/platypus/test
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    53
and reportlab/demos/tests.
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    54
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    55
The scripts in other subdirectories of demos are fairly useful.
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    56
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    57
Other executable scripts are
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    58
	./pdfbase/pdfdoc.py
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    59
	./pdfgen/canvas.py
2b1bac113dfb Release 1.00 Administration
rgbecker
parents:
diff changeset
    60
	./platypus/tables.py