翻譯:《實用的Python編程》09_03_Distribution
目錄 | 上一節 (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 第三方包) | 下一節 (完結)
浙公網安備 33010602011771號