René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Remove deprecation notes for non-deprecated `importlib.resources` functions","articleBody":"I wrote some code using [read_text()](https://docs.python.org/3/library/importlib.resources.html#importlib.resources.read_text) and a few other functions from `importlib` and was surprised that Pylint complained they are deprecated. There's no mention of that in the documentation.\n\nEventually I discovered [that the Python 3.13 release notes](https://docs.python.org/3/whatsnew/3.12.html#pending-removal-in-python-3-13) claim that they are \"pending removal\" as if they've *already* been deprecated.\n\nIt links to [this note](https://importlib-resources.readthedocs.io/en/latest/using.html#migrating-from-legacy) which says that `files()` is \"preferred\", but are the old methods really deprecated? Are they really going to be removed?\n\nSeems kind of insane to me. The suggested alternative to `read_text()` is to copy all this code into your project:\n\n```python\ndef read_text(\n    package: Package,\n    resource: Resource,\n    encoding: str = 'utf-8',\n    errors: str = 'strict',\n) -\u003e str:\n    \"\"\"Return the decoded string of the resource.\n\n    The decoding-related arguments have the same semantics as those of\n    bytes.decode().\n    \"\"\"\n    with open_text(package, resource, encoding, errors) as fp:\n        return fp.read()\n\ndef open_text(\n    package: Package,\n    resource: Resource,\n    encoding: str = 'utf-8',\n    errors: str = 'strict',\n) -\u003e TextIO:\n    \"\"\"Return a file-like object opened for text reading of the resource.\"\"\"\n    return (_common.files(package) / _common.normalize_path(resource)).open(\n        'r', encoding=encoding, errors=errors\n    )\n\ndef files(package):\n    # type: (Package) -\u003e Traversable\n    \"\"\"\n    Get a Traversable resource from a package\n    \"\"\"\n    return from_package(get_package(package))\n\n\ndef normalize_path(path):\n    # type: (Any) -\u003e str\n    \"\"\"Normalize a path by ensuring it is a string.\n\n    If the resulting string contains path separators, an exception is raised.\n    \"\"\"\n    str_path = str(path)\n    parent, file_name = os.path.split(str_path)\n    if parent:\n        raise ValueError(f'{path!r} must be only a file name')\n    return file_name\n\n\ndef get_resource_reader(package):\n    # type: (types.ModuleType) -\u003e Optional[ResourceReader]\n    \"\"\"\n    Return the package's loader if it's a ResourceReader.\n    \"\"\"\n    # We can't use\n    # a issubclass() check here because apparently abc.'s __subclasscheck__()\n    # hook wants to create a weak reference to the object, but\n    # zipimport.zipimporter does not support weak references, resulting in a\n    # TypeError.  That seems terrible.\n    spec = package.__spec__\n    reader = getattr(spec.loader, 'get_resource_reader', None)  # type: ignore\n    if reader is None:\n        return None\n    return reader(spec.name)  # type: ignore\n\n\ndef resolve(cand):\n    # type: (Package) -\u003e types.ModuleType\n    return cand if isinstance(cand, types.ModuleType) else importlib.import_module(cand)\n\n\ndef get_package(package):\n    # type: (Package) -\u003e types.ModuleType\n    \"\"\"Take a package name or module object and return the module.\n\n    Raise an exception if the resolved module is not a package.\n    \"\"\"\n    resolved = resolve(package)\n    if wrap_spec(resolved).submodule_search_locations is None:\n        raise TypeError(f'{package!r} is not a package')\n    return resolved\n\n\ndef from_package(package):\n    \"\"\"\n    Return a Traversable object for the given package.\n\n    \"\"\"\n    spec = wrap_spec(package)\n    reader = spec.loader.get_resource_reader(spec.name)\n    return reader.files()\n```\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-141507\n* gh-141557\n* gh-141558\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/Timmmm","@type":"Person","name":"Timmmm"},"datePublished":"2025-09-26T08:23:24.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/139344/cpython/issues/139344"}