dycw-utilities 0.109.4__tar.gz → 0.109.5__tar.gz

{dycw_utilities-0.109.4 → dycw_utilities-0.109.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.109.4
+Version: 0.109.5
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12

{dycw_utilities-0.109.4 → dycw_utilities-0.109.5}/pyproject.toml

@@ -89,7 +89,7 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.109.4"
+version = "0.109.5"
 
 [project.optional-dependencies]
 test = [
@@ -332,7 +332,7 @@ zzz-test-zoneinfo = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.109.4"
+current_version = "0.109.5"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.109.4 → dycw_utilities-0.109.5}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.109.4"
+__version__ = "0.109.5"

{dycw_utilities-0.109.4 → dycw_utilities-0.109.5}/src/utilities/dataclasses.py

@@ -453,7 +453,8 @@ def text_to_dataclass(
     warn_name_errors: bool = False,
     head: bool = False,
     case_sensitive: bool = False,
-    allow_extra: bool = False,
+    allow_extra_keys: bool = False,
+    extra_parsers: Mapping[type[_T], Callable[[str], _T]] | None = None,
 ) -> TDataclass:
     """Construct a dataclass from a string or a mapping or strings."""
     match text_or_mapping:
@@ -477,10 +478,12 @@ def text_to_dataclass(
         warn_name_errors=warn_name_errors,
         head=head,
         case_sensitive=case_sensitive,
-        allow_extra=allow_extra,
+        allow_extra=allow_extra_keys,
     )
     field_names_to_values = {
-        f.name: _text_to_dataclass_parse(f, t, cls, case_sensitive=case_sensitive)
+        f.name: _text_to_dataclass_parse(
+            f, t, cls, head=head, case_sensitive=case_sensitive, extra=extra_parsers
+        )
         for f, t in fields_to_serializes.items()
     }
     return mapping_to_dataclass(
@@ -492,7 +495,7 @@ def text_to_dataclass(
         warn_name_errors=warn_name_errors,
         head=head,
         case_sensitive=case_sensitive,
-        allow_extra=allow_extra,
+        allow_extra=allow_extra_keys,
     )
 
 
@@ -519,10 +522,14 @@ def _text_to_dataclass_parse(
     cls: type[Dataclass],
     /,
     *,
+    head: bool = False,
     case_sensitive: bool = False,
+    extra: Mapping[type[_T], Callable[[str], _T]] | None = None,
 ) -> Any:
     try:
-        return parse_text(field.type_, text, case_sensitive=case_sensitive)
+        return parse_text(
+            field.type_, text, head=head, case_sensitive=case_sensitive, extra=extra
+        )
     except ParseTextError:
         raise _TextToDataClassParseValueError(cls=cls, field=field, text=text) from None
 

{dycw_utilities-0.109.4 → dycw_utilities-0.109.5}/src/utilities/python_dotenv.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from dataclasses import dataclass
 from os import environ
-from typing import TYPE_CHECKING, override
+from typing import TYPE_CHECKING, TypeVar, override
 
 from dotenv import dotenv_values
 
@@ -13,13 +13,16 @@ from utilities.pathlib import PWD
 from utilities.reprlib import get_repr
 
 if TYPE_CHECKING:
-    from collections.abc import Mapping
+    from collections.abc import Callable, Mapping
     from collections.abc import Set as AbstractSet
     from pathlib import Path
 
     from utilities.types import PathLike, StrMapping, TDataclass
 
 
+_T = TypeVar("_T")
+
+
 def load_settings(
     cls: type[TDataclass],
     /,
@@ -30,6 +33,7 @@ def load_settings(
     warn_name_errors: bool = False,
     head: bool = False,
     case_sensitive: bool = False,
+    extra_parsers: Mapping[type[_T], Callable[[str], _T]] | None = None,
 ) -> TDataclass:
     """Load a set of settings from the `.env` file."""
     path = get_repo_root(cwd=cwd).joinpath(".env")
@@ -57,7 +61,8 @@ def load_settings(
             warn_name_errors=warn_name_errors,
             head=head,
             case_sensitive=case_sensitive,
-            allow_extra=True,
+            allow_extra_keys=True,
+            extra_parsers=extra_parsers,
         )
     except MappingToDataclassError as error:
         raise _LoadSettingsMissingKeysError(path=path, fields=error.fields) from None