แพ็กเกจและ __init__.py

แพ็กเกจคืออะไร

mypackage/
    __init__.py
    utils.py
    math_helpers.py

ไฟล์ __init__.py

# mypackage/__init__.py
from .utils import helper
from .math_helpers import add

การนำเข้าจากแพ็กเกจ

import mypackage
from mypackage import helper
from mypackage.math_helpers import add
print(add(2, 3))

แพ็กเกจย่อย

mypackage/
    __init__.py
    network/
        __init__.py
        http.py

การนำเข้าแบบสัมพัทธ์

# mypackage/network/http.py
from ..utils import helper   # two levels up

การนำเข้าแบบสัมบูรณ์เทียบกับแบบสัมพัทธ์

# Absolute
from mypackage.utils import helper

# Relative (inside mypackage)
from .utils import helper

__all__ ใน __init__.py

# mypackage/__init__.py
__all__ = ['helper', 'add']
from .utils import helper
from .math_helpers import add

แพ็กเกจเนมสเปซ (PEP 420)

# No __init__.py needed
# Just have the directory and import normally
import myns.module

การเริ่มต้นแพ็กเกจด้วย __init__

# mypackage/__init__.py
import logging
logging.getLogger(__name__).addHandler(logging.NullHandler())
VERSION = '1.0.0'

การแจกจ่ายแพ็กเกจ

# pyproject.toml excerpt
[project]
name = "mypackage"
version = "1.0.0"

# Install locally
# pip install -e .

การตรวจสอบแอตทริบิวต์ของแพ็กเกจ

import mypackage
print(mypackage.__file__)   # path to __init__.py
print(mypackage.__path__)   # list of directory paths
print(mypackage.__name__)   # 'mypackage'

ตรวจสอบความเข้าใจ

สรุปทบทวน