二、實驗步驟
2.1 實驗准備
我們的實驗項目名為 factorial。
$ mkdir factorial
$ cd factorial/ 2.2 主代碼
我們給將要創建的 Python 模塊取名為 myfact，因此我們下一步創建 myfact 目錄。
$ mkdir myfact
$ cd myfact/ 主代碼將在 fact.py 文件里面。
"myfact module" def factorial(num): """ 返回給定數字的階乘值 :arg num: 我們將計算其階乘的整數值 :return: 階乘值，若傳遞的參數為負數，則為 -1 """ if num >= 0: if num == 0: return 1 return num * factorial(num -1) else: return -1 我們還有模塊的 __init__.py 文件，內容如下：
from fact import factorial __all__ = [factorial, ] 我們還在 factorial 目錄下添加了一個 README.rst 文件。因此，目錄結構看起來像下面這樣：
2.3 MANIFEST.in
現在我們要寫一個 MANIFEST.in 文件，它用來在使用 sdist 命令的時候找出將成為項目源代碼壓縮包一部分的所有文件。
include *.py include README.rst 如果你想要排除某些文件，你可以在這個文件中使用 exclude 語句。
2.4 安裝 python-setuptools 包
我們使用 virtualenv（這里不示范步驟）。
$ sudo pip3 install setuptools
2.5 setup.py
最終我們需要寫一個 setup.py，用來創建源代碼壓縮包或安裝軟件。
#!/usr/bin/env python3 """Factorial project""" from setuptools import find_packages, setup setup(name = 'factorial', version = '0.1', description = "Factorial module.", long_description = "A test module for our book.", platforms = ["Linux"], author="ShiYanLou", author_email="support@shiyanlou.com", url="https://www.shiyanlou.com/courses/596", license = "MIT", packages=find_packages() ) name 是項目名稱，version 是發布版本，description 和 long_description 分別是項目介紹，項目長描述。platforms 是此模塊的支持平台列表。find_packages() 是一個能在你源目錄下找到所有模塊的特殊函數，packaging docs。
2.5.1. setup.py 用例
要創建一個源文件發布版本，執行以下命令。
$ python3 setup.py sdist
執行完畢會返回類似下面的信息：
running sdist
running egg_info
creating factorial.egg-info
writing factorial.egg-info/PKG-INFO
writing top-level names to factorial.egg-info/top_level.txt
writing dependency_links to factorial.egg-info/dependency_links.txt
writing manifest file 'factorial.egg-info/SOURCES.txt' reading manifest file 'factorial.egg-info/SOURCES.txt' reading manifest template 'MANIFEST.in' writing manifest file 'factorial.egg-info/SOURCES.txt' running check creating factorial-0.1 creating factorial-0.1/factorial.egg-info creating factorial-0.1/myfact making hard links in factorial-0.1... hard linking MANIFEST.in -> factorial-0.1 hard linking README.rst -> factorial-0.1 hard linking setup.py -> factorial-0.1 hard linking factorial.egg-info/PKG-INFO -> factorial-0.1/factorial.egg-info hard linking factorial.egg-info/SOURCES.txt -> factorial-0.1/factorial.egg-info hard linking factorial.egg-info/dependency_links.txt -> factorial-0.1/factorial.egg-info hard linking factorial.egg-info/top_level.txt -> factorial-0.1/factorial.egg-info hard linking myfact/__init__.py -> factorial-0.1/myfact hard linking myfact/fact.py -> factorial-0.1/myfact Writing factorial-0.1/setup.cfg creating dist Creating tar archive removing 'factorial-0.1' (and everything under it) 我們能在 dist 目錄下看到一個 tar 壓縮包。
$ ls dist/
factorial-0.1.tar.gz
記住嘗試安裝代碼時使用 virtualenv。
執行下面的命令從源代碼安裝。
$ sudo python3 setup.py install
學習更多可前往 packaging.python.org。
2.6. Python Package Index (PyPI)
你還記得我們經常使用的 pip 命令嗎？有沒有想過這些包是從哪里來的？答案是 PyPI。這是 Python 的軟件包管理系統。
為了實驗，我們會使用 PyPI 的測試服務器 https://testpypi.python.org/pypi。
2.6.1. 創建賬號
首先在這個鏈接注冊賬號。你會收到帶有鏈接的郵件，點擊這個鏈接確認你的注冊。
創建 ~/.pypirc 文件，存放你的賬號詳細信息，其內容格式如下：
[distutils]
index-servers = pypi
testpypi
[pypi]
repository: https://upload.pypi.org/legacy/
username: <username> password: <password> [testpypi] repository:https://test.pypi.org/legacy/ username: <username> password: <password> 替換 <username> 和 <password> 為您新創建的帳戶的詳細信息。在這里，由於我們是到 testpypi的網頁上去注冊賬號，即將相應的服務上傳到 testpypi，所以在這里，你只需修改[testpypi]的用戶名和密碼
記得在 setup.py 中更改項目的名稱為其它的名字來測試下面的指令，在接下來的命令中我將項目名稱修改為factorial2，為了不重復，需要自行修改至其它名稱。
2.6.2. 上傳到 TestPyPI 服務
下一步我們會將我們的項目到 TestPyPI 服務。這通過 twine 命令完成。
我們也會使用 -r 把它指向測試服務器。
$ sudo pip3 install twine
$ twine upload dist/* -r testpypi
執行完畢會返回類似下面的信息,
Uploading distributions to https://test.pypi.org/legacy/
Uploading factorial2-0.1.tar.gz
在這里你也可以使用下面的命令上傳到 PyPI 服務上，但這里需要注意，在 ~/.pypirc 里面，你需要到 https://pypi.python.org頁面，按照上面的步驟去注冊一個賬號，然后到~/.pypirc 的 [pypi] 下填寫相應的用戶名和密碼。testpypi 和 pypi 的賬號密碼並不通用。
$ twine upload dist/* -r pypi
現在如果你瀏覽這個頁面，你會發現你的項目已經准備好被別人使用了。
三、總結
本實驗使用了 setuptools 包，並完成了較為完整的項目創建&發布流程，最后還將項目發布到了網絡 （PyPI）上。