搬运工：
http://www.cnblogs.com/sting2me/p/6550897.html
简单总结：
1、做 setup.py 文件，参考模板
2、python setup.py sdist build
3、sudo pip install twine
4、twine upload dist/*
使用Python编程的都知道，Python的包安装非常的方便，一般都是可以pip来安装搞定：
sudo pip install <package name>
pip的安装请移步：https://pip.pypa.io/en/stable/installing/
最近因为项目上的需要，发布了一个自己的pypi Python包，这里我大致分享如何发布自己的Pypi包一般过程。
打包工作主要依赖python的一个叫setuptools的包来完成，在进行下面操作前请使用pip安装它：
sudo pip install setuptools
（这里面我都是假设你已经准备好你的代码，测试代码以及目录结构，加上我今天要分享的，就可以组成一个完整的python包）
- 第一步，就是到pypi（https://pypi.python.org/pypi）上注册自己的用户, 点击“Register”，填写自己的用户名，密码，邮件地址后，就成功了。
记住自己的用户名和密码，后面上传的时候要输入的
- 准备setup.py/setup.conf文件，它是放在你包的根目录的，这一步至关重要，包括要发布的包名字，版本，license，描述，特性（classifier)等等，下面是我自己包的一个setup.py文件的内容，基本上只需要在这个上面修改就行了，具体如下：
#!/usr/bin/env python
# coding=utf-8
from setuptools import setup, find_packages
setup(
name='<项目的名称>',
version=<项目版本>,
description=(
'<项目的简单描述>'
),
long_description=open('README.rst').read(),
author='<你的名字>',
author_email='<你的邮件地址>',
maintainer='<维护人员的名字>',
maintainer_email='<维护人员的邮件地址',
license='BSD License',
packages=find_packages(),
platforms=["all"],
url='<项目的网址，我一般都是github的url>',
classifiers=[
'Development Status :: 4 - Beta',
'Operating System :: OS Independent',
'Intended Audience :: Developers',
'License :: OSI Approved :: BSD License',
'Programming Language :: Python',
'Programming Language :: Python :: Implementation',
'Programming Language :: Python :: 2',
'Programming Language :: Python :: 2.7',
'Programming Language :: Python :: 3',
'Programming Language :: Python :: 3.4',
'Programming Language :: Python :: 3.5',
'Programming Language :: Python :: 3.6',
'Topic :: Software Development :: Libraries'
],
)
需要注意的上面的字段：
version - 这个简单，就是包的发布的版本，可以直接写在这，也可以从其他地方引用过来。
long_description - 必须是rst（reStructuredText )格式的，因为这个里面的内容是显示在pypi包首页上，具体rst的语法可以参考：http://rest-sphinx-memo.readthedocs.io/en/latest/ReST.html
我的long_description是同目录下的README.rst的内容，同时这个README也是我的github项目首页。
packages - 申明你的包里面要包含的目录，比如 ['mypackage', 'mypackage_test'] 可以是这种使用我的示例，让setuptools自动决定要包含哪些包
install_requires - 申明依赖包，安装包时pip会自动安装：格式如下（我上面的setup.py没有这个参数，因为我不依赖第三方包:)）：
install_requires=[
'Twisted>=13.1.0',
'w3lib>=1.17.0',
'queuelib',
'lxml',
'pyOpenSSL',
'cssselect>=0.9',
'six>=1.5.2',
'parsel>=1.1',
'PyDispatcher>=2.0.5',
'service_identity',
]
- 准备requirements.txt 和 test-requirements.txt，这个申明包的依赖包和跑自动化测试的测试依赖包，具体格式示例如下：
mock>=2.0.0
flake8>=3.2.1
eventlet>=0.19.0
nose2>=0.6.5
cov_core>=1.15.0
virtualenv>=15.1.0
以上是我的test-requirements.txt的内容，requirements.txt的格式个上面一样。
准备这个两个文件不是必须的。
但是，有了它们，用户可以自己手动安装依赖包
pip install -r requirements.txt
有了它们，结合tox等工具，可以非常方便的加入自动化测试。
- 准备一个项目的README.rst文件,前面也提到了它的格式要求，第一次发包，可以直接copy别人的格式，这东西熟能生巧，多写就会了。
README的截图就不放了，以免广告嫌疑。有兴趣可以到参考http://rest-sphinx-memo.readthedocs.io/en/latest/ReST.html
- 准备好上面的步骤，一个包就基本完整了，剩下的就是打包了(cd到包的根目录)：
可以使用下面命令打包一个源代码的包:
python setup.py sdist build
这样在当前目录的dist文件夹下，就会多出一个以tar.gz结尾的包了：
也可以打包一个wheels格式的包，使用下面的命令搞定：
python setup.py bdist_wheel --universal
这样会在dist文件夹下生成一个whl文件，
- 上传生成的包，可以使用setuptools,或者twine上传,推荐使用twine上次，因为使用setuptools上传时，你的用户名和密码是明文或者未加密传输，安全起见还是使用twine吧
# 上传source 包python
setup.py sdist upload
# 上传pre-compiled包
python setup.py bdist_wheel upload
使用twine上传,先安装twine
sudo pip install twine
twine upload dist/*
上次前都会提示你前面注册的用户名和密码。一切搞定，你的包现在可以通过pip在任何地方安装了
网友评论