Python快速從注釋生成文檔的方法
作為一個標準的程序猿,為程序編寫說明文檔是一步必不可少的工作,如何才能寫的又好又快呢,下面我們就來詳細探討下吧。
今天將告訴大家一個簡單平時只要注意的小細節(jié),就可以輕松生成注釋文檔,也可以檢查我們寫的類方法引用名稱是否重復有問題等。
一看別人專業(yè)的大牛們寫的文檔多牛多羨慕,不用擔心我們可以讓python為我們生成基本滿足的說明文檔,一來可以提高代碼整體閱讀性,二來可以將代碼的整體結(jié)構(gòu)看著也更清晰,這樣在交接的時候可以省很多麻煩,其它同事在接手你工作的時候也不會一行行去問你這是什么那是什么的,因為注釋已經(jīng)很直觀的表述了,在整合的時候可當說明文檔給客戶簡單說明(主要是給你BOSS看的).
那么進入正題怎么實現(xiàn)看下面我簡單的代碼格式,注意注釋的地方和函數(shù)名類名都是與__all__內(nèi)相關(guān)聯(lián)的
#!/usr/bin/env python # -*-coding:utf-8 -*- ''' 文檔快速生成注釋的方法介紹,首先我們要用到__all__屬性 在Py中使用為導出__all__中的所有類、函數(shù)、變量成員等 在模塊使用__all__屬性可避免相互引用時命名沖突 ''' __all__ = ['Login', 'check', 'Shop', 'upDateIt', 'findIt', 'deleteIt', 'createIt'] class Login: ''' 測試注釋一可以寫上此類的作用說明等 例如此方法用來寫登錄 ''' def __init__(self): ''' 初始化你要的參數(shù)說明 那么登錄可能要用到 用戶名username 密碼password ''' pass def check(self): ''' 協(xié)商你要實現(xiàn)的功能說明 功能也有很多例如驗證 判斷語句,驗證碼之類的 ''' pass class Shop: ''' 商品類所包含的屬性及方法 update改/更新 find查找 delete刪除 create添加 ''' def __init__(self): ''' 初始化商品的價格、日期、分類等 ''' pass def upDateIt(self): ''' 用來更新商品信息 ''' pass def findIt(self): ''' 查找商品信息 ''' pass def deleteIt(self): ''' 刪除過期下架商品信息 ''' pass def createIt(self): ''' 創(chuàng)建新商品及上架信息 ''' pass if __name__=="__main__": import pythonzhushi print help(pythonzhushi)
這里要強調(diào)說明下py的名字要和你當前工作的py名字一樣(我這里創(chuàng)建的py名字就是pythonzhushi,最后導入也是這名字),因為下面的測試中import的導入的是自身所以,im port 名稱 和Help(名稱)以及你的文件名稱要一致才可以。為了更加直觀請看下面這圖:
當然還可以從其它文件引用的方式導入這里用到python常用的導入方式from從哪個目錄import導入什么文件pythonzhushi
當然我這里還是用圖片來展示以下:
是不是一目了然,這樣也可以導入我們需要做的注釋文檔,help幫助方法就是幫我們查看到此文件中所包含的類,函數(shù),的一個簡單幫助文檔,類似于readme文檔的一個說明。最后來看看掩飾效果吧:
是不是簡單的打印出我們程序的說明文檔,后面步驟直接可以建一個文本把這個粘貼過去,就完成一個readme的文檔說明,經(jīng)過測試有幾點注意是,想要寫#這種注釋不要寫到def放發(fā)內(nèi)要寫到它的上面位置和裝飾器類似,相反三引號'''不要寫到def外面,這樣也是沒顯示效果的。大家趕緊去試試吧。感謝觀看。。
- Python實現(xiàn)多行注釋的另類方法
- Python中的多行注釋文檔編寫風格匯總
- Python注釋詳解
- python訪問類中docstring注釋的實現(xiàn)方法
- Python中的單行、多行、中文注釋方法
- 學習python分支結(jié)構(gòu)
- Python分支結(jié)構(gòu)(switch)操作簡介
- Python循環(huán)結(jié)構(gòu)的應用場景詳解
- 詳解Python的循環(huán)結(jié)構(gòu)知識點
- Python之循環(huán)結(jié)構(gòu)
- Python的for和break循環(huán)結(jié)構(gòu)中使用else語句的技巧
- Python注釋、分支結(jié)構(gòu)、循環(huán)結(jié)構(gòu)、偽“選擇結(jié)構(gòu)”用法實例分析
相關(guān)文章
Python實現(xiàn)基本數(shù)據(jù)結(jié)構(gòu)中隊列的操作方法示例
這篇文章主要介紹了Python實現(xiàn)基本數(shù)據(jù)結(jié)構(gòu)中隊列的操作方法,結(jié)合實例形式演示了Python針對數(shù)據(jù)結(jié)構(gòu)中隊列的初始化、插入、刪除、判斷隊列滿及隊列空等相關(guān)操作技巧,需要的朋友可以參考下2017-12-12如何對csv文件數(shù)據(jù)分組,并用pyecharts展示
這篇文章主要介紹了如何對csv文件數(shù)據(jù)分組,并用pyecharts展示,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2022-11-11使用Python OpenCV為CNN增加圖像樣本的實現(xiàn)
這篇文章主要介紹了使用Python OpenCV為CNN增加圖像樣本的實現(xiàn),小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2019-06-06