Confused deprecation in importlib.resources.abc

[serhiy-storchaka]

In https://docs.python.org/3.12/library/importlib.resources.abc.html:

The documentation for importlib.resources.abc.Traversable says: "Deprecated since version 3.12, will be removed in version 3.14: Use importlib.resources.abc.Traversable instead."

The documentation for importlib.resources.abc.TraversableResources says: "Deprecated since version 3.12, will be removed in version 3.14: Use importlib.resources.abc.TraversableResources instead."

Why does it recommend to use the same deprecated class?

[hugovk]

Ah, this is a bug, the classes in importlib.abc have been deprecated, use the ones in importlib.resources.abc instead:

https://docs.python.org/3.12/whatsnew/3.12.html#pending-removal-in-python-3-14

---

The deprecations would need moving to:

https://docs.python.org/3.12/library/importlib.html#module-importlib.abc

However, the classes aren't actually documented there.

It doesn't seem worth fully documenting them, shall we add brief entries? The class title, and the deprecation note?

[AlexWaygood]

Duplicate of #105189

[serhiy-storchaka]

It doesn't seem worth fully documenting them, shall we add brief entries? The class title, and the deprecation note?

Yes, I think it would be fine.