`fnmatch.translate` changed in an undocumented way in Python 3.14

[Avasam]

Documentation

Since Python 3.14, fnmatch.translate appends a lowercase z, whilst 3.13 and below used an uppercase Z.
https://docs.python.org/3/library/fnmatch.html#fnmatch.translate makes no mention of this. Searching for fnmatch in https://docs.python.org/3/whatsnew/3.14.html only finds https://docs.python.org/3/whatsnew/3.14.html#fnmatch .

> uvx --python=3.13 python -c "import fnmatch; print(fnmatch.translate('foo*'))"
(?s:foo.*)\Z
> uvx --python=3.14 python -c "import fnmatch; print(fnmatch.translate('foo*'))"
(?s:foo.*)\z

(noticed in pypa/distutils#381)

---

Edit:
After further research, the only mention I could find in "What's new in Python 3.14" is https://docs.python.org/3/whatsnew/3.14.html#re, which only says

Support \z as a synonym for \Z

not that \z is now also used in place of \Z.
https://docs.python.org/3/howto/regex.html#more-metacharacters does mention that

\Z
The same as \z. For compatibility with old Python versions.

Up to you to see if this is worth acting upon. It did confuse me and I had a bit of a hard time finding reference for this change. But I understand if it's considered "implementation detail" and that distutils (setuptools)'s test validating a regex is too niche of a use-case to be worth documenting.

[serhiy-storchaka]

This is an implementation detail. It changed several times in the past. It was foo.*$, then foo.*\Z(?ms), then (?s:foo.*)\Z, then (?s:foo.*)\z. There were also changes in other parts of the regular expression.

I understand that some code depends on such details, but they do this on their own risk, and this is not the first time they have had to adapt.

[serhiy-storchaka]

On other hand, we can be nice this time and document this change in "Porting to 3.14".

Yet one option -- restore \Z and add an option to control whether it should be added at all. Users that depends on this implementation detail usually just want to remove \Z, so they will be glad to use the new option. Years later we can change \Z to \z. If users use the new option, this change will not affect them.

\Z and \z will be aliases of one other at least next 5 years. Then \Z will became an error.