whenever 0.10.1.dev0__tar.gz → 0.10.2__tar.gz

{whenever-0.10.1.dev0 → whenever-0.10.2}/Cargo.lock

@@ -339,33 +339,23 @@ dependencies = [
 
 [[package]]
 name = "pyo3-build-config"
-version = "0.28.2"
+version = "0.29.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8bf94ee265674bf76c09fa430b0e99c26e319c945d96ca0d5a8215f31bf81cf7"
+checksum = "c5e2a7d2f0d013342f295c048ad19237add5154a55b1c5a254c0ec93d4109078"
 dependencies = [
- "python3-dll-a",
  "target-lexicon",
 ]
 
 [[package]]
 name = "pyo3-ffi"
-version = "0.28.2"
+version = "0.29.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "491aa5fc66d8059dd44a75f4580a2962c1862a1c2945359db36f6c2818b748dc"
+checksum = "ca85c467da1bbc8d866eea5deff9cf29ea5f7785054a17da36e65bda9c05845b"
 dependencies = [
  "libc",
  "pyo3-build-config",
 ]
 
-[[package]]
-name = "python3-dll-a"
-version = "0.2.14"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d381ef313ae70b4da5f95f8a4de773c6aa5cd28f73adec4b4a31df70b66780d8"
-dependencies = [
- "cc",
-]
-
 [[package]]
 name = "quote"
 version = "1.0.45"

{whenever-0.10.1.dev0 → whenever-0.10.2}/Cargo.toml

@@ -24,19 +24,18 @@ crate-type = ["cdylib", "rlib"]
 lto = "fat"
 codegen-units = 1
 strip = true
-# FUTURE: consider `opt-level = "s"`.
-# It reduces binary size by about 10%, at about 10% slower performance
+opt-level = 3
 
 [dependencies]
 ahash = "^0.8.12"
 
 [dependencies.pyo3-ffi]
-version = "^0.28.2"
+version = "^0.29.0"
 default-features = false
 features = ["extension-module", "generate-import-lib"]
 
 [build-dependencies]
-pyo3-build-config = { version = "^0.28.2" }
+pyo3-build-config = { version = "^0.29.0" }
 
 [dev-dependencies]
 criterion = "^0.8.1"
@@ -48,4 +47,4 @@ harness = false
 path = "benchmarks/rust/main.rs"
 
 [lints.rust]
-unexpected_cfgs = { level = "warn", check-cfg = [ "cfg(Py_3_9)", "cfg(Py_3_10)", "cfg(Py_3_11)", "cfg(Py_3_12)", "cfg(Py_3_13)", "cfg(Py_GIL_DISABLED)"] }
+unexpected_cfgs = { level = "warn", check-cfg = [ "cfg(Py_3_9)", "cfg(Py_3_10)", "cfg(Py_3_11)", "cfg(Py_3_12)", "cfg(Py_3_13)", "cfg(Py_GIL_DISABLED)", "cfg(PyPy)"] }

{whenever-0.10.1.dev0 → whenever-0.10.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: whenever
-Version: 0.10.1.dev0
+Version: 0.10.2
 Summary: Modern datetime library for Python
 Author-email: Arie Bovenberg <a.c.bovenberg@gmail.com>
 Maintainer-email: Arie Bovenberg <a.c.bovenberg@gmail.com>

{whenever-0.10.1.dev0 → whenever-0.10.2}/pyproject.toml

@@ -7,7 +7,7 @@ maintainers = [
     {name = "Arie Bovenberg", email = "a.c.bovenberg@gmail.com"},
 ]
 readme = "README.md"
-version = "0.10.1.dev0"
+version = "0.10.2"
 license = "MIT"
 description = "Modern datetime library for Python"
 requires-python = ">=3.10"
@@ -60,10 +60,17 @@ dev-extra = [
     "slotscheck>=0.20,<0.21",
     "build",
     "packaging>=26.2",
-    "pyperf>=2.10,<3",
     "setuptools-rust",
     "twine>=6.2.0",
 ]
+benchmark = [
+    "arrow>=1.4,<2",
+    "matplotlib>=3.10,<4",
+    "pendulum>=3.2,<4",
+    "pyperf>=2.10,<3",
+    "python-dateutil>=2.9,<3",
+    "setuptools-rust",
+]
 docs = [
     "furo>=2025.12.19,<2026",
     "myst-parser>=5,<6",
@@ -73,6 +80,7 @@ docs = [
 ]
 
 [tool.uv.dependency-groups]
+benchmark = {requires-python = ">=3.14"}
 docs = {requires-python = ">=3.13"}
 
 

whenever-0.10.2/pysrc/whenever/__init__.py

@@ -0,0 +1,214 @@
+from __future__ import annotations
+
+
+# Almost everything is lazily imported, to speed up initial import time.
+def __getattr__(name: str) -> object:
+    # When any name from a group is first accessed, the whole module is loaded
+    # and all names from it are pre-populated, so subsequent accesses skip __getattr__.
+    if src := _LAZY_NAMES.get(name):
+        mod = __import__(src, fromlist=("",))
+        g = globals()
+        for n in _LAZY_MODULES[src]:
+            g[n] = getattr(mod, n)
+        return g[name]
+    # TZPATH is a live view, not a cached value.
+    elif name == "TZPATH":
+        from ._core import _get_tzpath
+
+        return _get_tzpath()
+    elif name == "AnyDelta":
+        from ._core import (
+            DateDelta,
+            DateTimeDelta,
+            ItemizedDateDelta,
+            ItemizedDelta,
+            TimeDelta,
+        )
+
+        globals()["AnyDelta"] = val = (
+            DateDelta
+            | TimeDelta
+            | DateTimeDelta
+            | ItemizedDelta
+            | ItemizedDateDelta
+        )
+        return val
+    elif name == "__version__":
+        globals()["__version__"] = version = __import__(
+            "importlib.metadata"
+        ).metadata.version(__name__)
+        return version
+
+    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
+
+
+# Ensures not-yet-imported names are still included in dir() output
+def __dir__() -> list[str]:
+    return sorted(
+        (
+            globals().keys()
+            | _LAZY_NAMES.keys()
+            | {"TZPATH", "AnyDelta", "__version__"}
+        )
+        - {"_LAZY_MODULES", "_LAZY_NAMES"}
+    )
+
+
+# This could be derived from the imports below, but it's easier for static
+# analysis and IDEs if it's statically defined.
+__all__ = (
+    # Date and time
+    "Date",
+    "YearMonth",
+    "MonthDay",
+    "IsoWeekDate",
+    "Time",
+    "Instant",
+    "OffsetDateTime",
+    "ZonedDateTime",
+    "PlainDateTime",
+    # Deltas and time units
+    "DateDelta",
+    "TimeDelta",
+    "DateTimeDelta",
+    "ItemizedDelta",
+    "ItemizedDateDelta",
+    "years",
+    "months",
+    "weeks",
+    "days",
+    "hours",
+    "minutes",
+    "seconds",
+    "milliseconds",
+    "microseconds",
+    "nanoseconds",
+    # Exceptions/warnings
+    "DaysAssumed24HoursWarning",
+    "StaleOffsetWarning",
+    "NaiveArithmeticWarning",
+    "PotentialDstBugWarning",
+    "WheneverDeprecationWarning",
+    "SkippedTime",
+    "RepeatedTime",
+    "InvalidOffsetError",
+    "ImplicitlyIgnoringDST",
+    "TimeZoneNotFoundError",
+    # Enums/constants
+    "Weekday",
+    "MONDAY",
+    "TUESDAY",
+    "WEDNESDAY",
+    "THURSDAY",
+    "FRIDAY",
+    "SATURDAY",
+    "SUNDAY",
+    # Other
+    "reset_system_tz",
+    "patch_current_time",
+    "reset_tzpath",
+    "clear_tzcache",
+    "available_timezones",
+    "AnyDelta",
+)
+
+
+_LAZY_MODULES = {
+    f"{__package__}._core": (
+        # Classes
+        "Date",
+        "Time",
+        "Instant",
+        "OffsetDateTime",
+        "ZonedDateTime",
+        "PlainDateTime",
+        "DateDelta",
+        "TimeDelta",
+        "DateTimeDelta",
+        "ItemizedDelta",
+        "ItemizedDateDelta",
+        # Unit constructors
+        "years",
+        "months",
+        "weeks",
+        "days",
+        "hours",
+        "minutes",
+        "seconds",
+        "milliseconds",
+        "microseconds",
+        "nanoseconds",
+        # Exceptions/warnings
+        "DaysAssumed24HoursWarning",
+        "StaleOffsetWarning",
+        "NaiveArithmeticWarning",
+        "PotentialDstBugWarning",
+        "WheneverDeprecationWarning",
+        "SkippedTime",
+        "RepeatedTime",
+        "InvalidOffsetError",
+        "ImplicitlyIgnoringDST",
+        "TimeZoneNotFoundError",
+        # Other
+        "reset_system_tz",
+        "_EXTENSION_LOADED",
+        # Unpickle functions
+        "_unpkl_date",
+        "_unpkl_ddelta",
+        "_unpkl_dtdelta",
+        "_unpkl_iddelta",
+        "_unpkl_idelta",
+        "_unpkl_inst",
+        "_unpkl_local",
+        "_unpkl_offset",
+        "_unpkl_tdelta",
+        "_unpkl_time",
+        "_unpkl_utc",
+        "_unpkl_zoned",
+    ),
+    f"{__package__}._utils": (
+        "patch_current_time",
+        "reset_tzpath",
+        "clear_tzcache",
+        "available_timezones",
+    ),
+    f"{__package__}._typing": (
+        "RoundModeStr",
+        "DeltaUnitStr",
+        "DateDeltaUnitStr",
+        "ExactDeltaUnitStr",
+        "DisambiguateStr",
+        "OffsetMismatchStr",
+    ),
+    f"{__package__}._shared": (
+        "YearMonth",
+        "MonthDay",
+        "Weekday",
+        "IsoWeekDate",
+        "_unpkl_iwd",
+        "_unpkl_md",
+        "_unpkl_ym",
+        "MONDAY",
+        "TUESDAY",
+        "WEDNESDAY",
+        "THURSDAY",
+        "FRIDAY",
+        "SATURDAY",
+        "SUNDAY",
+    ),
+}
+_LAZY_NAMES = {n: mod for mod, names in _LAZY_MODULES.items() for n in names}
+
+
+# Without this, IDEs won't show proper information for our types.
+# Note we don't actually import the variable from `typing`,
+# as this has a runtime cost.
+TYPE_CHECKING = False
+
+if TYPE_CHECKING:
+    from ._core import *
+    from ._shared import *
+    from ._typing import *
+    from ._utils import *
+
+del TYPE_CHECKING

{whenever-0.10.1.dev0 → whenever-0.10.2}/pysrc/whenever/__init__.pyi

@@ -74,9 +74,22 @@ __all__ = [
     "InvalidOffsetError",
     "ImplicitlyIgnoringDST",
     "TimeZoneNotFoundError",
-    # Other stuff
+    # Enums/constants
     "Weekday",
+    "MONDAY",
+    "TUESDAY",
+    "WEDNESDAY",
+    "THURSDAY",
+    "FRIDAY",
+    "SATURDAY",
+    "SUNDAY",
+    # Other
     "reset_system_tz",
+    "patch_current_time",
+    "reset_tzpath",
+    "clear_tzcache",
+    "available_timezones",
+    "AnyDelta",
 ]
 
 _EXTENSION_LOADED: bool
@@ -175,8 +188,26 @@ class Date(_DateOrTimeMixin):
     def prev_day(self) -> Date: ...
     def nth_weekday_of_month(self, n: int, weekday: Weekday, /) -> Date: ...
     def nth_weekday(self, n: int, weekday: Weekday, /) -> Date: ...
-    def start_of(self, unit: Literal["year", "month"], /) -> Date: ...
-    def end_of(self, unit: Literal["year", "month"], /) -> Date: ...
+    def start_of(
+        self,
+        unit: Literal[
+            "year",
+            "month",
+            "week_mon",
+            "week_sun",
+        ],
+        /,
+    ) -> Date: ...
+    def end_of(
+        self,
+        unit: Literal[
+            "year",
+            "month",
+            "week_mon",
+            "week_sun",
+        ],
+        /,
+    ) -> Date: ...
     def at(self, t: Time, /) -> PlainDateTime: ...
     def to_stdlib(self) -> _date: ...
     @deprecated("Use to_stdlib() instead")
@@ -1187,12 +1218,30 @@ class _LocalTime(ABC):
     def in_leap_year(self) -> bool: ...
     def start_of(
         self,
-        unit: Literal["year", "month", "day", "hour", "minute", "second"],
+        unit: Literal[
+            "year",
+            "month",
+            "week_mon",
+            "week_sun",
+            "day",
+            "hour",
+            "minute",
+            "second",
+        ],
         /,
     ) -> Self: ...
     def end_of(
         self,
-        unit: Literal["year", "month", "day", "hour", "minute", "second"],
+        unit: Literal[
+            "year",
+            "month",
+            "week_mon",
+            "week_sun",
+            "day",
+            "hour",
+            "minute",
+            "second",
+        ],
         /,
     ) -> Self: ...
     @overload
@@ -1617,14 +1666,32 @@ class OffsetDateTime(_PyDateTimeMixin, _ExactAndLocalTime):
     ) -> Self: ...
     def start_of(
         self,
-        unit: Literal["year", "month", "day", "hour", "minute", "second"],
+        unit: Literal[
+            "year",
+            "month",
+            "week_mon",
+            "week_sun",
+            "day",
+            "hour",
+            "minute",
+            "second",
+        ],
         /,
         *,
         stale_offset_ok: bool = ...,
     ) -> Self: ...
     def end_of(
         self,
-        unit: Literal["year", "month", "day", "hour", "minute", "second"],
+        unit: Literal[
+            "year",
+            "month",
+            "week_mon",
+            "week_sun",
+            "day",
+            "hour",
+            "minute",
+            "second",
+        ],
         /,
         *,
         stale_offset_ok: bool = ...,
@@ -2241,3 +2308,7 @@ class DaysAssumed24HoursWarning(PotentialDstBugWarning): ...
 class StaleOffsetWarning(PotentialDstBugWarning): ...
 class NaiveArithmeticWarning(PotentialDstBugWarning): ...
 class WheneverDeprecationWarning(UserWarning): ...
+
+AnyDelta: TypeAlias = (
+    DateDelta | TimeDelta | DateTimeDelta | ItemizedDelta | ItemizedDateDelta
+)

{whenever-0.10.1.dev0 → whenever-0.10.2}/pysrc/whenever/_common.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from collections.abc import Callable
 
-# Unused imports are necessary for sphinc autodoc due to
+# Unused imports are necessary for sphinx autodoc due to
 # scoping issues introduced by add_alternate_constructors().
 from datetime import (  # noqa: F401
     date as _date,

{whenever-0.10.1.dev0 → whenever-0.10.2}/pysrc/whenever/_core.py

@@ -6,6 +6,7 @@ try:  # pragma: no cover
     from ._whenever import (
         _clear_tz_cache as _clear_tz_cache,
         _clear_tz_cache_by_keys as _clear_tz_cache_by_keys,
+        _get_tzpath as _get_tzpath,
         _patch_time_frozen as _patch_time_frozen,
         _patch_time_keep_ticking as _patch_time_keep_ticking,
         _set_tzpath as _set_tzpath,
@@ -13,6 +14,8 @@ try:  # pragma: no cover
         _unpkl_date,
         _unpkl_ddelta,
         _unpkl_dtdelta,
+        _unpkl_iddelta,
+        _unpkl_idelta,
         _unpkl_inst,
         _unpkl_local,
         _unpkl_offset,
@@ -22,24 +25,6 @@ try:  # pragma: no cover
         _unpkl_zoned,
     )
 
-    # Backfill symbols not yet in the Rust extension (temporary)
-    try:
-        from ._whenever import _unpkl_idelta as _unpkl_idelta
-    except ImportError:
-        from ._pywhenever import _unpkl_idelta as _unpkl_idelta
-    try:
-        from ._whenever import _unpkl_iddelta as _unpkl_iddelta
-    except ImportError:
-        from ._pywhenever import _unpkl_iddelta as _unpkl_iddelta
-    try:
-        from ._whenever import ItemizedDelta as ItemizedDelta
-    except ImportError:
-        from ._pywhenever import ItemizedDelta as ItemizedDelta
-    try:
-        from ._whenever import ItemizedDateDelta as ItemizedDateDelta
-    except ImportError:
-        from ._pywhenever import ItemizedDateDelta as ItemizedDateDelta
-
     _EXTENSION_LOADED = True
 
 except ModuleNotFoundError as e:
@@ -50,6 +35,7 @@ except ModuleNotFoundError as e:
     from ._pywhenever import (
         _clear_tz_cache,
         _clear_tz_cache_by_keys,
+        _get_tzpath,
         _patch_time_frozen,
         _patch_time_keep_ticking,
         _set_tzpath,
@@ -70,14 +56,8 @@ except ModuleNotFoundError as e:
 
     _EXTENSION_LOADED = False
 
-# YearMonth/MonthDay/IsoWeekDate unpickle functions always come from _shared
-from ._shared import _unpkl_iwd, _unpkl_md, _unpkl_ym
-from ._typing import *
+    # In pure Python mode, populate TZPATH eagerly (the Rust extension defers
+    # this to first timezone lookup for faster import time).
+    from ._utils import reset_tzpath
 
-MONDAY = Weekday.MONDAY
-TUESDAY = Weekday.TUESDAY
-WEDNESDAY = Weekday.WEDNESDAY
-THURSDAY = Weekday.THURSDAY
-FRIDAY = Weekday.FRIDAY
-SATURDAY = Weekday.SATURDAY
-SUNDAY = Weekday.SUNDAY
+    reset_tzpath()

{whenever-0.10.1.dev0 → whenever-0.10.2}/pysrc/whenever/_format.py

@@ -617,6 +617,9 @@ class _FracTrim(_Field):
             return [_DotFrac(self.width)]
         return [_Literal(ch), self]
 
+    def __repr__(self) -> str:
+        return "F" * self.width
+
 
 class _DotFrac(_Field):
     """Decimal point + trimmed fractional seconds (``.FFF``).

{whenever-0.10.1.dev0 → whenever-0.10.2}/pysrc/whenever/_parse.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import sys
 from datetime import (
     date as _date,
@@ -6,7 +8,7 @@ from datetime import (
     timedelta as _timedelta,
     timezone as _timezone,
 )
-from typing import Literal, NoReturn, cast
+from typing import TYPE_CHECKING, Literal, NoReturn, cast
 
 from ._common import (
     DUMMY_LEAP_YEAR,
@@ -15,7 +17,9 @@ from ._common import (
     check_utc_bounds,
     mk_fixed_tzinfo,
 )
-from ._tz import SafeTzId, TimeZone, get_tz, resolve_ambiguity, validate_tzid
+
+if TYPE_CHECKING:
+    from ._tz import SafeTzId, TimeZone
 
 
 class InvalidOffsetError(ValueError):
@@ -122,6 +126,8 @@ def offset_dt_from_iso(s: str) -> tuple[_datetime, Nanos]:
 
 
 def zdt_from_iso(s: str) -> tuple[_datetime, Nanos, TimeZone]:
+    from ._tz import get_tz, resolve_ambiguity
+
     if len(s) < 11 or "W" in s[:11] or not s.isascii():
         _parse_err(s)
 
@@ -180,6 +186,8 @@ def _time_offset_tz_from_iso(
 ) -> tuple[_time, Nanos, _timezone | Literal["Z"] | None, SafeTzId | None]:
     # ditch the bracketted timezone (if present)
     if s.endswith("]"):
+        from ._tz import validate_tzid
+
         # NOTE: sorry for the unicode escape sequences. Literal brackets
         # break my LSP's indentation detection. \x5b is open bracket '['
         s, tz_raw = s[:-1].rsplit("\x5b", 1)