python中setup 打包安装包

python的第三方模块越来越丰富，涉及的领域也非常广，如科学计算、图片处理、web应用、GUI开发等。当然也可以将自己写的模块进行打包或发布。一简单的方法是将你的类包直接copy到python的lib目录，但此方式不便于管理与维护，存在多个python版本时会非常混乱。现介绍如何编写setup.py来对一个简单的python模块进行打包。

一、编写模块
进入项目目录
#cd /home/pysetup 
#vi foo.py
class MyClass():      def __init__(self):          self.blog = "http://blog.liuts.com"      def printblog(self):          print self.blog      def printBblog(self):          print self.blog.swapcase() 
二、编写setup.py
#vi setup.py
from distutils.core import setup setup(name='Myblog',        version='1.0',        description='My Blog Distribution Utilities',        author='Liu tiansi',        author_email='[e-mail]',        url='http://blog.liuts.com',        py_modules=['foo'],
     ) 
更多参数说明见表：

三、setup.py参数说明

#python setup.py build     # 编译
#python setup.py install     #安装
#python setup.py sdist       #生成压缩包(zip/tar.gz)
#python setup.py bdist_wininst   #生成NT平台安装包(.exe)
#python setup.py bdist_rpm #生成rpm包

或者直接"bdist 包格式"，格式如下：
 
#python setup.py bdist --help-formats 
   --formats=rpm       RPM distribution
   --formats=gztar     gzip'ed tar file
   --formats=bztar     bzip2'ed tar file
   --formats=ztar     compressed tar file
   --formats=tar       tar file
   --formats=wininst   Windows executable installer
   --formats=zip       ZIP file

四、打包
#python setup.py sdist
 
running sdist

warning: sdist: manifest template 'MANIFEST.in' does not exist (using default file list)
warning: sdist: standard file not found: should have one of README, README.txt

writing manifest file 'MANIFEST'
creating Myblog-1.0
making hard links in Myblog-1.0...
hard linking foo.py -> Myblog-1.0
hard linking setup.py -> Myblog-1.0
creating dist
tar -cf dist/Myblog-1.0.tar Myblog-1.0
gzip -f9 dist/Myblog-1.0.tar
removing 'Myblog-1.0' (and everything under it)

提示两条warning可以忽略，不影响打包，当然一个完善的项目必须有README及MANIFEST.in(项目文件清单)文件。
#ls dist

Myblog-1.0.tar.gz

五、安装
#tar -zxvf Myblog-1.0.tar.gz
#cd Myblog-1.0.tar.gz
#python setup.py install (此命令大家再熟悉不过了)
 
running install
running build
running build_py
creating build/lib.linux-x86_64-2.6
copying foo.py -> build/lib.linux-x86_64-2.6
running install_lib
copying build/lib.linux-x86_64-2.6/foo.py -> /usr/local/lib/python2.6/dist-packages
byte-compiling /usr/local/lib/python2.6/dist-packages/foo.py to foo.pyc
running install_egg_info
Writing /usr/local/lib/python2.6/dist-packages/Myblog-1.0.egg-info

六、测试

>>> from foo import MyClass
>>> app=MyClass()
>>> app.print printblog()
>>> app.printblog()

http://blog.liuts.com

>>> app.printBblog()

HTTP://BLOG.LIUTS.COM

>>>

如何制作Python安装模块

Python模块的安装方法：
    1. 单文件模块
                直接把文件拷贝到$python_dir/lib

   2. 多文件模块，带setup.py
                 python setup.py install          

   3. egg文件，类似Java的jar
                 1) 下载ez_setup.py,运行python ez_setup    
                 2)  easy_install *.egg


虽然Python的模块可以拷贝安装，但是一般情况下推荐制作一个安装包，即写一个setup.py文件来安装。

setup.py文件的使用:

% python setup.py build #编译
% python setup.py install    #安装
% python setup.py sdist     #制作分发包
% python setup.py bdist_wininst  #制作windows下的分发包
% python setup.py bdist_rpm

setup.py文件的编写

setup.py中主要执行一个 setup函数，该函数中大部分是描述性东西，最主要的是packages参数，列出所有的package，可以用自带的find_packages来动态获取package。所以setup.py文件的编写实际是很简单的。

简单的例子:
setup.py文件

from setuptools import setup, find_packages

setup(
      name="mytest",
      version="0.10",
      description="My test module",
      author="Robin Hood",
      url="http://www.csdn.net",
      license="LGPL",
      packages= find_packages(),
      scripts=["scripts/test.py"],
      )

mytest.py

import sys

def get():
    return sys.path

scripts/test.py

import os

print os.environ.keys()

setup中的scripts表示将该文件放到 Python的Scripts目录下，可以直接用。

OK，简单的安装成功，可以运行所列举的命令生成安装包，或者安装该python包。

本机测试成功(win32-python25)！