mypackage/
    __init__.py
    module1.py
    subpackage/
        __init__.py
        module2.py

# 전체 모듈 임포트
import mypackage.module1

# 특정 함수만 임포트
from mypackage.module1 import function1

# 서브패키지의 모듈 임포트
from mypackage.subpackage import module2

# mypackage/__init__.py

# 버전 정보
VERSION = '1.0.0'

# 공개할 모듈 지정
__all__ = ['module1', 'module2']

# 패키지 초기화 코드
print("Initializing package...")

# 하위 모듈 자동 임포트
from .module1 import function1

# 현재 디렉터리
from . import module1

# 부모 디렉터리
from .. import other_module

# 부모의 다른 패키지
from ..other_package import some_module

# 여러 위치에 분산된 패키지
path1/mypackage/module1.py
path2/mypackage/module2.py

# PYTHONPATH에 path1과 path2 추가
import mypackage.module1
import mypackage.module2

# PEP 420 네임스페이스 패키지 상세 예제
# 디렉터리 구조:
# /path1/spam/module1.py
# /path2/spam/module2.py

# PYTHONPATH=/path1:/path2 python

import spam.module1  # /path1/spam/module1.py
import spam.module2  # /path2/spam/module2.py

# 패키지 경로 확인
import spam
print(spam.__path__)  # ['/path1/spam', '/path2/spam'] 같은 형태로 출력

# setup.py
from setuptools import setup, find_packages

setup(
    name="mypackage",
    version="1.0.0",
    packages=find_packages(),
    install_requires=[
        'requests>=2.22.0',
    ],
)

# 패키지 데이터 파일 포함 (setup.py)
setup(
    # ... 기타 설정 ...
    package_data={
        'mypackage': ['data/*.json', 'templates/*.html'],
    },
    # 또는
    include_package_data=True,  # MANIFEST.in 사용 시
)

# MANIFEST.in
include mypackage/data/*.json
include mypackage/templates/*.html

# 데이터 파일 접근 (코드에서)
import pkg_resources
data_path = pkg_resources.resource_filename('mypackage', 'data/config.json')

# Python 3.7+ 에서는 importlib.resources 사용 가능
from importlib import resources
with resources.path('mypackage.data', 'config.json') as path:
    config_path = path

# mypackage/__init__.py
def get_module1():
    import mypackage.module1
    return mypackage.module1

# 사용 시점에 임포트
def function_that_uses_module1():
    module1 = get_module1()
    return module1.some_function()

# mypackage/plugins/__init__.py
import importlib
import pkgutil

def load_plugins():
    """모든 플러그인 모듈을 동적으로 로드"""
    plugins = {}
    
    # 현재 패키지(plugins)의 경로
    package_path = __path__
    prefix = __name__ + "."
    
    # 모든 하위 모듈 탐색
    for _, name, ispkg in pkgutil.iter_modules(package_path, prefix):
        if not ispkg:  # 패키지가 아닌 모듈만 처리
            module = importlib.import_module(name)
            if hasattr(module, 'register'):
                plugin_name = name.split('.')[-1]
                plugins[plugin_name] = module
    
    return plugins

# 사용 예:
plugins = load_plugins()
for name, plugin in plugins.items():
    plugin.register()

# mypackage/__init__.py

# 공개 API만 노출
__all__ = ['public_function', 'PublicClass']

# 내부 모듈에서 필요한 것만 가져오기
from .module1 import public_function, PublicClass
from .module2 import _internal_function  # 언더스코어로 내부용 표시

# 서브패키지는 명시적으로 임포트해야 함
# 예: import mypackage.subpackage

# 최적화된 구현이 있으면 사용, 없으면 순수 파이썬 구현 사용
try:
    from mypackage._fast_impl import fast_function
except ImportError:
    from mypackage._pure_impl import fast_function

# 버전별 호환성
import sys
if sys.version_info >= (3, 8):
    from importlib.metadata import version
else:
    from importlib_metadata import version

# tests/test_module1.py
import unittest
from mypackage import module1

class TestModule1(unittest.TestCase):
    def test_function1(self):
        result = module1.function1(10)
        self.assertEqual(result, 20)
        
# pytest 사용 예
# tests/test_module2.py
import pytest
from mypackage import module2

def test_function2():
    assert module2.function2(5) == 10
    
# 테스트 실행
# python -m unittest discover
# pytest

# mypackage/module1.py
def function1(param1, param2=None):
    """
    중요한 기능을 수행하는 함수
    
    Args:
        param1 (int): 첫 번째 매개변수
        param2 (str, optional): 두 번째 매개변수. 기본값은 None
        
    Returns:
        bool: 성공 여부를 반환
        
    Raises:
        ValueError: param1이 0보다 작을 경우
        
    Examples:
        >>> function1(10)
        True
        >>> function1(-5)
        Traceback (most recent call last):
            ...
        ValueError: param1은 양수여야 합니다
    """
    if param1 < 0:
        raise ValueError("param1은 양수여야 합니다")
    # 함수 구현...
    return True

# docs/conf.py
extensions = [
    'sphinx.ext.autodoc',
    'sphinx.ext.viewcode',
    'sphinx.ext.napoleon',
]

# docs/index.rst
.. MyPackage documentation master file

Welcome to MyPackage's documentation!
=====================================

.. toctree::
   :maxdepth: 2
   :caption: Contents:
   
   api
   examples

# docs/api.rst
API Reference
============

.. automodule:: mypackage.module1
   :members:
   :undoc-members:
   :show-inheritance: