1 distutils.core -- Distutils のコア機能

Extension クラスは、セットアップスクリプト中で C または C++拡張モジュールを表します。コンストラクタで以下のキーワード引数をとります。

argument name	value	type
name	パッケージの名前	文字列
version	パッケージのバージョン番号	`distutils.version`を参照してください
description	1行で書いたパッケージ解説	文字列
long_description	パッケージの長い解説	文字列
author	パッケージ作者の名前	文字列
author_email	パッケージ作者のemailアドレス	文字列
maintainer	現在のメンテナの名前(パッケージ作者と異なる場合)	文字列
maintainer_email	現在のメンテナのemailアドレス(パッケージ作者と異なる場合)
url	パッケージのURL(ホームページ)	URL
download_url	パッケージダウンロード用URL	URL
packages	distutilsが操作するPythonパッケージのリスト	文字列のリスト
py_modules	distutilsが操作するPythonモジュールのリスト	文字列のリスト
scripts	ビルドおよびインストールする単体スクリプトファイルのリスト	文字列のリスト
ext_modules	ビルドする拡張モジュール	`distutils.core.Extension`インスタンスのリスト
classifiers	パッケージのTrove カテゴリのリスト	XXX もっと良い定義へのリンク
distclass	使用する `Distribution`クラス	`distutils.core.Distribution`のサブクラス
script_name	setup.pyスクリプトの名前 - デフォルトでは`sys.argv[0]`	文字列
script_args	セットアップスクリプトの引数	文字列のリスト
options	セットアップスクリプトのデフォルト引数	文字列
license	パッケージのライセンス
keywords	説明用メタデータ。 PEP 314を参照してください
platforms
cmdclass	コマンド名から `Command` サブクラスへのマッピング	辞書

値	説明
init	`Distribution`インスタンスを作成し、キーワード引数を `setup()`に渡したあとに停止する。
config	設定ファイルをパーズしたあと停止する(そしてそのデータは `Distribution`インスタンスに保存される)。
commandline	コマンドライン (`sys.argv[1:]` または `script_args`) がパーズされたあとに停止する (そしてそのデータは `Distribution`インスタンスに保存される)。
run	全てのコマンドを実行したあとに停止する(関数 `setup()` を通常の方法で呼び出した場合と同じ)。デフォルト値。

argument name	value	type
name	拡張のフルネーム(パッケージを含む) -- ファイル名やパス名ではなく、Pythonのピリオド区切りの名前	string
sources	ソースファイル名のリスト。配布物ルートディレクトリ (setupスクリプトのある場所) からの相対パス、プラットフォーム独立のためUnix形式(スラッシュで区切る)で記述します。ソースファイルは C, C++, SWIG (.i)、特定プラットフォーム用のリソースファイル、その他 `build_ext`コマンドがソースファイルだと認識するどの形式でもありえます。	string
include_dirs	C/C++ヘッダファイルを検索するディレクトリのリスト(プラットフォーム独立のため Unix 形式で記述する)	string
define_macros	定義するマクロのリスト; それぞれのマクロは 2要素のタプルで定義されます。'値'には定義しようとしている文字列、または内容なしで定義する場合は`None`(ソースコード中で `#define FOO`と書く、または Unix Cコンパイラのコマンドラインで -DFOO を指定するのと等価です)を指定します。	(string,string) または (name,`None`) のタプル
undef_macros	定義を消すマクロのリスト	string
library_dirs	リンク時にC/C++ライブラリを検索するディレクトリのリスト	string
libraries	リンクするライブラリ名のリスト (ファイル名やパスではない)	string
runtime_library_dirs	実行時(shared extensionでは、拡張が読み込まれる時)に C/C++ライブラリを探索するディレクトリのリスト	string
extra_objects	追加でリンクするファイル('sources'に対応するコードが含まれていないファイル、バイナリ形式のリソースファイルなど)のリスト	string
extra_compile_args	'sources'のソースをコンパイルする時に追加するプラットフォーム特有またはコンパイラ特有の情報コマンドラインを利用できるプラットホームとコンパイラでは、これは通常コマンドライン引数のリストですが、他のプラットホームでも、それは何かに使えます。	string
extra_link_args	オブジェクトファイルをリンクして拡張(または新しいPythonインタプリタ)を作る時に追加するプラットフォーム特有またはコンパイラ特有の情報 'extra_compile_args'に似た実装です。	string
export_symbols	shared extensionからエクスポートされるシンボルのリスト。全てのプラットフォームでは使われず、 Python拡張(典型的には `init` + extension_name という1つのシンボルだけエクスポートする)に一般的に必要なものでもない。	string
depends	拡張が依存するファイルのリスト	string
language	拡張の言語 (例: `'c'`, `'c++'`, `'objc'`)。指定しなければソースの拡張子で検出される。	string