ไม่จำเป็นต้อง __init__.py สำหรับแพ็คเกจใน Python 3.3+

ฉันใช้ Python 3.5.1 ฉันอ่านเอกสารและส่วนแพ็คเกจที่นี่: https://docs.python.org/3/tutorial/modules.html#packages

ตอนนี้ฉันมีโครงสร้างต่อไปนี้:

/home/wujek/Playground/a/b/module.py

module.py:

class Foo:
    def __init__(self):
        print('initializing Foo')

ตอนนี้ในขณะที่/home/wujek/Playground:

~/Playground $ python3
>>> import a.b.module
>>> a.b.module.Foo()
initializing Foo
<a.b.module.Foo object at 0x100a8f0b8>

ในทำนองเดียวกันตอนนี้อยู่ที่บ้าน superfolder ของPlayground:

~ $ PYTHONPATH=Playground python3
>>> import a.b.module
>>> a.b.module.Foo()
initializing Foo
<a.b.module.Foo object at 0x10a5fee10>

ที่จริงฉันสามารถทำสิ่งต่าง ๆ ได้ทุกอย่าง:

~ $ PYTHONPATH=Playground python3
>>> import a
>>> import a.b
>>> import Playground.a.b

ทำไมจึงใช้งานได้ ผมคิดว่ามีความจำเป็นที่จะ__init__.pyไฟล์ (คนที่ว่างเปล่าจะทำงาน) ทั้งในaและbสำหรับmodule.pyที่จะ importable เมื่องูหลามจุดเส้นทางไปยังPlaygroundโฟลเดอร์?

ดูเหมือนว่าจะเปลี่ยนไปจาก Python 2.7:

~ $ PYTHONPATH=Playground python
>>> import a
ImportError: No module named a
>>> import a.b
ImportError: No module named a.b
>>> import a.b.module
ImportError: No module named a.b.module

ด้วย__init__.pyทั้งใน~/Playground/aและ~/Playground/a/bมันใช้งานได้ดี

Python 3.3+ มีแพ็คเกจเนมสเปซโดยนัยที่อนุญาตให้สร้างแพ็กเกจโดยไม่มี__init__.pyไฟล์

การอนุญาตแพ็คเกจเนมสเปซโดยนัยหมายความว่าข้อกำหนดในการจัดหา__init__.pyไฟล์สามารถถูกดร็อปได้อย่างสมบูรณ์และได้รับผลกระทบ ...

วิธีการแบบเก่ากับ__init__.pyไฟล์ยังคงใช้งานได้เหมือนใน Python 2

สำคัญ

@ คำตอบของไมค์นั้นถูกต้อง แต่ก็ไม่แน่ชัด เป็นความจริงที่ว่า Python 3.3+ รองรับแพ็คเกจเนมสเปซโดยนัยที่อนุญาตให้สร้างแพ็คเกจโดยไม่มี__init__.pyไฟล์

อย่างไรก็ตามสิ่งนี้ใช้ได้กับไฟล์ที่ว่าง__init__.pyเท่านั้น ดังนั้นไฟล์EMPTY__init__.pyจึงไม่จำเป็นอีกต่อไปและสามารถละไว้ได้ หากคุณต้องการเรียกใช้สคริปต์การเริ่มต้นเฉพาะเมื่อมีการนำเข้าแพ็คเกจหรือโมดูลหรือแพ็คเกจย่อยใด ๆ คุณยังต้องใช้__init__.pyไฟล์ นี่เป็นคำตอบที่ดีสำหรับStack Overflowสำหรับสาเหตุที่คุณต้องการใช้__init__.pyไฟล์ในการเริ่มต้นเพิ่มเติมในกรณีที่คุณสงสัยว่าทำไมสิ่งนี้ถึงมีประโยชน์

ตัวอย่างโครงสร้างไดเรกทอรี:

  parent_package/
     __init__.py            <- EMPTY, NOT NECESSARY in Python 3.3+
     child_package/
          __init__.py       <- STILL REQUIRED if you want to run an initialization script
          child1.py
          child2.py
          child3.py

parent_package/child_package/__init__.py:

print("from parent")

ตัวอย่าง

ตัวอย่างด้านล่างแสดงให้เห็นถึงวิธีการดำเนินการสคริปต์เริ่มต้นเมื่อchild_packageหรือหนึ่งในโมดูลที่นำเข้า

ตัวอย่างที่ 1 :

from parent_package import child_package  # prints "from parent"

ตัวอย่างที่ 2 :

from parent_package.child_package import child1  # prints "from parent"

หากคุณมีsetup.pyในโครงการของคุณและคุณใช้find_packages()ในนั้นมีความจำเป็นต้องมี__init__.pyไฟล์ในทุกไดเรกทอรีเพื่อให้แพคเกจที่จะพบโดยอัตโนมัติ

แพ็คเกจจะรับรู้ได้ก็ต่อเมื่อมี__init__.pyไฟล์อยู่ด้วย

UPD : ถ้าคุณต้องการใช้แพ็คเกจเนมสเปซโดยปริยายโดยที่__init__.pyคุณไม่จำเป็นต้องใช้find_namespace_packages()แทน

เอกสาร

ฉันจะบอกว่าใครควรละเว้น__init__.pyแต่ถ้าใครอยากจะมีแพคเกจ namespace โดยปริยาย หากคุณไม่ทราบว่ามันแปลว่าอะไรคุณอาจไม่ต้องการมันดังนั้นคุณควรใช้งานต่อไป__init__.pyใน Python 3