dycw-utilities 0.151.11__tar.gz → 0.152.0__tar.gz

{dycw_utilities-0.151.11 → dycw_utilities-0.152.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.151.11
+Version: 0.152.0
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -12,7 +12,7 @@ Provides-Extra: logging
 Requires-Dist: coloredlogs<15.1,>=15.0.1; extra == 'logging'
 Provides-Extra: test
 Requires-Dist: dycw-pytest-only<2.2,>=2.1.1; extra == 'test'
-Requires-Dist: hypothesis<6.137,>=6.136.1; extra == 'test'
+Requires-Dist: hypothesis<6.137,>=6.136.6; extra == 'test'
 Requires-Dist: pudb<2025.2,>=2025.1; extra == 'test'
 Requires-Dist: pytest-asyncio<1.2,>=1.1.0; extra == 'test'
 Requires-Dist: pytest-cov<6.3,>=6.2.1; extra == 'test'

{dycw_utilities-0.151.11 → dycw_utilities-0.152.0}/pyproject.toml

@@ -49,9 +49,6 @@ dev = [
   "pytest-cov >=6.2.1, <6.3",
   "pytest-timeout >=2.4.0, <2.5",
 ]
-dnspython = [
-  "dnspython >=2.7.0, <2.8",
-]
 eventkit = [
   "eventkit >=1.0.3, <1.1",
 ]
@@ -72,7 +69,7 @@ http-test = [
   "orjson",
 ]
 hypothesis = [
-  "hypothesis >=6.136.1, <6.137",
+  "hypothesis >=6.136.6, <6.137",
 ]
 hypothesis-test = [
   "libcst",
@@ -214,7 +211,7 @@ statsmodels = [
   "statsmodels >=0.14.4, <0.15",
 ]
 typed-settings = [
-  "typed-settings >=24.6.0, <24.7",
+  "typed-settings >=25.0.0, <25.1",
 ]
 tzdata = [
   "tzdata >=2025.2, <2025.3",
@@ -232,7 +229,7 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.151.11"
+version = "0.152.0"
 
 [project.entry-points.pytest11]
 pytest-randomly = "utilities.pytest_plugins.pytest_randomly"
@@ -244,7 +241,7 @@ logging = [
 ]
 test = [
   "dycw-pytest-only >=2.1.1, <2.2",
-  "hypothesis >=6.136.1, <6.137",
+  "hypothesis >=6.136.6, <6.137",
   "pudb >=2025.1, <2025.2",
   "pytest >=8.4.1, <8.5",
   "pytest-asyncio >=1.1.0, <1.2",
@@ -265,7 +262,7 @@ test = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.151.11"
+current_version = "0.152.0"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.151.11 → dycw_utilities-0.152.0}/src/tests/test_iterables.py

@@ -68,7 +68,6 @@ from utilities.iterables import (
     _RangePartitionsTotalError,
     _sort_iterable_cmp_floats,
     always_iterable,
-    always_iterable_hashable,
     apply_bijection,
     apply_to_tuple,
     apply_to_varargs,
@@ -166,27 +165,6 @@ class TestAlwaysIterable:
         assert list(always_iterable(yield_ints())) == [0, 1]
 
 
-class TestAlwaysIterableHashable:
-    def test_none(self) -> None:
-        assert always_iterable_hashable(None) is None
-
-    @given(x=integers())
-    def test_integer(self, *, x: int) -> None:
-        assert always_iterable_hashable(x) == (x,)
-
-    @given(x=text())
-    def test_string(self, *, x: str) -> None:
-        assert always_iterable_hashable(x) == (x,)
-
-    @given(x=lists(integers()))
-    def test_list_of_integers(self, *, x: list[int]) -> None:
-        assert always_iterable_hashable(x) == tuple(x)
-
-    @given(x=lists(text()))
-    def test_list_of_strings(self, *, x: list[str]) -> None:
-        assert always_iterable_hashable(x) == tuple(x)
-
-
 class TestApplyBijection:
     @given(text=text_ascii())
     def test_main(self, *, text: str) -> None:

{dycw_utilities-0.151.11 → dycw_utilities-0.152.0}/src/tests/test_polars.py

@@ -147,6 +147,7 @@ from utilities.polars import (
     cross_rolling_quantile,
     dataclass_to_dataframe,
     dataclass_to_schema,
+    decreasing_horizontal,
     deserialize_dataframe,
     deserialize_series,
     drop_null_struct_series,
@@ -159,6 +160,7 @@ from utilities.polars import (
     get_expr_name,
     get_frequency_spectrum,
     get_series_number_of_decimals,
+    increasing_horizontal,
     insert_after,
     insert_before,
     insert_between,
@@ -1594,6 +1596,39 @@ class TestGetSeriesNumberOfDecimals:
             _ = get_series_number_of_decimals(Series(dtype=Float64))
 
 
+class TestIncreasingAndDecreasingHorizontal:
+    def test_main(self) -> None:
+        df = DataFrame(
+            data=[(1, 2, 3), (1, 3, 2), (2, 1, 3), (2, 3, 1), (3, 1, 2), (3, 2, 1)],
+            schema={"x": Int64, "y": Int64, "z": Int64},
+            orient="row",
+        ).with_columns(
+            increasing_horizontal("x", "y", "z").alias("inc"),
+            decreasing_horizontal("x", "y", "z").alias("dec"),
+        )
+        inc = Series(
+            name="inc", values=[True, False, False, False, False, False], dtype=Boolean
+        )
+        assert_series_equal(df["inc"], inc)
+        dec = Series(
+            name="dec", values=[False, False, False, False, False, True], dtype=Boolean
+        )
+        assert_series_equal(df["dec"], dec)
+
+    def test_empty(self) -> None:
+        df = (
+            Series(name="x", values=[1, 2, 3], dtype=Int64)
+            .to_frame()
+            .with_columns(
+                increasing_horizontal().alias("inc"),
+                decreasing_horizontal().alias("dec"),
+            )
+        )
+        expected = Series(values=[True, True, True], dtype=Boolean)
+        assert_series_equal(df["inc"], expected, check_names=False)
+        assert_series_equal(df["dec"], expected, check_names=False)
+
+
 class TestInsertBeforeOrAfter:
     df: ClassVar[DataFrame] = DataFrame(schema={"a": Int64, "b": Int64, "c": Int64})
 

{dycw_utilities-0.151.11 → dycw_utilities-0.152.0}/src/tests/test_postgres.py

@@ -23,8 +23,6 @@ from utilities.typing import get_literal_elements
 if TYPE_CHECKING:
     from pathlib import Path
 
-    from utilities.types import MaybeListStr
-
 
 @composite
 def tables(draw: DrawFn, /) -> list[Table | str]:
@@ -68,8 +66,8 @@ class TestPGDump:
         format_: _PGDumpFormat,
         jobs: int | None,
         create: bool,
-        extension: MaybeListStr | None,
-        extension_exc: MaybeListStr | None,
+        extension: list[str] | None,
+        extension_exc: list[str] | None,
         schema: list[str] | None,
         schema_exc: list[str] | None,
         table: list[Table | str] | None,

{dycw_utilities-0.151.11 → dycw_utilities-0.152.0}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.151.11"
+__version__ = "0.152.0"

{dycw_utilities-0.151.11 → dycw_utilities-0.152.0}/src/utilities/iterables.py

@@ -46,7 +46,7 @@ from utilities.types import SupportsAdd, SupportsLT
 if TYPE_CHECKING:
     from types import NoneType
 
-    from utilities.types import MaybeIterable, MaybeIterableHashable, Sign, StrMapping
+    from utilities.types import MaybeIterable, Sign, StrMapping
 
 
 ##
@@ -66,16 +66,6 @@ def always_iterable[T](obj: MaybeIterable[T], /) -> Iterable[T]:
 ##
 
 
-def always_iterable_hashable[T](
-    obj: MaybeIterable[T] | None, /
-) -> MaybeIterableHashable[T] | None:
-    """Ensure an object is always hashable."""
-    return None if obj is None else tuple(always_iterable(obj))
-
-
-##
-
-
 def apply_bijection[T, U](
     func: Callable[[T], U], iterable: Iterable[T], /
 ) -> Mapping[T, U]:
@@ -1489,7 +1479,6 @@ __all__ = [
     "ResolveIncludeAndExcludeError",
     "SortIterableError",
     "always_iterable",
-    "always_iterable_hashable",
     "apply_bijection",
     "apply_to_tuple",
     "apply_to_varargs",

{dycw_utilities-0.151.11 → dycw_utilities-0.152.0}/src/utilities/polars.py

@@ -7,7 +7,7 @@ from collections.abc import Set as AbstractSet
 from contextlib import suppress
 from dataclasses import asdict, dataclass
 from functools import partial, reduce
-from itertools import chain, product
+from itertools import chain, pairwise, product
 from math import ceil, log
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, Literal, assert_never, cast, overload, override
@@ -1471,6 +1471,37 @@ class _GetSeriesNumberOfDecimalsAllNullError(GetSeriesNumberOfDecimalsError):
 ##
 
 
+@overload
+def increasing_horizontal(*columns: ExprLike) -> Expr: ...
+@overload
+def increasing_horizontal(*columns: Series) -> Series: ...
+@overload
+def increasing_horizontal(*columns: IntoExprColumn) -> Expr | Series: ...
+def increasing_horizontal(*columns: IntoExprColumn) -> Expr | Series:
+    """Check if a set of columns are increasing."""
+    columns2 = ensure_expr_or_series_many(*columns)
+    if len(columns2) == 0:
+        return lit(value=True, dtype=Boolean)
+    return all_horizontal(prev < curr for prev, curr in pairwise(columns2))
+
+
+@overload
+def decreasing_horizontal(*columns: ExprLike) -> Expr: ...
+@overload
+def decreasing_horizontal(*columns: Series) -> Series: ...
+@overload
+def decreasing_horizontal(*columns: IntoExprColumn) -> Expr | Series: ...
+def decreasing_horizontal(*columns: IntoExprColumn) -> Expr | Series:
+    """Check if a set of columns are decreasing."""
+    columns2 = ensure_expr_or_series_many(*columns)
+    if len(columns2) == 0:
+        return lit(value=True, dtype=Boolean)
+    return all_horizontal(prev > curr for prev, curr in pairwise(columns2))
+
+
+##
+
+
 def insert_after(df: DataFrame, column: str, value: IntoExprColumn, /) -> DataFrame:
     """Insert a series after an existing column; not in-place."""
     columns = df.columns
@@ -2472,6 +2503,7 @@ __all__ = [
     "cross",
     "dataclass_to_dataframe",
     "dataclass_to_schema",
+    "decreasing_horizontal",
     "deserialize_dataframe",
     "drop_null_struct_series",
     "ensure_data_type",
@@ -2483,6 +2515,7 @@ __all__ = [
     "get_expr_name",
     "get_frequency_spectrum",
     "get_series_number_of_decimals",
+    "increasing_horizontal",
     "insert_after",
     "insert_before",
     "insert_between",

{dycw_utilities-0.151.11 → dycw_utilities-0.152.0}/src/utilities/redis.py

@@ -35,7 +35,7 @@ if TYPE_CHECKING:
     from redis.typing import EncodableT
 
     from utilities.iterables import MaybeIterable
-    from utilities.types import Delta, MaybeListStr, MaybeSequence, MaybeType, TypeLike
+    from utilities.types import Delta, MaybeSequence, MaybeType, TypeLike
 
 
 _PUBLISH_TIMEOUT: Delta = SECOND
@@ -583,7 +583,7 @@ class PublishError(Exception):
 async def publish_many[T](
     redis: Redis,
     channel: str,
-    data: MaybeSequence[bytes | T] | MaybeListStr,
+    data: MaybeSequence[bytes | str | T],
     /,
     *,
     serializer: Callable[[T], EncodableT] | None = None,

{dycw_utilities-0.151.11 → dycw_utilities-0.152.0}/src/utilities/types.py

@@ -2,15 +2,7 @@ from __future__ import annotations
 
 import datetime as dt
 from asyncio import Event
-from collections.abc import (
-    Callable,
-    Collection,
-    Coroutine,
-    Hashable,
-    Iterable,
-    Mapping,
-    Sequence,
-)
+from collections.abc import Callable, Collection, Coroutine, Iterable, Mapping
 from enum import Enum
 from ipaddress import IPv4Address, IPv6Address
 from logging import Logger
@@ -123,20 +115,16 @@ IPv6AddressLike = MaybeStr[IPv6Address]
 
 
 # iterables
-type IterableHashable[T: Hashable] = tuple[T, ...] | frozenset[T]
 type MaybeCollection[T] = T | Collection[T]
-type MaybeIterableHashable[T: Hashable] = T | IterableHashable[T]
 type MaybeIterable[T] = T | Iterable[T]
-type MaybeList[T] = T | list[T]
-type MaybeSequence[T] = T | Sequence[T]
+type MaybeSequence[T] = T | SequenceLT[T]
+type SequenceLT[T] = list[T] | tuple[T, ...]
 # iterables - str
-type CollectionStr = (
-    dict[str, Any] | frozenset[str] | list[str] | set[str] | tuple[str, ...]
-)
+type SequenceStr = SequenceLT[str]
+type CollectionStr = dict[str, Any] | frozenset[str] | set[str] | SequenceStr
+# iterables - maybe str
 type MaybeCollectionStr = str | CollectionStr
-type MaybeListStr = MaybeList[str]
 type MaybeSequenceStr = str | SequenceStr
-type SequenceStr = list[str] | tuple[str, ...]
 
 
 # logging
@@ -288,7 +276,6 @@ __all__ = [
     "ExceptionTypeLike",
     "IPv4AddressLike",
     "IPv6AddressLike",
-    "IterableHashable",
     "LogLevel",
     "LoggerOrName",
     "MathRoundMode",
@@ -303,9 +290,6 @@ __all__ = [
     "MaybeCollectionStr",
     "MaybeCoro",
     "MaybeIterable",
-    "MaybeIterableHashable",
-    "MaybeList",
-    "MaybeListStr",
     "MaybeSequence",
     "MaybeSequenceStr",
     "MaybeStr",

dycw_utilities-0.151.11/src/tests/test_dnspython.py

@@ -1,14 +0,0 @@
-from __future__ import annotations
-
-from ipaddress import IPv4Address
-
-from tests.conftest import SKIPIF_CI_AND_MAC
-from utilities.dnspython import nslookup
-
-
-class TestNSLookup:
-    @SKIPIF_CI_AND_MAC
-    def test_main(self) -> None:
-        result = nslookup("localhost")
-        expected = [IPv4Address("127.0.0.1")]
-        assert result == expected

dycw_utilities-0.151.11/src/utilities/dnspython.py

@@ -1,17 +0,0 @@
-from __future__ import annotations
-
-from ipaddress import IPv4Address
-
-from dns.resolver import resolve
-
-from utilities.functools import cache
-
-
-@cache
-def nslookup(address: str, /) -> list[IPv4Address]:
-    """Look up a set of addresses."""
-    ans = resolve(address)  # skipif-ci-and-mac
-    return [IPv4Address(str(rd)) for rd in ans]  # skipif-ci-and-mac
-
-
-__all__ = ["nslookup"]