importlib.resources for Accessing Package Data Files

Using __file__ to locate data files packaged with a library breaks when the package is installed as a zip (wheel) or in certain isolated environments.

Use importlib.resources (Python 3.9+ API) to access package data files robustly.

# Package structure:
# mypackage/
#   __init__.py
#   templates/email.html
#   data/schema.json

from importlib import resources
import json

# Read a text resource
def get_template() -> str:
    ref = resources.files('mypackage') / 'templates' / 'email.html'
    return ref.read_text(encoding='utf-8')

# Read a binary resource
def get_schema() -> dict:
    ref = resources.files('mypackage') / 'data' / 'schema.json'
    return json.loads(ref.read_bytes())

# Get a file path (for APIs that require real paths)
from contextlib import contextmanager

with resources.as_file(resources.files('mypackage') / 'data' / 'schema.json') as path:
    # path is a real filesystem path, extracted if needed
    validate(path)

Wheels can be installed as zip files, making __file__-based paths fail. importlib.resources handles all installation scenarios including zip imports and namespace packages.