python 軟體目錄規範-技術-拾貝文庫網
文章推薦指數: 80 %
1.可讀性高: 不熟悉這個專案的程式碼的人,一眼就能看懂目錄結構,知道程式啟動指令碼是哪個,測試目錄在哪兒,配置檔案在哪兒等等。
從而非常快速的瞭解這個專案。
python軟體目錄規範
標籤:access test clear 程式 邏輯 軟體開發 log 設計 內容
軟體目錄結構規範
軟體開發規範
一、為什麼要設計好目錄結構?
1.可讀性高:不熟悉這個專案的程式碼的人,一眼就能看懂目錄結構,知道程式啟動指令碼是哪個,測試目錄在哪兒,配置檔案在哪兒等等。
從而非常快速的瞭解這個專案。
2.可維護性高:定義好組織規則後,維護者就能很明確地知道,新增的哪個檔案和程式碼應該放在什麼目錄之下。
這個好處是,隨著時間的推移,程式碼/配置的規模增加,專案結構不會混亂,仍然能夠組織良好。
二、目錄組織方式
關於如何組織一個較好的Python工程目錄結構,已經有一些得到了共識的目錄結構。
假設你的專案名為ATM
ATM/
|--bin/存放專案的一些可執行檔案,當然你可以起名script/之類的也行,但bin/更直觀。
易懂
||--__init__| |--start.py寫啟動程式
|
|--core/存放專案的所有原始碼(核心程式碼)。
(1)原始碼中的所有模組、包都應該放在此目錄。
不要置於頂層目錄。
(2)其子目錄tests/存放單元測試程式碼;(3)程式的入口最好命名為main.py。
||--tests/|||--__init__.py|||--test.main.py||
||--__init__.py
||--test_main.py|存放核心邏輯
|
|--conf/配置檔案
||--__init__.py
||--setting.py寫上相關配置||---db/資料庫檔案
||--db.json寫資料庫檔案|
|--docs/存放一些文件|
|--lib/庫檔案,放自定義模組和包||--__init__.py||--common.py放常用的功能||--log/日誌檔案||--access.log寫上日誌||--__init__.py
|--README專案說明檔案注:執行程式時,在bin目錄下執行start.py程式碼,不可以直接執行core下的模組。
關於README的內容
這個我覺得是每個專案都應該有的一個檔案,目的是能簡要描述該專案的資訊,讓讀者快速瞭解這個專案。
它需要說明以下幾個事項:
軟體定位,軟體的基本功能。
執行程式碼的方法:安裝環境、啟動命令等。
簡要的使用說明。
程式碼目錄結構說明,更詳細點可以說明軟體的基本原理。
常見問題說明。
python軟體目錄規範標籤:access test clear 程式 邏輯 軟體開發 log 設計 內容 原文地址:https://www.cnblogs.com/ceason/p/11644955.html
上一篇:常用的html特殊符號編碼下一篇:windows快捷啟動命令
搜索
最新發布:
win11安全模式怎麼進入
win11下載卡在0%不動怎麼辦
win11下載的軟體怎麼移到桌面
win11正式版如何安裝安卓app
膝上型電腦如何重灌系統win11
重灌系統win11後c盤會清空嗎
win11重灌系統步驟和詳細教程
臺式電腦系統安裝步驟圖解win11
win11下載軟體被阻止怎麼辦
升級win11後怎麼退回win10
win10升級win11方法教程
win10瀏覽器打不開網頁但能上網怎麼辦
win10u盤安裝系統詳細步驟
win10開機黑屏只有滑鼠怎麼辦
win10開機慢怎麼設定優化
延伸文章資訊
- 1如何分析python專案目錄結構 - 水鴨快答
txt記錄依賴的軟體包及對應的版本號,專案使用了哪些Python包, ... 面對一個python專案,如何分析專案目錄結構呢? ... 檔案:README。md:.
- 2Python常見的檔案處理應用
首先,先來看一下我們目前專案的檔案結構,如下:. 現在就來分別介紹幾個Python常用的檔案操作方式:. 檢查檔案是否存在. 利用Path 模組(Module)中的exists()方法,來 ...
- 3python 專案目錄結構設定 - 程式人生
為專案設定目錄結構是為了將功能類似的檔案放置在同一目錄內,增強專案的可讀性和可維護性。如果一個python專案功能單一,程式碼量很小, ...
- 4结构化您的工程 - Python最佳实践指南!
在实践层面, “结构化”意味着通过编写简洁的代码,并且正如文件系统中文件和目录的组织一样, 代码应该使逻辑和依赖清晰。 哪个函数应该深入到哪个模块?数据在项目中如何 ...
- 5Python-如何設計結構清晰的目錄結構 - 程式前沿
關於配置檔案的使用方法