mypackage/
├── __init__.py         # (1)
├── module1.py          
└── subpackage/
    ├── __init__.py     # (2)
    └── module2.py      # (4)

mypackage/
├── __init__.py          # 包初始化文件
├── api.py               # 公共API模塊
├── utils.py             # 內(nèi)部工具模塊
└── algorithms/
    ├── __init__.py      # 子包初始化
    ├── sorting.py       # 排序算法
    └── searching.py     # 搜索算法

# mypackage/utils.py

def log_info(message):
    """內(nèi)部日志工具"""
    print(f"[INFO] {message}")

def validate_input(data):
    """輸入驗(yàn)證工具"""
    if not data:
        raise ValueError("輸入數(shù)據(jù)不能為空")
    return True

# mypackage/algorithms/sorting.py

def quick_sort(arr):
    """快速排序?qū)崿F(xiàn)"""
    if len(arr) <= 1:
        return arr
    pivot = arr[0]
    left = [x for x in arr[1:] if x <= pivot]
    right = [x for x in arr[1:] if x > pivot]
    return quick_sort(left) + [pivot] + quick_sort(right)

def bubble_sort(arr):
    """冒泡排序?qū)崿F(xiàn)"""
    n = len(arr)
    for i in range(n-1):
        for j in range(n-i-1):
            if arr[j] > arr[j+1]:
                arr[j], arr[j+1] = arr[j+1], arr[j]
    return arr

# mypackage/algorithms/searching.py

def binary_search(arr, target):
    """二分查找實(shí)現(xiàn)"""
    low, high = 0, len(arr) - 1
    while low <= high:
        mid = (low + high) // 2
        if arr[mid] == target:
            return mid
        elif arr[mid] < target:
            low = mid + 1
        else:
            high = mid - 1
    return -1

# mypackage/algorithms/__init__.py

# 1. 批量導(dǎo)入 - 僅暴露公共API
from .sorting import quick_sort as qsort
from .searching import binary_search as bsearch

# 2. 定義__all__ - 控制通配符導(dǎo)入
__all__ = ["qsort", "bsearch"]

# 3. 共享子包級函數(shù)
def get_algorithm_version():
    return "Algorithms v1.2.3"

# mypackage/api.py

# 導(dǎo)入共享包級工具
from .utils import log_info, validate_input
# 導(dǎo)入算法子包
from .algorithms import qsort, bsearch

def process_data(data):
    """公共API - 處理數(shù)據(jù)"""
    # 使用共享工具
    log_info("開始處理數(shù)據(jù)")
    validate_input(data)
    
    # 使用算法
    sorted_data = qsort(data)
    index = bsearch(sorted_data, data[0])
    
    log_info(f"處理完成，找到索引: {index}")
    return index

# mypackage/__init__.py

# 1. 批量導(dǎo)入 - 簡化用戶導(dǎo)入路徑
# 用戶只需: from mypackage import process_data
from .api import process_data

# 2. 定義__all__ - 控制通配符導(dǎo)入
__all__ = ["process_data", "config", "show_version"]

# 3. 隱藏內(nèi)部實(shí)現(xiàn) - 只暴露公共接口
# 內(nèi)部模塊不直接暴露

# 4. 共享包級變量/函數(shù)
# 包級配置
config = {
    "debug": False,
    "max_items": 1000
}

def show_version():
    """獲取包版本"""
    return "mypackage v1.0.0"

# 5. 共享子包功能 (通過子包的__init__.py)
from .algorithms import get_algorithm_version

# 1. 直接使用包級函數(shù)
from mypackage import process_data, config, show_version

data = [5, 2, 8, 3, 1]
config["debug"] = True  # 修改共享配置

print(f"Package version: {show_version()}")
result = process_data(data)
print(f"Result index: {result}")

# 2. 使用子包功能
from mypackage.algorithms import qsort, get_algorithm_version

print(f"Algorithm version: {get_algorithm_version()}")
sorted_list = qsort([4, 2, 7, 1, 3])
print(f"Sorted list: {sorted_list}")

# 3. 使用通配符導(dǎo)入
from mypackage import *

# 只能導(dǎo)入 __all__ 中定義的內(nèi)容
# process_data, config, show_version 可用
# utils, sorting 等內(nèi)部模塊不可直接訪問