単一のpythonファイル配布：モジュールまたはパッケージ？

useful_thing単一のファイルに存在する便利なpython関数またはクラス（または何でも）が呼び出されたとします。ソースツリーを整理するには、本質的に2つの方法があります。最初の方法は単一のモジュールを使用します：

- setup.py
- README.rst
- ...etc...
- foo.py

どこuseful_thingで定義されていますfoo.py。2番目の戦略は、パッケージを作成することです。

- setup.py
- README.rst
- ...etc...
- foo
|-module.py
|-__init__.py

どこuseful_thingで定義されていますmodule.py。パッケージの場合__init__.pyは次のようになります

from foo.module import useful_thing

両方の場合でできるようにfrom foo import useful_thing。

質問：どちらの方法が推奨されますか？

編集：ユーザーgnatはこの質問の形式が不十分だと言っているので、公式のpythonパッケージチュートリアルでは、上記のどの方法が推奨されるかについてコメントしていないようです。私は、賛否両論の議論を生成するのではなく、コミュニティが好む方法があるかどうかに興味があるので、私は賛否両論の個人的なリストを明示的に与えていません

あなたはあなたのために働く最も簡単なことをします。

以下のために一つの機能モジュール、絶対にパッケージを作成するにはポイントがありません。パッケージは、追加の名前空間を作成したり、複数のモジュールにわたってコードを整理したりするのに役立ちます。

jsonそしてunittestPythonの標準ライブラリ内のモジュールのコードの組織のために、本当に例えばパッケージです。しかし、1つのモジュールとして、現在1つのpythonファイルにコードを残しておくことはまったく問題ありません。

例が必要な場合：

• six1つのモジュールのみの配布です
• すべてが同様に単一のモジュールディストリビューションであることを、私はいくつかのパッケージをリリースしていますsetuptools_subversion、formatflowed、rtfunicode。

パッケージを実際に活用するプロジェクトの良い例については、以下をご覧ください。

• requests
• フラスコ

「公式」の推奨事項はありません。両方のオプションは完全に有効です。