私はすでにPythonプログラミング言語で簡単なソフトウェアを作成しました。それは私が書いたいくつかのライブラリとプログラムで動作するいくつかの実行可能ファイルを持っています。このソフトウェアのドキュメントとインストール方法を標準のソースパッケージに含める方法を知りたいです。
私は少し知ってMakeFiles
いますが、ファイル構造などにどの標準を使用する必要があるのかわかりません。
正規のドキュメントは次のとおりです。
http://packages.python.org/distribute/setuptools.html
PyPIまたは他のPythonインデックスサーバーにアップロードできるsetuptoolsを使用して適切なパッケージを構築するため。
ディレクトリ構造の本当の基準はないと思います。
私が通常行うことは次のとおりです。
MyProject/
|
|
|\ src/
| |
| |\ mypackage_1/
| |\ mypackage_2/
| |\ mymodule_1.py
| \ mymodule_2.py
|
|\ bin/
| |
| |\ my_script_1.py
| \ my_script_2.py
|
|\ doc/
| |
| |\ documentation_for_package_1/
| |\ documentation_for_package_2/
| |\ documentation_for_modules/
| \ documentation_for_scripts
|
|
\ tests/
|
|\ tests_for_mypackage_1/
|\ tests_for_mypackage_2/
|\ tests_for_mymodule_1
|\ tests_for_mymodule_2
\ tests_for_scripts/
このディレクトリツリーを使用すると、setuptoolsを使用してすべてのモジュール、パッケージなどをインストールしたり、配布したりするのは難しくありません。distutilsのみを使用したい場合、これは簡単ではないと思います。