whenever 0.10.0b4__tar.gz → 0.10.1.dev0__tar.gz

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/Cargo.toml

@@ -14,7 +14,6 @@ include = [
     "README.md",
     "src",
     "tests/*.py",
-    "requirements/*.txt",
 ]
 
 [lib]

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: whenever
-Version: 0.10.0b4
+Version: 0.10.1.dev0
 Summary: Modern datetime library for Python
 Author-email: Arie Bovenberg <a.c.bovenberg@gmail.com>
 Maintainer-email: Arie Bovenberg <a.c.bovenberg@gmail.com>
@@ -157,6 +157,7 @@ while many serious and long-standing issues remain unaddressed.
 - 💎 Thoroughly tested and documented
 - 📆 Support for date arithmetic
 - ⏱️ Nanosecond precision
+- 🗄️ [SQLAlchemy support](https://pypi.org/project/whenever-sqlalchemy/)
 - 🪃 Pydantic support (beta)
 - 🦀 Rust!—but with a [pure-Python option](https://whenever.readthedocs.io/en/latest/faq.html#how-can-i-use-the-pure-python-version)
 - 🧵 Free-threading support (beta)

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/README.md

@@ -121,6 +121,7 @@ while many serious and long-standing issues remain unaddressed.
 - 💎 Thoroughly tested and documented
 - 📆 Support for date arithmetic
 - ⏱️ Nanosecond precision
+- 🗄️ [SQLAlchemy support](https://pypi.org/project/whenever-sqlalchemy/)
 - 🪃 Pydantic support (beta)
 - 🦀 Rust!—but with a [pure-Python option](https://whenever.readthedocs.io/en/latest/faq.html#how-can-i-use-the-pure-python-version)
 - 🧵 Free-threading support (beta)

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/_custom_pybuild/backend.py

@@ -1,9 +1,8 @@
 # See pyproject.toml for why this file exists.
-from setuptools import build_meta as _orig
-from setuptools.build_meta import *
-import platform
 import os
+import platform
 
+from setuptools.build_meta import *
 
 if os.getenv("WHENEVER_NO_BUILD_RUST_EXT") or (
     platform.python_implementation() in ("PyPy", "GraalVM")

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/pyproject.toml

@@ -7,7 +7,7 @@ maintainers = [
     {name = "Arie Bovenberg", email = "a.c.bovenberg@gmail.com"},
 ]
 readme = "README.md"
-version = "0.10.0b4"
+version = "0.10.1.dev0"
 license = "MIT"
 description = "Modern datetime library for Python"
 requires-python = ">=3.10"
@@ -39,6 +39,42 @@ keywords = [
     "zoneinfo", "tzdata", "tzdb"
 ]
 
+[dependency-groups]
+test = [
+    "pytest-benchmark[histogram]>=5.2.3,<6",
+    "pytest-cov>=7.1.0,<8",
+    "pytest-order>=1.4.0,<2",
+    "pytest>=9.0.3,<10",
+    "hypothesis>=6.152.7,<7",
+]
+typing = [
+    "mypy>=2.1.0,<2.2",
+]
+integrations = [
+    "time_machine>=3.2,<4; implementation_name == 'cpython'",
+    "tzdata>=2020.1",
+    "pydantic>=2.10,<3",
+]
+dev-extra = [
+    "ruff>=0.15,<0.16",
+    "slotscheck>=0.20,<0.21",
+    "build",
+    "packaging>=26.2",
+    "pyperf>=2.10,<3",
+    "setuptools-rust",
+    "twine>=6.2.0",
+]
+docs = [
+    "furo>=2025.12.19,<2026",
+    "myst-parser>=5,<6",
+    "sphinx-copybutton~=0.5",
+    "sphinx-design>=0.7,<0.8",
+    "sphinx>=9,<10",
+]
+
+[tool.uv.dependency-groups]
+docs = {requires-python = ">=3.13"}
+
 
 [project.urls]
 Documentation = "https://whenever.readthedocs.io"
@@ -46,26 +82,24 @@ Repository = "https://github.com/ariebovenberg/whenever"
 Issues = "https://github.com/ariebovenberg/whenever/issues"
 Changelog = "https://github.com/ariebovenberg/whenever/blob/main/CHANGELOG.md"
 
-[tool.black]
+[tool.ruff]
 line-length = 79
-include = '\.pyi?$'
-exclude = '''
-/(
-    \.eggs
-  | \.hg
-  | \.git
-  | \.mypy_cache
-  | \.venv
-  | _build
-  | build
-  | dist
-)/
-'''
+target-version = "py310"
+exclude = ["pysrc/whenever/_typing_312.py"]
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "I"]
+
+[tool.ruff.lint.per-file-ignores]
+"_custom_pybuild/backend.py" = ["F403"]
+"docs/conf.py" = ["E402"]
+"pysrc/whenever/__init__.py" = ["F401", "F403", "F405"]
+"pysrc/whenever/_core.py" = ["F401", "F403", "F405"]
+
+[tool.ruff.lint.isort]
+combine-as-imports = true
 
-[tool.isort]
-profile = 'black'
-line_length = 79
-combine_as_imports = true
+[tool.ruff.format]
 
 [tool.mypy]
 warn_unused_ignores = true
@@ -96,8 +130,9 @@ find = { where = ["pysrc"] }
 # We essentially use three build systems:
 # - We use maturin to build the binary distributions for different
 #   platforms in CI, since it is very convenient for this purpose.
-# - We need setuptools to allow enabling/disabling building the Rust
-#   extension using the environment variable, since maturin does not support this.
+# - We use setuptools for source distributions and editable installs.
+# - The custom backend below runs `build_rust --inplace` during editable
+#   installs so `uv sync` can keep the Rust extension in the source tree.
 # - To actually build the Rust extension with setuptools, we need
 #   setuptools_rust.
 [tool.maturin]
@@ -110,8 +145,8 @@ requires = [
     "setuptools",
     "wheel",
 ]
-# We need a custom backend to make the inclusion of setuptools_rust conditional
-# on the environment variable.
+# We need a custom backend to make editable installs build the Rust
+# extension in place.
 # Follows the approach from setuptools.pypa.io/en/latest/build_meta.html#dynamic-build-dependencies-and-other-build-meta-tweaks
 build-backend = "backend"
 backend-path = ["_custom_pybuild"]

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/pysrc/whenever/__init__.py

@@ -31,7 +31,7 @@ if not _EXTENSION_LOADED:  # pragma: no cover
 
 # Yes, we could get the version with importlib.metadata,
 # but we try to keep our import time as low as possible.
-__version__ = "0.10.0b4"
+__version__ = "0.10.0"
 
 # We expose these at module-level for convenience
 MONDAY = Weekday.MONDAY

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

@@ -930,7 +930,9 @@ class ItemizedDelta(
         *,
         relative_to: ZonedDateTime | PlainDateTime | OffsetDateTime,
     ) -> float: ...
-    def __iter__(self) -> Iterator[
+    def __iter__(
+        self,
+    ) -> Iterator[
         Literal[
             "years",
             "months",

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

@@ -7,7 +7,7 @@ from collections.abc import Callable
 from datetime import (  # noqa: F401
     date as _date,
     datetime as _datetime,
-    time as _time,
+    time as _time,  # noqa: F401
     timedelta as _timedelta,
     timezone as _timezone,
 )

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

@@ -76,7 +76,7 @@ def _parse_digits(s: str, pos: int, count: int) -> tuple[int, int]:
     chunk = s[pos:end]
     if not chunk.isdigit():
         raise ValueError(
-            f"Expected {count} digits at position {pos}, " f"got {chunk!r}"
+            f"Expected {count} digits at position {pos}, got {chunk!r}"
         )
     return int(chunk), end
 
@@ -934,9 +934,7 @@ def _validate_cross_fields(elements: Iterable[_Element]) -> None:
 # Characters allowed as unquoted literals in patterns.
 # Letters must be quoted. Reserved chars (< > [ ] { } #) raise errors.
 # '.' and ':' are handled separately as potential compound-token prefixes.
-_LITERAL_CHARS = frozenset(
-    " \t\n" "0123456789" "-/,;_" "()+@!~*&%$^|\\=?`" '"'
-)
+_LITERAL_CHARS = frozenset(' \t\n0123456789-/,;_()+@!~*&%$^|\\=?`"')
 _PENDING_CHARS = frozenset(".:")
 
 _RESERVED_CHARS = frozenset("<>[]{}#")
@@ -1090,7 +1088,7 @@ def validate_fields(
     for el in elements:
         if isinstance(el, _Field) and el.category not in allowed_categories:
             raise ValueError(
-                f"{type_name} does not support pattern " f"field {el!r}"
+                f"{type_name} does not support pattern field {el!r}"
             )
 
 
@@ -1170,7 +1168,7 @@ def parse_fields(
 
     if pos != len(s):
         raise ValueError(
-            f"Unexpected trailing text at position {pos}: " f"{s[pos:]!r}"
+            f"Unexpected trailing text at position {pos}: {s[pos:]!r}"
         )
 
     state.resolve()

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

@@ -239,7 +239,6 @@ def monthday_from_iso(s: str) -> _date:
 # The ISO parsing functions were improved in Python 3.11,
 # so we use them if available.
 if sys.version_info >= (3, 11):
-
     _date_from_iso_basic = _date.fromisoformat
 
     def _time_from_iso_nofrac(s: str) -> _time:

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/pysrc/whenever/_pywhenever.py

@@ -454,7 +454,7 @@ class Date(_Base):
             return Date._from_py_unchecked(self._py_date.replace(day=1))
         else:
             raise ValueError(
-                f"Invalid unit: {unit!r}. " "Valid units: 'year', 'month'"
+                f"Invalid unit: {unit!r}. Valid units: 'year', 'month'"
             )
 
     def end_of(self, unit: Literal["year", "month"], /) -> Date:
@@ -479,7 +479,7 @@ class Date(_Base):
             )
         else:
             raise ValueError(
-                f"Invalid unit: {unit!r}. " "Valid units: 'year', 'month'"
+                f"Invalid unit: {unit!r}. Valid units: 'year', 'month'"
             )
 
     def nth_weekday_of_month(self, n: int, weekday: Weekday, /) -> Date:
@@ -518,8 +518,8 @@ class Date(_Base):
             raise ValueError("n must not be 0")
         if not isinstance(weekday, Weekday):
             raise TypeError("weekday must be a Weekday enum member")
-        if not (-5 <= n <= 5):
-            raise ValueError("n must be between -5 and 5")
+        if not (-521_722 <= n <= 521_722):
+            raise ValueError("n out of range")
         target_dow = weekday.value
         self_dow = self._py_date.isoweekday()
 
@@ -936,10 +936,9 @@ class Date(_Base):
                 sign,
             )
 
-        # mypy false positive: 'keywords must be strings' (but they're string literals!)
         return ItemizedDateDelta._from_signed(
             sign if any(results.values()) else 0, **results
-        )  # type: ignore[misc]
+        )
 
     @overload
     def until(
@@ -2094,8 +2093,7 @@ class TimeDelta(_Base):
         sign: Sign = 1 if self._total_ns >= 0 else -1
         if not any(result.values()):
             sign = 0  # due to rounding, the result may be zero even if self is not zero
-        # mypy false positive: 'keywords must be strings' (but they're string literals!)
-        return ItemizedDelta._from_signed(sign, **result)  # type: ignore[misc]
+        return ItemizedDelta._from_signed(sign, **result)
 
     def _in_exact_units(
         self,
@@ -3415,8 +3413,7 @@ class ItemizedDelta(_Base, Mapping[DeltaUnitStr, int]):
         >>> d.format_iso()
         'P1W11DT4H1.000012S'
         """
-        # Mypy complains about string unpacking. But it's valid here. See mypy/issues/13823
-        y, m, w, d, h, s = "ymwdhs" if lowercase_units else "YMWDHS"  # type: ignore[misc]
+        y, m, w, d, h, s = "ymwdhs" if lowercase_units else "YMWDHS"
 
         sgn = self.sign()
         parts = ["-" * (sgn < 0), "P"]
@@ -3940,6 +3937,10 @@ class ItemizedDelta(_Base, Mapping[DeltaUnitStr, int]):
                     stacklevel=2,
                 )
             relative_to = relative_to.to_plain().assume_tz("UTC")
+        elif not isinstance(relative_to, ZonedDateTime):
+            raise TypeError(
+                "relative_to must be a ZonedDateTime, PlainDateTime, or OffsetDateTime"
+            )
         return relative_to.add(self).since(
             relative_to,
             in_units=units,
@@ -3989,6 +3990,10 @@ class ItemizedDelta(_Base, Mapping[DeltaUnitStr, int]):
                     stacklevel=2,
                 )
             relative_to = relative_to.to_plain().assume_tz("UTC")
+        elif not isinstance(relative_to, ZonedDateTime):
+            raise TypeError(
+                "relative_to must be a ZonedDateTime, PlainDateTime, or OffsetDateTime"
+            )
         return (relative_to.add(self) - relative_to).total(
             unit, relative_to=relative_to
         )
@@ -4293,8 +4298,7 @@ class ItemizedDateDelta(_Base, Mapping[DateDeltaUnitStr, int]):
         which is not part of the ISO 8601 standard, but is a common extension.
         See :ref:`here <iso8601-durations>` for more information.
         """
-        # Mypy complains about string unpacking. But it's valid here. See mypy/issues/13823
-        y, m, w, d = "ymwd" if lowercase_units else "YMWD"  # type: ignore[misc]
+        y, m, w, d = "ymwd" if lowercase_units else "YMWD"
 
         parts = ["-" * (self.sign() < 0), "P"]
         if self._years is not None:
@@ -4801,7 +4805,9 @@ def _check_bound(i: int | None, max_value: int) -> int | None:
 
 
 def _check_component(
-    value: int, sign: Sign, max_value: int  # may also be UNSET
+    value: int,
+    sign: Sign,
+    max_value: int,  # may also be UNSET
 ) -> tuple[int | None, Sign]:
     if value is UNSET:
         return None, sign
@@ -5483,7 +5489,6 @@ class _LocalTime(_BasicConversions):
 # - OffsetDateTime
 # (This base class class itself is not for public use.)
 class _ExactTime(_BasicConversions):
-
     __slots__ = ()
 
     def timestamp(self) -> int:
@@ -5719,7 +5724,6 @@ class _ExactTime(_BasicConversions):
 # - OffsetDateTime
 # (The class itself it not for public use.)
 class _ExactAndLocalTime(_LocalTime, _ExactTime):
-
     __slots__ = ()
 
     @property
@@ -6016,7 +6020,7 @@ class Instant(_ExactTime):
         state = parse_fields(elements, s)
         if state.offset_secs is None:
             raise ValueError(
-                "Instant.parse() pattern must include an offset " "field (x/X)"
+                "Instant.parse() pattern must include an offset field (x/X)"
             )
         if state.year is None or state.month is None or state.day is None:
             raise ValueError(
@@ -6248,7 +6252,7 @@ class Instant(_ExactTime):
         return hash((self._py_dt, self._nanos))
 
     def __repr__(self) -> str:
-        return f"Instant(\"{str(self).replace('T', ' ')}\")"
+        return f'Instant("{str(self).replace("T", " ")}")'
 
     # a custom pickle implementation with a smaller payload
     def __reduce__(self) -> tuple[object, ...]:
@@ -7207,10 +7211,12 @@ class OffsetDateTime(_ExactAndLocalTime):
             return result
         elif offset_mismatch == "raise":
             offset_expected = _format_offset(
-                self._py_dt.utcoffset(), basic=False  # type: ignore[arg-type]
+                self._py_dt.utcoffset(),  # type: ignore[arg-type]
+                basic=False,
             )
             offset_actual = _format_offset(
-                result._py_dt.utcoffset(), basic=False  # type: ignore[arg-type]
+                result._py_dt.utcoffset(),  # type: ignore[arg-type]
+                basic=False,
             )
             raise InvalidOffsetError(
                 f"Offset mismatch: timezone {tz!r} has offset {offset_actual}, "
@@ -7265,7 +7271,7 @@ class OffsetDateTime(_ExactAndLocalTime):
         return _offset_since(
             self,
             b,
-            total or None,
+            None if total is UNSET else total,
             None if in_units is UNSET else in_units,
             round_mode,
             round_increment,
@@ -7305,14 +7311,14 @@ class OffsetDateTime(_ExactAndLocalTime):
         return _offset_since(
             b,
             self,
-            total or None,
+            None if total is UNSET else total,
             None if in_units is UNSET else in_units,
             round_mode,
             round_increment,
         )
 
     def __repr__(self) -> str:
-        return f"OffsetDateTime(\"{str(self).replace('T', ' ')}\")"
+        return f'OffsetDateTime("{str(self).replace("T", " ")}")'
 
     # a custom pickle implementation with a smaller payload
     def __reduce__(self) -> tuple[object, ...]:
@@ -8106,7 +8112,7 @@ class ZonedDateTime(_ExactAndLocalTime):
         return _zoned_since(
             self,
             b,
-            total or None,
+            None if total is UNSET else total,
             None if in_units is UNSET else in_units,
             round_mode,
             round_increment,
@@ -8146,7 +8152,7 @@ class ZonedDateTime(_ExactAndLocalTime):
         return _zoned_since(
             b,
             self,
-            total or None,
+            None if total is UNSET else total,
             None if in_units is UNSET else in_units,
             round_mode,
             round_increment,
@@ -8457,7 +8463,7 @@ class ZonedDateTime(_ExactAndLocalTime):
             f'ZonedDateTime("{_format_date(self._py_dt, False)} '
             f"{_format_time(self._py_dt, self._nanos, 'auto', False)}"
             f"{_format_offset(self._py_dt.utcoffset(), False)}"  # type: ignore[arg-type]
-            f"[{self._tz.key or '<system timezone without ID>'}]\")"
+            f'[{self._tz.key or "<system timezone without ID>"}]")'
         )
 
     # a custom pickle implementation with a smaller payload
@@ -8977,7 +8983,7 @@ class PlainDateTime(_LocalTime):
         return _plain_since(
             self,
             b,
-            total or None,
+            None if total is UNSET else total,
             None if in_units is UNSET else in_units,
             round_mode,
             round_increment,
@@ -9021,7 +9027,7 @@ class PlainDateTime(_LocalTime):
         return _plain_since(
             b,
             self,
-            total or None,
+            None if total is UNSET else total,
             None if in_units is UNSET else in_units,
             round_mode,
             round_increment,
@@ -9335,7 +9341,7 @@ class PlainDateTime(_LocalTime):
         return self.date()._add_days(next_day).at(rounded_time)
 
     def __repr__(self) -> str:
-        return f"PlainDateTime(\"{str(self).replace('T', ' ')}\")"
+        return f'PlainDateTime("{str(self).replace("T", " ")}")'
 
     # a custom pickle implementation with a smaller payload
     def __reduce__(self) -> tuple[object, ...]:
@@ -9925,8 +9931,7 @@ def _plain_since(
                 sign,
             )
 
-    # mypy false positive: 'keywords must be strings' (but they're string literals!)
-    return ItemizedDelta._from_signed(  # type: ignore[misc]
+    return ItemizedDelta._from_signed(
         sign if any(result.values()) else 0, **result
     )
 
@@ -9995,7 +10000,7 @@ def _offset_since(
             round_increment=effective_increment,
             round_mode=effective_round_mode,
         )
-        return ItemizedDelta._from_signed(  # type: ignore[misc]
+        return ItemizedDelta._from_signed(
             sign if any(result.values()) else 0, **result
         )
 
@@ -10088,8 +10093,7 @@ def _zoned_since(
                 sign,
             )
 
-    # mypy false positive: 'keywords must be strings' (but they're string literals!)
-    return ItemizedDelta._from_signed(  # type: ignore[misc]
+    return ItemizedDelta._from_signed(
         sign if any(result.values()) else 0, **result
     )
 

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/pysrc/whenever/_shared.py

@@ -37,17 +37,16 @@ def _nth_weekday_of_month(year: int, month: int, n: int, weekday: int) -> int:
     ``weekday`` is ISO weekday (1=Mon, 7=Sun).
     Returns the day of month, or raises ValueError if it doesn't exist.
     """
+    dim = days_in_month(year, month)
     if n > 0:
         first_dow = _date(year, month, 1).isoweekday()
         offset = (weekday - first_dow) % 7
         day = 1 + offset + (n - 1) * 7
     else:
-        dim = days_in_month(year, month)
         last_dow = _date(year, month, dim).isoweekday()
         offset = (last_dow - weekday) % 7
         day = dim - offset + (n + 1) * 7
 
-    dim = days_in_month(year, month)
     if day < 1 or day > dim:
         raise ValueError(f"Weekday #{n} doesn't exist in {year}-{month:02d}")
     return day

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/pysrc/whenever/_utils.py

@@ -228,7 +228,9 @@ def available_timezones() -> set[str]:
     for base in TZPATH:
         zones.update(_find_all_tznames(base))
 
-    zones.discard("posixrules")  # a special file that shouldn't be included
+    # special files that shouldn't be included
+    zones.discard("posixrules")
+    zones.discard("localtime")
     return zones
 
 

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/pysrc/whenever.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: whenever
-Version: 0.10.0b4
+Version: 0.10.1.dev0
 Summary: Modern datetime library for Python
 Author-email: Arie Bovenberg <a.c.bovenberg@gmail.com>
 Maintainer-email: Arie Bovenberg <a.c.bovenberg@gmail.com>
@@ -157,6 +157,7 @@ while many serious and long-standing issues remain unaddressed.
 - 💎 Thoroughly tested and documented
 - 📆 Support for date arithmetic
 - ⏱️ Nanosecond precision
+- 🗄️ [SQLAlchemy support](https://pypi.org/project/whenever-sqlalchemy/)
 - 🪃 Pydantic support (beta)
 - 🦀 Rust!—but with a [pure-Python option](https://whenever.readthedocs.io/en/latest/faq.html#how-can-i-use-the-pure-python-version)
 - 🧵 Free-threading support (beta)

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/setup.py

@@ -1,6 +1,6 @@
 import os
-
 import platform
+
 from setuptools import setup
 
 _SKIP_BUILD_SUGGESTION = """
@@ -16,10 +16,9 @@ building the Rust extension and use the (slower) Python version instead.
 
 extra_setup_kwargs = {}
 
-if (
-    os.getenv("WHENEVER_NO_BUILD_RUST_EXT")
-    or platform.python_implementation() in ("PyPy", "GraalVM")
-):
+if os.getenv(
+    "WHENEVER_NO_BUILD_RUST_EXT"
+) or platform.python_implementation() in ("PyPy", "GraalVM"):
     print("Skipping Whenever Rust extension build")
 else:
     from setuptools_rust import Binding, RustExtension, build_rust

{whenever-0.10.0b4 → whenever-0.10.1.dev0}/src/classes/date.rs

@@ -591,8 +591,8 @@ fn nth_weekday(cls: HeapType<Date>, slf: Date, args: &[PyObj]) -> PyReturn {
             .to_i64()?;
         if raw == 0 {
             raise_value_err("n must not be 0")?
-        } else if !(-5..=5).contains(&raw) {
-            raise_value_err("n must be between -5 and 5")?
+        } else if !(-521_722..=521_722).contains(&raw) {
+            raise_value_err("n out of range")?
         }
         // SAFETY: we just checked that it's well within range
         raw as i32