klaatu-python 2.5.0__py3-none-any.whl → 2.7.0__py3-none-any.whl

klaatu_python/utils/__init__.py

@@ -1,6 +1,7 @@
 from .dicts import filter_values_not_null, group_by, group_dicts, zip_dict_lists, zip_dicts
 from .iterables import (
     circulate,
+    count_distinct,
     first_not_null,
     first_not_null_or_null,
     getitem0,
@@ -10,6 +11,7 @@ from .iterables import (
     most_common,
     nonulls,
     partition,
+    seq_contains_seq,
 )
 from .numbers import (
     can_coerce_to_int,
@@ -25,7 +27,7 @@ from .numbers import (
 )
 from .paths import deepest_common_path, sanitize_path
 from .strings import fancy_join
-from .time import daterange, round_up_timedelta
+from .time import date_to_timestamp_ms, daterange, round_to_whole_hour, round_up_timedelta
 from .urls import append_query_to_url, strip_url_query
 from .various import get_binary_reply, is_truthy
 
@@ -35,6 +37,8 @@ __all__ = [
     "can_coerce_to_int",
     "circulate",
     "coerce_between",
+    "count_distinct",
+    "date_to_timestamp_ms",
     "daterange",
     "deepest_common_path",
     "fancy_join",
@@ -58,9 +62,11 @@ __all__ = [
     "percent_rounded",
     "roman",
     "round_to_n",
+    "round_to_whole_hour",
     "round_up_timedelta",
     "rounded_percentage",
     "sanitize_path",
+    "seq_contains_seq",
     "strip_url_query",
     "to_int",
     "zip_dict_lists",

klaatu_python/utils/iterables.py

@@ -20,6 +20,21 @@ def circulate(lst: Iterable[_T], rounds: int) -> list[_T]:
     return lst
 
 
+def count_distinct(values: Iterable[_HashableT]) -> dict[_HashableT, int]:
+    """
+    Returns a dict where the keys are distinct values from `values`, and the
+    values are the number of occurances of each value.
+    """
+    occurrences: dict[_HashableT, int] = {}
+
+    for value in values:
+        if value not in occurrences:
+            occurrences[value] = 0
+        occurrences[value] += 1
+
+    return occurrences
+
+
 def first_not_null(*values: _T | None) -> _T:
     ret = first_not_null_or_null(*values)
     if ret is None:
@@ -104,12 +119,7 @@ def most_common(values: Iterable[_HashableT]) -> tuple[_HashableT | None, int]:
 
     Given an _empty_ iterable, it will return `(None, 0)`.
     """
-    occurrences: dict[_HashableT, int] = {}
-
-    for value in values:
-        if value not in occurrences:
-            occurrences[value] = 0
-        occurrences[value] += 1
+    occurrences = count_distinct(values)
 
     if not occurrences:
         return None, 0
@@ -128,3 +138,12 @@ def partition(items: Sequence[_T], length: int) -> Iterator[Sequence[_T]]:
     while offset == 0 or offset < len(items):
         yield items[offset : offset + length]
         offset += length
+
+
+def seq_contains_seq(container: Sequence, containee: Sequence) -> bool:
+    if len(containee) > len(container):
+        return False
+    for idx in range(len(container) - len(containee) + 1):
+        if container[idx : idx + len(containee)] == containee:
+            return True
+    return False

klaatu_python/utils/time.py

@@ -1,8 +1,16 @@
+import datetime
 from collections.abc import Iterator
 from datetime import date, timedelta
 from math import ceil
 
 
+def date_to_timestamp_ms(date: datetime.date, tzinfo: datetime.tzinfo = datetime.timezone.utc) -> int:
+    epoch = datetime.datetime(1970, 1, 1, tzinfo=datetime.timezone.utc)
+    dt = datetime.datetime(date.year, date.month, date.day, tzinfo=tzinfo)
+
+    return int((dt - epoch).total_seconds() * 1000)
+
+
 def daterange(start_date: date, end_date: date) -> Iterator[date]:
     """
     Iterates the dates between `start_date` (inclusive) and `end_date`
@@ -12,6 +20,11 @@ def daterange(start_date: date, end_date: date) -> Iterator[date]:
         yield start_date + timedelta(days=n)
 
 
+def round_to_whole_hour(d: datetime.datetime | None = None) -> datetime.datetime:
+    d = d or datetime.datetime.now()
+    return datetime.datetime(year=d.year, month=d.month, day=d.day, hour=d.hour, tzinfo=d.tzinfo)
+
+
 def round_up_timedelta(td: timedelta) -> timedelta:
     """
     If td > 30 min, round up to nearest hour. Otherwise, to nearest 10

{klaatu_python-2.5.0.dist-info → klaatu_python-2.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: klaatu-python
-Version: 2.5.0
+Version: 2.7.0
 Author: Robert Huselius
 Author-email: Robert Huselius <robert@huseli.us>
 License-Expression: GPL-3.0-only
@@ -13,6 +13,8 @@ Description-Content-Type: text/markdown
 
 # klaatu-python
 
+<img width="500" alt="thisprojectwascodedbyahumanbeing-wordart" src="https://github.com/user-attachments/assets/83071cfd-5aec-4a4d-897d-8aa4a933fa31" />
+
 A bunch of more or less useful Python utils without _any_ 3rd party dependencies.
 
 ## Development install

{klaatu_python-2.5.0.dist-info → klaatu_python-2.7.0.dist-info}/RECORD

@@ -1,16 +1,16 @@
 klaatu_python/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 klaatu_python/case.py,sha256=6FJuXXOWsJg786ftEafunjngjeOvpB3F3WP1a2wlQ9Y,1798
 klaatu_python/lock.py,sha256=D--5HjqAgtflOtNjp0klF8C_gXUjOrrT9YpKx4vFWn8,1393
-klaatu_python/utils/__init__.py,sha256=UlRL41R0cA-oHFpYideyIs9tO064imhth4tzsFNHIhw,1492
+klaatu_python/utils/__init__.py,sha256=o12-aSe4iewttGYx9IgNh2bu9yFP2uLPNxWbtosXApk,1678
 klaatu_python/utils/dicts.py,sha256=xeYvL_4ox9ykrUv964JwpGhacmGbm1Oyz03sq78CyoI,2702
-klaatu_python/utils/iterables.py,sha256=QCIOh4EiLE67460yMuwm5wyJl8CNOm8jz3VjrJbf6DM,3803
+klaatu_python/utils/iterables.py,sha256=WA0yFYj5LFHS5N-5MEADjBaQfjBo5ADTaoVSncJ-j60,4391
 klaatu_python/utils/numbers.py,sha256=b0_Eiwumw8-zoKrjNx70KDO-jGGKNbG8gGHQ_ACitwo,4787
 klaatu_python/utils/paths.py,sha256=8Yr92R5EE8tU_nE3_mjCmhZ3ftkl8FilMoCp9agT71c,1935
 klaatu_python/utils/strings.py,sha256=GTZb6gUeqhS-7rjwkrwynZ9kLFj0f55mSmFwEI1d5wQ,469
-klaatu_python/utils/time.py,sha256=sssUDMrD78T4EBpX85ds6iQySBkIC2GPbeuVhypAxGc,829
+klaatu_python/utils/time.py,sha256=EwuCBzTaLBWmcPXd9Vbgbpfwc4eQN-XbmJD_A--LQDU,1369
 klaatu_python/utils/urls.py,sha256=vV10t9nsX6bFCtHwtOqo0TEbsdFPJ73P2PALw_hyT8s,931
 klaatu_python/utils/various.py,sha256=cBNtf5AC7T7tCcIvxb5Q1AYQsGZMUlPFdu27wwQ_up0,775
-klaatu_python-2.5.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-klaatu_python-2.5.0.dist-info/WHEEL,sha256=s49dN1sxqzkgPplo4QuUaKomil-_cbDzeLK4-pZKD-A,81
-klaatu_python-2.5.0.dist-info/METADATA,sha256=mz9hjzW-K72e_Sd0ew56XK0LfQzqzEXuLQaceLyctHo,763
-klaatu_python-2.5.0.dist-info/RECORD,,
+klaatu_python-2.7.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+klaatu_python-2.7.0.dist-info/WHEEL,sha256=s49dN1sxqzkgPplo4QuUaKomil-_cbDzeLK4-pZKD-A,81
+klaatu_python-2.7.0.dist-info/METADATA,sha256=8nz7V5TTgsldYbGd3hVAsbnspMqGdjh7v7obXutn34I,917
+klaatu_python-2.7.0.dist-info/RECORD,,