軟體開發目錄規範

2022-09-21 03:51:12 字數 1065 閱讀 8198

通常為了提高程式的可讀性與可維護性，要為軟體設計乙個良好的目錄結構，這與規範的編碼風格同等重要。軟體的目錄規範並無硬性標準，只要清晰可讀即可，這裡假設軟體名為demo，筆者推薦目錄結構如下

demo/


|-- core/


| |-- core.py


||-- api/


| |-- api.py


||-- db/


| |-- db_handle.py


||-- lib/


| |-- common.py


||-- conf/


| |-- settings.py


||-- run.py


|-- setup.py


|-- requirements.txt


|-- readme
檔案詳情readme的內容，這個應該是每個專案會有的乙個檔案，目的是能簡要描述該項目的資訊，讓讀者快速了解這個專案。它需要說明以下幾個事項:

1、軟體定位，軟體的基本功能；


2、執行**的方法: 安裝環境、啟動命令等；


3、簡要的使用說明；


4、**目錄結構說明，更詳細點可以說明軟體的基本原理；


5、常見問題說明。
一般來說，用setup.py來管理**的打包、安裝、部署問題。業界標準的寫法是用python流行的打包工具setuptools來管理這些事情，這種方式普遍應用於開源專案中。不過這裡的核心思想不是用標準化的工具來解決這些問題，而是說，乙個專案一定要有乙個安裝部署工具，能快速便捷的在一台新機器上將環境裝好、**部署好和將程式執行起來。

requirements.txt檔案的存在是為了方便開發者維護軟體的依賴庫。我們需要將開發過程中依賴庫的資訊新增進該檔案中，避免在 setup.py安裝依賴時漏掉軟體包，同時也方便了使用者明確專案引用了哪些python包。

這個檔案的格式是每一行包含乙個包依賴的說明，通常是flask>=0.10這種格式，要求是這個格式能被pip識別，這樣就可以簡單的通過 pip install -r requirements.txt來把所有python依賴庫都裝好了，具體格式參照

python軟體開發目錄 軟體開發目錄規範

為了提高程式的可讀性與可維護性，我們應該為軟體設計良好的目錄結構，這與規範的編碼風格同等重要。軟體的目錄規範並無硬性標準，只要清晰可讀即可，假設你的軟體名為foo，筆者推薦目錄結構如下 foo core 存放業務邏輯相關 core.py api 存放介面檔案，介面主要用於為業務邏輯提供資料操作。ap...

軟體開發目錄規範

為了提高程式的可讀性與可維護性，我們應該為軟體設計良好的目錄結構，這與規範的編碼風格同等重要，簡而言之就是把軟體 分檔案目錄。假設你要寫乙個atm軟體，你可以按照下面的目錄結構管理你的軟體 atm core src.py 業務核心邏輯 api api.py 介面檔案 db db handle.py ...

軟體開發目錄規範

為了提高程式的可讀性與可維護性，我們應該為軟體設計良好的目錄結構，這與規範的編碼風格同等重要。軟體的目錄規範並無硬性標準，只要清晰可讀即可，假設你的軟體名為foo，筆者推薦目錄結構如下 foo core 存放業務邏輯相關 core.py api 存放介面檔案，介面主要用於為業務邏輯提供資料操作。ap...