dycw-utilities 0.109.24__py3-none-any.whl → 0.109.26__py3-none-any.whl

{dycw_utilities-0.109.24.dist-info → dycw_utilities-0.109.26.dist-info}/METADATA

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

{dycw_utilities-0.109.24.dist-info → dycw_utilities-0.109.26.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=lTcMVKZy93oLWx7dgqyW_K3S_kxMyIwptBXIvNDLsl8,61
+utilities/__init__.py,sha256=u3bOXUZkUtu44-KigskBo_7SPJ0LgayUw3iTPoGATOo,61
 utilities/altair.py,sha256=Gpja-flOo-Db0PIPJLJsgzAlXWoKUjPU1qY-DQ829ek,9156
 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=rQS-G-JwhQNufV80aThSOD_ENliueqkz4N6NqtTTPN8,23294
+utilities/dataclasses.py,sha256=8-38WHrScAvElBNvFxBnhJwab1XXkSXpDOiNPOAvh2Q,23295
 utilities/datetime.py,sha256=GOs-MIEW_A49kzqa1yhIoeNeSqqPVgGO-h2AThtgTDk,37326
 utilities/enum.py,sha256=HoRwVCWzsnH0vpO9ZEcAAIZLMv0Sn2vJxxA4sYMQgDs,5793
 utilities/errors.py,sha256=BtSNP0JC3ik536ddPyTerLomCRJV9f6kdMe6POz0QHM,361
@@ -73,11 +73,11 @@ utilities/streamlit.py,sha256=U9PJBaKP1IdSykKhPZhIzSPTZsmLsnwbEPZWzNhJPKk,2955
 utilities/sys.py,sha256=h0Xr7Vj86wNalvwJVP1wj5Y0kD_VWm1vzuXZ_jw94mE,2743
 utilities/tempfile.py,sha256=VqmZJAhTJ1OaVywFzk5eqROV8iJbW9XQ_QYAV0bpdRo,1384
 utilities/tenacity.py,sha256=1PUvODiBVgeqIh7G5TRt5WWMSqjLYkEqP53itT97WQc,4914
-utilities/text.py,sha256=fKPnh_wNFRXF1mM1CkTUUlBUrAj7Mf2xDGnHfrUepQs,4775
+utilities/text.py,sha256=Ax_n-nY80_onWxag9M0PkmbaAqwyut9AEA9tEMd5lBs,6694
 utilities/threading.py,sha256=GvBOp4CyhHfN90wGXZuA2VKe9fGzMaEa7oCl4f3nnPU,1009
 utilities/timer.py,sha256=Rkc49KSpHuC8s7vUxGO9DU55U9I6yDKnchsQqrUCVBs,4075
 utilities/traceback.py,sha256=KwHPLdEbdj0fFhXo8MBfxcvem8A-VXYDwFMNJ6f0cTM,27328
-utilities/types.py,sha256=fkaqL67A_1p0-Q88JTu1dt_GV3mVo5mSslYa9DGWNq4,17903
+utilities/types.py,sha256=z1hbBOT5TkzTn2JOvSldw6DScxi3erG9qpJ3xci66GI,17963
 utilities/typing.py,sha256=gLg4EbE1FX52fJ1d3ji4i08qolwu9qgWt8w_w_Y5DTk,5512
 utilities/tzdata.py,sha256=2ZsPmhTVM9Ptrxb4QrWKtKOB9RiH8IOO-A1u7ULdVbg,176
 utilities/tzlocal.py,sha256=42BCquGF54oIqIKe5RGziP4K8Nbm3Ey7uqcNn6m5ge8,534
@@ -87,7 +87,7 @@ utilities/warnings.py,sha256=yUgjnmkCRf6QhdyAXzl7u0qQFejhQG3PrjoSwxpbHrs,1819
 utilities/whenever.py,sha256=TjoTAJ1R27-rKXiXzdE4GzPidmYqm0W58XydDXp-QZM,17786
 utilities/zipfile.py,sha256=24lQc9ATcJxHXBPc_tBDiJk48pWyRrlxO2fIsFxU0A8,699
 utilities/zoneinfo.py,sha256=-DQz5a0Ikw9jfSZtL0BEQkXOMC9yGn_xiJYNCLMiqEc,1989
-dycw_utilities-0.109.24.dist-info/METADATA,sha256=qsqFi_RWRE2umffrznAhmCyC9F_zn5VwAbpMoaqO8iw,13005
-dycw_utilities-0.109.24.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dycw_utilities-0.109.24.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
-dycw_utilities-0.109.24.dist-info/RECORD,,
+dycw_utilities-0.109.26.dist-info/METADATA,sha256=aJEgBNp03JxSJvRWENUjCb_0CqvmCZktjl1S-XNYfDQ,13005
+dycw_utilities-0.109.26.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dycw_utilities-0.109.26.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
+dycw_utilities-0.109.26.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.109.24"
+__version__ = "0.109.26"

utilities/dataclasses.py

@@ -24,7 +24,7 @@ from utilities.iterables import OneStrEmptyError, OneStrNonUniqueError, one_str
 from utilities.operator import is_equal
 from utilities.parse import ParseTextError, parse_text
 from utilities.sentinel import Sentinel, sentinel
-from utilities.types import ParseTextExtra, TDataclass
+from utilities.types import ParseTextExtra, StrStrMapping, TDataclass
 from utilities.typing import get_type_hints
 
 if TYPE_CHECKING:
@@ -444,7 +444,7 @@ class StrMappingToFieldMappingError(Exception):
 
 
 def text_to_dataclass(
-    text_or_mapping: str | Mapping[str, str],
+    text_or_mapping: str | StrStrMapping,
     cls: type[TDataclass],
     /,
     *,
@@ -499,9 +499,7 @@ def text_to_dataclass(
     )
 
 
-def _text_to_dataclass_split_text(
-    text: str, cls: type[TDataclass], /
-) -> Mapping[str, str]:
+def _text_to_dataclass_split_text(text: str, cls: type[TDataclass], /) -> StrStrMapping:
     pairs = (t for t in text.split(",") if t != "")
     return dict(_text_to_dataclass_split_key_value_pair(pair, cls) for pair in pairs)
 

utilities/text.py

@@ -6,8 +6,13 @@ from re import IGNORECASE, Match, search
 from textwrap import dedent
 from typing import TYPE_CHECKING, Any, Literal, overload, override
 
+from utilities.iterables import CheckDuplicatesError, check_duplicates
+from utilities.reprlib import get_repr
+
 if TYPE_CHECKING:
-    from collections.abc import Iterable, Sequence
+    from collections.abc import Iterable, Mapping, Sequence
+
+    from utilities.types import StrStrMapping
 
 
 def parse_bool(text: str, /) -> bool:
@@ -81,14 +86,81 @@ def _snake_case_title(match: Match[str], /) -> str:
 ##
 
 
+@overload
+def split_key_value_pairs(
+    text: str,
+    /,
+    *,
+    list_separator: str = ",",
+    pair_separator: str = "=",
+    mapping: Literal[True],
+) -> StrStrMapping: ...
+@overload
+def split_key_value_pairs(
+    text: str,
+    /,
+    *,
+    list_separator: str = ",",
+    pair_separator: str = "=",
+    mapping: Literal[False] = False,
+) -> Sequence[tuple[str, str]]: ...
+@overload
+def split_key_value_pairs(
+    text: str,
+    /,
+    *,
+    list_separator: str = ",",
+    pair_separator: str = "=",
+    mapping: bool = False,
+) -> Sequence[tuple[str, str]] | StrStrMapping: ...
 def split_key_value_pairs(
-    text: str, /, *, list_separator: str = ",", pair_separator: str = "="
-) -> Sequence[tuple[str, str]]:
+    text: str,
+    /,
+    *,
+    list_separator: str = ",",
+    pair_separator: str = "=",
+    mapping: bool = False,
+) -> Sequence[tuple[str, str]] | StrStrMapping:
     """Split a string into key-value pairs."""
-    return [
-        split_str(text_i, separator=pair_separator, n=2)
-        for text_i in split_str(text, separator=list_separator)
-    ]
+    try:
+        pairs = [
+            split_str(text_i, separator=pair_separator, n=2)
+            for text_i in split_str(text, separator=list_separator)
+        ]
+    except SplitStrError as error:
+        raise _SplitKeyValuePairsSplitError(text=text, inner=error.text) from None
+    if not mapping:
+        return pairs
+    try:
+        check_duplicates(k for k, _ in pairs)
+    except CheckDuplicatesError as error:
+        raise _SplitKeyValuePairsDuplicateKeysError(
+            text=text, counts=error.counts
+        ) from None
+    return dict(pairs)
+
+
+@dataclass(kw_only=True, slots=True)
+class SplitKeyValuePairsError(Exception):
+    text: str
+
+
+@dataclass(kw_only=True, slots=True)
+class _SplitKeyValuePairsSplitError(SplitKeyValuePairsError):
+    inner: str
+
+    @override
+    def __str__(self) -> str:
+        return f"Unable to split {self.text!r} into key-value pairs; got {self.inner!r}"
+
+
+@dataclass(kw_only=True, slots=True)
+class _SplitKeyValuePairsDuplicateKeysError(SplitKeyValuePairsError):
+    counts: Mapping[str, int]
+
+    @override
+    def __str__(self) -> str:
+        return f"Unable to split {self.text!r} into a mapping since there are duplicate keys; got {get_repr(self.counts)}"
 
 
 ##
@@ -182,6 +254,7 @@ def strip_and_dedent(text: str, /, *, trailing: bool = False) -> str:
 __all__ = [
     "ParseBoolError",
     "ParseNoneError",
+    "SplitKeyValuePairsError",
     "SplitStrError",
     "join_strs",
     "parse_bool",

utilities/types.py

@@ -46,6 +46,7 @@ type OpenMode = Literal[
     "a+b",
 ]
 type StrMapping = Mapping[str, Any]
+type StrStrMapping = Mapping[str, str]
 type TupleOrStrMapping = tuple[Any, ...] | StrMapping
 type MaybeCallable[_T] = _T | Callable[[], _T]
 type MaybeStr[_T] = _T | str
@@ -288,6 +289,7 @@ __all__ = [
     "RoundMode",
     "Seed",
     "StrMapping",
+    "StrStrMapping",
     "SupportsAbs",
     "SupportsAdd",
     "SupportsBytes",