4.1 型どおりのアプローチ

Windows での拡張モジュールのビルドには、Unix と同じように、 distutils パッケージを使ったビルド作業の制御と手動の二通りのアプローチがあります。 distutils によるアプローチはほとんどの拡張モジュールでうまくいきます; distutils を使った拡張モジュールのビルドとパッケージ化については、 Python モジュールの配布 にあります。この節では、C や C++で書かれた Python 拡張モジュールを手動でビルドするアプローチについて述べます。

以下の説明に従って拡張モジュールをビルドするには、インストールされている Python と同じバージョンの Python のソースコードを持っていなければなりません。また、 Microsoft Visual C++ ``Developer Studio'' が必要になります; プロジェクトファイルは VC++ バージョン 7.1 向けのものが提供されていますが、以前のバージョンの VC++も使えます。Python自体をビルドしたものと同じバージョンの VC++を使わなければならないことに注意しましょう。ここで述べる例題のファイルは、Python ソースコードと共に配布されており、PC\example_nt\ ディレクトリにあります。

例題ファイルをコピーする
example_nt ディレクトリは PC ディレクトリのサブディレクトリになっています。これは PC 関連の全てのファイルをソースコード配布物内の同じディレクトリに置くための措置です。とはいえ実際には、 example_nt ディレクトリはPC の下では利用できません。そこで、まずこのディレクトリを一階層上にコピーして、 example_nt が PC および Include と同じ階層のディレクトリになるようにします。以降の作業は、移動先の新しいディレクトリ内で行ってください。

プロジェクトを開く
VC++から、ファイル > ソリューションを開くダイアログメニューを選択します (ファイル > 開くではありません!)。ディレクトリ階層を辿って、example_nt をコピーしたディレクトリ 内のexample.sln を選択し、「開く」をクリックします。

例題の DLL をビルドする
設定が全て正しく行われているか調べるために、ビルドしてみます:

ビルド構成を選びます。このステップは省略できます。ビルド > 設定マネージャー > アクティブなソリューションの設定を選び、リリースまたはデバッグを選びます。このステップを飛ばすと、VC++ はデフォルトでデバッグ構成を使います。
DLL をビルドします。ビルド > ソリューションのビルドを選びます。この操作で。全ての中間ファイルおよび最終ファイルが、上のビルド構成で選んだ構成に従ってDebug または Release という名前のディレクトリに生成されます。

デバッグモードの DLL をテストする
デバッグビルドが成功したら、コマンドプロンプトを起動し、 example_nt\Debug ディレクトリに移動してください。以下のセッション通りにコマンドを実行できるはずです (C> は DOS コマンドのプロンプト、»> は Python のプロンプトです; ビルド情報や様々なデバッグ出力は、ここに示したスクリーン出力と一致しないこともあるので注意して下さい):

C>..\..\PCbuild\python_d
Adding parser accelerators ...
Done.
Python 2.2 (#28, Dec 19 2001, 23:26:37) [MSC 32 bit (Intel)] on win32
Type "copyright", "credits" or "license" for more information.
>>> import example
[4897 refs]
>>> example.foo()
Hello, world
[4903 refs]
>>>

おめでとうございます! とうとう初めての Python 拡張モジュールのビルドに成功しましたね。

自分用にプロジェクトを作成する
プロジェクト用のディレクトリを適当な名前で作成してください。自作の C ソースコードをディレクトリ内にコピーします。モジュールのソースコードファイル名は必ずしもモジュール名と一致している必要はありませんが、初期化関数の名前はモジュール名と一致していなければなりません -- 初期化関数の名前が initspam() なら、モジュールはspam という名前でしか import できません。initspam() は第一引数を "spam" にして、Py_InitModule() を呼び出します (このディレクトリにある、最小限の内容が書かれている example.c を手がかりにするとよいでしょう)。ならわしとして、ファイルはspam.c または spammodule.c という名前にしておきます。出力ファイル名はリリースモードでは smap.dll や spam.pyd、デバッグモードではsmap_d.dll や spam_d.pyd、になるはずです (後者は、システムライブラリ spam.dll と、Python インタフェースとなる自作のモジュールとの混同を避けるために推奨されています) 。

さて、やり方は二通りあります:

example.dsw と example.vcproj をコピーし、 spam.* に名前を変えて、手作業で編集する
新しくプロジェクトを作成する; 説明は下にあります。

どちらの場合も、example_nt\example.def を spam\spam.def にコピーして、新たにできた spam.def を編集し、二行目に `initspam' が入るようにします。自分で新たなプロジェクトを作成したのなら、ここで spam.def をプロジェクトに追加しておいてください (このファイルはたった二行しかない目障りなファイルです。.def ファイルを全く無視するという方法もあり、それには /exprt:initspam を「プロジェクトのプロパティ」ダイアログにあるリンク設定のどこかに手動で追加します)。

新しくプロジェクトを作成する
ファイル > 新規作成 > プロジェクトダイアログを使って、新たなプロジェクト用ワークスペースを作成します。 Visual C++ プロジェクト/Win32/Win32 プロジェクトを選択し、名前("spam") を入れ、「場所」が先ほど作成した spam ディレクトリの親ディレクトリに (Python ビルドツリーの直下のサブディレクトリで、 Include および PC と同じディレクトリになるはずです) あることを確かめます。「作成」をクリックします。

TODO You should now create the file spam.def as instructed in the previous section. Add the source files to the project, using Project > Add Existing Item. Set the pattern to *.* and select both spam.c and spam.def and click OK. (Inserting them one by one is fine too.)

プロジェクト > spam のプロパティダイアログを開きます。ほんのいくつかですが、設定の変更が必要です。構成ドロップダウンリストにすべての構成が設定されているか確かめてください。 C/C++ タブを選び、ポップアップメニューから「一般」カテゴリを選びます。以下のテキスト:

..\Include,..\PC

を、追加のインクルードディレクトリとラベルされたエントリボックスに入力します

次に、「リンカ」タブの「一般」カテゴリを選び、

..\PCbuild

を追加のライブラリディレクトリと書かれたテキストボックスに入力します。

さて、構成ごとに特有の設定をいくつか行う必要があります:

「構成」ドロップダウンリストから、リリースを選んでください。「リンク」タブをクリックし、「入力」カテゴリを選んで、「追加の依存ファイル」ボックス内のリストにpythonXY.lib を追加します。

「構成」ドロップダウンリストから、デバッグに切り替え、「追加の依存ファイル」ボックス内のリストにpythonXY_d.lib を追加します。次に C/C++ タブをクリックして、コード生成をカテゴリから選び、ラインタイムライブラリに対してマルチスレッドデバッグ DLL を選びます。

「構成」ドロップダウンリストからリリースに切り替えなおします。ラインタイムライブラリに対してマルチスレッド DLL を選びます。

前の節で述べたspam.def をここで作成しておかねばなりません。その後、追加 > ファイルをプロジェクトに追加ダイアログを選びます。「ファイルの種類」を *.* にして、 spam.c と spam.def を選び、 OK をクリックします (一つ一つファイルを追加してもかまいません)。

作っているモジュールが新たな型を作成するのなら、以下の行:

    PyObject_HEAD_INIT(&PyType_Type)

がうまくいかないはずです。そこで:

    PyObject_HEAD_INIT(NULL)

に変更してください。また、以下の行をモジュール初期化関数に加えます:

    MyObject_Type.ob_type = &PyType_Type;

この操作を行う詳しい理由は、 Python FAQ の第 3 節を参照してください。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。