Phân phối tập tin python duy nhất: mô-đun hoặc gói?

Giả sử tôi có một hàm hoặc lớp python hữu ích (hoặc bất cứ thứ gì) được gọi là useful_thingtồn tại trong một tệp duy nhất. Có hai cách cần thiết để tổ chức cây nguồn. Cách đầu tiên sử dụng một mô-đun duy nhất:

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

nơi useful_thingđược định nghĩa trong foo.py. Chiến lược thứ hai là tạo ra một gói:

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

nơi useful_thingđược định nghĩa trong module.py. Trong trường hợp gói __init__.pysẽ như thế này

from foo.module import useful_thing

để trong cả hai trường hợp bạn có thể làm from foo import useful_thing.

Câu hỏi: Cách nào được ưa thích, và tại sao?

EDIT: Vì người dùng gnat nói rằng câu hỏi này được hình thành kém, tôi sẽ thêm rằng hướng dẫn đóng gói python chính thức dường như không bình luận về phương pháp nào được mô tả ở trên là phương pháp được ưa thích. Tôi rõ ràng không đưa ra danh sách ưu và nhược điểm cá nhân vì tôi quan tâm đến việc liệu có phương pháp ưa thích nào của cộng đồng không, không tạo ra cuộc thảo luận về ưu / nhược điểm :)

Bạn làm điều đơn giản nhất phù hợp với bạn .

Đối với một mô-đun một chức năng , hoàn toàn không có điểm nào trong việc tạo ra một gói. Các gói rất hữu ích để tạo một không gian tên bổ sung và / hoặc để tổ chức mã của bạn trên nhiều mô-đun.

Các mô-đun jsonvà unittesttrong thư viện chuẩn Python thực sự là các gói, ví dụ, cho mục đích tổ chức mã. Nhưng nó hoàn toàn ổn khi để lại mã hiện đang sống chỉ trong một tệp python, dưới dạng một mô-đun.

Nếu bạn muốn ví dụ:

• sixlà một phân phối của chỉ một mô-đun
• Tôi đã phát hành một số gói mà tất cả đều phân phối mô-đun đơn lẻ cũng như: setuptools_subversion, formatflowed, rtfunicode.

Để có một ví dụ tốt về các dự án thực sự sử dụng các gói tuyệt vời, hãy xem:

• requests
• Bình

Không có khuyến nghị 'chính thức'; cả hai tùy chọn là hoàn toàn hợp lệ.