推荐两篇很好的文章

• python 核心 - 打包与发布
• 使用 ReadtheDocs 托管文档

准备

注册账号

很显然地要在 Pypi 上注册一个账号，记住账号和密码。

安装必要的库

setuptools

原则上安装了 pip 的环境都有 setuptools, 但并不影响你去尝试升级一下它。
pip install --upgrade setuptools

twine

这是一个简化将库发布到 Pypi 上流程的工具，具体的使用之后会讲到。
pip install --upgrade setuptools

克隆仓库

大名鼎鼎的 requests 库的作者大神 kennethreitz 为大家准备了一个仓库作为一个 setup.py 的很好的模板，当然你也可以自己手写 setup.py。
git clone https://github.com/kennethreitz/setup.py

编码

编辑 setup.py

直接编辑之前的仓库里的 setup.py， 只需要修改一些必要的配置就可以了。

编写核心代码

接下来我们就可以编写自己的代码了，要注意源代码文件夹（仓库里的 my package 文件夹）的名字与 setup.py 里配置的包名（Name）要一致。
另外在重新上传之前我们要修改_version.py 里的版本号，以免覆盖了以前的上传。
最终的代码结构:

1
2
3
4
5
6
7
8
9

│  LICENSE
│  MANIFEST.in
│  README.rst
│  setup.py
│
└─condition_chain
        core.py
        __init__.py
        __version__.py

打包上传

在 setup.py 的同级目录下运行以下命令。
python setup.py sdist bdist_wheel
然后运行 twine upload dist/*
注意要输入 Pypi 账号和密码。

大功告成

之后我们就可以在 Pypi 里搜索到自己的 Python 库了，当然也可以直接通过 pip 安装。