Python reportlab教程(1)-安装以及第一个示例

今天介绍基于Python平台的优秀PDF报表类库Reportlab。它不属于Python的标准类库，所以必须手动下载类库包并安装。因为涉及到把图片转换为PDF，所以还需要Python imaging library(PIL)类库。两个类库下载地址：

1. ReportLab: https://www.reportlab.com/software/downloads/
2. Python Imaging Library: http://www.pythonware.com/products/pil/

目前ReprtLab只有支持Python2.X版本，估计3.x版本的也很快放出。安装方法：windows用户可以直接下载.exe安装包，直接安装。如果是linux用户，可以下载源码安装(建议先安装PIL包)。安装方法(需要把安装代码放在python安装目录的合适位置)：

$ python setup.py install

安装之后可以运行自带例子，通常放在Lib/site-packages/reportlab/test的目录下，你可以通过以下指令运行所有例子：

$ cd /usr/local/Python.2.4.3/Lib/site-packages/reportlab/test
$ python runAll.py
........................................................................
.......................................................................
----------------------------------------------------------------------
Ran 143 tests in 45.886s
OK
Logs and output files written to folder ".../ReportLab_tmp/reportlab_test"

其实你如果是windows用户而且不关心这些例子，完全可以跳过，只需要在python shell输入import reportlab.pdfgen，方可测试是否安装正确。安装就不细说了。下面来看看第一个例子，跟学其他一样，先来看看最简单的Hello World程序。在Reportlab中最低级的组件就是在pdfgen包中的canvas对象，而且在这个包里允许用户使用文本，图片创建自定义的PDF文件报表。来看代码：

'''
Created on Aug 23, 2010
@author: leyond.info
'''
from reportlab.pdfgen import canvas

c = canvas.Canvas( "hello.pdf" )
c.drawString( 100 , 750 , "Hello World!" )
c.showPage()
c.save()

很简单，使用 ReportLab 来生成 PDF 你可以认为就象是在画图一样，因此第一行从pdfgen中导入了canvas，准备开始绘画。首先使用Canvas对象生成一个名为hello.pdf的文件，然后使用drawString方法在canvas中的100×100处绘画出’Hello World!’字样。这里需要注意的坐标位置，通常我们的原点坐标在左上角，而reportlab的缺省设置却是在左下角，这一点不要混淆了。showPage()用于产生分页，由于后面没有内容，没有起到效果，故此在这个例子中，可以删除这行代码。最后一行代码将之前绘画的所有内容写入文件，否则将产生空白内容。

运行代码之后将在对应目录下生成hello.pdf文件，见上面的预览图。

Python Reportlab的安装和第一个Hello World例子讲解就到这，更多关于Reportlab的内容，请关注Code之行人。