Python 模組的結構約定是什麼?


這裡有一個示例專案,它展示了一種非常好的專案結構方式:https://github.com/kennethreitz/samplemod. 該專案是關於建立“sample”模組的。目錄結構如下所示

README.rst
LICENSE
setup.py
requirements.txt
sample/__init__.py
sample/core.py
sample/helpers.py
docs/conf.py
docs/index.rst
tests/test_basic.py
tests/test_advanced.py

README.rst 檔案:此檔案用於簡要描述模組,如何設定,如何使用等。

許可證:包含許可證文字和任何版權宣告。

setup.py:它是 Python 對多平臺安裝程式的解決方案,並建立檔案。如果您熟悉命令列安裝,那麼 make && make install 轉換為 python setup.py build && python setup.py install。因此,它用於在使用者機器上構建您的專案。

requirements.txt:Pip 需求檔案應指定為專案做出貢獻所需的依賴項:測試、構建和生成文件。如果您的專案沒有開發依賴項,或者您更喜歡透過 setup.py 設定開發環境,則此檔案是不必要的。

docs/:此目錄包含專案的文件。

tests/:所有測試都應位於此目錄中。最初,您將擁有一個測試檔案。隨著它們的增長,您可以像模組目錄一樣組織測試。

sample/:此目錄包含您實際的模組程式碼。如果您的模組僅包含單個檔案,則可以將其直接放置在儲存庫的根目錄中,例如 sample.py。您的庫不應位於模稜兩可的 src 或 python 子目錄中。如果希望此模組駐留在包中,則它將包含一個 __init__.py 檔案。

更新於: 2019年10月1日

137 次瀏覽

開啟你的職業生涯

透過完成課程獲得認證

開始
廣告

© . All rights reserved.