Make the gettext functions accept a localedir of type Traversable

[Jesse205]

Feature or enhancement

Proposal:

from gettext import bindtextdomain, find, translation
import importlib.resources

bindtextdomain("demo-zipapp", importlib.resources.files("demo_zipapp").joinpath("locales"))
translation("demo-zipapp", importlib.resources.files("demo_zipapp").joinpath("locales"))
find("demo-zipapp", importlib.resources.files("demo_zipapp").joinpath("locales"))

In ZipApp, since files within the application cannot be read directly through traditional file APIs, it is necessary to use importlib.resources.files to read them.

importlib.resources.files returns a Traversable object, which is not supported by gettext.

Here is a demo app: demo-zipapp.zip (source) | demo-zipapp.zip (zipapp)

Has this already been discussed elsewhere?

I have already discussed this feature proposal on Discourse

Links to previous discussion of this feature:

https://discuss.python.org/t/make-the-gettext-functions-accept-a-localedir-of-type-traversable/107330

Linked PRs

• gh-149809: Make the gettext functions accept a localedir of type Traversable #149810

[picnixz]

I feel that special casing this for Traversal is not a good idea. Is Traversal a protocol class? if so, it is ok, but otherwise we should check for protocol-like classes instead IMO.

just to understand: the purpose is to allow usage of zipapp files wiith gettext and avoid habing those files on the disk right?

[Jesse205]

Traversable is a protocol class:

Because of this, Path is also considered a Traversable:

So I explicitly excluded PathLike in the code (Path is also a PathLike type, and the path needs to use os.path.abspath to get the absolute path):

---

just to understand: the purpose is to allow usage of zipapp files wiith gettext and avoid habing those files on the disk right?

Right!