1 pure Python 配布物 (モジュール形式)

単に二つのモジュール、特定のパッケージに属しないモジュールを 配布するだけなら、setup スクリプト中で py_modules オプションを使って個別に指定できます。

もっとも単純なケースでは、二つのファイル: setup スクリプト自体と、 配布したい単一のモジュール、この例では foo.py について 考えなければなりません:

<root>/
        setup.py
        foo.py

(この節の全ての図において、 <root> は配布物ルートディレクトリ を参照します。) この状況を扱うための最小の setup スクリプトは 以下のようになります:

from distutils.core import setup
setup(name='foo',
      version='1.0',
      py_modules=['foo'],
      )

配布物の名前は name オプションで個々に指定し、配布される モジュールの一つと配布物を同じ名前にする必要はないことに注意して ください (とはいえ、この命名方法はよいならわしでしょう)。 ただし、配布物名はファイル名を作成するときに使われるので、 文字、数字、アンダースコア、ハイフンだけで構成しなければなりません。

py_modules はリストなので、もちろん複数のモジュールを 指定できます。例えば、モジュール foobar を 配布しようとしているのなら、 setup スクリプトは以下のようになります:

<root>/
        setup.py
        foo.py
        bar.py

また、セットアップスクリプトは以下のようになります.

from distutils.core import setup
setup(name='foobar',
      version='1.0',
      py_modules=['foo', 'bar'],
      )

モジュールのソースファイルは他のディレクトリに置けますが、 そうしなければならないようなモジュールを沢山持っているのなら、 モジュールを個別に列挙するよりもパッケージを指定した方が 簡単でしょう。

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