目的:
首先,在文件的最開頭,如果有個多行注釋(三引號),就會將注釋寫入__DOC__變量,在help查看時,可以看見這個變量。
如果還需要輸出函數(shù),則可以將函數(shù)放入__all__變量。
1
|
__all__ = ['search','fix','hello','parser'] |
all里面的元素是唯一的,所以,這里要避免函數(shù)重名。當然,python對函數(shù)的重載也不是很提倡……
這樣在python命令行,可以看見注釋了。
比如一個程序是test02.py,先import它,再看
1
|
help(test02) |
或者在程序中調用print(help(test02))
源代碼:
1
2
3
4
5
6
7
8
9
10
11
12
|
#test02.py """ author:Zhao Zhenyu this is an absolute test program. """ __all__ = ["function1", "function2"] def function1(): pass def function2(): """2nd """ pass |
執(zhí)行情況:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
>>> import test02 >>> help(test02) Help on module test02: NAME test02 DESCRIPTION author:Zhao Zhenyu this is an absolute test program. FUNCTIONS function1() function2() 2nd DATA __all__ = ['function1', 'function2'] FILE c:\users\lenovo\documents\python scripts\python_spider\csdn例子\test02.py >>> |
以上這篇對python的文件內(nèi)注釋 help注釋方法就是小編分享給大家的全部內(nèi)容了,希望能給大家一個參考,也希望大家多多支持服務器之家。
原文鏈接:https://blog.csdn.net/tjzzy/article/details/70256155