dycw-utilities 0.108.4__py3-none-any.whl → 0.109.0__py3-none-any.whl

{dycw_utilities-0.108.4.dist-info → dycw_utilities-0.109.0.dist-info}/METADATA

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

{dycw_utilities-0.108.4.dist-info → dycw_utilities-0.109.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=-2lmFv1UZnPQpN8IvJ-ViPH2DA03IC4wyaSgQYQI0zc,60
+utilities/__init__.py,sha256=us3aLi645m07ZoZciss9gQZW8TJND1cejqEh_im4aL8,60
 utilities/altair.py,sha256=NSyDsm8QlkAGmsGdxVwCkHnPxt_35yJBa9Lg7bz9Ays,9054
 utilities/astor.py,sha256=xuDUkjq0-b6fhtwjhbnebzbqQZAjMSHR1IIS5uOodVg,777
 utilities/asyncio.py,sha256=41oQUurWMvadFK5gFnaG21hMM0Vmfn2WS6OpC0R9mas,14757
@@ -40,12 +40,12 @@ utilities/operator.py,sha256=0M2yZJ0PODH47ogFEnkGMBe_cfxwZR02T_92LZVZvHo,3715
 utilities/optuna.py,sha256=loyJGWTzljgdJaoLhP09PT8Jz6o_pwBOwehY33lHkhw,1923
 utilities/orjson.py,sha256=DW5pOpMyrR5Q8caQYly9AqRPazDBqrWv5GRWfULqka4,36291
 utilities/os.py,sha256=D_FyyT-6TtqiN9KSS7c9g1fnUtgxmyMtzAjmYLkk46A,3587
-utilities/parse.py,sha256=vKVWIqR5JykQzPSnMHQr7_h43M6TwfYEnPmjmbgSA-o,4585
+utilities/parse.py,sha256=yLLH51VNwmcWbEvwqh6M-weWt7NIayd7No67Oe80S3k,4585
 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=ENkJunh7goUT0IOQ9LFbh-AFj7plC5ePKHBsnXk6slo,52122
+utilities/polars.py,sha256=ZXiHLkn6CbRh0_e0db5KRjHPU0LAedwzGno7k9fsiIo,48917
 utilities/pqdm.py,sha256=foRytQybmOQ05pjt5LF7ANyzrIa--4ScDE3T2wd31a4,3118
 utilities/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 utilities/pydantic.py,sha256=f6qtR5mO2YMuyvNmbaEj5YeD9eGA4YYfb7Bjzh9jUs0,1845
@@ -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.108.4.dist-info/METADATA,sha256=rAF0wyx5NT-CYkx5Meatz3jzjaRSMeBHx6mSCdfBcM8,13004
-dycw_utilities-0.108.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dycw_utilities-0.108.4.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
-dycw_utilities-0.108.4.dist-info/RECORD,,
+dycw_utilities-0.109.0.dist-info/METADATA,sha256=7Urd3hro439NaLJ2Kkzu7mJNlYt5qxb3HmbzrcZwbkQ,13004
+dycw_utilities-0.109.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dycw_utilities-0.109.0.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
+dycw_utilities-0.109.0.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.108.4"
+__version__ = "0.109.0"

utilities/parse.py

@@ -6,7 +6,7 @@ from dataclasses import dataclass
 from enum import Enum
 from pathlib import Path
 from types import NoneType
-from typing import Any, get_args, override
+from typing import Any, override
 
 from utilities.datetime import is_subclass_date_not_datetime
 from utilities.enum import ParseEnumError, parse_enum
@@ -14,7 +14,7 @@ from utilities.functions import is_subclass_int_not_bool
 from utilities.iterables import one, one_str
 from utilities.sentinel import ParseSentinelError, Sentinel, parse_sentinel
 from utilities.text import ParseBoolError, ParseNoneError, parse_bool, parse_none
-from utilities.typing import is_literal_type, is_optional_type
+from utilities.typing import get_args, is_literal_type, is_optional_type
 from utilities.version import ParseVersionError, Version, parse_version
 
 

utilities/polars.py

@@ -71,7 +71,6 @@ from utilities.iterables import (
     CheckMappingsEqualError,
     CheckSubSetError,
     CheckSuperMappingError,
-    CheckSuperSetError,
     OneEmptyError,
     OneNonUniqueError,
     always_iterable,
@@ -79,7 +78,6 @@ from utilities.iterables import (
     check_mappings_equal,
     check_subset,
     check_supermapping,
-    check_superset,
     is_iterable_not_str,
     one,
 )
@@ -92,7 +90,6 @@ from utilities.math import (
     number_of_decimals,
 )
 from utilities.reprlib import get_repr
-from utilities.sentinel import Sentinel
 from utilities.types import MaybeStr, Number, WeekDay
 from utilities.typing import (
     get_args,
@@ -1484,100 +1481,6 @@ def week_num(column: IntoExprColumn, /, *, start: WeekDay = "mon") -> Expr | Ser
 ##
 
 
-def yield_rows_as_dataclasses(
-    df: DataFrame,
-    cls: type[TDataclass],
-    /,
-    *,
-    globalns: StrMapping | None = None,
-    localns: StrMapping | None = None,
-    check_types: Literal["none", "first", "all"] = "first",
-) -> Iterator[TDataclass]:
-    """Yield the rows of a DataFrame as dataclasses."""
-    from dacite import from_dict
-    from dacite.exceptions import WrongTypeError
-
-    columns = df.columns
-    required: set[str] = set()
-    for field in yield_fields(cls, globalns=globalns, localns=localns):
-        if isinstance(field.default, Sentinel) and isinstance(
-            field.default_factory, Sentinel
-        ):
-            required.add(field.name)
-    try:
-        check_superset(columns, required)
-    except CheckSuperSetError as error:
-        raise _YieldRowsAsDataClassesColumnsSuperSetError(
-            df=df, cls=cls, left=error.left, right=error.right, extra=error.extra
-        ) from None
-    rows = df.iter_rows(named=True)
-    match check_types:
-        case "none":
-            yield from _yield_rows_as_dataclasses_no_check_types(rows, cls)
-        case "first":
-            try:
-                first = next(rows)
-            except StopIteration:
-                return
-            try:
-                yield from_dict(cls, cast("Data", first))
-            except WrongTypeError as error:
-                raise _YieldRowsAsDataClassesWrongTypeError(
-                    df=df, cls=cls, msg=str(error)
-                ) from None
-            yield from _yield_rows_as_dataclasses_no_check_types(rows, cls)
-        case "all":
-            try:
-                for row in rows:
-                    yield from_dict(cls, cast("Data", row))
-            except WrongTypeError as error:
-                raise _YieldRowsAsDataClassesWrongTypeError(
-                    df=df, cls=cls, msg=str(error)
-                ) from None
-        case _ as never:
-            assert_never(never)
-
-
-def _yield_rows_as_dataclasses_no_check_types(
-    rows: Iterator[dict[str, Any]], cls: type[TDataclass], /
-) -> Iterator[TDataclass]:
-    """Yield the rows of a DataFrame as dataclasses without type checking."""
-    from dacite import Config, from_dict
-
-    config = Config(check_types=False)
-    for row in rows:
-        yield from_dict(cls, cast("Data", row), config=config)
-
-
-@dataclass(kw_only=True, slots=True)
-class YieldRowsAsDataClassesError(Exception):
-    df: DataFrame
-    cls: type[Dataclass]
-
-
-@dataclass(kw_only=True, slots=True)
-class _YieldRowsAsDataClassesColumnsSuperSetError(YieldRowsAsDataClassesError):
-    left: AbstractSet[str]
-    right: AbstractSet[str]
-    extra: AbstractSet[str]
-
-    @override
-    def __str__(self) -> str:
-        return f"DataFrame columns {get_repr(self.left)} must be a superset of dataclass fields {get_repr(self.right)}; dataclass had extra fields {get_repr(self.extra)}."
-
-
-@dataclass(kw_only=True, slots=True)
-class _YieldRowsAsDataClassesWrongTypeError(YieldRowsAsDataClassesError):
-    msg: str
-
-    @override
-    def __str__(self) -> str:
-        return self.msg
-
-
-##
-
-
 @overload
 def yield_struct_series_elements(
     series: Series, /, *, strict: Literal[True]
@@ -1714,7 +1617,6 @@ __all__ = [
     "IsNullStructSeriesError",
     "SetFirstRowAsColumnsError",
     "StructFromDataClassError",
-    "YieldRowsAsDataClassesError",
     "YieldStructSeriesElementsError",
     "append_dataclass",
     "are_frames_equal",
@@ -1749,7 +1651,6 @@ __all__ = [
     "struct_from_dataclass",
     "touch",
     "unique_element",
-    "yield_rows_as_dataclasses",
     "yield_struct_series_dataclasses",
     "yield_struct_series_elements",
     "zoned_datetime",