python-iso639 2025.1.27__tar.gz → 2025.2.8__tar.gz

{python_iso639-2025.1.27 → python_iso639-2025.2.8}/CHANGELOG.md

@@ -17,6 +17,16 @@ major/minor/micro version numbers like `05` (it'd have to be just `5`).
 ### Fixed
 ### Security
 
+## [2025.2.8]
+
+### Added
+* Explcitly indicated that the library is type-annotated.
+
+## [2025.1.28]
+
+### Changed
+* Sped up the retrieval of `Language` objects during runtime.
+
 ## [2025.1.27]
 
 ### Changed

{python_iso639-2025.1.27/src/python_iso639.egg-info → python_iso639-2025.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: python-iso639
-Version: 2025.1.27
+Version: 2025.2.8
 Summary: ISO 639 language codes, names, and other associated information
 Author-email: "Jackson L. Lee" <jacksonlunlee@gmail.com>
 License: Apache 2.0
@@ -28,10 +28,10 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Provides-Extra: dev
-Requires-Dist: black==24.10.0; extra == "dev"
+Requires-Dist: black==25.1.0; extra == "dev"
 Requires-Dist: build==1.2.2; extra == "dev"
 Requires-Dist: flake8==7.1.1; extra == "dev"
-Requires-Dist: mypy==1.14.1; extra == "dev"
+Requires-Dist: mypy==1.15.0; extra == "dev"
 Requires-Dist: pytest==8.3.4; extra == "dev"
 Requires-Dist: requests==2.32.3; extra == "dev"
 Requires-Dist: twine==6.1.0; extra == "dev"
@@ -48,9 +48,10 @@ other associated information.
 
 Current features:
 
-* A representation of languages mapped across ISO 639-1, 639-2, and 639-3.
-* Functionality to "guess" what a language is for a given
+* 🌐 A representation of languages mapped across ISO 639-1, 639-2, and 639-3.
+* 🔎 Functionality to "guess" what a language is for a given
   unknown language code or name.
+* 🚀 Optimized for speed in retrieving language information.
 
 ## Installation
 
@@ -82,6 +83,15 @@ Create a `Language` instance by one of the class methods.
 Language(part3='fra', part2b='fre', part2t='fra', part1='fr', scope='I', type='L', name='French', comment=None, other_names=None, macrolanguage=None, retire_reason=None, retire_change_to=None, retire_remedy=None, retire_date=None)
 ```
 
+Fast object instantiation for retrieving language information (run on Python 3.13, macOS 15.2, Apple M1 Pro)
+
+```python
+In [1]: import iso639
+
+In [2]: %timeit iso639.Language.from_part3("fra")
+220 ns ± 0.658 ns per loop (mean ± std. dev. of 7 runs, 1,000,000 loops each)
+```
+
 #### From Another ISO 639 Code Set or a Reference Name
 
 ```python

{python_iso639-2025.1.27 → python_iso639-2025.2.8}/README.md

@@ -10,9 +10,10 @@ other associated information.
 
 Current features:
 
-* A representation of languages mapped across ISO 639-1, 639-2, and 639-3.
-* Functionality to "guess" what a language is for a given
+* 🌐 A representation of languages mapped across ISO 639-1, 639-2, and 639-3.
+* 🔎 Functionality to "guess" what a language is for a given
   unknown language code or name.
+* 🚀 Optimized for speed in retrieving language information.
 
 ## Installation
 
@@ -44,6 +45,15 @@ Create a `Language` instance by one of the class methods.
 Language(part3='fra', part2b='fre', part2t='fra', part1='fr', scope='I', type='L', name='French', comment=None, other_names=None, macrolanguage=None, retire_reason=None, retire_change_to=None, retire_remedy=None, retire_date=None)
 ```
 
+Fast object instantiation for retrieving language information (run on Python 3.13, macOS 15.2, Apple M1 Pro)
+
+```python
+In [1]: import iso639
+
+In [2]: %timeit iso639.Language.from_part3("fra")
+220 ns ± 0.658 ns per loop (mean ± std. dev. of 7 runs, 1,000,000 loops each)
+```
+
 #### From Another ISO 639 Code Set or a Reference Name
 
 ```python

{python_iso639-2025.1.27 → python_iso639-2025.2.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-iso639"
-version = "2025.1.27"
+version = "2025.2.8"
 description = "ISO 639 language codes, names, and other associated information"
 readme = "README.md"
 requires-python = ">= 3.9"
@@ -34,10 +34,10 @@ classifiers = [
 
 [project.optional-dependencies]
 dev = [
-    "black == 24.10.0",
+    "black == 25.1.0",
     "build == 1.2.2",
     "flake8 == 7.1.1",
-    "mypy == 1.14.1",
+    "mypy == 1.15.0",
     "pytest == 8.3.4",
     "requests == 2.32.3",
     "twine == 6.1.0",
@@ -52,7 +52,7 @@ where = [ "src" ]
 [tool.setuptools]
 zip-safe = false
 package-dir = { "" = "src" }
-package-data = { "iso639" = ["_data/*.tab"] }
+package-data = { "iso639" = ["_data/*.tab", "py.typed"] }
 
 [tool.pytest.ini_options]
 addopts = "-vv --durations=0 --strict-markers"

{python_iso639-2025.1.27 → python_iso639-2025.2.8}/src/iso639/__init__.py

@@ -1,7 +1,7 @@
 import datetime
 from importlib.metadata import version
 
-from .language import Language, LanguageNotFoundError, _get_all_languages
+from .language import ALL_LANGUAGES, Language, LanguageNotFoundError
 
 
 # __version__ is based on calendar versioning (https://calver.org/).
@@ -12,13 +12,6 @@ __version__ = version("python-iso639")
 DATA_LAST_UPDATED = datetime.date(2025, 1, 15)
 
 
-def __getattr__(name):
-    if name == "ALL_LANGUAGES":
-        return _get_all_languages()
-    else:
-        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
-
-
 __all__ = [
     "__version__",
     "ALL_LANGUAGES",

{python_iso639-2025.1.27 → python_iso639-2025.2.8}/src/iso639/language.py

@@ -3,10 +3,9 @@
 from __future__ import annotations
 
 import datetime
-import functools
 from dataclasses import dataclass
 
-from typing import List, Union, Set, Tuple
+from typing import Dict, List, Union, Set
 
 from ._data import (
     _PART3_TO_CODES,
@@ -101,7 +100,7 @@ class Language:
         return isinstance(other, Language) and self.part3 == other.part3
 
     @classmethod
-    def match(cls, user_input) -> Language:
+    def match(cls, user_input: str, /) -> Language:
         """Return a ``Language`` instance by matching on the user input.
 
         Parameters
@@ -131,7 +130,7 @@ class Language:
         # Order of columns to query the data tables.
         # Bias towards (and therefore prioritize) the user input being
         # a language code rather than a language name.
-        query_order = (
+        query_order: List[_COLUMN_TYPE] = [
             _CodesColumn.ID,
             _CodesColumn.PART2B,
             _CodesColumn.PART2T,
@@ -140,55 +139,55 @@ class Language:
             _CodesColumn.REF_NAME,
             _NameIndexColumn.PRINT_NAME,
             _NameIndexColumn.INVERTED_NAME,
-        )
-        return _get_language(user_input, query_order)
+        ]
+        return _PART3_TO_LANGUAGES[_get_part3(user_input, query_order)]
 
     @classmethod
-    def from_part3(cls, user_input) -> Language:
+    def from_part3(cls, user_input: str, /) -> Language:
         """Return a ``Language`` instance from an ISO 639-3 code."""
-        return _get_language(user_input, (_CodesColumn.ID, _RetirementsColumn.ID))
+        return _PART3_TO_LANGUAGES[
+            _get_part3(user_input, [_CodesColumn.ID, _RetirementsColumn.ID])
+        ]
 
     @classmethod
-    def from_part2b(cls, user_input) -> Language:
+    def from_part2b(cls, user_input: str, /) -> Language:
         """Return a ``Language`` instance from an ISO 639-2 (bibliographic) code."""
-        return _get_language(user_input, (_CodesColumn.PART2B,))
+        return _PART3_TO_LANGUAGES[_get_part3(user_input, [_CodesColumn.PART2B])]
 
     @classmethod
-    def from_part2t(cls, user_input) -> Language:
+    def from_part2t(cls, user_input: str, /) -> Language:
         """Return a ``Language`` instance from an ISO 639-2 (terminological) code."""
-        return _get_language(user_input, (_CodesColumn.PART2T,))
+        return _PART3_TO_LANGUAGES[_get_part3(user_input, [_CodesColumn.PART2T])]
 
     @classmethod
-    def from_part1(cls, user_input) -> Language:
+    def from_part1(cls, user_input: str, /) -> Language:
         """Return a ``Language`` instance from an ISO 639-1 code."""
-        return _get_language(user_input, (_CodesColumn.PART1,))
+        return _PART3_TO_LANGUAGES[_get_part3(user_input, [_CodesColumn.PART1])]
 
     @classmethod
-    def from_name(cls, user_input) -> Language:
+    def from_name(cls, user_input: str, /) -> Language:
         """Return a ``Language`` instance from an ISO 639-3 reference language name."""
-        query_order = (
+        query_order: List[_COLUMN_TYPE] = [
             _CodesColumn.REF_NAME,
             _NameIndexColumn.PRINT_NAME,
             _NameIndexColumn.INVERTED_NAME,
-        )
-        return _get_language(user_input, query_order)
+        ]
+        return _PART3_TO_LANGUAGES[_get_part3(user_input, query_order)]
 
 
-@functools.lru_cache()
-def _get_language(user_input: str, query_order: Tuple[_COLUMN_TYPE]) -> Language:
-    """Create a ``Language`` instance.
+def _get_part3(user_input: str, query_order: List[_COLUMN_TYPE]) -> str:
+    """Get the part 3 code of a language.
 
     Parameters
     ----------
     user_input : str
         The user-provided language code or name.
-    query_order : Tuple[_COLUMN_TYPE]
-        A tuple of columns to specify query order.
-        A tuple but not a list because this argument needs to be hashable for lru_cache.
+    query_order : List[_COLUMN_TYPE]
+        A list of columns to specify query order.
 
     Returns
     -------
-    Language
+    str
 
     Raises
     ------
@@ -227,6 +226,21 @@ def _get_language(user_input: str, query_order: Tuple[_COLUMN_TYPE]) -> Language
             f"{user_input!r} isn't an ISO language code or name"
         )
 
+    return part3
+
+
+def _get_language(part3: str) -> Language:
+    """Create a ``Language`` instance.
+
+    Parameters
+    ----------
+    part3 : str
+        Part 3 code of the language.
+
+    Returns
+    -------
+    Language
+    """
     from_codes = _PART3_TO_CODES.get(part3)
     from_macrolanguages = _PART3_TO_MACROLANGUAGES.get(part3)
     from_retirements = _PART3_TO_RETIREMENTS.get(part3)
@@ -300,11 +314,15 @@ def _get_language(user_input: str, query_order: Tuple[_COLUMN_TYPE]) -> Language
     return language
 
 
-@functools.lru_cache()
-def _get_all_languages() -> Set[Language]:
-    languages = set()
+def _get_all_languages() -> Dict[str, Language]:
+    languages = {}
     for part3 in _PART3_TO_CODES:
-        languages.add(_get_language(part3, (_CodesColumn.ID,)))
+        languages[part3] = _get_language(part3)
     for part3 in _PART3_TO_RETIREMENTS:
-        languages.add(_get_language(part3, (_RetirementsColumn.ID,)))
+        languages[part3] = _get_language(part3)
     return languages
+
+
+_PART3_TO_LANGUAGES: Dict[str, Language] = _get_all_languages()
+
+ALL_LANGUAGES: Set[Language] = set(_PART3_TO_LANGUAGES.values())

{python_iso639-2025.1.27 → python_iso639-2025.2.8/src/python_iso639.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: python-iso639
-Version: 2025.1.27
+Version: 2025.2.8
 Summary: ISO 639 language codes, names, and other associated information
 Author-email: "Jackson L. Lee" <jacksonlunlee@gmail.com>
 License: Apache 2.0
@@ -28,10 +28,10 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Provides-Extra: dev
-Requires-Dist: black==24.10.0; extra == "dev"
+Requires-Dist: black==25.1.0; extra == "dev"
 Requires-Dist: build==1.2.2; extra == "dev"
 Requires-Dist: flake8==7.1.1; extra == "dev"
-Requires-Dist: mypy==1.14.1; extra == "dev"
+Requires-Dist: mypy==1.15.0; extra == "dev"
 Requires-Dist: pytest==8.3.4; extra == "dev"
 Requires-Dist: requests==2.32.3; extra == "dev"
 Requires-Dist: twine==6.1.0; extra == "dev"
@@ -48,9 +48,10 @@ other associated information.
 
 Current features:
 
-* A representation of languages mapped across ISO 639-1, 639-2, and 639-3.
-* Functionality to "guess" what a language is for a given
+* 🌐 A representation of languages mapped across ISO 639-1, 639-2, and 639-3.
+* 🔎 Functionality to "guess" what a language is for a given
   unknown language code or name.
+* 🚀 Optimized for speed in retrieving language information.
 
 ## Installation
 
@@ -82,6 +83,15 @@ Create a `Language` instance by one of the class methods.
 Language(part3='fra', part2b='fre', part2t='fra', part1='fr', scope='I', type='L', name='French', comment=None, other_names=None, macrolanguage=None, retire_reason=None, retire_change_to=None, retire_remedy=None, retire_date=None)
 ```
 
+Fast object instantiation for retrieving language information (run on Python 3.13, macOS 15.2, Apple M1 Pro)
+
+```python
+In [1]: import iso639
+
+In [2]: %timeit iso639.Language.from_part3("fra")
+220 ns ± 0.658 ns per loop (mean ± std. dev. of 7 runs, 1,000,000 loops each)
+```
+
 #### From Another ISO 639 Code Set or a Reference Name
 
 ```python

{python_iso639-2025.1.27 → python_iso639-2025.2.8}/src/python_iso639.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ README.md
 pyproject.toml
 src/iso639/__init__.py
 src/iso639/language.py
+src/iso639/py.typed
 src/iso639/_data/__init__.py
 src/iso639/_data/iso-639-3-macrolanguages.tab
 src/iso639/_data/iso-639-3.tab

{python_iso639-2025.1.27 → python_iso639-2025.2.8}/src/python_iso639.egg-info/requires.txt

@@ -1,9 +1,9 @@
 
 [dev]
-black==24.10.0
+black==25.1.0
 build==1.2.2
 flake8==7.1.1
-mypy==1.14.1
+mypy==1.15.0
 pytest==8.3.4
 requests==2.32.3
 twine==6.1.0