dycw-utilities 0.109.1__py3-none-any.whl → 0.109.3__py3-none-any.whl

{dycw_utilities-0.109.1.dist-info → dycw_utilities-0.109.3.dist-info}/METADATA

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

{dycw_utilities-0.109.1.dist-info → dycw_utilities-0.109.3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=hXFp40lgEbzHJocIbjY5_v_hKGMzhE6Os9g06SFuZME,60
+utilities/__init__.py,sha256=XHS4BHXBA86Rjy07zPtJwGLkB2QC4JUa0pQjTRZS2zE,60
 utilities/altair.py,sha256=NSyDsm8QlkAGmsGdxVwCkHnPxt_35yJBa9Lg7bz9Ays,9054
 utilities/astor.py,sha256=xuDUkjq0-b6fhtwjhbnebzbqQZAjMSHR1IIS5uOodVg,777
 utilities/asyncio.py,sha256=41oQUurWMvadFK5gFnaG21hMM0Vmfn2WS6OpC0R9mas,14757
@@ -11,7 +11,7 @@ utilities/contextlib.py,sha256=OOIIEa5lXKGzFAnauaul40nlQnQko6Na4ryiMJcHkIg,478
 utilities/contextvars.py,sha256=RsSGGrbQqqZ67rOydnM7WWIsM2lIE31UHJLejnHJPWY,505
 utilities/cryptography.py,sha256=HyOewI20cl3uRXsKivhIaeLVDInQdzgXZGaly7hS5dE,771
 utilities/cvxpy.py,sha256=Rv1-fD-XYerosCavRF8Pohop2DBkU3AlFaGTfD8AEAA,13776
-utilities/dataclasses.py,sha256=12Cxq0ZXFuc4lPD6Y92Ny-b25C0EnkAZ3Hz59tetcbQ,21709
+utilities/dataclasses.py,sha256=4siQUalzjYckhJ7R9Cn4Pmerxzx18_mjPIwUmeuwwKs,23049
 utilities/datetime.py,sha256=GOs-MIEW_A49kzqa1yhIoeNeSqqPVgGO-h2AThtgTDk,37326
 utilities/enum.py,sha256=HoRwVCWzsnH0vpO9ZEcAAIZLMv0Sn2vJxxA4sYMQgDs,5793
 utilities/errors.py,sha256=BtSNP0JC3ik536ddPyTerLomCRJV9f6kdMe6POz0QHM,361
@@ -38,22 +38,22 @@ utilities/more_itertools.py,sha256=CPUxrMAcTwRxbzbhiqPKi3Xx9hxqI0t6gkWjutaibGk,5
 utilities/numpy.py,sha256=rA1b0_GkBUSMjnv77tinRM70KRnkcmZxI9xbrsXFDRg,21819
 utilities/operator.py,sha256=0M2yZJ0PODH47ogFEnkGMBe_cfxwZR02T_92LZVZvHo,3715
 utilities/optuna.py,sha256=loyJGWTzljgdJaoLhP09PT8Jz6o_pwBOwehY33lHkhw,1923
-utilities/orjson.py,sha256=DW5pOpMyrR5Q8caQYly9AqRPazDBqrWv5GRWfULqka4,36291
+utilities/orjson.py,sha256=Wj5pzG_VdgoAy14a7Luhem-BgYrRtRFvvl_POiszRd0,36930
 utilities/os.py,sha256=D_FyyT-6TtqiN9KSS7c9g1fnUtgxmyMtzAjmYLkk46A,3587
-utilities/parse.py,sha256=yLLH51VNwmcWbEvwqh6M-weWt7NIayd7No67Oe80S3k,4585
+utilities/parse.py,sha256=-rnx9qBKo9UZbE1HtvBwYOs4vF7YiJiciPAM6IKmfRc,5183
 utilities/pathlib.py,sha256=31WPMXdLIyXgYOMMl_HOI2wlo66MGSE-cgeelk-Lias,1410
 utilities/period.py,sha256=ikHXsWtDLr553cfH6p9mMaiCnIAP69B7q84ckWV3HaA,10884
 utilities/pickle.py,sha256=Bhvd7cZl-zQKQDFjUerqGuSKlHvnW1K2QXeU5UZibtg,657
 utilities/platform.py,sha256=NU7ycTvAXAG-fdYmDXaM1m4EOml2cGiaYwaUzfzSqyU,1767
-utilities/polars.py,sha256=ZXiHLkn6CbRh0_e0db5KRjHPU0LAedwzGno7k9fsiIo,48917
+utilities/polars.py,sha256=USK_Rck8nmFYg2Rs-akqN9jV4w52lpz4rgkWUMQdLMk,49087
 utilities/pqdm.py,sha256=foRytQybmOQ05pjt5LF7ANyzrIa--4ScDE3T2wd31a4,3118
 utilities/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 utilities/pydantic.py,sha256=f6qtR5mO2YMuyvNmbaEj5YeD9eGA4YYfb7Bjzh9jUs0,1845
 utilities/pyinstrument.py,sha256=ROq2txPwbe2ZUuYJ2IDNbfT97lu2ca0v5_C_yn6sSlM,800
 utilities/pyrsistent.py,sha256=TLJfiiKO4cKNU_pCoM3zDqmSM421qpuoaeaBNnyC_Ac,2489
 utilities/pytest.py,sha256=85QUax4g2VBBAqAHtM9wekcSLB7_9O8AKFTaCshztL8,7989
-utilities/pytest_regressions.py,sha256=Kp1NS_cyXvBFqyiF_oSzYmSJzIOdAZ0SFcSGmbL_UtI,5001
-utilities/python_dotenv.py,sha256=-d2bQ3Ayyv9JUK59k6F3-mTzQmb2SV0HzqG9fpsD8C8,2976
+utilities/pytest_regressions.py,sha256=-SVT9647Dg6-JcdsiaDKXe3NdOmmrvGevLKWwGjxq3c,5088
+utilities/python_dotenv.py,sha256=10DHEB7AVeZqH7I4wr6nACdJQYQJanlEj6EsyLvCN9w,3059
 utilities/random.py,sha256=lYdjgxB7GCfU_fwFVl5U-BIM_HV3q6_urL9byjrwDM8,4157
 utilities/re.py,sha256=5J4d8VwIPFVrX2Eb8zfoxImDv7IwiN_U7mJ07wR2Wvs,3958
 utilities/redis.py,sha256=CsDQqc9V6ASLzLQwtbQXZQEndyG9pJiCOhPlPeszt7Y,21203
@@ -75,7 +75,7 @@ utilities/threading.py,sha256=GvBOp4CyhHfN90wGXZuA2VKe9fGzMaEa7oCl4f3nnPU,1009
 utilities/timer.py,sha256=Rkc49KSpHuC8s7vUxGO9DU55U9I6yDKnchsQqrUCVBs,4075
 utilities/traceback.py,sha256=KwHPLdEbdj0fFhXo8MBfxcvem8A-VXYDwFMNJ6f0cTM,27328
 utilities/types.py,sha256=QK8kgH80TJdh_vktaZHrCEk7f1f8kHiDr8dJlK8aSac,17814
-utilities/typing.py,sha256=qX0o3NfImTXt40iGpERIVjuOQGb0XINfWUOxMmlh1s4,5157
+utilities/typing.py,sha256=gLg4EbE1FX52fJ1d3ji4i08qolwu9qgWt8w_w_Y5DTk,5512
 utilities/tzdata.py,sha256=2ZsPmhTVM9Ptrxb4QrWKtKOB9RiH8IOO-A1u7ULdVbg,176
 utilities/tzlocal.py,sha256=42BCquGF54oIqIKe5RGziP4K8Nbm3Ey7uqcNn6m5ge8,534
 utilities/uuid.py,sha256=jJTFxz-CWgltqNuzmythB7iEQ-Q1mCwPevUfKthZT3c,611
@@ -84,7 +84,7 @@ utilities/warnings.py,sha256=yUgjnmkCRf6QhdyAXzl7u0qQFejhQG3PrjoSwxpbHrs,1819
 utilities/whenever.py,sha256=5x2t47VJmJRWcd_NLFy54NkB3uom-XQYxEbLtEfL1bs,17775
 utilities/zipfile.py,sha256=24lQc9ATcJxHXBPc_tBDiJk48pWyRrlxO2fIsFxU0A8,699
 utilities/zoneinfo.py,sha256=-DQz5a0Ikw9jfSZtL0BEQkXOMC9yGn_xiJYNCLMiqEc,1989
-dycw_utilities-0.109.1.dist-info/METADATA,sha256=dCcv9ZcxodWQ1Ze4u30ZUglTEC7NipHnFMOMN9zv6Oc,13004
-dycw_utilities-0.109.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dycw_utilities-0.109.1.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
-dycw_utilities-0.109.1.dist-info/RECORD,,
+dycw_utilities-0.109.3.dist-info/METADATA,sha256=TF66WIpVFJnaJA80lxa_GKBZKZUzfz8VWd95FQW8v4A,13004
+dycw_utilities-0.109.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dycw_utilities-0.109.3.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
+dycw_utilities-0.109.3.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.109.1"
+__version__ = "0.109.3"

utilities/dataclasses.py

@@ -48,6 +48,7 @@ def dataclass_repr(
     exclude: Iterable[str] | None = None,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     rel_tol: float | None = None,
     abs_tol: float | None = None,
     extra: Mapping[type[_T], Callable[[_T, _T], bool]] | None = None,
@@ -56,7 +57,9 @@ def dataclass_repr(
 ) -> str:
     """Repr a dataclass, without its defaults."""
     out: dict[str, str] = {}
-    for fld in yield_fields(obj, globalns=globalns, localns=localns):
+    for fld in yield_fields(
+        obj, globalns=globalns, localns=localns, warn_name_errors=warn_name_errors
+    ):
         if (
             fld.keep(
                 include=include,
@@ -76,6 +79,7 @@ def dataclass_repr(
                         exclude=exclude,
                         globalns=globalns,
                         localns=localns,
+                        warn_name_errors=warn_name_errors,
                         rel_tol=rel_tol,
                         abs_tol=abs_tol,
                         extra=extra,
@@ -90,6 +94,7 @@ def dataclass_repr(
                             exclude=exclude,
                             globalns=globalns,
                             localns=localns,
+                            warn_name_errors=warn_name_errors,
                             rel_tol=rel_tol,
                             abs_tol=abs_tol,
                             extra=extra,
@@ -122,6 +127,7 @@ def dataclass_to_dict(
     exclude: Iterable[str] | None = None,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     rel_tol: float | None = None,
     abs_tol: float | None = None,
     extra: Mapping[type[_T], Callable[[_T, _T], bool]] | None = None,
@@ -131,7 +137,9 @@ def dataclass_to_dict(
 ) -> StrMapping:
     """Convert a dataclass to a dictionary."""
     out: StrMapping = {}
-    for fld in yield_fields(obj, globalns=globalns, localns=localns):
+    for fld in yield_fields(
+        obj, globalns=globalns, localns=localns, warn_name_errors=warn_name_errors
+    ):
         if fld.keep(
             include=include,
             exclude=exclude,
@@ -146,6 +154,7 @@ def dataclass_to_dict(
                         fld.value,
                         globalns=globalns,
                         localns=localns,
+                        warn_name_errors=warn_name_errors,
                         rel_tol=rel_tol,
                         abs_tol=abs_tol,
                         extra=extra,
@@ -159,6 +168,7 @@ def dataclass_to_dict(
                             v,
                             globalns=globalns,
                             localns=localns,
+                            warn_name_errors=warn_name_errors,
                             rel_tol=rel_tol,
                             abs_tol=abs_tol,
                             extra=extra,
@@ -189,13 +199,21 @@ def mapping_to_dataclass(
     fields: Iterable[_YieldFieldsClass[Any]] | None = None,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     head: bool = False,
     case_sensitive: bool = False,
     allow_extra: bool = False,
 ) -> TDataclass:
     """Construct a dataclass from a mapping."""
     if fields is None:
-        fields_use = list(yield_fields(cls, globalns=globalns, localns=localns))
+        fields_use = list(
+            yield_fields(
+                cls,
+                globalns=globalns,
+                localns=localns,
+                warn_name_errors=warn_name_errors,
+            )
+        )
     else:
         fields_use = fields
     fields_to_values = str_mapping_to_field_mapping(
@@ -204,6 +222,7 @@ def mapping_to_dataclass(
         fields=fields_use,
         globalns=globalns,
         localns=localns,
+        warn_name_errors=warn_name_errors,
         head=head,
         case_sensitive=case_sensitive,
         allow_extra=allow_extra,
@@ -244,12 +263,20 @@ def one_field(
     fields: Iterable[_YieldFieldsClass[Any]] | None = None,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     head: bool = False,
     case_sensitive: bool = False,
 ) -> _YieldFieldsClass[Any]:
     """Get the unique field a key matches to."""
     if fields is None:
-        fields_use = list(yield_fields(cls, globalns=globalns, localns=localns))
+        fields_use = list(
+            yield_fields(
+                cls,
+                globalns=globalns,
+                localns=localns,
+                warn_name_errors=warn_name_errors,
+            )
+        )
     else:
         fields_use = fields
     mapping = {f.name: f for f in fields_use}
@@ -362,6 +389,7 @@ def str_mapping_to_field_mapping(
     fields: Iterable[_YieldFieldsClass[Any]] | None = None,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     head: bool = False,
     case_sensitive: bool = False,
     allow_extra: bool = False,
@@ -376,6 +404,7 @@ def str_mapping_to_field_mapping(
                 fields=fields,
                 globalns=globalns,
                 localns=localns,
+                warn_name_errors=warn_name_errors,
                 head=head,
                 case_sensitive=case_sensitive,
             )
@@ -421,6 +450,7 @@ def text_to_dataclass(
     *,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     head: bool = False,
     case_sensitive: bool = False,
     allow_extra: bool = False,
@@ -433,13 +463,18 @@ def text_to_dataclass(
             ...
         case _ as never:
             assert_never(never)
-    fields = list(yield_fields(cls, globalns=globalns, localns=localns))
+    fields = list(
+        yield_fields(
+            cls, globalns=globalns, localns=localns, warn_name_errors=warn_name_errors
+        )
+    )
     fields_to_serializes = str_mapping_to_field_mapping(
         cls,
         keys_to_serializes,
         fields=fields,
         globalns=globalns,
         localns=localns,
+        warn_name_errors=warn_name_errors,
         head=head,
         case_sensitive=case_sensitive,
         allow_extra=allow_extra,
@@ -454,6 +489,7 @@ def text_to_dataclass(
         fields=fields,
         globalns=globalns,
         localns=localns,
+        warn_name_errors=warn_name_errors,
         head=head,
         case_sensitive=case_sensitive,
         allow_extra=allow_extra,
@@ -525,6 +561,7 @@ def yield_fields(
     *,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
 ) -> Iterator[_YieldFieldsInstance[Any]]: ...
 @overload
 def yield_fields(
@@ -533,6 +570,7 @@ def yield_fields(
     *,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
 ) -> Iterator[_YieldFieldsClass[Any]]: ...
 def yield_fields(
     obj: Dataclass | type[Dataclass],
@@ -540,10 +578,16 @@ def yield_fields(
     *,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
 ) -> Iterator[_YieldFieldsInstance[Any]] | Iterator[_YieldFieldsClass[Any]]:
     """Yield the fields of a dataclass."""
     if is_dataclass_instance(obj):
-        for field in yield_fields(type(obj), globalns=globalns, localns=localns):
+        for field in yield_fields(
+            type(obj),
+            globalns=globalns,
+            localns=localns,
+            warn_name_errors=warn_name_errors,
+        ):
             yield _YieldFieldsInstance(
                 name=field.name,
                 value=getattr(obj, field.name),
@@ -558,7 +602,9 @@ def yield_fields(
                 kw_only=field.kw_only,
             )
     elif is_dataclass_class(obj):
-        hints = get_type_hints(obj, globalns=globalns, localns=localns)
+        hints = get_type_hints(
+            obj, globalns=globalns, localns=localns, warn_name_errors=warn_name_errors
+        )
         for field in fields(obj):
             if isinstance(field.type, type):
                 type_ = field.type

utilities/orjson.py

@@ -114,6 +114,7 @@ def serialize(
     before: Callable[[Any], Any] | None = None,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     dataclass_hook: _DataclassHook | None = None,
     dataclass_defaults: bool = False,
 ) -> bytes:
@@ -123,6 +124,7 @@ def serialize(
         before=before,
         globalns=globalns,
         localns=localns,
+        warn_name_errors=warn_name_errors,
         dataclass_hook=dataclass_hook,
         dataclass_defaults=dataclass_defaults,
     )
@@ -139,6 +141,7 @@ def _pre_process(
     before: Callable[[Any], Any] | None = None,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     dataclass_hook: _DataclassHook | None = None,
     dataclass_defaults: bool = False,
     error: _ErrorMode = "raise",
@@ -150,6 +153,7 @@ def _pre_process(
         before=before,
         globalns=globalns,
         localns=localns,
+        warn_name_errors=warn_name_errors,
         dataclass_hook=dataclass_hook,
         dataclass_defaults=dataclass_defaults,
         error=error,
@@ -196,6 +200,7 @@ def _pre_process(
                 dataclass,
                 globalns=globalns,
                 localns=localns,
+                warn_name_errors=warn_name_errors,
                 final=partial(_dataclass_final, hook=dataclass_hook),
                 defaults=dataclass_defaults,
             )
@@ -212,6 +217,7 @@ def _pre_process(
                 before=before,
                 globalns=globalns,
                 localns=localns,
+                warn_name_errors=warn_name_errors,
                 dataclass_hook=dataclass_hook,
             )
         case list() as list_:
@@ -222,6 +228,7 @@ def _pre_process(
                 before=before,
                 globalns=globalns,
                 localns=localns,
+                warn_name_errors=warn_name_errors,
                 dataclass_hook=dataclass_hook,
             )
         case Mapping() as mapping:
@@ -234,6 +241,7 @@ def _pre_process(
                 before=before,
                 globalns=globalns,
                 localns=localns,
+                warn_name_errors=warn_name_errors,
                 dataclass_hook=dataclass_hook,
             )
         case tuple() as tuple_:
@@ -244,6 +252,7 @@ def _pre_process(
                 before=before,
                 globalns=globalns,
                 localns=localns,
+                warn_name_errors=warn_name_errors,
                 dataclass_hook=dataclass_hook,
             )
         # other
@@ -263,6 +272,7 @@ def _pre_process_container(
     before: Callable[[Any], Any] | None = None,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     dataclass_hook: _DataclassHook | None = None,
     dataclass_include_defaults: bool = False,
 ) -> Any:
@@ -272,6 +282,7 @@ def _pre_process_container(
             before=before,
             globalns=globalns,
             localns=localns,
+            warn_name_errors=warn_name_errors,
             dataclass_hook=dataclass_hook,
             dataclass_defaults=dataclass_include_defaults,
         )
@@ -716,6 +727,7 @@ class OrjsonFormatter(Formatter):
         before: Callable[[Any], Any] | None = None,
         globalns: StrMapping | None = None,
         localns: StrMapping | None = None,
+        warn_name_errors: bool = False,
         dataclass_hook: _DataclassHook | None = None,
         dataclass_defaults: bool = False,
     ) -> None:
@@ -723,6 +735,7 @@ class OrjsonFormatter(Formatter):
         self._before = before
         self._globalns = globalns
         self._localns = localns
+        self._warn_name_errors = warn_name_errors
         self._dataclass_hook = dataclass_hook
         self._dataclass_defaults = dataclass_defaults
 
@@ -752,6 +765,7 @@ class OrjsonFormatter(Formatter):
             before=self._before,
             globalns=self._globalns,
             localns=self._localns,
+            warn_name_errors=self._warn_name_errors,
             dataclass_hook=self._dataclass_hook,
             dataclass_defaults=self._dataclass_defaults,
         ).decode()

utilities/parse.py

@@ -5,6 +5,7 @@ from contextlib import suppress
 from dataclasses import dataclass
 from enum import Enum
 from pathlib import Path
+from re import DOTALL
 from types import NoneType
 from typing import Any, override
 
@@ -12,9 +13,10 @@ from utilities.datetime import is_subclass_date_not_datetime
 from utilities.enum import ParseEnumError, parse_enum
 from utilities.functions import is_subclass_int_not_bool
 from utilities.iterables import one, one_str
+from utilities.re import ExtractGroupError, extract_group
 from utilities.sentinel import ParseSentinelError, Sentinel, parse_sentinel
 from utilities.text import ParseBoolError, ParseNoneError, parse_bool, parse_none
-from utilities.typing import get_args, is_literal_type, is_optional_type
+from utilities.typing import get_args, is_literal_type, is_optional_type, is_tuple_type
 from utilities.version import ParseVersionError, Version, parse_version
 
 
@@ -42,6 +44,18 @@ def parse_text(
                 return _parse_text_type(inner, text, case_sensitive=case_sensitive)
             except ParseTextError:
                 raise ParseTextError(obj=obj, text=text) from None
+    if is_tuple_type(obj):
+        args = get_args(obj)
+        try:
+            texts = extract_group(r"^\((.*)\)$", text, flags=DOTALL).split(", ")
+        except ExtractGroupError:
+            raise ParseTextError(obj=obj, text=text) from None
+        if len(args) != len(texts):
+            raise ParseTextError(obj=obj, text=text)
+        return tuple(
+            parse_text(arg, text, case_sensitive=case_sensitive, head=head)
+            for arg, text in zip(args, texts, strict=True)
+        )
     raise ParseTextError(obj=obj, text=text) from None
 
 

utilities/polars.py

@@ -726,10 +726,13 @@ def dataclass_to_schema(
     *,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
 ) -> SchemaDict:
     """Cast a dataclass as a schema dict."""
     out: dict[str, Any] = {}
-    for field in yield_fields(obj, globalns=globalns, localns=localns):
+    for field in yield_fields(
+        obj, globalns=globalns, localns=localns, warn_name_errors=warn_name_errors
+    ):
         if is_dataclass_instance(field.value):
             dtypes = dataclass_to_schema(
                 field.value, globalns=globalns, localns=localns
@@ -1388,12 +1391,15 @@ def struct_from_dataclass(
     *,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     time_zone: TimeZoneLike | None = None,
 ) -> Struct:
     """Construct the Struct data type for a dataclass."""
     if not is_dataclass_class(cls):
         raise _StructFromDataClassNotADataclassError(cls=cls)
-    anns = get_type_hints(cls, globalns=globalns, localns=localns)
+    anns = get_type_hints(
+        cls, globalns=globalns, localns=localns, warn_name_errors=warn_name_errors
+    )
     data_types = {
         k: _struct_from_dataclass_one(v, time_zone=time_zone) for k, v in anns.items()
     }

utilities/pytest_regressions.py

@@ -51,6 +51,7 @@ class OrjsonRegressionFixture:
         *,
         globalns: StrMapping | None = None,
         localns: StrMapping | None = None,
+        warn_name_errors: bool = False,
         dataclass_defaults: bool = False,
         suffix: str | None = None,
     ) -> None:
@@ -61,6 +62,7 @@ class OrjsonRegressionFixture:
             obj,
             globalns=globalns,
             localns=localns,
+            warn_name_errors=warn_name_errors,
             dataclass_defaults=dataclass_defaults,
         )
         basename = self._basename

utilities/python_dotenv.py

@@ -27,6 +27,7 @@ def load_settings(
     cwd: PathLike = PWD,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
     head: bool = False,
     case_sensitive: bool = False,
 ) -> TDataclass:
@@ -53,6 +54,7 @@ def load_settings(
             cls,
             globalns=globalns,
             localns=localns,
+            warn_name_errors=warn_name_errors,
             head=head,
             case_sensitive=case_sensitive,
             allow_extra=True,

utilities/typing.py

@@ -19,6 +19,7 @@ from typing import (
 from typing import get_args as _get_args
 from typing import get_type_hints as _get_type_hints
 from uuid import UUID
+from warnings import warn
 
 from utilities.iterables import unique_everseen
 from utilities.sentinel import Sentinel
@@ -68,16 +69,18 @@ def get_type_hints(
     *,
     globalns: StrMapping | None = None,
     localns: StrMapping | None = None,
+    warn_name_errors: bool = False,
 ) -> dict[str, Any]:
     """Get the type hints of an object."""
     result: dict[str, Any] = cls.__annotations__
     _ = {Literal, Path, Sentinel, StrMapping, UUID, dt}
-    globalns = globals() | ({} if globalns is None else dict(globalns))
-    localns = {} if localns is None else dict(localns)
+    globalns_use = globals() | ({} if globalns is None else dict(globalns))
+    localns_use = {} if localns is None else dict(localns)
     try:
-        hints = _get_type_hints(cls, globalns=globalns, localns=localns)
-    except NameError:
-        pass
+        hints = _get_type_hints(cls, globalns=globalns_use, localns=localns_use)
+    except NameError as error:
+        if warn_name_errors:
+            warn(f"Error getting type hints for {cls!r}; {error}", stacklevel=2)
     else:
         result.update({
             key: value
@@ -179,6 +182,14 @@ def is_set_type(obj: Any, /) -> bool:
 ##
 
 
+def is_tuple_type(obj: Any, /) -> bool:
+    """Check if an object is a tuple type annotation."""
+    return _is_annotation_of_type(obj, tuple)
+
+
+##
+
+
 def is_union_type(obj: Any, /) -> bool:
     """Check if an object is a union type annotation."""
     is_old_union = _is_annotation_of_type(obj, Union)  # pyright: ignore[reportDeprecated]
@@ -209,5 +220,6 @@ __all__ = [
     "is_optional_type",
     "is_sequence_type",
     "is_set_type",
+    "is_tuple_type",
     "is_union_type",
 ]