Python的安装包

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

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

[python]   
Standard commands:   
build             build everything needed to install   
build_py          "build" pure [Python](http://www.2cto.com/kf/web/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定义的

setup.py vs requirements.txt


setup(
    name="MyLibrary",
    version="1.0",
    install_requires=[
        "requests",
        "bcrypt",
    ],
    # ...
)

# This is an implicit value, here for clarity
--index https://pypi.python.org/simple/

MyPackage==1.0
requests==1.2.0
bcrypt==1.0.2

这里每个依赖都标明了准确的版本号，一般一个Python库对依赖的版本比较宽松，而一个应用則会依赖比较具体的版本号。虽然也许跑其他版本的 requests 并不会出错，但是我们在本地测试顺利后，我们就会希望在线上也跑相同的版本。

文件的头部有一个 --index https://pypi.python.org/simple/ ，一般如果你不用声明这项，除非你使用的不是PyPI。然而它却是 requirements.txt 的一个重要部分，这一行把一个抽象的依赖声明 requests==1.2.0 转变为一个具体的依赖声明 requests 1.2.0 from pypi.python.org/simple/ ，这不像“鸭子类型”，倒像一次 isinstance 检查。

这样很简单地声明了这个Python库的一些信息。但是，你并没有看到你可以从哪里获取这些依赖库。这里并没有提供一个url或者一个文件系统来获取这些依赖，而只是告诉我们依赖是 requests ， bcrypt ，这很重要，我们可以称这种声明方式为“抽象的依赖”，它们只是以名字（或者加上了一个具体的版本号）的方式来出现的。这就像我们说的“鸭子类型”，你不在乎它是什么样子的只要它看起来是 requests 。

使用pip freeze

$ pip freeze > requirements.txt

这种方式配合virtualenv 才好使，否则把整个环境中的包都列出来了。

使用 pipreqs

这个工具的好处是可以通过对项目目录的扫描，自动发现使用了那些类库，自动生成依赖清单。缺点是可能会有些偏差，需要检查并自己调整下。

参考资料

Python深入：Distutils发布Python模块关于python中的setup.py setup.py vs requirements.txt Python使用requirements.txt安装类库