專案文件注釋的檢視方法
條件:
1:在專案的根目錄執行
python3 -m pydoc -b :使用任務未被占用的埠
或python3 -m pydoc -p 10011 :使用指定的10011埠
2:對於專案中的包, 包中必須有「__init__.py」檔案, 才能被索引顯示出來, 如果沒有這個檔案,pydoc
會將其當做乙個普通的目錄, pydoc不會去遞迴索引這個目錄。
3:pydoc 只能顯示python模組, 也就是以「.py」結尾的檔案, 其他的不會被索引顯示。
專案注釋文件的生成(包中必須有「init.py」檔案, 才能被索引顯示出來)
方法1 生成文字格式的注釋文件
import pydoc
import sys
with
open
('aa.txt'
,'w'
)as f:
pydoc.doc(
'bin.socketserver'
, output=f)
方法2: 使用help()函式, 生成的是文字格式的文件import pydoc
import sys
# help() == pydoc.help() == pydoc.doc()
sys.stdout =
open
('aa.txt'
,'w'
)help
('bin.socketserver'
)sys.stdout.close(
)# sys.stdout的作用是將輸出到控制台的內容寫
# 入檔案(來自 )
# 問題1:help函式會生成每乙個類所有父類的注釋文件, 所有公共父類會重複生成很多次注釋,
import pydoc
import sys
# 方法1 和方法2 配合獲取目錄下所有檔案(帶絕對路徑的檔案)可以生成整個專案的注釋文件
'/home/myubuntu/desktop'
)pydoc.writedocs(
'/home/myubuntu/desktop'
)# /home/myubuntu/desktop : 是專案資料夾所在的父目錄
# 注意: 生成注釋文件的py模組必須在專案目錄的子目錄中建立, 子子目錄也可以。
# 方法3會生成乙個「專案名字.html」文件, 這個文件可以放在專案目錄下任何地方。 如果放在專案其他目錄
# 不行,就複製這個檔案,修改其中的標籤的鏈結指向「專案名字.html」這個檔案即可(鏈結必須是相對路徑)。
# 修改標籤的鏈結abc(package)
# doc_file是生成注釋文件的目錄
# 檔案完整內容如下:
>
python: package abc<
/title>
"content-type" content=
"text/html; charset=utf-8"
>
<
/head>
"#f0f0f8"
>
"100%" cellspacing=
0 cellpadding=
2 border=
0 summary=
"heading"
>
"#7799ee"
>
"#ffffff" face=
"helvetica, arial"
>
gmtesttool_iccard<
/strong>
<
/big>
<
/big>
<
/font>
<
/td>
>
"#ffffff" face=
"helvetica, arial"
>
"file:/root/桌面/abc/__init__.py"
>
/root/桌面/abc/__init__.py<
/a>
<
/font>
<
/td>
<
/tr>
<
/table>
<
/p>
"100%" cellspacing=
0 cellpadding=
2 border=
0 summary=
"section"
>
"#aa55cc"
>
3 valign=bottom>
"#ffffff" face=
"helvetica, arial"
>
package contents<
/strong>
<
/big>
<
/font>
<
/td>
<
/tr>
"#aa55cc"
>
<
/tt>
<
/td>
<
/td>
"100%"
>
"100%" summary=
"list"
>
"25%" valign=top>
"./doc_file/abc.html"
>
abc<
/strong>
(package)
<
/a>
<
/td>
<
/tr>
<
/table>
<
/td>
<
/tr>
<
/table>
<
/body>
<
/html>
python 自帶模組 os模組
os模組 首先可以開啟cmd輸入python進入互動介面 然後輸入dir os 就可以看到os的全部用法了 我們簡單的舉幾個例子就行了。寫入os.getcwd 可以檢視當前所在路徑 import osprint os.getcwd 寫入os.listdir檢視當前路徑下的檔案 當然你也可以指定檢視那...
Python爬蟲02 urllib自帶模組編寫
現在的python已經出到了3.5.2 在python 3以後的版本中,urllib2這個模組已經不單獨存在 也就是說當你import urllib2時,系統提示你沒這個模組 urllib2被合併到了urllib中,叫做urllib.request 和 urllib.error urllib整個模組...
驚喜Python 3 3後的pydoc功能
在學習任何一門語言的時候,我們都離不開參考資料 幫助文件,因為現在語言發展的越來越完善,引進的built in命令越來越多,要想把它們全部記憶是非常不可能的事情。開發人員往往會集中在某個領域,對該領域中的語言語法細節也許擅長,但偶爾也需要使用其他領域的語法細節,這時就需要參考資料了。現在的搜尋引擎這...