Python模块篇
wanghl
|
1#
wanghl 发表于 2006-04-05 15:15
Python模块篇Python模块篇 整理：Jims of 肥肥世家 jims.yang@gmail.com > Copyright © 2004,2005,2006 本文遵从GNU 的自由文档许可证(Free Document License)的条款，欢迎转载、修改、散布。 发布时间：2004年7月10日 更新时间：2006年03月01日，增加cjkcodecs模块。 Abstract Python为开发人员提供了丰富的模块，通过这些模块，我们就可快速开发出功能强大的程序。本笔记记录我所接触或学习过的Python模块，为想学习Python的朋友提供一个参考。 Table of Contents 1. Python Imaging Library(PIL) 1.1. 安装 1.1.1. 下载相关软件 1.1.2. 开始安装 2. Pmw(Python megawidgets)Python超级GUI组件集 2.1. 安装 2.2. 模块功能演示 2.2.1. ScrolledListBox(滚动列表框) 2.2.2. ScrolledText（滚动文本框） 3. PyXML 3.1. 安装 3.2. 使用 4. PyGame 5. PyOpenGL 6. NumPy和Numarray 7. MySQLdb 7.1. 安装 7.2. 模块功能 7.3. 模块功能演示 8. Tkinter模块 8.1. Tkinter简介 9. PyGTK 9.1. 安装 9.2. 示例 10. PyQt 10.1. 安装 11. PyMedia 12. Python-ldap 12.1. 示例 13. ftplib -- FTP protocol client 13.1. 示例 14. Psyco 14.1. 安装 15. smtplib 15.1. 示例 16. XMPPPY 16.1. 示例 16.2. cjkcodecs Chapter 1. Python Imaging Library(PIL) Table of Contents 1.1. 安装 1.1.1. 下载相关软件 1.1.2. 开始安装 PIL(Python图形库)为python提供强大的图形处理的能力，并提供广泛的图形文件格式支持，当前最新的版本是1.1.4。可到以下网址 http://www.pythonware.com/products/pil/index.htm 了解PIL的最新动态。该库能进行图形格式的转换、打印和显示。还能进行一些图形效果的处理，如图形的放大、缩小和旋转等。是Python用户进行图象处理的强有力工具。 1.1. 安装 1.1.1. 下载相关软件 到 http://www.pythonware.com/products/pil/index.htm 下载最新版的PIL安装程序。这里介绍的是在linux下的安装方法。windows平台的安装方法较简单，只要双击安装程序，就可一步步安装好了。
1.1.2. 开始安装
Chapter 2. Pmw(Python megawidgets)Python超级GUI组件集 Table of Contents 2.1. 安装 2.2. 模块功能演示 2.2.1. ScrolledListBox(滚动列表框) 2.2.2. ScrolledText（滚动文本框） Pmw是一个在python中利用Tkinter模块构建的高级GUI组件，每个Pmw都合并了一个或多个Tkinter组件，以实现更有用和更复杂的功能。如，Pmw中的一个ScrolledListBox（滚动列表框）实现了Tkinter的Scrollbar（滚动条）和ListBox（列表框）功能，使我们编程更方便。如果你在Python中开发GUI程序，Pmw是将是你的一个好帮手。 2.1. 安装 现在最新的Pmw是1.2版，Pmw的安装比较简单，只要到 http://pmw.sourceforge.net/ 下载软件，然后用tar -zxvf命令解压文件，把解压出来的Pmw目录拷到python的模块目录下就可以了，如site-packages 目录。windows平台使用同一压缩包，安装方法也一样。安装完成后可登录进python的命令行界面运行“import Pmw”测试是否安装成功，如果没有出错信息，则安装成功，可以使用了。 2.2. 模块功能演示 2.2.1. ScrolledListBox(滚动列表框) #ScrolledListBox used to select image. from Tkinter import * import Pmw class ImageSelection( Frame ): """List of available images and an area to display them""" def __init__( self, images ): """Create list of PhotoImages and Label to display them""" Frame.__init__( self ) Pmw.initialise() self.pack( expand = YES, fill = BOTH ) self.master.title( "Select an image" ) self.photos = [] #add PhotoImage object to list photos for item in images: self.photos.append( PhotoImage( file = item ) ) #create scrolled list box with vertical scrollbar self.listBox = Pmw.ScrolledListBox( self, items = images, listbox_height = 3, vscrollmode = "static", selectioncommand = self.switchImage ) self.listBox.pack( side = LEFT, expand = YES, fill = BOTH, padx = 5, pady = 5 ) self.display = Label( self, image = self.photos[0] ) self.display.pack( padx = 5, pady = 5 ) def switchImage ( self ): """Change image in Label to current selection""" #get tuple containing index of selected list item chosenPicture = self.listBox.curselection() #configure label to display selected image if chosenPicture: choice = int( chosenPicture[0] ) self.display.config( image = self.photos[ choice ] ) def main(): images = [ "c:\python23\logo.gif", "c:\python23\china.gif", "c:\python23\canada.gif", "c:\python23\logo.gif" ] ImageSelection(images).mainloop() if __name__ == "__main__": main() 2.2.2. ScrolledText（滚动文本框） #Copying selected text from one text area to another. from Tkinter import * import Pmw class CopyTextWindow( Frame ): """Demonatrate ScrolledText""" def __init__( self ): """Create two ScrolledText and a Button""" Frame.__init__( self ) Pmw.initialise() self.pack( expand = YES, fill = BOTH ) self.master.title( "ScrolledText Demo" ) #create scrolled text box with word wrap enable self.text1 = Pmw.ScrolledText( self, text_width = 25, text_height = 12, text_wrap = WORD, hscrollmode = "static", vscrollmode = "static" ) self.text1.pack( side = LEFT, expand = YES, fill = BOTH, padx = 5, pady = 5 ) self.copyButton = Button( self, text = "Copy >>>", command = self.copyText ) self.copyButton.pack( side = LEFT, padx = 5, pady = 5 ) #create uneditable scrolled text box self.text2 = Pmw.ScrolledText( self, text_state = DISABLED, text_width = 25, text_height = 12, text_wrap = WORD, hscrollmode = "static", vscrollmode = "static" ) self.text2.pack( side = LEFT, expand = YES, fill = BOTH, padx = 5, pady = 5 ) def copyText( self ): """set the text in the second ScrolledText""" self.text2.settext( self.text1.get( SEL_FIRST,SEL_LAST ) ) def main(): CopyTextWindow().mainloop() if __name__ == "__main__": main() Chapter 3. PyXML Table of Contents 3.1. 安装 3.2. 使用 PyXML是一套用Python解析和处理XML文档的工具包，包中的4DOM是完全相容于W3C DOM规范的。它包含以下内容：
3.1. 安装 到 http://sourceforge.net/project/showfiles.php?group_id=6473 下载最新版的模块，现在是PyXML-0.8.3。安装PyXML需要有python2.0以上及以上的版本。下载完成后用tar解压缩生成PyXML-0.8.3目录，进入该目录并运行python setup.py build和python setup.py install完成安装。测试方法是进入命令行交互界面运行“import xml.dom.ext"命令，如果没提示模块出错则说明安装成功。PyXML提供windows平台的安装包，下载后双击运行就可以了。 3.2. 使用 由于该模块的内容较多，所以该模块的详细使用将我在“PyXML学习笔记”中单独讨论。 Chapter 4. PyGame PyGame是一组用于多媒体开发和游戏软件开发的模块。 Chapter 5. PyOpenGL PyOpenGL模块封装了“OpenGL应用程序编程接口”，通过该模块python程序员可在程序中集成2D和3D的图形。 Chapter 6. NumPy和Numarray NumPy是Python的一个扩展库，主要用于处理任意维数的固定类型数组，它的低层代码使用C来编写，所以速度的优势很明显。Numarray是NumPy的一个改进版，用于取代NumPy。 Chapter 7. MySQLdb Table of Contents 7.1. 安装 7.2. 模块功能 7.3. 模块功能演示 MySQLdb模块用于连接MySQL数据库。源码位于 http://sourceforge.net/projects/mysql-python ，这里还有用于zope的ZMySQLDA模块，通过它就可在zope中连接mysql数据库。 7.1. 安装 安装的方法在解压目录的README文件中有详细说明。不难，这里就不详细讲了。要注意的一点是，如果你的mysql不是安装在默认的路径，而是安装在/usr/local/mysql这样的路径的话，libmysqlclient.so.12这个动态库python可能会找不到，造成import出错，解决方法是在/usr/lib下做一个符号连接，ln -s /usr/local/mysql/lib/mysql/libmysqlclient.so.12 libmysqlclient.so.12。最后在python中用import MySQLdb测试，如果没有出错信息就说明安装成功，可以连接mysql数据库了。 7.2. 模块功能
7.3. 模块功能演示 #!/usr/bin/python import MySQLdb try: connection = MySQLdb.connect(user="user",passwd="password",host="xxx",db="test") except: print "Could not connect to MySQL server." exit( 0 ) try: cursor = connection.cursor() cursor.execute( "SELECT note_id,note_detail FROM note where note_id = 1" ) print "Rows selected:", cursor.rowcount for row in cursor.fetchall(): print "note : ", row[0], row[1] cursor.close() Chapter 8. Tkinter模块 Table of Contents 8.1. Tkinter简介 8.1. Tkinter简介 Tkinter是Python默认的图形界面接口，Tkinter是一个和Tk接口的Python模块，Tkinter库提供了对Tk API的接口，它属于Tcl/Tk的GUI工具组。Tcl/Tk是由John Ousterhout发展的书写和图形设备。Tcl(工具命令语言)是个宏语言，用于简化shell下复杂程序的开发，Tk工具包是和Tcl一起开发的，目的是为了简化用户接口的设计过程。Tk工具包由许多不同的小部件，如一个按钮、一个滚动条等。通过Tk提供的这些小部件，我们就可快速地进行GUI开发。Perl、Scheme等语言也利用Tk库进行GUI开发。Tkinter是跨平台，在各种平台下都能使用。 Chapter 9. PyGTK Table of Contents 9.1. 安装 9.2. 示例 PyGTK是一个用于python GUI程序开发的GTK+库，当前版本的PyGTK需要GTK+ 2.0以上版本支持和Python 2.2以上版本支持才能运行。 9.1. 安装 如果是在Debian系统中，则安装python2.3-gtk2软件包即可。如果要从源码安装，可到 http://www.pygtk.org 下载最新的软件包。安装方法也很简单，和其它开源软件差不多，通过configure、make和make install三步操作就可完成。具体操作你可参考源码目录下的README和INSTALL文档，里面有详细的安装说明。注意，要成功安装PyGTK，要有相应版本的GTK+和Python支持。在源码目录下有一个examples目录，这是一个宝贵的资源，里面有很多有用的PyGTK示例代码，对我们学习PyGTK很有帮助。 9.2. 示例 下面是一个PyGTK的示例，演示了PyGTK的基本概念。 #!/usr/bin/env python #-*- encoding:utf-8 -*- import pygtk pygtk.require('2.0') import gtk class base: #destroy信号的回调函数 def destroy(self,widget,data=None): gtk.main_quit() #clicked信号的回调函数 def hello(self,widget,data): print 'hello ' + data + ' this is a button clicked() test' #delete_event事件的回调函数 def delete_event(self, widget, event, data=None): print "delete event occurred" #如果delete_event事件返回假，则会触发destroy信号，从而关闭窗口。 #如果返回真，则不会关闭窗口。这个特性在当我们需要一个确认是否退出的选择对话框时是很有用。 return gtk.FALSE def __init__(self): self.window = gtk.Window(gtk.WINDOW_TOPLEVEL) #设置窗口的delete_event信号触发delete_event函数 self.window.connect("delete_event", self.delete_event) #设置窗口的destroy信号触发destroy函数 handler1 = self.window.connect("destroy",self.destroy) print "handler1 is:%d" % handler1 self.window.set_title('PyGTK 测试 window') self.window.set_default_size(200,200) self.window.set_border_width(100) #控制窗口出现的位置 self.window.set_position(gtk.WIN_POS_CENTER) #生成按钮实例 self.button1 = gtk.Button() self.button2 = gtk.Button() self.button1.set_label('label1') self.button2.set_label('label2') #设置按钮的clicked信号触发hello函数，并传递‘pyGTK’字符串参数给hello函数 handler2 = self.button1.connect("clicked",self.hello,"pyGTK") print "handler2 is:%d" % handler2 #设置按钮的clicked信号触发self..window对象的gtk.Widget.destroy方法 self.button1.connect_object("clicked", gtk.Widget.destroy, self.window) #取消handler2的功能 # self.button.disconnect(handler2) #设置一个不可见的横向的栏位self.box1 self.box1 = gtk.HBox(gtk.FALSE, 0) #把box1放到窗口中 self.window.add(self.box1) #把button1部件放到box1中 self.box1.pack_start(self.button1,gtk.TRUE,gtk.TRUE,0) self.button1.show() #把button2部件放到button1部件之后 self.box1.pack_start(self.button2,gtk.TRUE,gtk.TRUE,0) self.button2.show() self.box1.show() self.window.show() def main(self): gtk.main() print __name__ if __name__ == "__main__": base = base() base.main() 有关PyGTK的详细介绍请参考我整理的“PyGTK学习笔记”。 Chapter 10. PyQt Table of Contents 10.1. 安装 PyQt是一套用于python的Qt开发库，由一系列的模块组成，有qt, qtcanvas, qtgl, qtnetwork, qtsql, qttable, qtui and qtxml，包含有300个类和超过5750个的函数和方法。 PyQt还支持一个叫qtext的模块，它包含一个QScintilla库。该库是Scintillar编辑器类的Qt接口。 10.1. 安装 到 http://www.riverbankcomputing.co.uk/pyqt/download.php 下载最新的版本。安装PyQt需要先安装SIP，到以 这里 下载。 SIP 是一个把C\C++库转换成Python模块的工具。
Chapter 11. PyMedia PyMedia模块是一个用于多媒体操作的python模块。它提供了丰富而简单的接口用于多媒体处理(wav, mp3, ogg, avi, divx, dvd, cdda etc)。可在Windows和Linux平台下使用。 Chapter 12. Python-ldap Table of Contents 12.1. 示例 Python-ldap模块提供一组面向对象的API，可方便地在python中访问ldap目录服务，它基于OpenLDAP2.x。 12.1. 示例
Chapter 13. ftplib -- FTP protocol client Table of Contents 13.1. 示例 ftplib模块定义了FTP类和一些方法，用以进行客户端的ftp编程。我们可用python编写一个自已的ftp客户端程序，用于下载文件或镜像站点。如果想了解ftp协议的详细内容，请参考 RFC959 。 13.1. 示例 该模块是python的通用模块，所以默认应该已安装。ftplib模块使用很简单，暂时只有一个FTP类和十几个函数。下面用一个交互方式演示一下ftplib的主要功能。 >>> from ftplib import FTP >>> ftp=FTP('ftp.python.org') >>> ftp.login() '230 Login successful.' >>> ftp.dir() drwxrwxr-x 7 1004 1004 512 Aug 13 01:35 pub >>> ftp.cwd('pub') '250 Directory successfully changed.' >>> ftp.dir() drwxrwxr-x 5 1000 1004 1024 Dec 24 11:04 docs.python.org drwxrwsr-x 2 1002 1004 512 Oct 12 2001 jython lrwx------ 1 0 1003 25 Aug 03 2001 python -> www.python.org/ftp/python drwxr-xr-x 9 1018 1004 512 Feb 02 03:44 pyvault drwxr-xr-x 2 1005 1004 512 May 06 2003 tmp drwxrwsr-x 59 1004 1004 3072 Feb 03 14:58 www.python.org >>> ftp.quit() '221 Goodbye.' 下面一个下载文件的示例 #!/usr/bin/env python #author:Jims of www.ringkee.com #create date: 2005/02/05 #description: Using ftplib module download a file from a ftp server. from ftplib import FTP ftp=FTP() ftp.set_debuglevel(2) #打开调试级别2，显示详细信息 ftp.connect('ftp_server','port') #连接 ftp.login('username','password') #登录，如果匿名登录则用空串代替即可 print ftp.getwelcome() #显示ftp服务器欢迎信息 ftp.cwd('xxx/xxx/') #选择操作目录 bufsize = 1024 #设置缓冲块大小 filename='dog.jpg' file_handler = open(filename,'wb').write #以写模式在本地打开文件 ftp.retrbinary('RETR dog.jpg',file_handler,bufsize) #接收服务器上文件并写入本地文件 ftp.set_debuglevel(0) #关闭调试 ftp.quit() #退出ftp服务器 下面一个上传文件的示例，要成功运行该脚本，需在ftp服务器上有上传文件的权限。 #!/usr/bin/env python #author:Jims of www.ringkee.com #create date: 2005/02/05 #description: Using ftplib module upload a file to a ftp server. from ftplib import FTP ftp=FTP() ftp.set_debuglevel(2) ftp.connect('ftp_server','port') ftp.login('username','password') print ftp.getwelcome() ftp.cwd('xxx/xxx/') bufsize = 1024 filename='dog.jpg' file_handler = open(filename,'rb') ftp.storbinary('STOR dog.jpg',file_handler,bufsize) #上传文件 ftp.set_debuglevel(0) file_handler.close() #关闭文件 ftp.quit() 是不是很简单，其它功能可查询python的官方网站，网址是 http://docs.python.org/lib/module-ftplib.html 。 Chapter 14. Psyco Table of Contents 14.1. 安装 Psyco是一个Python代码加速度器，可使Python代码的执行速度提高到与编译语言一样的水平。 14.1. 安装 安装Psyco很简单，它有两种安装方式，一种是源码方式，一种是二进制码方式：
Chapter 15. smtplib Table of Contents 15.1. 示例 15.1. 示例 smtplib模块以发送电子邮件。下面是一个示例，可发送附件。 #!/usr/bin/python #-*- encoding:utf-8 -*- import smtplib,mimetypes from email import Encoders from email.MIMEBase import MIMEBase from email.MIMEText import MIMEText from email.MIMEMultipart import MIMEMultipart msg = MIMEMultipart() #创建可包含附件的MIME对象 msg['Subject'] = 'this is title' msg['From'] = 'yjnet@21cn.com' msg['To'] = 'yjnet@21cn.com' txt = MIMEText('这是邮件正文的中文测试。',_charset='utf-8') msg.attach(txt) filename = 'jdk15.tar' #附件名 fp = open(filename,'rb') ctype,encoding = mimetypes.guess_type(filename) if ctype is None or encoding is not None: ctype = 'application/octet-stream' maintype,subtype = ctype.split('/',1) m = MIMEBase(maintype,subtype) m.set_payload(fp.read()) fp.close() Encoders.encode_base64(m) #把附件编码 m.add_header('Content-disposition','attachment',filename=filename) #修改邮件头 msg.attach(m) #添加附件 s = smtplib.SMTP('smtp.21cn.com') #连接邮件服务器 s.login('yjnet','****') #登录邮件服务器 s.sendmail('yjnet@21cn.com','yjnet@21cn.com',msg.as_string()) #发送邮件 s.close() Chapter 16. XMPPPY Table of Contents 16.1. 示例 16.2. cjkcodecs Jabber服务器采用开发的XMPP协议，Google Talk也是采用XMPP协议的IM系统。在Python中有一个xmpppy模块支持该协议。也就是说，我们可以通过该模块与Jabber服务器通信，是不是很Cool。 16.1. 示例 下面是一个简单的示例，可使大家对该模块有一个大概的了解。 #导入xmpppy模块 >>> import xmpp #建立Client实例，debian是我的jabber服务器名，jabber服务器的安装可参考我的Debian学习笔记。 >>> c=xmpp.Client('debian',debug=[]) #连接 >>> c.connect() 'tcp' #验证 >>> c.auth('yangjing','12345') 'old_auth' #登入 >>> c.sendInitPresence() #向ringkee@debian >>> c.send(xmpp.protocol.Message('ringkee@debian ','test message from yangjing')) '20' #下面测试信息接收功能，如果没有信息，则pending_data()为空 >>>c.TCPsocket.pending_data() [] #如果有信息，则pending_data()不为空 >>> c.TCPsocket.pending_data() [] #接收信息 >>> c.TCPsocket.receive() "message from ringkee@debianmessage from ringkee@debian" #登出 >>> c.disconnect() 16.2. cjkcodecs 在python2.4版以前，python不能处理cjk（中国，日本和韩国）的编码，所以就有了cjkcodecs模块。安装该模块后Python就能处理cjk字符了。下载网址： http://cjkpython.i18n.org/ 。 |