Zy Filemanager

📁 File Browser

Name	Size	Permissions	Actions
📁 __pycache__	DIR	0755	🗑️
📁 compat	DIR	0755	🗑️
📁 future	DIR	0755	🗑️
📁 tests	DIR	0755	🗑️
📄 __init__.py (700 bytes)	700 B	0644	✍️ ⬇️ 🗑️
📄 _adapters.py (4,482 bytes)	4.38 KB	0644	✍️ ⬇️ 🗑️
📄 _common.py (5,624 bytes)	5.49 KB	0644	✍️ ⬇️ 🗑️
📄 _functional.py (2,743 bytes)	2.68 KB	0644	✍️ ⬇️ 🗑️
📄 _itertools.py (1,277 bytes)	1.25 KB	0644	✍️ ⬇️ 🗑️
📄 abc.py (5,549 bytes)	5.42 KB	0644	✍️ ⬇️ 🗑️
📄 py.typed (0 bytes)	0 B	0644	✍️ ⬇️ 🗑️
📄 readers.py (6,250 bytes)	6.1 KB	0644	✍️ ⬇️ 🗑️
📄 simple.py (2,590 bytes)	2.53 KB	0644	✍️ ⬇️ 🗑️

📤 Upload Files

Single File

Multiple Files

ZIP Extract

ZIP file will be deleted after extraction

➕ Create New

New Folder

New File

✍️ Editing: _functional.py

            File: /opt/hc_python/lib/python3.12/site-packages/importlib_resources/_functional.py

            Size: 2.68 KB | 
            Last Modified: 2025-04-04 15:08:35        

"""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)

↩️ Back