Document recommended language, territory, script, and variant casing in the locale guide and API. Explain that Locale preserves constructor components while Locale.parse normalizes string identifiers, with mixed-case examples. Numeric territory codes and modifier casing are also covered. No runtime behavior changes.
Validation on Linux / Python 3.12.14 with the project's CLDR 48.2 import:
Full suite: 7,831 passed, 7 skipped, 2 xfailed, matching the unchanged baseline.
Core/localedata and API doctests: 151 passed, 1 skipped.
Guide constructor/parsing examples: 8 passed.
All applicable pinned pre-commit hooks, Ruff, and git diff --check passed.
Executable Python AST is unchanged after removing docstrings.
Strict Sphinx output matches the unchanged baseline's 111 unresolved-reference warnings and 5 pre-existing markup errors. The ordinary warnings-as-errors build has the same 5 markup errors (JavaScript extractor docstring indentation and unresolved targets in dates/dev/messages).
Other Python/OS matrix combinations remain for hosted CI.
Hosted CI and Security workflows currently await maintainer approval.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #115.
Document recommended language, territory, script, and variant casing in the locale guide and API. Explain that Locale preserves constructor components while Locale.parse normalizes string identifiers, with mixed-case examples. Numeric territory codes and modifier casing are also covered. No runtime behavior changes.
Validation on Linux / Python 3.12.14 with the project's CLDR 48.2 import:
Other Python/OS matrix combinations remain for hosted CI.
Hosted CI and Security workflows currently await maintainer approval.