time-split 1.0.1__tar.gz → 1.0.3__tar.gz

{time_split-1.0.1 → time_split-1.0.3}/PKG-INFO

@@ -1,8 +1,9 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: time-split
-Version: 1.0.1
+Version: 1.0.3
 Summary: Time-based k-fold validation splits for heterogeneous data.
 License: MIT
+License-File: LICENSE.md
 Keywords: hyper,parameter,optimization,cross,validation,time,temporal,heterogenous,data
 Author: Richard Sundqvist
 Author-email: richard.sundqvist@live.se
@@ -21,6 +22,7 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Provides-Extra: app
 Provides-Extra: plotting
 Requires-Dist: click ; extra == "app"
@@ -66,7 +68,7 @@ strong non-stationary characteristics.
   a CRON-expression, or a pre-defined list.
 - [Data selection](https://time-split.readthedocs.io/en/stable/guide/spans.html) based on a timedelta, or the splitting 
   schedule itself.
-- Automatically extract and [normalize](https://time-split.readthedocs.io/en/stable/guide/expand_limits.html) data limits for 
+- Automatically extract and [normalize](https://time-split.readthedocs.io/en/stable/guide/expand-limits.html) data limits for 
   supported data types.
 - [Plotting function](https://time-split.readthedocs.io/en/stable/api/time_split.html#time_split.plot) for
   visualization of folds. Display fold sizes (hour/row count), or 
@@ -107,9 +109,6 @@ pip install -U time-split
 This is the preferred method to install ``time-split``, as it will always install the
 most recent stable release.
 
-If you don't have [pip] installed, this [Python installation guide] can guide
-you through the process.
-
 ## License
 [MIT](LICENSE.md)
 
@@ -122,6 +121,4 @@ All contributions, bug reports, bug fixes, documentation improvements, enhanceme
 started, see the [Contributing Guide](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).
 
 [Python Package Index (PyPI)]: https://pypi.org/project/time-split
-[pip]: https://pip.pypa.io
-[Python installation guide]: http://docs.python-guide.org/en/stable/starting/installation/
 

{time_split-1.0.1 → time_split-1.0.3}/README.md

@@ -28,7 +28,7 @@ strong non-stationary characteristics.
   a CRON-expression, or a pre-defined list.
 - [Data selection](https://time-split.readthedocs.io/en/stable/guide/spans.html) based on a timedelta, or the splitting 
   schedule itself.
-- Automatically extract and [normalize](https://time-split.readthedocs.io/en/stable/guide/expand_limits.html) data limits for 
+- Automatically extract and [normalize](https://time-split.readthedocs.io/en/stable/guide/expand-limits.html) data limits for 
   supported data types.
 - [Plotting function](https://time-split.readthedocs.io/en/stable/api/time_split.html#time_split.plot) for
   visualization of folds. Display fold sizes (hour/row count), or 
@@ -69,9 +69,6 @@ pip install -U time-split
 This is the preferred method to install ``time-split``, as it will always install the
 most recent stable release.
 
-If you don't have [pip] installed, this [Python installation guide] can guide
-you through the process.
-
 ## License
 [MIT](LICENSE.md)
 
@@ -84,5 +81,3 @@ All contributions, bug reports, bug fixes, documentation improvements, enhanceme
 started, see the [Contributing Guide](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).
 
 [Python Package Index (PyPI)]: https://pypi.org/project/time-split
-[pip]: https://pip.pypa.io
-[Python installation guide]: http://docs.python-guide.org/en/stable/starting/installation/

{time_split-1.0.1 → time_split-1.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "time-split"
-version = "1.0.1"
+version = "1.0.3"
 description = "Time-based k-fold validation splits for heterogeneous data."
 authors = [
     { name = "Richard Sundqvist", email = "richard.sundqvist@live.se" },
@@ -23,6 +23,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
 requires-python = ">=3.11"
 
@@ -50,45 +51,44 @@ poetry-plugin-export = ">=1.8"
 
 [tool.poetry.group.manual-extras.dependencies]
 # Extras that must be available for docs + tests go here. Doc/test-only deps go in their respective groups.
-croniter = "^6.0.0"
-pyarrow = "^19.0.0"
-polars = { version = "^1.21.0", extras = ["pandas"] }
+croniter = "~6.0.0"
+pyarrow = "~22.0.0"
+polars = { version = "~1.34.0", extras = ["pandas"] }
 
 [tool.poetry.group.docs]
 [tool.poetry.group.docs.dependencies]
 # duplicate object warnings for sphinx>=4
 # description: https://github.com/astropy/astropy/issues/11723
 # https://github.com/astropy/astropy/pull/12270
-sphinx = "~8.1.3"
-sphinx-gallery = "^0.18.0"
-pydata-sphinx-theme = "^0.16.1"
-myst-parser = "^4.0.0"
-nbsphinx = "^0.9.6"
-ipython = "^8.31.0"
+sphinx = "~8.1.3" # 8.2 breaks xdoc refs in README.md; maybe https://github.com/sphinx-doc/sphinx/issues/13932?
+sphinx-gallery = "~0.19.0"
+pydata-sphinx-theme = "~0.16.1"
+myst-parser = "~4.0.1"
+ipython = "~9.6.0"
 
 [tool.poetry.group.notebooks]
 optional = true
 [tool.poetry.group.notebooks.dependencies]
-jupyterlab = "^4"
+jupyterlab = "~4.4.10"
 ipywidgets = "*"
 jupyterlab-execute-time = "*"
 tqdm = "*"
 
 [tool.poetry.group.test.dependencies]
-pytest = "^8.3.4"
-xdoctest = "^1.2.0"
-coverage = "^7.6.10"
-pytest-cov = "^6.0.0"
+pytest = "~8.4.2"
+xdoctest = "~1.3.0"
+coverage = "~7.11.0"
+pytest-cov = "~7.0.0"
 
-scikit-learn = "^1.6.1"
-dask = { version = "^2025.1.0", extras = ["dataframe"] }
+scikit-learn = "~1.7.2"
+dask = { version = "~2025.10.0", extras = ["dataframe"] }
 
 [tool.poetry.group.devops.dependencies]
-invoke = "~2.2.0"
-mypy = "~1.17.0"
-ruff = "~0.12.3"
+invoke = "~2.2.1"
+mypy = "~1.18.2"
+ruff = "~0.14.2"
 
-safety = "~3.5.1"
+safety = "~3.6.2"
 codespell = "~2.4.1"
 bump2version = "~1.0.1"
 
@@ -140,13 +140,11 @@ ignore = [
     "ANN401",
     "TID252", # Prefer absolute imports over relative imports from parent modules
     "TRY003",
-    "PD901", # Avoid using the generic variable name `df` for DataFrames
     "PLC0415", # `import` should be at the top-level of a file
     "PLR0913", #
     "SIM108", # Use ternary operator - coverage issue, see https://github.com/nedbat/coveragepy/issues/509
     "TD003", # Missing issue link
     "TC006", # Add quotes to type expression in `typing.cast()`
-    "UP038", #  https://github.com/astral-sh/ruff/issues/7871
 ]
 
 [tool.ruff.lint.per-file-ignores]

{time_split-1.0.1 → time_split-1.0.3}/src/time_split/__init__.py

@@ -11,6 +11,6 @@ __all__ = [
     "split",
 ]
 
-__version__ = "1.0.1"
+__version__ = "1.0.3"
 
 _logging.getLogger(__name__).addHandler(_logging.NullHandler())

time_split-1.0.3/src/time_split/_docstrings.py

@@ -0,0 +1,40 @@
+from collections.abc import Callable
+from typing import ParamSpec, TypeVar
+
+P = ParamSpec("P")
+T = TypeVar("T")
+
+
+def docs(__func: Callable[P, T], /) -> Callable[P, T]:
+    """Add info the docstring of a function."""
+    if not __func.__doc__:
+        return __func
+
+    offset = "pandas :ref:`offset alias <pandas:timeseries.offset_aliases>`"
+    span = (
+        f"Range {{}} `schedule` timestamps. Either a {offset}, an integer (`schedule`-based offsets), "
+        f"or `'all'` (requires `available` data)."
+    )
+    docstrings = {
+        "schedule": f"A :attr:`~time_split.types.DatetimeIterable`, {offset}, or `cron <https://pypi.org/project/croniter/>`_ expression.",
+        "before": span.format("before"),
+        "after": span.format("after"),
+        "step": "Select a subset of folds, preferring folds later in the schedule.",
+        "n_splits": "Maximum number of folds, preferring folds later in the schedule.",
+        "available": "Binds `schedule` to a range.",
+        "expand_limits": f'A {offset} used to expand `available` data to its likely `"true"` limits. Pass ``False`` to disable.',
+        "filter": "A callable ``(start, mid, end) -> bool`` applied to each fold. Strings are converted using :func:`~rics.misc.get_by_full_name`.",
+        "ignore_filters": "Set to ignore filtering parameters (e.g. `step` and `filter`).",
+        "USER_GUIDE": (
+            "For more information about the `schedule`, `before/after` and `expand_limits`-arguments"
+            ", see the :ref:`User guide`."
+        ),
+        "OFFSET": offset,
+        "DatetimeIndexSplitterKwargs": "See :func:`~time_split.split`. The `available` keyword is managed by the integration.",
+        "show_removed": "If ``True``, splits removed by `n_splits` or `step` are included in the figure.",
+        "log_progress": "Controls logging of fold progress. See :func:`~.log_split_progress` for details.",
+    }
+
+    __func.__doc__ = __func.__doc__.format(**docstrings)
+
+    return __func

{time_split-1.0.1 → time_split-1.0.3}/src/time_split/integration/_log_progress.py

@@ -3,13 +3,10 @@ from collections.abc import Iterable
 from typing import Any
 
 from .. import log_split_progress
-from .._docstrings import add_docstrings
 from ..types import DatetimeSplitBounds, DatetimeSplits, LogSplitProgressKwargs, MetricsType
 
 LogProgressArg = str | bool | logging.Logger | logging.LoggerAdapter[Any] | LogSplitProgressKwargs[MetricsType]
 
-add_docstrings(log_progress="Controls logging of fold progress. See :func:`~.log_split_progress` for details.")
-
 
 def handle_log_progress_arg(
     log_progress: LogProgressArg[MetricsType], *, splits: DatetimeSplits

time_split-1.0.1/src/time_split/_docstrings.py

@@ -1,42 +0,0 @@
-from collections.abc import Callable
-from typing import ParamSpec, TypeVar
-
-P = ParamSpec("P")
-T = TypeVar("T")
-
-
-def add_docstrings(**kwargs: str) -> None:
-    """Add a documented argument to the ``@docs`` decorator."""
-    _DOCSTRINGS.update(kwargs)
-
-
-def docs(__func: Callable[P, T], /) -> Callable[P, T]:
-    """Add info the docstring of a function."""
-    assert __func.__doc__ is not None  # noqa: S101
-    __func.__doc__ = __func.__doc__.format(**_DOCSTRINGS)
-    return __func
-
-
-_OFFSET = "pandas :ref:`offset alias <pandas:timeseries.offset_aliases>`"
-_SPAN = (
-    f"Range {{arg}} `schedule` timestamps. Either a {_OFFSET}, an integer (`schedule`-based offsets), "
-    f"or `'all'` (requires `available` data)."
-)
-_DOCSTRINGS = {
-    "schedule": f"A :attr:`~time_split.types.DatetimeIterable`, {_OFFSET}, or `cron <https://pypi.org/project/croniter/>`_ expression.",
-    "before": _SPAN.format(arg="before"),
-    "after": _SPAN.format(arg="after"),
-    "step": "Select a subset of folds, preferring folds later in the schedule.",
-    "n_splits": "Maximum number of folds, preferring folds later in the schedule.",
-    "available": "Binds `schedule` to a range.",
-    "expand_limits": f'A {_OFFSET} used to expand `available` data to its likely `"true"` limits. Pass ``False`` to disable.',
-    "filter": "A callable ``(start, mid, end) -> bool`` applied to each fold. Strings are converted using :func:`~rics.misc.get_by_full_name`.",
-    "ignore_filters": "Set to ignore filtering parameters (e.g. `step` and `filter`).",
-    "USER_GUIDE": (
-        "For more information about the `schedule`, `before/after` and `expand_limits`-arguments"
-        ", see the :ref:`User guide`."
-    ),
-    "OFFSET": _OFFSET,
-    "DatetimeIndexSplitterKwargs": "See :func:`~time_split.split`. The `available` keyword is managed by the integration.",
-    "show_removed": "If ``True``, splits removed by `n_splits` or `step` are included in the figure.",
-}