pluralio 2.2.0__tar.gz → 2.3.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {pluralio-2.2.0 → pluralio-2.3.1}/.github/ISSUE_TEMPLATE/bug_report.md +1 -1
- {pluralio-2.2.0 → pluralio-2.3.1}/CHANGELOG.md +85 -1
- {pluralio-2.2.0 → pluralio-2.3.1}/CONTRIBUTING.md +7 -1
- {pluralio-2.2.0 → pluralio-2.3.1}/PKG-INFO +20 -13
- {pluralio-2.2.0 → pluralio-2.3.1}/README.md +16 -10
- {pluralio-2.2.0 → pluralio-2.3.1}/SECURITY.md +2 -2
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/conf.py +16 -2
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/cookbook.rst +8 -8
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/index.rst +4 -3
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/languages.rst +25 -22
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/usage.rst +6 -2
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/__init__.py +41 -10
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/core.py +40 -7
- pluralio-2.3.1/pluralio/py.typed +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/registry.py +44 -24
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/rules/__init__.py +1 -1
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/rules/en.py +53 -16
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/rules/es.py +9 -2
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/rules/fr.py +32 -8
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/rules/it.py +51 -16
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/rules/pt.py +12 -3
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/utils.py +34 -7
- {pluralio-2.2.0 → pluralio-2.3.1}/pyproject.toml +3 -2
- pluralio-2.3.1/tests/__init__.py +0 -0
- pluralio-2.3.1/tests/test_audit_regressions.py +495 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_core.py +18 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_cross_edge_cases.py +2 -2
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_fr_edge_cases.py +5 -2
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_fr_plurals.py +10 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_it_plurals.py +33 -6
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_pt_plurals.py +6 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_pt_singles.py +3 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_registry.py +9 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_utils.py +7 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/.github/pull_request_template.md +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/.github/workflows/ci.yml +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/.github/workflows/docs.yml +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/.github/workflows/release.yml +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/.gitignore +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/CODE_OF_CONDUCT.md +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/LICENSE +0 -0
- /pluralio-2.2.0/pluralio/py.typed → /pluralio-2.3.1/docs/_static/.gitkeep +0 -0
- /pluralio-2.2.0/tests/__init__.py → /pluralio-2.3.1/docs/_templates/.gitkeep +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/core.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/en.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/eo.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/es.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/extensibility.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/fr.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/it.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/pt.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/registry.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/rules.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/api/utils.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/docs/changelog.rst +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/pluralio/rules/eo.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/conftest.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_en_edge_cases.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_en_plurals.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_en_singles.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_eo_plurals.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_eo_singles.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_es_edge_cases.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_es_plurals.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_es_singles.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_fr_singles.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_inspect.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_it_edge_cases.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_it_singles.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_property.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_pt_edge_cases.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_registry_isolation.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_round_trip.py +0 -0
- {pluralio-2.2.0 → pluralio-2.3.1}/tests/test_version.py +0 -0
|
@@ -1,6 +1,57 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## [
|
|
3
|
+
## [2.3.1] - 2026-11-18
|
|
4
|
+
|
|
5
|
+
### Fixed
|
|
6
|
+
|
|
7
|
+
- English: `-us` nouns whose plural is `+es` now round-trip — `geniuses → genius`, `focuses → focus`, `apparatuses → apparatus` (the `ses$` rule produced `geniuse`); `pluralize("genius")` now returns `"geniuses"` via a new `(us)$` rule instead of returning the word unchanged
|
|
8
|
+
- English: `-use` words ending in `uses` (`houses`, `amuses`, `confuses`, `refuses`, …) are protected from the new `uses$` rule by explicit irregulars
|
|
9
|
+
- English: compound `-shoe` words singularize correctly (`horseshoes → horseshoe`, `snowshoes`); the `oes` rule produced `horsesho`
|
|
10
|
+
- English: `-afe` words take `+s` (`carafe → carafes`); the `fe$` rule produced `caraves`
|
|
11
|
+
- English: only `l+f` takes `-ves` (`wolf → wolves`); other consonant+`f` words take `+s` (`barf → barfs`, `nerf → nerfs`); `scarf`/`wharf` compounds keep `-ves` (`headscarf → headscarves`)
|
|
12
|
+
- English: consonant+`o` loanwords that take `+s` added (`limo`, `nacho`, `bimbo`, `bro`, `promo`, `jello`, `afro`, `mambo`, `matzo`); `menu` takes plain `+s` and `kudos` is invariable
|
|
13
|
+
- English: `singularize("taxis")` → `"taxi"` and `singularize("taxies")` → `"taxi"`
|
|
14
|
+
- Spanish: `jersey → jerséis` (RAE), with idempotent `pluralize("jerséis")` and `singularize("jerseis") → "jersey"`; `peones → peón` accent restoration
|
|
15
|
+
- French: `pot-au-feu → pots-au-feu` and `coq-au-vin → coqs-au-vin` — the `au` preposition and fixed compounds no longer pluralize every segment
|
|
16
|
+
- French: `-s` invariable nouns added (`mois`, `relais`, `repas`, `matelas`, `os`, `obus`, `vernis`, `puits`, `châssis`, `maquis`, `dais`, `débris`, `autobus`, `bus`, `iris`); `landau → landaus`
|
|
17
|
+
- Italian: missing sdrucciola `-co`/`-go` words added (`sindaco → sindaci`, `chimico`, `fisico`, `critico`, `greco`, `geologo`, `antropologo`, …); `-ista` professions pluralize in `-i` (`pianista → pianisti`); Greek masculine `-a` words (`diploma`, `sintoma`, `idiota`)
|
|
18
|
+
- Italian: invariable additions (`video`, `sms`, `pc`, `tv`, `cd`, `dvd`, `grù`, `cento`, numbers `undici`–`novanta`); `singularize("pesi") → "peso"`, `singularize("bracci") → "braccio"`
|
|
19
|
+
- `register()` raises `TypeError` for non-string codes instead of poisoning the registry (which broke `supported_languages()` sorting)
|
|
20
|
+
- `get_rules()` raises the documented `ValueError` for non-string languages instead of `TypeError: unhashable type`
|
|
21
|
+
- `add_irregular()` / `add_plural()` / `add_singular()` / `add_uncountable()` / `add_plural_rule()` / `add_singular_rule()` validate their arguments (`TypeError` with the offending parameter name) instead of raising raw `AttributeError`
|
|
22
|
+
- `ordinal()` raises the documented `ValueError` for `None` and `float("inf")` instead of `TypeError` / `OverflowError`
|
|
23
|
+
- `template()` treats `count=None` as "no count" (always pluralize) instead of crashing with `ValueError: invalid literal for int()`
|
|
24
|
+
- `join()` no longer emits double spaces when `conjunction=""`
|
|
25
|
+
- String counts are normalized via `int()` in the core (`count="01"` now means one, consistent with `count=1`)
|
|
26
|
+
|
|
27
|
+
### Changed
|
|
28
|
+
|
|
29
|
+
- `register_language` doctest imports `snapshot`/`restore` explicitly, so `pytest --doctest-modules` passes without the Sphinx global setup
|
|
30
|
+
|
|
31
|
+
### Added
|
|
32
|
+
|
|
33
|
+
- 236 regression tests pinning every fix above (`tests/test_audit_regressions.py`); suite grew from 7,280 to 7,516 tests, coverage stays at 100%
|
|
34
|
+
|
|
35
|
+
## [2.3.0] - 2026-10-06
|
|
36
|
+
|
|
37
|
+
### Fixed
|
|
38
|
+
|
|
39
|
+
- `register()` now normalizes language codes (`strip` + lowercase), so `LanguageRules(code=" xx ")` registers as `"xx"`; `get_rules()` applies the same normalization, making `lang=" EN "` work everywhere
|
|
40
|
+
- `pluralize()` / `singularize()` / `is_plural()` / `is_singular()` now validate `lang` even for empty words (documented `ValueError`)
|
|
41
|
+
- Regex rules that produce an empty string are now honored instead of being silently discarded (consistent with `add_irregular("x", "")`)
|
|
42
|
+
- `count="1"` (string) now returns the singular form, consistent with `template()`'s `int(str(...))` coercion
|
|
43
|
+
- `ordinal()` raises `ValueError` for non-integral floats instead of silently truncating (`3.7` was `"3rd"`)
|
|
44
|
+
- French: accentless `-aux`/`-eux` singulars (`emaux`, `regaux`, …) no longer leak into `irregular_plurals` — `pluralize("email")` now correctly returns `"emails"`; `regal`/`recital` follow the `-als` exceptions
|
|
45
|
+
- French: invariable verb+noun compounds (`porte-monnaie`, `porte-avions`, `brise-glace`, …) and the `vice-` prefix in hyphenated compounds
|
|
46
|
+
- Italian: `sabato`, `domenica`, months, and seasons are no longer treated as invariable (`sabati`, `domeniche`, `estati`, …) with correct singularization round-trips
|
|
47
|
+
- Portuguese: added `n$` → `ns` rule (`wagon` → `wagons`) and irregulars for accented `-n` words (`hífen` → `hifens`, `abdómen` → `abdomens`, `pólen`, `gérmen`, `líquen`)
|
|
48
|
+
|
|
49
|
+
### Changed
|
|
50
|
+
|
|
51
|
+
- `LanguageRules` attributes moved to PEP 224 docstrings, fixing duplicate object description warnings in the Sphinx build
|
|
52
|
+
- `docs/conf.py` reads `release` from the package version instead of a hardcoded string
|
|
53
|
+
- `doctest_global_setup` now imports the public API and restores a pristine registry snapshot per document — `sphinx -b doctest` runs all 123 docstring examples cleanly
|
|
54
|
+
- `SECURITY.md` supported versions updated to `2.x`
|
|
4
55
|
|
|
5
56
|
## [2.2.0] - 2025-07-13
|
|
6
57
|
|
|
@@ -447,3 +498,36 @@
|
|
|
447
498
|
- CI workflow (lint + type check + test on Python 3.10–3.13)
|
|
448
499
|
- Release workflow (trusted publishing to PyPI)
|
|
449
500
|
- 95% coverage requirement enforced in CI
|
|
501
|
+
|
|
502
|
+
[Unreleased]: https://github.com/MathiasPaulenko/pluralio/compare/v2.3.1...HEAD
|
|
503
|
+
[2.3.1]: https://github.com/MathiasPaulenko/pluralio/compare/v2.3.0...v2.3.1
|
|
504
|
+
[2.3.0]: https://github.com/MathiasPaulenko/pluralio/compare/v2.2.0...v2.3.0
|
|
505
|
+
[2.2.0]: https://github.com/MathiasPaulenko/pluralio/compare/v2.1.2...v2.2.0
|
|
506
|
+
[2.1.2]: https://github.com/MathiasPaulenko/pluralio/compare/v2.1.1...v2.1.2
|
|
507
|
+
[2.1.1]: https://github.com/MathiasPaulenko/pluralio/compare/v2.1.0...v2.1.1
|
|
508
|
+
[2.1.0]: https://github.com/MathiasPaulenko/pluralio/compare/v2.0.2...v2.1.0
|
|
509
|
+
[2.0.2]: https://github.com/MathiasPaulenko/pluralio/compare/v2.0.1...v2.0.2
|
|
510
|
+
[2.0.1]: https://github.com/MathiasPaulenko/pluralio/compare/v2.0.0...v2.0.1
|
|
511
|
+
[2.0.0]: https://github.com/MathiasPaulenko/pluralio/compare/v1.8.3...v2.0.0
|
|
512
|
+
[1.8.3]: https://github.com/MathiasPaulenko/pluralio/compare/v1.8.2...v1.8.3
|
|
513
|
+
[1.8.2]: https://github.com/MathiasPaulenko/pluralio/compare/v1.8.1...v1.8.2
|
|
514
|
+
[1.8.1]: https://github.com/MathiasPaulenko/pluralio/compare/v1.8.0...v1.8.1
|
|
515
|
+
[1.8.0]: https://github.com/MathiasPaulenko/pluralio/compare/v1.7.2...v1.8.0
|
|
516
|
+
[1.7.2]: https://github.com/MathiasPaulenko/pluralio/compare/v1.7.1...v1.7.2
|
|
517
|
+
[1.7.1]: https://github.com/MathiasPaulenko/pluralio/compare/v1.7.0...v1.7.1
|
|
518
|
+
[1.7.0]: https://github.com/MathiasPaulenko/pluralio/compare/v1.6.2...v1.7.0
|
|
519
|
+
[1.6.2]: https://github.com/MathiasPaulenko/pluralio/compare/v1.6.1...v1.6.2
|
|
520
|
+
[1.6.1]: https://github.com/MathiasPaulenko/pluralio/compare/v1.6.0...v1.6.1
|
|
521
|
+
[1.6.0]: https://github.com/MathiasPaulenko/pluralio/compare/v1.5.5...v1.6.0
|
|
522
|
+
[1.5.5]: https://github.com/MathiasPaulenko/pluralio/compare/v1.5.4...v1.5.5
|
|
523
|
+
[1.5.4]: https://github.com/MathiasPaulenko/pluralio/compare/v1.5.3...v1.5.4
|
|
524
|
+
[1.5.3]: https://github.com/MathiasPaulenko/pluralio/compare/v1.5.2...v1.5.3
|
|
525
|
+
[1.5.2]: https://github.com/MathiasPaulenko/pluralio/compare/v1.5.1...v1.5.2
|
|
526
|
+
[1.5.1]: https://github.com/MathiasPaulenko/pluralio/compare/v1.5.0...v1.5.1
|
|
527
|
+
[1.5.0]: https://github.com/MathiasPaulenko/pluralio/compare/v1.4.2...v1.5.0
|
|
528
|
+
[1.4.2]: https://github.com/MathiasPaulenko/pluralio/compare/v1.4.1...v1.4.2
|
|
529
|
+
[1.4.1]: https://github.com/MathiasPaulenko/pluralio/compare/v1.4.0...v1.4.1
|
|
530
|
+
[1.4.0]: https://github.com/MathiasPaulenko/pluralio/compare/v1.3.0...v1.4.0
|
|
531
|
+
[1.3.0]: https://github.com/MathiasPaulenko/pluralio/compare/v1.2.0...v1.3.0
|
|
532
|
+
[1.2.0]: https://github.com/MathiasPaulenko/pluralio/compare/v0.1.0...v1.2.0
|
|
533
|
+
[0.1.0]: https://github.com/MathiasPaulenko/pluralio/releases/tag/v0.1.0
|
|
@@ -35,9 +35,11 @@ pluralio/
|
|
|
35
35
|
│ ├── __init__.py # Public API + extensibility functions
|
|
36
36
|
│ ├── core.py # pluralize(), singularize(), _match_case(), hyphens
|
|
37
37
|
│ ├── registry.py # LanguageRules dataclass, register(), get_rules()
|
|
38
|
+
│ ├── utils.py # join(), ordinal(), template()
|
|
38
39
|
│ ├── rules/ # Language rule modules (subpackage)
|
|
39
40
|
│ │ ├── __init__.py # Imports all modules to trigger registration
|
|
40
41
|
│ │ ├── en.py # English rules
|
|
42
|
+
│ │ ├── eo.py # Esperanto rules
|
|
41
43
|
│ │ ├── es.py # Spanish rules
|
|
42
44
|
│ │ ├── fr.py # French rules
|
|
43
45
|
│ │ ├── it.py # Italian rules
|
|
@@ -52,8 +54,12 @@ pluralio/
|
|
|
52
54
|
│ ├── test_property.py
|
|
53
55
|
│ ├── test_round_trip.py
|
|
54
56
|
│ ├── test_inspect.py
|
|
57
|
+
│ ├── test_utils.py
|
|
58
|
+
│ ├── test_version.py
|
|
55
59
|
│ ├── test_en_plurals.py
|
|
56
60
|
│ ├── test_en_singles.py
|
|
61
|
+
│ ├── test_eo_plurals.py
|
|
62
|
+
│ ├── test_eo_singles.py
|
|
57
63
|
│ ├── test_es_plurals.py
|
|
58
64
|
│ ├── test_es_singles.py
|
|
59
65
|
│ ├── test_fr_plurals.py
|
|
@@ -68,7 +74,7 @@ pluralio/
|
|
|
68
74
|
│ ├── test_fr_edge_cases.py
|
|
69
75
|
│ ├── test_it_edge_cases.py
|
|
70
76
|
│ └── test_pt_edge_cases.py
|
|
71
|
-
├──
|
|
77
|
+
├── docs/ # Sphinx documentation
|
|
72
78
|
├── .github/workflows/ # CI + release workflows
|
|
73
79
|
├── pyproject.toml
|
|
74
80
|
├── CHANGELOG.md
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
Metadata-Version: 2.
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
2
|
Name: pluralio
|
|
3
|
-
Version: 2.
|
|
4
|
-
Summary: Pluralization and singularization for Python — EN/ES/PT/FR/IT/EO, zero deps, type-safe
|
|
3
|
+
Version: 2.3.1
|
|
4
|
+
Summary: Pluralization and singularization for Python — 6 languages (EN/ES/PT/FR/IT/EO), zero deps, type-safe, 100% test coverage
|
|
5
5
|
Project-URL: Homepage, https://github.com/MathiasPaulenko/pluralio
|
|
6
6
|
Project-URL: Repository, https://github.com/MathiasPaulenko/pluralio
|
|
7
7
|
Project-URL: Bug Tracker, https://github.com/MathiasPaulenko/pluralio/issues
|
|
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.10
|
|
|
19
19
|
Classifier: Programming Language :: Python :: 3.11
|
|
20
20
|
Classifier: Programming Language :: Python :: 3.12
|
|
21
21
|
Classifier: Programming Language :: Python :: 3.13
|
|
22
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
22
23
|
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
23
24
|
Classifier: Typing :: Typed
|
|
24
25
|
Requires-Python: >=3.10
|
|
@@ -41,7 +42,7 @@ Description-Content-Type: text/markdown
|
|
|
41
42
|
|
|
42
43
|
**Pluralization and singularization for Python**
|
|
43
44
|
|
|
44
|
-
|
|
45
|
+
6 languages · 7,516 tests · Zero dependencies · Type-safe · Extensible at runtime
|
|
45
46
|
|
|
46
47
|
[](https://pypi.org/project/pluralio/)
|
|
47
48
|
[](https://pypi.org/project/pluralio/)
|
|
@@ -61,7 +62,7 @@ English · Spanish · Portuguese · French · Italian · Esperanto · Zero depen
|
|
|
61
62
|
|
|
62
63
|
- **Zero dependencies** — pure Python standard library, nothing else to install
|
|
63
64
|
- **Type-safe** — full type hints, `py.typed` marker included (PEP 561)
|
|
64
|
-
- **100% test coverage** — 7,
|
|
65
|
+
- **100% test coverage** — 7,516 tests, every line is verified
|
|
65
66
|
- **6 languages** — English, Spanish, Portuguese, French, Italian, Esperanto
|
|
66
67
|
- **Extensible at runtime** — add irregulars, rules, uncountables, or entire languages without touching source code
|
|
67
68
|
- **Utility functions** — `join()`, `ordinal()`, `template()` for common UI tasks
|
|
@@ -277,6 +278,8 @@ Every word goes through a **three-step priority chain**:
|
|
|
277
278
|
| `LanguageRules` | Dataclass holding all rules for a language. |
|
|
278
279
|
| `register(rules)` | Register a `LanguageRules` instance. |
|
|
279
280
|
| `get_rules(lang)` | Retrieve rules for a language (raises `ValueError` if not found). |
|
|
281
|
+
| `snapshot()` | Deep-copy the current registry state (test isolation). |
|
|
282
|
+
| `restore(state)` | Restore a registry state returned by `snapshot()`. |
|
|
280
283
|
|
|
281
284
|
## Extending rules
|
|
282
285
|
|
|
@@ -363,7 +366,7 @@ How does pluralio compare to other Python inflection libraries?
|
|
|
363
366
|
| Hyphenated words | ✅ | ❌ | ❌ | ❌ |
|
|
364
367
|
| Unicode normalization (NFC/NFD) | ✅ | ❌ | ❌ | ❌ |
|
|
365
368
|
| Idempotency (ES) | ✅ | ❌ | ❌ | ❌ |
|
|
366
|
-
| Uncountables (ES) | ✅ ~
|
|
369
|
+
| Uncountables (ES) | ✅ ~92 | ❌ | ❌ | ❌ |
|
|
367
370
|
| Accent restoration (ES) | ✅ | ❌ | ⚠️ Partial | ❌ |
|
|
368
371
|
| Runtime extensibility | ✅ | ❌ | ❌ | ✅ |
|
|
369
372
|
| Add custom languages | ✅ | ❌ | ✅ | ❌ |
|
|
@@ -373,7 +376,7 @@ How does pluralio compare to other Python inflection libraries?
|
|
|
373
376
|
| Python 3.10+ | ✅ | ✅ | ✅ | ✅ |
|
|
374
377
|
| Test coverage | 100% | ~95% | ~60% | ~70% |
|
|
375
378
|
| Number to words | ❌ | ✅ | ❌ | ❌ |
|
|
376
|
-
| Ordinals (`1` → `1st`) |
|
|
379
|
+
| Ordinals (`1` → `1st`) | ✅ | ✅ | ❌ | ❌ |
|
|
377
380
|
| Indefinite articles (`a`/`an`) | ❌ | ✅ | ❌ | ❌ |
|
|
378
381
|
| Join words into a list | ✅ | ✅ | ❌ | ❌ |
|
|
379
382
|
| Present participle | ❌ | ✅ | ❌ | ❌ |
|
|
@@ -402,11 +405,11 @@ Benchmark: 100,000 calls across 13 mixed-language words (English, Spanish, Portu
|
|
|
402
405
|
| Language | Code | Regex rules | Irregulars | Uncountables | Status |
|
|
403
406
|
| --- | --- | --- | --- | --- | --- |
|
|
404
407
|
| English | `en` | 7 + 22 | 684 | 219 | ✅ Complete |
|
|
405
|
-
| Spanish | `es` | 9 + 8 |
|
|
406
|
-
| Portuguese | `pt` |
|
|
407
|
-
| French | `fr` | 6 + 4 |
|
|
408
|
-
| Italian | `it` | 19 + 12 |
|
|
409
|
-
| Esperanto | `eo` |
|
|
408
|
+
| Spanish | `es` | 9 + 8 | 354 | 92 | ✅ Complete |
|
|
409
|
+
| Portuguese | `pt` | 9 + 13 | 393 | 88 | ✅ Complete |
|
|
410
|
+
| French | `fr` | 6 + 4 | 100 | 92 | ✅ Complete |
|
|
411
|
+
| Italian | `it` | 19 + 12 | 249 | 126 | ✅ Complete |
|
|
412
|
+
| Esperanto | `eo` | 4 + 2 | 0 | 39 | ✅ Complete |
|
|
410
413
|
|
|
411
414
|
## Roadmap
|
|
412
415
|
|
|
@@ -419,7 +422,9 @@ Benchmark: 100,000 calls across 13 mixed-language words (English, Spanish, Portu
|
|
|
419
422
|
| `2.0.0` | Rules restructured into `pluralio/rules/` subpackage, performance optimization | ✅ Released |
|
|
420
423
|
| `2.1.0` | Esperanto (`eo`) — trivial `-j` plural | ✅ Released |
|
|
421
424
|
| `2.2.0` | Utility functions: `join()`, `ordinal()`, `template()` | ✅ Released |
|
|
422
|
-
| `2.3.0` |
|
|
425
|
+
| `2.3.0` | Bug fixes: language-code normalization, rule corrections (FR/IT/PT), docs | ✅ Released |
|
|
426
|
+
| `2.3.1` | Bug fixes: EN `-us`/`-fe`/`-o` rules, ES/FR/IT corrections, validation hardening | ✅ Released |
|
|
427
|
+
| `2.4.0` | Catalan (`ca`) — Romance, natural fit | 🔜 Planned |
|
|
423
428
|
| `3.0.0` | German (`de`) — umlauts + multiple plural patterns | 🔜 Planned |
|
|
424
429
|
|
|
425
430
|
## Changelog
|
|
@@ -428,6 +433,8 @@ See [CHANGELOG.md](CHANGELOG.md) for the full history.
|
|
|
428
433
|
|
|
429
434
|
### Recent releases
|
|
430
435
|
|
|
436
|
+
- **2.3.1** — Bug fixes: EN `-us`/`-fe`/`-o` rules, ES/FR/IT corrections, validation hardening
|
|
437
|
+
- **2.3.0** — Bug fixes: language-code normalization, rule corrections (FR/IT/PT), doctests
|
|
431
438
|
- **2.2.0** — Utility functions: `join()`, `ordinal()`, `template()`
|
|
432
439
|
- **2.1.2** — Bug fixes: `restore()` cache clearing, `_match_case` digit-only source, `register_language` redundant call
|
|
433
440
|
- **2.1.1** — Bug fixes: Esperanto double-plural, `register()` cache, `_match_case` empty target
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
**Pluralization and singularization for Python**
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
6 languages · 7,516 tests · Zero dependencies · Type-safe · Extensible at runtime
|
|
8
8
|
|
|
9
9
|
[](https://pypi.org/project/pluralio/)
|
|
10
10
|
[](https://pypi.org/project/pluralio/)
|
|
@@ -24,7 +24,7 @@ English · Spanish · Portuguese · French · Italian · Esperanto · Zero depen
|
|
|
24
24
|
|
|
25
25
|
- **Zero dependencies** — pure Python standard library, nothing else to install
|
|
26
26
|
- **Type-safe** — full type hints, `py.typed` marker included (PEP 561)
|
|
27
|
-
- **100% test coverage** — 7,
|
|
27
|
+
- **100% test coverage** — 7,516 tests, every line is verified
|
|
28
28
|
- **6 languages** — English, Spanish, Portuguese, French, Italian, Esperanto
|
|
29
29
|
- **Extensible at runtime** — add irregulars, rules, uncountables, or entire languages without touching source code
|
|
30
30
|
- **Utility functions** — `join()`, `ordinal()`, `template()` for common UI tasks
|
|
@@ -240,6 +240,8 @@ Every word goes through a **three-step priority chain**:
|
|
|
240
240
|
| `LanguageRules` | Dataclass holding all rules for a language. |
|
|
241
241
|
| `register(rules)` | Register a `LanguageRules` instance. |
|
|
242
242
|
| `get_rules(lang)` | Retrieve rules for a language (raises `ValueError` if not found). |
|
|
243
|
+
| `snapshot()` | Deep-copy the current registry state (test isolation). |
|
|
244
|
+
| `restore(state)` | Restore a registry state returned by `snapshot()`. |
|
|
243
245
|
|
|
244
246
|
## Extending rules
|
|
245
247
|
|
|
@@ -326,7 +328,7 @@ How does pluralio compare to other Python inflection libraries?
|
|
|
326
328
|
| Hyphenated words | ✅ | ❌ | ❌ | ❌ |
|
|
327
329
|
| Unicode normalization (NFC/NFD) | ✅ | ❌ | ❌ | ❌ |
|
|
328
330
|
| Idempotency (ES) | ✅ | ❌ | ❌ | ❌ |
|
|
329
|
-
| Uncountables (ES) | ✅ ~
|
|
331
|
+
| Uncountables (ES) | ✅ ~92 | ❌ | ❌ | ❌ |
|
|
330
332
|
| Accent restoration (ES) | ✅ | ❌ | ⚠️ Partial | ❌ |
|
|
331
333
|
| Runtime extensibility | ✅ | ❌ | ❌ | ✅ |
|
|
332
334
|
| Add custom languages | ✅ | ❌ | ✅ | ❌ |
|
|
@@ -336,7 +338,7 @@ How does pluralio compare to other Python inflection libraries?
|
|
|
336
338
|
| Python 3.10+ | ✅ | ✅ | ✅ | ✅ |
|
|
337
339
|
| Test coverage | 100% | ~95% | ~60% | ~70% |
|
|
338
340
|
| Number to words | ❌ | ✅ | ❌ | ❌ |
|
|
339
|
-
| Ordinals (`1` → `1st`) |
|
|
341
|
+
| Ordinals (`1` → `1st`) | ✅ | ✅ | ❌ | ❌ |
|
|
340
342
|
| Indefinite articles (`a`/`an`) | ❌ | ✅ | ❌ | ❌ |
|
|
341
343
|
| Join words into a list | ✅ | ✅ | ❌ | ❌ |
|
|
342
344
|
| Present participle | ❌ | ✅ | ❌ | ❌ |
|
|
@@ -365,11 +367,11 @@ Benchmark: 100,000 calls across 13 mixed-language words (English, Spanish, Portu
|
|
|
365
367
|
| Language | Code | Regex rules | Irregulars | Uncountables | Status |
|
|
366
368
|
| --- | --- | --- | --- | --- | --- |
|
|
367
369
|
| English | `en` | 7 + 22 | 684 | 219 | ✅ Complete |
|
|
368
|
-
| Spanish | `es` | 9 + 8 |
|
|
369
|
-
| Portuguese | `pt` |
|
|
370
|
-
| French | `fr` | 6 + 4 |
|
|
371
|
-
| Italian | `it` | 19 + 12 |
|
|
372
|
-
| Esperanto | `eo` |
|
|
370
|
+
| Spanish | `es` | 9 + 8 | 354 | 92 | ✅ Complete |
|
|
371
|
+
| Portuguese | `pt` | 9 + 13 | 393 | 88 | ✅ Complete |
|
|
372
|
+
| French | `fr` | 6 + 4 | 100 | 92 | ✅ Complete |
|
|
373
|
+
| Italian | `it` | 19 + 12 | 249 | 126 | ✅ Complete |
|
|
374
|
+
| Esperanto | `eo` | 4 + 2 | 0 | 39 | ✅ Complete |
|
|
373
375
|
|
|
374
376
|
## Roadmap
|
|
375
377
|
|
|
@@ -382,7 +384,9 @@ Benchmark: 100,000 calls across 13 mixed-language words (English, Spanish, Portu
|
|
|
382
384
|
| `2.0.0` | Rules restructured into `pluralio/rules/` subpackage, performance optimization | ✅ Released |
|
|
383
385
|
| `2.1.0` | Esperanto (`eo`) — trivial `-j` plural | ✅ Released |
|
|
384
386
|
| `2.2.0` | Utility functions: `join()`, `ordinal()`, `template()` | ✅ Released |
|
|
385
|
-
| `2.3.0` |
|
|
387
|
+
| `2.3.0` | Bug fixes: language-code normalization, rule corrections (FR/IT/PT), docs | ✅ Released |
|
|
388
|
+
| `2.3.1` | Bug fixes: EN `-us`/`-fe`/`-o` rules, ES/FR/IT corrections, validation hardening | ✅ Released |
|
|
389
|
+
| `2.4.0` | Catalan (`ca`) — Romance, natural fit | 🔜 Planned |
|
|
386
390
|
| `3.0.0` | German (`de`) — umlauts + multiple plural patterns | 🔜 Planned |
|
|
387
391
|
|
|
388
392
|
## Changelog
|
|
@@ -391,6 +395,8 @@ See [CHANGELOG.md](CHANGELOG.md) for the full history.
|
|
|
391
395
|
|
|
392
396
|
### Recent releases
|
|
393
397
|
|
|
398
|
+
- **2.3.1** — Bug fixes: EN `-us`/`-fe`/`-o` rules, ES/FR/IT corrections, validation hardening
|
|
399
|
+
- **2.3.0** — Bug fixes: language-code normalization, rule corrections (FR/IT/PT), doctests
|
|
394
400
|
- **2.2.0** — Utility functions: `join()`, `ordinal()`, `template()`
|
|
395
401
|
- **2.1.2** — Bug fixes: `restore()` cache clearing, `_match_case` digit-only source, `register_language` redundant call
|
|
396
402
|
- **2.1.1** — Bug fixes: Esperanto double-plural, `register()` cache, `_match_case` empty target
|
|
@@ -7,9 +7,11 @@ from pathlib import Path
|
|
|
7
7
|
|
|
8
8
|
sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
|
|
9
9
|
|
|
10
|
+
import pluralio # noqa: E402
|
|
11
|
+
|
|
10
12
|
project = "pluralio"
|
|
11
13
|
author = "Mathias Paulenko"
|
|
12
|
-
release =
|
|
14
|
+
release = pluralio.__version__
|
|
13
15
|
|
|
14
16
|
extensions = [
|
|
15
17
|
"sphinx.ext.autodoc",
|
|
@@ -56,5 +58,17 @@ intersphinx_mapping = {
|
|
|
56
58
|
}
|
|
57
59
|
|
|
58
60
|
doctest_global_setup = """
|
|
59
|
-
import
|
|
61
|
+
from pluralio import (
|
|
62
|
+
add_irregular, add_plural, add_plural_rule, add_singular,
|
|
63
|
+
add_singular_rule, add_uncountable, get_rules, is_plural,
|
|
64
|
+
is_singular, join, ordinal, pluralize, register_language,
|
|
65
|
+
singularize, supported_languages, template,
|
|
66
|
+
)
|
|
67
|
+
from pluralio.core import _match_case
|
|
68
|
+
from pluralio.registry import LanguageRules, register, restore, snapshot
|
|
69
|
+
|
|
70
|
+
try:
|
|
71
|
+
restore(_PRISTINE_REGISTRY)
|
|
72
|
+
except NameError:
|
|
73
|
+
_PRISTINE_REGISTRY = snapshot()
|
|
60
74
|
"""
|
|
@@ -35,14 +35,14 @@ Multi-language support
|
|
|
35
35
|
|
|
36
36
|
from pluralio import pluralize, supported_languages
|
|
37
37
|
|
|
38
|
-
word = "
|
|
38
|
+
word = "estudio"
|
|
39
39
|
for lang in supported_languages():
|
|
40
40
|
if lang in ("en", "eo", "es", "it"):
|
|
41
41
|
print(f"{lang}: {pluralize(word, lang=lang)}")
|
|
42
|
-
# en:
|
|
43
|
-
# eo:
|
|
44
|
-
# es:
|
|
45
|
-
# it:
|
|
42
|
+
# en: estudios
|
|
43
|
+
# eo: estudioj
|
|
44
|
+
# es: estudios
|
|
45
|
+
# it: estudi
|
|
46
46
|
|
|
47
47
|
Adding domain-specific vocabulary
|
|
48
48
|
---------------------------------
|
|
@@ -67,7 +67,7 @@ Marking words as uncountable
|
|
|
67
67
|
from pluralio import add_uncountable, pluralize, singularize
|
|
68
68
|
|
|
69
69
|
# Domain-specific uncountables
|
|
70
|
-
for word in ("feedback", "metadata", "
|
|
70
|
+
for word in ("feedback", "metadata", "upstream"):
|
|
71
71
|
add_uncountable(word)
|
|
72
72
|
|
|
73
73
|
pluralize("feedback") # "feedback"
|
|
@@ -118,8 +118,8 @@ Test isolation with snapshot/restore
|
|
|
118
118
|
|
|
119
119
|
state = snapshot()
|
|
120
120
|
try:
|
|
121
|
-
add_irregular("foo", "
|
|
122
|
-
assert pluralize("foo") == "
|
|
121
|
+
add_irregular("foo", "fooos")
|
|
122
|
+
assert pluralize("foo") == "fooos"
|
|
123
123
|
finally:
|
|
124
124
|
restore(state)
|
|
125
125
|
# After restore, "foo" is back to normal rules
|
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
pluralio
|
|
2
2
|
========
|
|
3
3
|
|
|
4
|
-
Pluralization and singularization for Python — zero dependencies,
|
|
5
|
-
extensible.
|
|
4
|
+
Pluralization and singularization for Python — 6 languages, zero dependencies,
|
|
5
|
+
type-safe, extensible.
|
|
6
6
|
|
|
7
|
-
Supports English, Spanish, Portuguese, French, Italian, and Esperanto
|
|
7
|
+
Supports English, Spanish, Portuguese, French, Italian, and Esperanto with
|
|
8
|
+
100% test coverage across 7,516 tests.
|
|
8
9
|
|
|
9
10
|
.. image:: https://img.shields.io/pypi/v/pluralio.svg
|
|
10
11
|
:target: https://pypi.org/project/pluralio/
|
|
@@ -26,32 +26,32 @@ registered automatically when you ``import pluralio``.
|
|
|
26
26
|
* - Spanish
|
|
27
27
|
- ``es``
|
|
28
28
|
- 9 + 8
|
|
29
|
-
-
|
|
29
|
+
- 354
|
|
30
30
|
- 92
|
|
31
31
|
- Complete
|
|
32
32
|
* - Portuguese
|
|
33
33
|
- ``pt``
|
|
34
|
-
-
|
|
35
|
-
-
|
|
34
|
+
- 9 + 13
|
|
35
|
+
- 393
|
|
36
36
|
- 88
|
|
37
37
|
- Complete
|
|
38
38
|
* - French
|
|
39
39
|
- ``fr``
|
|
40
40
|
- 6 + 4
|
|
41
|
-
-
|
|
42
|
-
-
|
|
41
|
+
- 100
|
|
42
|
+
- 92
|
|
43
43
|
- Complete
|
|
44
44
|
* - Italian
|
|
45
45
|
- ``it``
|
|
46
46
|
- 19 + 12
|
|
47
|
-
-
|
|
48
|
-
-
|
|
47
|
+
- 249
|
|
48
|
+
- 126
|
|
49
49
|
- Complete
|
|
50
50
|
* - Esperanto
|
|
51
51
|
- ``eo``
|
|
52
52
|
- 4 + 2
|
|
53
53
|
- 0
|
|
54
|
-
-
|
|
54
|
+
- 39
|
|
55
55
|
- Complete
|
|
56
56
|
|
|
57
57
|
Language-specific notes
|
|
@@ -60,10 +60,10 @@ Language-specific notes
|
|
|
60
60
|
English (``en``)
|
|
61
61
|
~~~~~~~~~~~~~~~~
|
|
62
62
|
|
|
63
|
-
- 684 irregulars covering Latin/Greek plurals
|
|
64
|
-
special cases.
|
|
65
|
-
- Regex rules handle ``-s``, ``-es``, ``-ies``, ``-ves``,
|
|
66
|
-
``-oes
|
|
63
|
+
- 684 irregulars covering Latin/Greek plurals (``-i``, ``-a``,
|
|
64
|
+
``-ae``, ``-ina``), compound words, and special cases.
|
|
65
|
+
- Regex rules handle ``-s``, ``-es``, ``-ies``, ``-ves``, and
|
|
66
|
+
``-oes`` endings.
|
|
67
67
|
- 219 uncountables including mass nouns, non-noun words, and
|
|
68
68
|
invariable terms.
|
|
69
69
|
|
|
@@ -72,14 +72,11 @@ Spanish (``es``)
|
|
|
72
72
|
|
|
73
73
|
- Accent restoration: singulars that lose an accent in the plural are
|
|
74
74
|
handled via irregular mappings (e.g. ``joven`` → ``jóvenes``).
|
|
75
|
-
- 81 extra singular-only entries for accent restoration that cannot
|
|
76
|
-
be derived from regex rules.
|
|
77
75
|
- 92 uncountables.
|
|
78
76
|
|
|
79
77
|
Portuguese (``pt``)
|
|
80
78
|
~~~~~~~~~~~~~~~~~~~
|
|
81
79
|
|
|
82
|
-
- 88 extra singular-only entries for accent restoration.
|
|
83
80
|
- Hyphenated compound handling for verb+noun constructions
|
|
84
81
|
(``quebra-mar`` → ``quebra-mares``).
|
|
85
82
|
|
|
@@ -87,8 +84,11 @@ French (``fr``)
|
|
|
87
84
|
~~~~~~~~~~~~~~~
|
|
88
85
|
|
|
89
86
|
- Both segments of hyphenated compounds are pluralized, skipping
|
|
90
|
-
function words (articles, prepositions)
|
|
91
|
-
-
|
|
87
|
+
function words (articles, prepositions) and invariable compounds
|
|
88
|
+
(``porte-monnaie``).
|
|
89
|
+
- ``-al`` → ``-aux``, ``-au``/``-eau`` → ``-aux``/``-eaux``,
|
|
90
|
+
``-eu`` → ``-eux``; the ``-als``/``-ails``/``-eus``/``-ous``
|
|
91
|
+
exceptions live in the irregular tables.
|
|
92
92
|
|
|
93
93
|
Italian (``it``)
|
|
94
94
|
~~~~~~~~~~~~~~~~
|
|
@@ -103,7 +103,7 @@ Esperanto (``eo``)
|
|
|
103
103
|
- Simplest pluralization system: ``-j`` suffix for nominative plural,
|
|
104
104
|
``-jn`` for accusative plural.
|
|
105
105
|
- Zero irregulars — the language is perfectly regular by design.
|
|
106
|
-
-
|
|
106
|
+
- 39 uncountables: pronouns, correlatives, and particles.
|
|
107
107
|
|
|
108
108
|
Roadmap
|
|
109
109
|
-------
|
|
@@ -114,11 +114,14 @@ Roadmap
|
|
|
114
114
|
* - Version
|
|
115
115
|
- Goal
|
|
116
116
|
- Status
|
|
117
|
-
* - ``2.2.0``
|
|
118
|
-
- Catalan (``ca``)
|
|
119
|
-
- Planned
|
|
120
117
|
* - ``2.3.0``
|
|
121
|
-
-
|
|
118
|
+
- Bug fixes and documentation corrections
|
|
119
|
+
- Released
|
|
120
|
+
* - ``2.3.1``
|
|
121
|
+
- Bug fixes: EN ``-us``/``-fe``/``-o`` rules, ES/FR/IT corrections, validation hardening
|
|
122
|
+
- Released
|
|
123
|
+
* - ``2.4.0``
|
|
124
|
+
- Catalan (``ca``)
|
|
122
125
|
- Planned
|
|
123
126
|
* - ``3.0.0``
|
|
124
127
|
- German (``de``)
|
|
@@ -51,14 +51,18 @@ The output mirrors the casing of the input:
|
|
|
51
51
|
Hyphenated words
|
|
52
52
|
----------------
|
|
53
53
|
|
|
54
|
-
|
|
55
|
-
for known prefixes
|
|
54
|
+
For English, Spanish, and Portuguese only the head noun is pluralized
|
|
55
|
+
(first segment by default, last segment for known prefixes like
|
|
56
|
+
``forget-`` or ``quebra-``). French and Italian pluralize every noun
|
|
57
|
+
segment, skipping articles, prepositions, and invariable compounds:
|
|
56
58
|
|
|
57
59
|
.. code-block:: python
|
|
58
60
|
|
|
59
61
|
pluralize("mother-in-law") # "mothers-in-law"
|
|
60
62
|
pluralize("forget-me-not") # "forget-me-nots"
|
|
63
|
+
pluralize("quebra-mar", lang="pt") # "quebra-mares"
|
|
61
64
|
pluralize("café-théâtre", lang="fr") # "cafés-théâtres"
|
|
65
|
+
pluralize("porte-monnaie", lang="fr") # "porte-monnaie" (invariable)
|
|
62
66
|
|
|
63
67
|
Whitespace preservation
|
|
64
68
|
-----------------------
|