การกระจายไฟล์หลามเดียว: โมดูลหรือแพ็คเกจ?

สมมติว่าฉันมีฟังก์ชั่นหลามที่มีประโยชน์หรือคลาส (หรืออะไรก็ตาม) ที่เรียกว่า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เพื่อที่ว่าในทั้งสองกรณีที่คุณสามารถทำได้

คำถาม:วิธีใดที่เป็นที่ต้องการและทำไม

แก้ไข: เนื่องจากผู้ใช้ริ้นกล่าวว่าคำถามนี้เกิดขึ้นไม่ดีฉันจะเพิ่มว่าการสอนบรรจุภัณฑ์งูใหญ่อย่างเป็นทางการดูเหมือนจะไม่แสดงความคิดเห็นว่าวิธีการใดที่อธิบายไว้ข้างต้นเป็นวิธีที่ต้องการ ฉันไม่ได้ให้รายการข้อดีข้อเสียส่วนตัวอย่างชัดเจนเพราะฉันสนใจว่ามีวิธีที่ชุมชนต้องการหรือไม่ไม่สร้างการอภิปรายข้อดี / ข้อเสีย :)

คุณทำสิ่งที่ง่ายที่สุดที่เหมาะกับคุณ

สำหรับโมดูลฟังก์ชั่นเดียวนั้นไม่มีจุดที่แน่นอนในการสร้างแพ็คเกจ แพคเกจมีประโยชน์สำหรับการสร้างเนมสเปซเพิ่มเติมและ / หรือสำหรับการจัดระเบียบโค้ดของคุณในหลาย ๆ โมดูล

jsonและunittestโมดูลในห้องสมุดมาตรฐานหลามจริงๆแพคเกจเช่นสำหรับวัตถุประสงค์รหัสองค์กร แต่ก็เป็นการดีที่จะปล่อยให้โค้ดอยู่ในไฟล์ python เพียงไฟล์เดียวซึ่งเป็นโมดูลเดียว

หากคุณต้องการตัวอย่าง:

• sixเป็นการกระจายตัวของโมดูลเพียงหนึ่ง
• setuptools_subversionฉันได้ออกแพคเกจหลายอย่างที่ทุกคนมีการกระจายโมดูลเดียวเช่นกัน: formatflowed, rtfunicode,

สำหรับตัวอย่างที่ดีของโครงการที่ใช้ประโยชน์จากแพ็คเกจได้อย่างยอดเยี่ยมดูที่:

• requests
• ขวด

ไม่มีคำแนะนำ 'อย่างเป็นทางการ'; ตัวเลือกทั้งสองถูกต้องทั้งหมด