目錄 | 上一節 (9.2 第三方包) | 下一節 (完結)

9.3 Distribution版本分發

在某些時候，你可能想要將自己的代碼提供給其他人——可能只是同事（使用）。本節給出執行此操作的最基本技術。更多詳細信息，請參考 Python 打包用戶指南。

創建 setup.py 文件

請添加一個 setup.py 到項目目錄的頂層。

# setup.py
import setuptools

setuptools.setup(
    name="porty",
    version="0.0.1",
    author="Your Name",
    author_email="you@example.com",
    description="Practical Python Code",
    packages=setuptools.find_packages(),
)

創建 MANIFEST.in 文件

如果有其它文件與你的項目相關聯，請使用一個 MANIFEST.in 文件指定這些關聯的文件。示例：

# MANIFEST.in
include *.csv

請將 MANIFEST.in 文件放到 setup.py 所在的目錄。

創建源碼發行版

要創建源碼發行版，請使用 setup.py 文件。示例：

bash % python setup.py sdist

這將在 dist/ 目錄中創建 .tar.gz 或者 .zip 文件。該文件就是你要提供給其他人使用的文件。

安裝你的代碼

其他人可以使用 pip 像安裝其它軟件包一樣安裝你的 Python 代碼。他們僅僅需要提供在之前的步驟中創建的文件即可。示例：

bash % python -m pip install porty-0.0.1.tar.gz

說明

上面的步驟描述了創建 Python 代碼包的最基本的知識，您可以將這些代碼包提供給其他人使用。實際上，根據第三方的依賴關系，它可能要復雜得多，無論你的應用是否包含外部代碼(例如 C 或 C++)。這已經超出了本課程的范圍，我們只作初步了解。

練習

練習 9.5：創建軟件包

使用練習 9.3 中創建的 porty-app/ 代碼，看看是否可以重新創建此前描述的步驟。具體來說，添加一個 setup.py 文件和一個 MANIFEST.in 文件到頂級目錄中。然后通過運行 python setup.py sdist 創建源碼發行版。

最后，看看是否可以在 Python 虛擬環境中安裝你的軟件包。

目錄 | 上一節 (9.2 第三方包) | 下一節 (完結)

注：完整翻譯見 https://github.com/codists/practical-python-zh