?HAMA

Edit File Size: 2.68 KB

/opt/hc_python/lib64/python3.12/site-packages/importlib_resources/_functional.py

Text Base64

"""Simplified function-based API for importlib.resources"""

import warnings

from ._common import as_file, files
from .abc import TraversalError

_MISSING = object()

def open_binary(anchor, *path_names):
    """Open for binary reading the *resource* within *package*."""
    return _get_resource(anchor, path_names).open('rb')

def open_text(anchor, *path_names, encoding=_MISSING, errors='strict'):
    """Open for text reading the *resource* within *package*."""
    encoding = _get_encoding_arg(path_names, encoding)
    resource = _get_resource(anchor, path_names)
    return resource.open('r', encoding=encoding, errors=errors)

def read_binary(anchor, *path_names):
    """Read and return contents of *resource* within *package* as bytes."""
    return _get_resource(anchor, path_names).read_bytes()

def read_text(anchor, *path_names, encoding=_MISSING, errors='strict'):
    """Read and return contents of *resource* within *package* as str."""
    encoding = _get_encoding_arg(path_names, encoding)
    resource = _get_resource(anchor, path_names)
    return resource.read_text(encoding=encoding, errors=errors)

def path(anchor, *path_names):
    """Return the path to the *resource* as an actual file system path."""
    return as_file(_get_resource(anchor, path_names))

def is_resource(anchor, *path_names):
    """Return ``True`` if there is a resource named *name* in the package,

Otherwise returns ``False``.
    """
    try:
        return _get_resource(anchor, path_names).is_file()
    except TraversalError:
        return False

def contents(anchor, *path_names):
    """Return an iterable over the named resources within the package.

The iterable returns :class:`str` resources (e.g. files).
    The iterable does not recurse into subdirectories.
    """
    warnings.warn(
        "importlib.resources.contents is deprecated. "
        "Use files(anchor).iterdir() instead.",
        DeprecationWarning,
        stacklevel=1,
    )
    return (resource.name for resource in _get_resource(anchor, path_names).iterdir())

def _get_encoding_arg(path_names, encoding):
    # For compatibility with versions where *encoding* was a positional
    # argument, it needs to be given explicitly when there are multiple
    # *path_names*.
    # This limitation can be removed in Python 3.15.
    if encoding is _MISSING:
        if len(path_names) > 1:
            raise TypeError(
                "'encoding' argument required with multiple path names",
            )
        else:
            return 'utf-8'
    return encoding

def _get_resource(anchor, path_names):
    if anchor is None:
        raise TypeError("anchor must be module or string, got None")
    return files(anchor).joinpath(*path_names)

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
compat DIR	-	drwxr-xr-x	2025-04-04 08:01:59	Edit Download recursive recursive
future DIR	-	drwxr-xr-x	2025-04-04 08:01:59	Edit Download recursive recursive
tests DIR	-	drwxr-xr-x	2025-04-04 08:01:59	Edit Download recursive recursive
__pycache__ DIR	-	drwxr-xr-x	2025-04-04 08:01:59	Edit Download recursive recursive
abc.py	5.42 KB	lrw-r--r--	2025-04-04 08:01:59	Edit Download recursive recursive
py.typed	0 B	lrw-r--r--	2025-04-04 08:01:59	Edit Download recursive recursive
readers.py	6.10 KB	lrw-r--r--	2025-04-04 08:01:59	Edit Download recursive recursive
simple.py	2.53 KB	lrw-r--r--	2025-04-04 08:01:59	Edit Download recursive recursive
_adapters.py	4.38 KB	lrw-r--r--	2025-04-04 08:01:59	Edit Download recursive recursive
_common.py	5.49 KB	lrw-r--r--	2025-04-04 08:01:59	Edit Download recursive recursive
_functional.py	2.68 KB	lrw-r--r--	2025-04-04 08:01:59	Edit Download recursive recursive
_itertools.py	1.25 KB	lrw-r--r--	2025-04-04 08:01:59	Edit Download recursive recursive
__init__.py	700 B	lrw-r--r--	2025-04-04 08:01:59	Edit Download recursive recursive

Directory Contents