Tek python dosya dağılımı: modül veya paket?

useful_thingTek bir dosyada bulunan kullanışlı bir python işlevi veya sınıfım (veya her ne olursa olsun) olduğunu varsayalım . Kaynak ağacı düzenlemenin esasen iki yolu vardır. İlk yol tek bir modül kullanıyor:

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

burada useful_thingtanımlanmıştır foo.py. İkinci strateji bir paket yapmaktır:

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

burada useful_thingtanımlanmıştır module.py. Paket halinde __init__.pybu gibi görünüyor

from foo.module import useful_thing

Böylece her iki durumda da yapabilirsiniz from foo import useful_thing.

Soru: Hangi yoldan tercih edilir ve neden?

EDIT: Gnat kullanıcısı bu sorunun kötü bir şekilde oluşturulduğunu söylediğinden, resmi python paketleme eğitiminin yukarıda açıklanan yöntemlerden hangisinin tercih edildiği konusunda yorum yapmadığını ekleyeceğim. Ben açıkça am değil ben lehte / aleyhte bir tartışma oluşturan bir topluluk tercih edilen yöntem, olup olmadığı ile ilgilenen olduğum için artıları ve eksileri benim kişisel listesini veren :)

İşe yarayan en basit şeyi yaptınız .

Bir İçin tek fonksiyon modülü , kesinlikle bir paket oluşturarak hiçbir anlamı yoktur. Paketler, ek bir ad alanı oluşturmak ve / veya kodunuzu birden fazla modülde düzenlemek için kullanışlıdır.

jsonVe unittestPython standart kütüphanede modüller gerçekten kod organizasyon amaçlı, örneğin paketler bulunmaktadır. Ancak şu anda sadece bir python dosyasında yaşayan bir kodu tek modül olarak bırakmak çok iyi.

Örnek istiyorsan:

• sixsadece bir modülün dağılımı
• Tüm yanı tek modüllü dağılımları olduğunu ben birkaç paket yayımlandı: setuptools_subversion, formatflowed, rtfunicode.

Paketleri gerçekten mükemmel bir şekilde kullanan projelere güzel bir örnek için, şunlara bakın:

• requests
• Flask

'Resmi' bir öneri yoktur; Her iki seçenek de tamamen geçerlidir.