单个python文件分发：模块还是包？

假设我有一个有用的python函数或类（或任何类）useful_thing，该函数或类存在于单个文件中。本质上有两种组织源树的方法。第一种方法使用单个模块：

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

在useful_thing中定义的位置foo.py。第二种策略是制作一个包装：

- 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。

问题：首选哪种方式，为什么？

编辑：由于用户说这个问题的格式不正确，因此我要补充一点，官方python打包教程似乎并未评论上述哪种方法是首选方法。我明确不提供自己的利弊清单，因为我对是否存在社区首选方法感兴趣，而不是对利弊进行讨论：）

您做最适合您的事情。

对于一个功能模块，创建包绝对没有意义。软件包对于创建其他名称空间和/或在多个模块中组织代码很有用。

例如，出于代码组织目的，Python标准库中的json和unittest模块实际上是软件包。但是，最好将当前仅驻留在一个python文件中的代码作为一个模块。

如果您需要示例：

• six是一个模块的分配
• 我已经发布了几个包，所有的都是单个模块的分布，以及：setuptools_subversion，formatflowed，rtfunicode。

有关真正充分利用软件包的项目的一个很好的例子，请查看：

• requests
• 烧瓶

没有“官方”建议；这两个选项都是完全有效的。