4. 構建C/C++擴展?

一個CPython的C擴展是一個共享庫(例如一個Linux上的 .so ，或者Windows上的 .pyd )，其會導出一個 初始化函數(shù) 。

為了可導入，共享庫必須在 PYTHONPATH 中有效，且必須命名遵循模塊名字，通過適當?shù)臄U展。當使用distutils時，會自動生成正確的文件名。

初始化函數(shù)的聲明如下：

PyObject *PyInit_modulename(void)?

該函數(shù)返回完整初始化過的模塊，或一個 PyModuleDef 實例。查看 Initializing C modules 了解更多細節(jié)。

對于僅有ASCII編碼的模塊名，函數(shù)必須是 PyInit_<modulename> ，將 <modulename> 替換為模塊的名字。當使用 Multi-phase initialization 時，允許使用非ASCII編碼的模塊名。此時初始化函數(shù)的名字是 PyInitU_<modulename> ，而 <modulename> 需要用Python的 punycode 編碼，連字號需替換為下劃線。在Python里:

def initfunc_name(name):
    try:
        suffix = b'_' + name.encode('ascii')
    except UnicodeEncodeError:
        suffix = b'U_' + name.encode('punycode').replace(b'-', b'_')
    return b'PyInit' + suffix

可以在一個動態(tài)庫里導出多個模塊，通過定義多個初始化函數(shù)。而導入他們需要符號鏈接或自定義導入器，因為缺省時只有對應了文件名的函數(shù)才會被發(fā)現(xiàn)。查看 "一個庫里的多模塊" 章節(jié)，在 PEP 489 了解更多細節(jié)。

4.1. 使用distutils構建C和C++擴展?

擴展模塊可以用distutils來構建，這是Python自帶的。distutils也支持創(chuàng)建二進制包，用戶無需編譯器而distutils就能安裝擴展。

一個distutils包包含了一個驅動腳本 setup.py 。這是個純Python文件，大多數(shù)時候也很簡單，看起來如下：

from distutils.core import setup, Extension

module1 = Extension('demo',
                    sources = ['demo.c'])

setup (name = 'PackageName',
       version = '1.0',
       description = 'This is a demo package',
       ext_modules = [module1])

通過文件 setup.py ，和文件 demo.c ，運行如下

python setup.py build

這會編譯 demo.c ，然后產生一個擴展模塊叫做 demo 在目錄 build 里。依賴于系統(tǒng)，模塊文件會放在某個子目錄形如 build/lib.system ，名字可能是 demo.so 或 demo.pyd 。

在文件 setup.py 里，所有動作的入口通過 setup 函數(shù)。該函數(shù)可以接受可變數(shù)量個關鍵字參數(shù)，上面的例子只使用了一個子集。特別需要注意的例子指定了構建包的元信息，以及指定了包內容。通常一個包會包括多個模塊，就像Python的源碼模塊、文檔、子包等。請參數(shù)distutils的文檔，在 分發(fā) Python 模塊（遺留版本） 來了解更多distutils的特性；本章節(jié)只解釋構建擴展模塊的部分。

通常預計算參數(shù)給 setup() ，想要更好的結構化驅動腳本。有如如上例子函數(shù) setup() 的 ext_modules 參數(shù)是一列擴展模塊，每個是一個 Extension 類的實例。例子中的實例定義了擴展命名為 demo ，從單一源碼文件構建 demo.c 。

更多時候，構建一個擴展會復雜的多，需要額外的預處理器定義和庫。如下例子展示了這些。

from distutils.core import setup, Extension

module1 = Extension('demo',
                    define_macros = [('MAJOR_VERSION', '1'),
                                     ('MINOR_VERSION', '0')],
                    include_dirs = ['/usr/local/include'],
                    libraries = ['tcl83'],
                    library_dirs = ['/usr/local/lib'],
                    sources = ['demo.c'])

setup (name = 'PackageName',
       version = '1.0',
       description = 'This is a demo package',
       author = 'Martin v. Loewis',
       author_email = 'martin@v.loewis.de',
       url = 'https://docs.python.org/extending/building',
       long_description = '''
This is really just a demo package.
''',
       ext_modules = [module1])

例子中函數(shù) setup() 在調用時額外傳遞了元信息，是推薦發(fā)布包構建時的內容。對于這個擴展，其指定了預處理器定義，include目錄，庫目錄，庫。依賴于編譯器，distutils還會用其他方式傳遞信息給編譯器。例如在Unix上，結果是如下編譯命令

gcc -DNDEBUG -g -O3 -Wall -Wstrict-prototypes -fPIC -DMAJOR_VERSION=1 -DMINOR_VERSION=0 -I/usr/local/include -I/usr/local/include/python2.2 -c demo.c -o build/temp.linux-i686-2.2/demo.o

gcc -shared build/temp.linux-i686-2.2/demo.o -L/usr/local/lib -ltcl83 -o build/lib.linux-i686-2.2/demo.so

這些行代碼僅用于展示目的；distutils用戶應該相信distutils能正確調用。

4.2. 發(fā)布你的擴展模塊?

當一個擴展已經成功地被構建時，有三種方式來使用它。

最終用戶通常想要安裝模塊，可以這么運行

python setup.py install

模塊維護者應該制作源碼包；要實現(xiàn)可以運行

python setup.py sdist

有些情況下，需要在源碼發(fā)布包里包含額外的文件；這通過 MANIFEST.in 文件實現(xiàn)，查看 Specifying the files to distribute 了解細節(jié)。

如果源碼發(fā)行包被成功地構建，維護者還可以創(chuàng)建二進制發(fā)行包。 取決于具體平臺，以下命令中的一個可以用來完成此任務

python setup.py bdist_rpm
python setup.py bdist_dumb