Python 歷時(shí)這么久以來至今還未有一個(gè)事實(shí)上標(biāo)準(zhǔn)的項(xiàng)目管理及構(gòu)建工具，以至于造成 Python 項(xiàng)目的結(jié)構(gòu)與構(gòu)建方式五花八門。這或許是體現(xiàn)了 Python 的自由意志。
不像 Java 在經(jīng)歷了最初的手工構(gòu)建，到半自動(dòng)化的 Ant, 再到 Maven 基本就是事實(shí)上的標(biāo)準(zhǔn)了。其間 Maven 還接受了其他的 Gradle(Android 項(xiàng)目主推), SBT(主要是 Scala 項(xiàng)目), Ant+Ivy, Buildr 等的挑戰(zhàn)，但都很難撼動(dòng) Maven 的江湖地位，而且其他的差不多遵循了 Maven 的目錄布局。
回到 Python，產(chǎn)生過 pip, pipenv, conda 那樣的包管理工具，但對(duì)項(xiàng)目的目錄布局沒有任何約定。
關(guān)于構(gòu)建很多還是延續(xù)了傳統(tǒng)的 Makefile 的方式，再就是加上 setup.py 和 build.py 用程序代碼來進(jìn)行安裝與構(gòu)建。關(guān)于項(xiàng)目目錄布局，有做成項(xiàng)目模板的，然后做成工具來應(yīng)用項(xiàng)目模板。
下面大概瀏覽一下四個(gè)工具的使用
CookieCutter
PyScaffold
PyBuilder
Poetry
CookieCutter 一個(gè)經(jīng)典的 Python 項(xiàng)目目錄結(jié)構(gòu)
最后由 cookiecutter 生成的項(xiàng)目模板是下面的樣子：
這大概是當(dāng)前比較流行的目錄結(jié)構(gòu)的主體框架，主要元素是：
項(xiàng)目 sample 目錄中重復(fù) sample 目錄中放置 Python 源文件，tests 目錄中是測試文件，再加一個(gè) docs 目錄放文檔，README.rst, 其他的用于構(gòu)建的 setup, setup.cfg 和 Makefile 文件。
這其實(shí)是一個(gè)很經(jīng)典的 Python 項(xiàng)目結(jié)構(gòu)，接下來的構(gòu)建就用 make 命令了，輸入 make 會(huì)看到定義在 Makefile 文件中的指令
為使用上面的構(gòu)建過程，需要安裝相應(yīng)的包，如 tox, wheel, coverage, sphinx, flake8, 它們都可以通過 pip 來安裝。之后就可以 make test, make coverage, make docs，make dist 等。其中 make docs 可以生成一個(gè)很漂亮的 Web 文檔。
PyScaffold 創(chuàng)建一個(gè)項(xiàng)目
PyScaffold 顧名思義，它是一個(gè)用來創(chuàng)建 Python 項(xiàng)目腳手架的工具，安裝和使用：
這樣創(chuàng)建了一個(gè) Python 項(xiàng)目，目錄結(jié)構(gòu)與前面 cookiecutter 所選的模板差不多，只不過它把源文件放在了 src 目錄，而非 sample 目錄。
整個(gè)項(xiàng)目的構(gòu)建就要用 tox 這個(gè)工具了。tox 是一個(gè)自動(dòng)化測試和構(gòu)建工具，它在構(gòu)建過程中可創(chuàng)建 Python 虛擬環(huán)境，這讓測試和構(gòu)建能有一個(gè)干凈的環(huán)境。
tox -av 能顯示出定義在 tox.ini 中所有的任務(wù)：
要執(zhí)行哪個(gè)命令便用 tox -e build, tox -e docs 等
在我體驗(yàn) tox 命令過程中，每一步好像都比較慢，應(yīng)該是創(chuàng)建虛擬機(jī)要花些時(shí)間。
PyBuilder
最好再看另一個(gè)構(gòu)建工具 PyBuilder， 它所創(chuàng)建出的目錄結(jié)構(gòu)很接近于 Maven, 下面來瞧瞧
完后看下它的目錄結(jié)構(gòu)：
構(gòu)建過程仍然是用 pyb 命令，可用 pyb -h 查看幫助，pyb -t 列出所有的任務(wù), PyBuilder 的任務(wù)是以插件的方式加入的，插件配置在 build.py 文件中。
PyBuilder 也是在構(gòu)建或測試之前創(chuàng)建虛擬環(huán)境, 從 0.12.9 版開始可通過參數(shù) --no-venvs 跳過創(chuàng)建虛擬環(huán)境這一步。使用了 --no-venvs 的話 Python 代碼將會(huì)在運(yùn)行 pyb 的當(dāng)前 Python 環(huán)境中執(zhí)行，所需的依賴將要手工安裝。
項(xiàng)目的依賴也要定義在 build.py 文件中
隨后在執(zhí)行 pyb 創(chuàng)建虛擬環(huán)境時(shí)就會(huì)安裝上面的依賴，并在其中運(yùn)行測試與構(gòu)建。
Poetry
最后一個(gè) Poetry, 感覺這是一個(gè)更為成熟，項(xiàng)目活躍度也更高的 Python 構(gòu)建，它有著更強(qiáng)大的信賴管理功能，用 poetry add boto3 就能添加依賴，poetry show --tree 顯示出依賴樹?？聪氯绾伟惭b及創(chuàng)建一個(gè)項(xiàng)目
它創(chuàng)建的項(xiàng)目比上面都簡單
如果給 poetry new 帶上 --src 參數(shù)，那么源文件目錄 sample 會(huì)放在 src 目錄下，即 sample/src/sample.
poetry init 會(huì)在當(dāng)前目錄中生成 pyproject.toml 文件，目錄等的生成需手動(dòng)完成。
它不關(guān)注文檔的生成，代碼規(guī)范的檢查，代碼覆蓋率都沒有。它的項(xiàng)目配置更集中，全部在 pyproject.toml 文件中，toml 是什么呢?它是一種配置文件的格式 Tom's Obvious, Minimal Language
pyproject.toml 有些類似 NodeJS 的 package.json 文件，比如 poetry add, poetry install 命令的行
其他主要的
poetry run 能執(zhí)行任何系統(tǒng)命令，只是它會(huì)在它要的虛擬環(huán)境中執(zhí)行。所以可以想見，poetry 的項(xiàng)目要生成文檔或覆蓋率都必須用 poetry run ... 命令來支持 sphinx, coverage 或 flake8。
在 sample 目錄(與 pyproject.toml 文件平級(jí))中創(chuàng)建文件 my_module.py, 內(nèi)容為
然后在 pyproject.toml 中寫上
再執(zhí)行
就會(huì)輸出 "hello poetry"。 通過對(duì)以上四個(gè)工具的認(rèn)識(shí)，項(xiàng)目結(jié)構(gòu)的復(fù)雜度由 cookiecutter-pyproject -> PyScaffold -> PyBuilder -> Poetry 依次降低，使用的難度大略也是相同的順序。
京公網(wǎng)安備 11010802030320號(hào)