Розподіл файлів одного пітона: модуль чи пакет?

Припустимо, у мене є корисна функція 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.

Питання: Який спосіб є кращим і чому?

EDIT: Оскільки користувач gnat каже, що це питання сформовано погано, я додам, що офіційний підручник з упаковки python, схоже, не коментує, який із описаних вище методів є кращим. Я не надаю особистого списку плюсів і мінусів, тому що мене цікавить, чи існує метод, який бажає отримати спільнота, а не викликати обговорення плюсів і мінусів :)

Ви робите найпростішу річ, яка працює для вас .

Для одного функціонального модуля створити пакет абсолютно немає сенсу. Пакети корисні для створення додаткового простору імен та / або для організації вашого коду через декілька модулів.

The jsonІ unittestмодулі в стандартній бібліотеці Python дійсно пакети, наприклад, для організації коду цілей. Але цілком чудово залишити код, який зараз живе лише в одному файлі python, як один модуль.

Якщо ви хочете приклади:

• six це розподіл справедливих одного модуля
• Я випустив кілька пакетів , які всі є розподілу одиночних модулів , а також: setuptools_subversion, formatflowed,rtfunicode .

Для хорошого прикладу проектів, які справді прекрасно використовують пакети, дивіться:

• requests
• Колба

Не існує «офіційної» рекомендації; обидва варіанти цілком дійсні.