패키지와 __init__·__main__

# mypkg/
#   __init__.py
#   core.py
#   utils.py
#
# mypkg/__init__.py
# from .core import important_function   # 패키지 레벨 re-export
# __version__ = "1.0.0"
#
# mypkg/core.py
# def important_function():
#     return 42
#
# mypkg/utils.py
# def helper():
#     return "helped"

# 이제 호출자 가능:
# from mypkg import important_function   # __init__.py re-export 덕분에 작동
# from mypkg.utils import helper          # 항상 작동, 전체 path
# print(mypkg.__version__)

# mypkg/__main__.py
# import sys
# from .core import important_function
#
# def main():
#     args = sys.argv[1:]
#     print("실행 with", args)
#     print("결과:", important_function())
#
# if __name__ == "__main__":
#     main()

# 부모 디렉토리에서 실행:
# python -m mypkg arg1 arg2
#
# 'python -m pytest', 'python -m http.server' 작동하는 방식.

# mymodule.py
# def public_func():
#     return "hi"
#
# def _internal():
#     return "export 안 됨"
#
# class Public:
#     pass
#
# class _Private:
#     pass
#
# __all__ = ["public_func", "Public"]
#
# 이제 `from mymodule import *` 가 public_func 와 Public 만 import.
# __all__ 없으면 어쨌든 public_func 와 Public 만 import
# (underscore 시작 안 하는 거), 명시적 __all__ 이 더 명확.

# 현대 Python (3.3+) 이 namespace 패키지 지원 — __init__.py 없이
# 패키지로 다뤄지는 디렉토리. 논리적 패키지가 여러 물리 디렉토리에
# 분산될 때 유용 (예 — 각 plugin 이 네임스페이스 일부 기여하는
# plugin 시스템).
#
# /path1/myorg/plugin_a/...
# /path2/myorg/plugin_b/...
#
# 어느 쪽도 __init__.py 없으면 둘 다 단일 'myorg' 네임스페이스 기여.
#
# 대부분 애플리케이션 코드엔 __init__.py 있는 regular 패키지가 OK +
# 의도 더 명확. namespace 패키지는 라이브러리/프레임워크 기능.