python的setup.py文件及其常用命令

python的setup.py文件及其常用命令

上传者： tingting1718     
我也要“ 分享赚钱”

2014/7/7

关注( 286)

评论( 0)

声明：此内容仅代表网友个人经验或观点，不代表本网站立场和观点。

    编写setup.py文件，获取帮助：python setup.py --help-commands

    [python]

    Standard commands:

    build            build everything needed to install

    build_py         "build" pure Python modules (copy to build directory)

    build_ext        build C/C++ extensions (compile/link to build directory)

    build_clib       build C/C++ libraries used by Python extensions

    build_scripts    "build" scripts (copy and fixup #! line)

    clean            clean up temporary files from 'build' command

    install          install everything from build directory

    install_lib      install all Python modules (extensions and pure Python)

    install_headers  install C/C++ header files

    install_scripts  install scripts (Python or otherwise)

    install_data     install data files

    sdist            create a source distribution (tarball, zip file, etc.)

    register         register the distribution with the Python package index

    bdist            create a built (binary) distribution

    bdist_dumb       create a "dumb" built distribution

    bdist_rpm        create an RPM distribution

    bdist_wininst    create an executable installer for MS Windows

    upload           upload binary package to PyPI

    check            perform. some checks on the package

    Extra commands:

    rotate           delete older distributions, keeping N newest files

    develop          install package in 'development mode'

    setopt           set an option in setup.cfg or another config file

    saveopts         save supplied options to setup.cfg or other config file

    egg_info         create a distribution's .egg-info directory

    install_egg_info Install an .egg-info directory for the package

    alias            define a shortcut to invoke one or more commands

    easy_install     Find/get/install Python packages

    bdist_egg        create an "egg" distribution

    test             run unit tests after in-place build

    standard commands(标准命令)是distutils内建命令，而Extra commands（附加命令）是像

    setuptools这样的第三方包创建的。

    命令详解：

    1.sdist：用来创建一个源码包，在windows下为zip格式，linux下为tag.gz格式 。

    setup.py示例：

    from setuptools import setup

    setup(name='xxx',version='0.1.1')

    打包命令：python setup.py sdist

    distutils将浏览包的路径，查找包含在档案中的文件，包括：

    1）所有py_modules、packages和scripts选项隐含的python源文件

    2）所有在ext_modules选项中列出的C源文件

    3）符合test/test*.py模式的文件

    4）README、README.txt、setup.py和setup.cfg文件

    如果需要包含更多文件，那么可以使用MANIFEST.in文件模版，示例如下：

    include xx.txt

    include yy/xx.txt

    ....

    2.bdist_egg:用来创建一个二进制分发版本，经常用来替代基于bdist生成的模式

    3.install：安装包到python中。另外，他还可能会安装在setup.py中的install_requires定义的

    相关模块，例如：

    install_requires=['...','...']

    删除一个包：1）删除这个包所创建的文件，2）删除在site-packages文件夹easy-install.pth文

    件中列举的所有引用。

    4.develop:编译并且在适当的位置安装包，然后添加一个简单的链接到python site-packages文

    件夹中，可以使用显式的-u选项删除包，例如：

    python setup.py develop

    python setup.py develop -u

    使用该方式比其他方式安装包更好一些

    5.创建一个新命令：这是由setuptools引入的，是一种将包定义为插件的简单方法，示例：

    ...entry_points='''

    [distutils.commands]

    my_command=my.command.module.Class