dycw-utilities 0.138.0__py3-none-any.whl → 0.138.2__py3-none-any.whl

{dycw_utilities-0.138.0.dist-info → dycw_utilities-0.138.2.dist-info}/METADATA

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

{dycw_utilities-0.138.0.dist-info → dycw_utilities-0.138.2.dist-info}/RECORD

@@ -1,11 +1,11 @@
-utilities/__init__.py,sha256=-LD1QyR_P_VpkzFmNAkfoqYhCifIwYOuBQGhhpTr7lI,60
+utilities/__init__.py,sha256=rGNA-g7KeJXl2hGton-8NQ9cLlXVune9zy_gn79rBFU,60
 utilities/aiolimiter.py,sha256=mD0wEiqMgwpty4XTbawFpnkkmJS6R4JRsVXFUaoitSU,628
 utilities/altair.py,sha256=HeZBVUocjkrTNwwKrClppsIqgNFF-ykv05HfZSoHYno,9104
 utilities/asyncio.py,sha256=dcGeKQzjLBXxKzZkVIk5oZsFXEcynVbRB9iNB5XEDZk,38526
 utilities/atomicwrites.py,sha256=geFjn9Pwn-tTrtoGjDDxWli9NqbYfy3gGL6ZBctiqSo,5393
 utilities/atools.py,sha256=9im2g8OCf-Iynqa8bAv8N0Ycj9QvrJmGO7yLCZEdgII,986
 utilities/cachetools.py,sha256=v1-9sXHLdOLiwmkq6NB0OUbxeKBuVVN6wmAWefWoaHI,2744
-utilities/click.py,sha256=PToheYTcKmBwKOMHasZ36CKcMNmM005nKdvOCFUo5dw,16989
+utilities/click.py,sha256=9kncXtPzRQ_23j06q0RJDvyOsR5KPoKRfbXHqiBKYxo,17492
 utilities/concurrent.py,sha256=ZdhcNeBl1-HaAPY3h7bZ5ccuYdfdq2ATHplvZdnzlhk,2858
 utilities/contextlib.py,sha256=lpaLJBy3X0UGLWjM98jkQZZq8so4fRmoK-Bheq0uOW4,1027
 utilities/contextvars.py,sha256=RsSGGrbQqqZ67rOydnM7WWIsM2lIE31UHJLejnHJPWY,505
@@ -85,10 +85,10 @@ utilities/tzlocal.py,sha256=KyCXEgCTjqGFx-389JdTuhMRUaT06U1RCMdWoED-qro,728
 utilities/uuid.py,sha256=32p7DGHGM2Btx6PcBvCZvERSWbpupMXqx6FppPoSoTU,612
 utilities/version.py,sha256=ufhJMmI6KPs1-3wBI71aj5wCukd3sP_m11usLe88DNA,5117
 utilities/warnings.py,sha256=un1LvHv70PU-LLv8RxPVmugTzDJkkGXRMZTE2-fTQHw,1771
-utilities/whenever.py,sha256=4K_DfnPvQ2iddgKmTd3aa1RT3ZTh3bU4R0xe41l9goI,20099
+utilities/whenever.py,sha256=R5d9UCNCdAOyjwLUmfH2Vn8Ykee8OHQi2skRTFfbZMM,20492
 utilities/zipfile.py,sha256=24lQc9ATcJxHXBPc_tBDiJk48pWyRrlxO2fIsFxU0A8,699
 utilities/zoneinfo.py,sha256=oEH-nL3t4h9uawyZqWDtNtDAl6M-CLpLYGI_nI6DulM,1971
-dycw_utilities-0.138.0.dist-info/METADATA,sha256=nExJGsgLn_Rn-_aeZ2risr4iR1Xuout7dLx9QEb8qbI,1637
-dycw_utilities-0.138.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dycw_utilities-0.138.0.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
-dycw_utilities-0.138.0.dist-info/RECORD,,
+dycw_utilities-0.138.2.dist-info/METADATA,sha256=6gn_JI5I-uywry5ZT3yIFP0t4wjcSyUNy6vosoP_rtI,1637
+dycw_utilities-0.138.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dycw_utilities-0.138.2.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
+dycw_utilities-0.138.2.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.138.0"
+__version__ = "0.138.2"

utilities/click.py

@@ -8,7 +8,7 @@ from typing import TYPE_CHECKING, TypedDict, assert_never, override
 import click
 import whenever
 from click import Choice, Context, Parameter, ParamType
-from click.types import StringParamType
+from click.types import IntParamType, StringParamType
 
 import utilities.whenever
 from utilities.enum import EnsureEnumError, ensure_enum
@@ -478,6 +478,14 @@ class FrozenSetEnums[E: enum.Enum](FrozenSetParameter[Enum[E], E]):
         super().__init__(Enum(enum, case_sensitive=case_sensitive), separator=separator)
 
 
+class FrozenSetInts(FrozenSetParameter[IntParamType, int]):
+    """A frozenset-of-ints-valued parameter."""
+
+    @override
+    def __init__(self, *, separator: str = ",") -> None:
+        super().__init__(IntParamType(), separator=separator)
+
+
 class FrozenSetStrs(FrozenSetParameter[StringParamType, str]):
     """A frozenset-of-strs-valued parameter."""
 
@@ -555,6 +563,14 @@ class ListEnums[E: enum.Enum](ListParameter[Enum[E], E]):
         super().__init__(Enum(enum, case_sensitive=case_sensitive), separator=separator)
 
 
+class ListInts(ListParameter[IntParamType, int]):
+    """A list-of-ints-valued parameter."""
+
+    @override
+    def __init__(self, *, separator: str = ",") -> None:
+        super().__init__(IntParamType(), separator=separator)
+
+
 class ListStrs(ListParameter[StringParamType, str]):
     """A list-of-strs-valued parameter."""
 
@@ -590,6 +606,7 @@ __all__ = [
     "IPv6Address",
     "ListChoices",
     "ListEnums",
+    "ListInts",
     "ListParameter",
     "ListStrs",
     "MonthDay",

utilities/whenever.py

@@ -25,6 +25,7 @@ from whenever import (
     PlainDateTime,
     Time,
     TimeDelta,
+    YearMonth,
     ZonedDateTime,
 )
 
@@ -670,6 +671,18 @@ def to_zoned_date_time(
 ##
 
 
+def two_digit_year_month(year: int, month: int, /) -> YearMonth:
+    """Construct a year-month from a 2-digit year."""
+    min_year = DATE_TWO_DIGIT_YEAR_MIN.year
+    max_year = DATE_TWO_DIGIT_YEAR_MAX.year
+    years = range(min_year, max_year + 1)
+    (year_use,) = (y for y in years if y % 100 == year)
+    return YearMonth(year_use, month)
+
+
+##
+
+
 class WheneverLogRecord(LogRecord):
     """Log record powered by `whenever`."""
 
@@ -774,4 +787,5 @@ __all__ = [
     "to_local_plain",
     "to_nanos",
     "to_zoned_date_time",
+    "two_digit_year_month",
 ]