Ⅰ python 程序有什麼好的自動從注釋生成文檔的方法
用Sphinx
以win32系統為例，最簡單的安裝方式是在Dos下輸入如下代碼
pip install -U sphinx
安裝好了之後，用最簡單的半自動生成API文檔的方式進行
例如：你的python安裝在C:\python27， 想要給flask包自動製作文檔，製作完成的文檔放在C:\python_doc\flask的文件夾
代碼如下：
sphinx-apidoc -F -o C:\python_doc\flask C:\python27\lib\site-packages\
（此處-o應緊跟輸出文件夾，不然會產生一個-F的文件夾，多謝@Hyacz）
然後進入C:\python_doc\flask文件夾
cd C:\python_doc\flask
此文件夾下有一個make.bat文件，再執行一下
make html
然後就能在\_build\html文件夾中看到生成好的文檔了，還支持查找的功能
Ⅱ python2.7.12 subprocess模塊文檔翻譯
17.1 subprocess
這個模塊允許你產生子線程，連接他們（主線成，和產生的子線程）之間的輸入／輸出／錯誤 管道（pipes，管道是一種把兩個進程之間的標准輸入和標准輸出連接起來的機制，從而提供一種讓多個進程間通信的方法）。這個模塊想要替換一些比較舊的模塊和方法：
17.1.1 使用subprocess
在使用subprocess時推薦調用以下幾個方來完成你的需求。如果有更高級的情況，可以使用Popen介面。
根據args參數運行命令，等待命令執行結束，返回進程返回值
根據args參數運行命令，等待命令執行結束，如果進程返回值為0則返回（return），否則會raise一個CalledProcessError錯誤，CalledProcessError類的returncode屬性會包含進程返回值。
subprocess.check_output( args , * , stdin=None , stderr=None , shell=False , universal_newlines=False )
正在更新....
Ⅲ 如何實現 C/C++ 與 Python 的通信
屬於混合編程的問題。較全面的介紹一下，不僅限於題主提出的問題。
以下討論中，Python指它的標准實現，即CPython（雖然不是很嚴格）
本文分4個部分
C/C++ 調用 Python （基礎篇）— 僅討論Python官方提供的實現方式
Python 調用 C/C++ （基礎篇）— 僅討論Python官方提供的實現方式
C/C++ 調用 Python （高級篇）— 使用 Cython
Python 調用 C/C++ （高級篇）— 使用 SWIG
練習本文中的例子，需要搭建Python擴展開發環境。具體細節見搭建Python擴展開發環境 - 蛇之魅惑 - 知乎專欄
1 C/C++ 調用 Python（基礎篇）
Python 本身就是一個C庫。你所看到的可執行體python只不過是個stub。真正的python實體在動態鏈接庫里實現，在Windows平台上，這個文件位於 %SystemRoot%\System32\python27.dll。
你也可以在自己的程序中調用Python，看起來非常容易：
//my_python.c
#include <Python.h>
int main(int argc, char *argv[])
{
Py_SetProgramName(argv[0]);
Py_Initialize();
PyRun_SimpleString("print 'Hello Python!'\n");
Py_Finalize();
return 0;
}
在Windows平台下，打開Visual Studio命令提示符，編譯命令為
cl my_python.c -IC:\Python27\include C:\Python27\libs\python27.lib
在Linux下編譯命令為
gcc my_python.c -o my_python -I/usr/include/python2.7/ -lpython2.7
在Mac OS X 下的編譯命令同上
產生可執行文件後，直接運行，結果為輸出
Hello Python!
Python庫函數PyRun_SimpleString可以執行字元串形式的Python代碼。
雖然非常簡單，但這段代碼除了能用C語言動態生成一些Python代碼之外，並沒有什麼用處。我們需要的是C語言的數據結構能夠和Python交互。
下面舉個例子，比如說，有一天我們用Python寫了一個功能特別強大的函數：
def great_function(a):
return a + 1
接下來要把它包裝成C語言的函數。我們期待的C語言的對應函數應該是這樣的：
int great_function_from_python(int a) {
int res;
// some magic
return res;
}
首先，復用Python模塊得做『import』，這里也不例外。所以我們把great_function放到一個mole里，比如說，這個mole名字叫 great_mole.py
接下來就要用C來調用Python了，完整的代碼如下：
#include <Python.h>
int great_function_from_python(int a) {
int res;
PyObject *pMole,*pFunc;
PyObject *pArgs, *pValue;
/* import */
pMole = PyImport_Import(PyString_FromString("great_mole"));
/* great_mole.great_function */
pFunc = PyObject_GetAttrString(pMole, "great_function");
/* build args */
pArgs = PyTuple_New(1);
PyTuple_SetItem(pArgs,0, PyInt_FromLong(a));
/* call */
pValue = PyObject_CallObject(pFunc, pArgs);
res = PyInt_AsLong(pValue);
return res;
}
從上述代碼可以窺見Python內部運行的方式：
所有Python元素，mole、function、tuple、string等等，實際上都是PyObject。C語言里操縱它們，一律使用PyObject *。
Python的類型與C語言類型可以相互轉換。Python類型XXX轉換為C語言類型YYY要使用PyXXX_AsYYY函數；C類型YYY轉換為Python類型XXX要使用PyXXX_FromYYY函數。
也可以創建Python類型的變數，使用PyXXX_New可以創建類型為XXX的變數。
若a是Tuple，則a[i] = b對應於 PyTuple_SetItem(a,i,b)，有理由相信還有一個函數PyTuple_GetItem完成取得某一項的值。
不僅Python語言很優雅，Python的庫函數API也非常優雅。
現在我們得到了一個C語言的函數了，可以寫一個main測試它
#include <Python.h>
int great_function_from_python(int a);
int main(int argc, char *argv[]) {
Py_Initialize();
printf("%d",great_function_from_python(2));
Py_Finalize();
}
編譯的方式就用本節開頭使用的方法。
在Linux/Mac OSX運行此示例之前，可能先需要設置環境變數：
bash:
export PYTHONPATH=.:$PYTHONPATH
csh:
setenv PYTHONPATH .:$PYTHONPATH
2 Python 調用 C/C++（基礎篇）
這種做法稱為Python擴展。
比如說，我們有一個功能強大的C函數：
int great_function(int a) {
return a + 1;
}
期望在Python里這樣使用：
>>> from great_mole import great_function
>>> great_function(2)
3
考慮最簡單的情況。我們把功能強大的函數放入C文件 great_mole.c 中。
#include <Python.h>
int great_function(int a) {
return a + 1;
}
static PyObject * _great_function(PyObject *self, PyObject *args)
{
int _a;
int res;
if (!PyArg_ParseTuple(args, "i", &_a))
return NULL;
res = great_function(_a);
return PyLong_FromLong(res);
}
static PyMethodDef GreateMoleMethods[] = {
{
"great_function",
_great_function,
METH_VARARGS,
""
},
{NULL, NULL, 0, NULL}
};
PyMODINIT_FUNC initgreat_mole(void) {
(void) Py_InitMole("great_mole", GreateMoleMethods);
}
除了功能強大的函數great_function外，這個文件中還有以下部分：
包裹函數_great_function。它負責將Python的參數轉化為C的參數（PyArg_ParseTuple），調用實際的great_function，並處理great_function的返回值，最終返回給Python環境。
導
出表GreateMoleMethods。它負責告訴Python這個模塊里有哪些函數可以被Python調用。導出表的名字可以隨便起，每一項有4
個參數：第一個參數是提供給Python環境的函數名稱，第二個參數是_great_function，即包裹函數。第三個參數的含義是參數變長，第四個
參數是一個說明性的字元串。導出表總是以{NULL, NULL, 0, NULL}結束。
導出函數initgreat_mole。這個的名字不是任取的，是你的mole名稱添加前綴init。導出函數中將模塊名稱與導出表進行連接。
在Windows下面，在Visual Studio命令提示符下編譯這個文件的命令是
cl /LD great_mole.c /o great_mole.pyd -IC:\Python27\include C:\Python27\libs\python27.lib
/LD 即生成動態鏈接庫。編譯成功後在當前目錄可以得到 great_mole.pyd（實際上是dll）。這個pyd可以在Python環境下直接當作mole使用。
在Linux下面，則用gcc編譯：
gcc -fPIC -shared great_mole.c -o great_mole.so -I/usr/include/python2.7/ -lpython2.7
在當前目錄下得到great_mole.so，同理可以在Python中直接使用。
本部分參考資料
《Python源碼剖析-深度探索動態語言核心技術》是系統介紹CPython實現以及運行原理的優秀教程。
Python 官方文檔的這一章詳細介紹了C/C++與Python的雙向互動Extending and Embedding the Python Interpreter
關於編譯環境，本文所述方法僅為出示原理所用。規范的方式如下：3. Building C and C++ Extensions with distutils
作為字典使用的官方參考文檔 Python/C API Reference Manual
用以上的方法實現C/C++與Python的混合編程，需要對Python的內部實現有相當的了解。接下來介紹當前較為成熟的技術Cython和SWIG。
3 C/C++ 調用 Python（使用Cython）
在
前面的小節中談到，Python的數據類型和C的數據類型貌似是有某種「一一對應」的關系的，此外，由於Python（確切的說是CPython）本身是
由C語言實現的，故Python數據類型之間的函數運算也必然與C語言有對應關系。那麼，有沒有可能「自動」的做替換，把Python代碼直接變成C代碼
呢？答案是肯定的，這就是Cython主要解決的問題。
安裝Cython非常簡單。Python 2.7.9以上的版本已經自帶easy_install：
easy_install -U cython
在Windows環境下依然需要Visual
Studio，由於安裝的過程需要編譯Cython的源代碼，故上述命令需要在Visual
Studio命令提示符下完成。一會兒使用Cython的時候，也需要在Visual
Studio命令提示符下進行操作，這一點和第一部分的要求是一樣的。
繼續以例子說明：
#great_mole.pyx
cdef public great_function(a,index):
return a[index]
這其中有非Python關鍵字cdef和public。這些關鍵字屬於Cython。由於我們需要在C語言中使用
「編譯好的Python代碼」，所以得讓great_function從外面變得可見，方法就是以「public」修飾。而cdef類似於Python的
def，只有使用cdef才可以使用Cython的關鍵字public。
這個函數中其他的部分與正常的Python代碼是一樣的。
接下來編譯 great_mole.pyx
cython great_mole.pyx
得到great_mole.h和great_mole.c。打開great_mole.h可以找到這樣一句聲明：
__PYX_EXTERN_C DL_IMPORT(PyObject) *great_function(PyObject *, PyObject *)
寫一個main使用great_function。注意great_function並不規定a是何種類型，它的
功能只是提取a的第index的成員而已，故使用great_function的時候，a可以傳入Python
String，也可以傳入tuple之類的其他可迭代類型。仍然使用之前提到的類型轉換函數PyXXX_FromYYY和PyXXX_AsYYY。
//main.c
#include <Python.h>
#include "great_mole.h"
int main(int argc, char *argv[]) {
PyObject *tuple;
Py_Initialize();
initgreat_mole();
printf("%s\n",PyString_AsString(
great_function(
PyString_FromString("hello"),
PyInt_FromLong(1)
)
));
tuple = Py_BuildValue("(iis)", 1, 2, "three");
printf("%d\n",PyInt_AsLong(
great_function(
tuple,
PyInt_FromLong(1)
)
));
printf("%s\n",PyString_AsString(
great_function(
tuple,
PyInt_FromLong(2)
)
));
Py_Finalize();
}
編譯命令和第一部分相同：
在Windows下編譯命令為
cl main.c great_mole.c -IC:\Python27\include C:\Python27\libs\python27.lib
在Linux下編譯命令為
gcc main.c great_mole.c -o main -I/usr/include/python2.7/ -lpython2.7
這個例子中我們使用了Python的動態類型特性。如果你想指定類型，可以利用Cython的靜態類型關鍵字。例子如下：
#great_mole.pyx
cdef public char great_function(const char * a,int index):
return a[index]
cython編譯後得到的.h里，great_function的聲明是這樣的：
__PYX_EXTERN_C DL_IMPORT(char) great_function(char const *, int);
很開心對不對！
這樣的話，我們的main函數已經幾乎看不到Python的痕跡了：
//main.c
#include <Python.h>
#include "great_mole.h"
int main(int argc, char *argv[]) {
Py_Initialize();
initgreat_mole();
printf("%c",great_function("Hello",2));
Py_Finalize();
}
在這一部分的最後我們給一個看似實用的應用（僅限於Windows）：
還是利用剛才的great_mole.pyx，准備一個dllmain.c：
#include <Python.h>
#include <Windows.h>
#include "great_mole.h"
extern __declspec(dllexport) int __stdcall _great_function(const char * a, int b) {
return great_function(a,b);
}
BOOL WINAPI DllMain(HINSTANCE hinstDLL,DWORD fdwReason,LPVOID lpReserved) {
switch( fdwReason ) {
case DLL_PROCESS_ATTACH:
Py_Initialize();
initgreat_mole();
break;
case DLL_PROCESS_DETACH:
Py_Finalize();
break;
}
return TRUE;
}
在Visual Studio命令提示符下編譯：
cl /LD dllmain.c great_mole.c -IC:\Python27\include C:\Python27\libs\python27.lib
會得到一個dllmain.dll。我們在Excel裡面使用它，沒錯，傳說中的Excel與Python混合編程：
參考資料：Cython的官方文檔，質量非常高：
Welcome to Cython』s Documentation
Ⅳ Python 中文文檔
Python標准庫中文版：http://tieba..com/f?kz=801447402
python 的教程我自己收集了上百M
市面也有一些中文版的書
樓主也應該學一學英語，將來自己能看英文文檔還是很好的。
Ⅳ python 怎麼開發文檔管理系統
這里假設variables 是一些數字。 variables = raw_input('please input your variables:')List=[int(x) for x in variables.split()]List.sort(reverse=True)print List
Ⅵ python有沒有什麼幫助文檔
你的PYTHON文件夾裡面的 DOC文件夾 里就有PYTHON的官方文檔。
另外你要看第三方庫的文檔 可以去網上搜 比如 flask beautifulsoup requests dj 都有官方的中文文檔。
當然PYthon最著名的第三方合作或者說現在各種開發庫的權威 應該是GITHUB這個網站。有空經常去這里 全是界的大牛都在這。。比微軟的MSDN還牛逼啊
Ⅶ python入門教程
Python語言是一種典型的腳本語言，簡潔，語法約束少，接近人類語言。有豐富的數據結構，例如列表、字典、集合等。具有可移植性，支持面向過程和面向對象編程，並且開源。
下載安裝：從python官網下載開發和運行環境程序。本例下載python-3.3.3.amd64的安裝包，並安裝。
開發工具：window系統中，python有多種開發工具，比如，一、直接在cmd命令窗口執行，但此種僅能單條語句執行，不能運行完整的程序。二、python自帶的集成開發環境，可通過開始——所有程序——python3.3——IDLE(Python GUI)啟動。三、其他集成開發環境，如PythonWin等，有編輯和調試能力，還實現了MFC類庫存的包裝。
本例中，使用python自帶的開發環境。File—New File，新建py文檔，編寫程序，保存。Run——Run mole，可得到運行結果。
封裝性：可以把屬性、方法結合在一起，不可以直接訪問對象的屬性，僅能通過介面與對象發生聯系。以下把方法和屬性封裝成了一個類。
構造器：python有3種類型的構造器，且一個類中僅可以定義一個構造器，若多個，則以最後為准。1.若不聲明，則默認為一個沒有任何操作的特殊的__init__方法，__init__(self)，此時可通過obj = my_class()聲明實例。 2.自聲明__init__構造器，會覆蓋默認的，且可以更新類的數據屬性。3.構造器方法__new__()，用於不可變內置類型派生，不能通過實例訪問屬性，僅能通過類訪問。
繼承性：python支持多繼承，且子類繼承了父類的方法和屬性。若子類中有和父類相同名稱的方法，則子類會覆蓋（Override）父類方法。父類方法依舊可以訪問。
數據結構：有豐富的數據結構，例如列表、字典、集合等。本例簡單介紹字典的使用。字典是鍵值對的無序集合，是可變對象。鍵在字典中是唯一的且必須是不可變對象。值可以是可變對象或不可變對象。以下例子對python字典的定義、訪問、更新等的操作。
文件的讀寫：python系統提供open()函數建立文件對象，並打開要讀寫的文件。可對文件進行讀，寫，若不需要時，需關閉文件，釋放系統資源。
其他：python的數據類型，如數字類型、字元串類型等。運算符、程序控制結構、函數、異常處理等內容。一些基本的用法，可在平時的使用中鞏固加強。若熟知java，python上手會很快。
Ⅷ python 如何使用幫助文檔
一般都是看具體使用哪個模塊，然後找到對應的文檔，
官方的在線文檔非常完善：
https://docs.python.org/2/library/index.html
Ⅸ Python Word文檔處理 上篇：python-docx
某天我收到一個需求：希望能夠用python對word文檔進行一些處理，比如更換一些文字以及添加批註。
簡單搜索後，我發現 python-docx 是一個處理docx文檔的常用python庫，因此我打算用它來進行進一步開發。
官方文檔 提供了一個簡單的示例
python-docx 將文檔抽象為document對象、paragraph對象以及run對象，提供了圍繞這些對象進行簡單處理的API
然而在文檔中並沒有出現關於批註操作的部分，我在搜尋 一些文章 後發現了在某個 issue 中提及了添加批註相關信息，然而還是沒有得到具體的解決辦法
docx文檔底層是由XML文件組成的
我們可以將一個 xx.docx 文件的後綴名改為 .rar 然後將其手動解壓，可以得到下面這些文件
在諸多文件當中主要用到的是 document.xml 文件，這里保存了文檔的內容
打開一份 document.xml 文件，拋開header、footer、table以及其他特殊項，去掉樣式等修飾項，一份樸素的docx文檔主要可以分為三個部分：paragraph、run、text
paragraph即段落，就是我們在word當中看到的一段。text即文本，就是真實的內容。run比較抽象，我們可以將其理解為片段，即語句的切分。
為了更好地理解run是什麼，打開一篇word文檔定位其中一句話
讓我們看看這篇文檔解壓之後的 document.xml 文件中對應的部分
OK，我們可以看到原本完整的一句話在word中被拆分成了許多個 <w:r> 標簽，這就是 run ，word切分 run 的規則很多，有的根據標點符號，有的根據中文分詞，句子中如果存在不同樣式的字詞也會單獨切分出來，因此我們很難預估一句話究竟會被分成幾個片段。
在issue中搜索comment關鍵字發現在一個 merge request 上已經給出了添加批註的解決方案，可以通過 paragraph 對象上的 add_comment 方法給一個段落添加批註
但這還是不符合我的需求，我的目標是精準添加到某個詞或者短語上
打開 這個貢獻者的源碼 進行研究
其實就是在P標簽內插入comment標簽引用，同時添加comment標簽到xx文件
同理我們可以在r標簽內插入comment標簽引用，同時添加comment標簽到xx文件，這樣就能實現給特定詞添加批註的需求了