pybear-dask 0.2.0__tar.gz

pybear_dask-0.2.0/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+
+
+## [0.2.0] - 2025-07-31
+
+### Added
+- base:
+
+        is_classifier
+
+- model_selection:
+    
+        GSTCVDask
+        AutoGridSearchCVDask
+        AutoGSTCVDask
+
+### Changed
+- None
+
+### Deprecated
+- None
+
+### Removed
+- None
+
+### Fixed
+- None
+
+### Security
+- None
+
+## [0.1] - [Unreleased]
+
+
+

pybear_dask-0.2.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, PylarBear
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

pybear_dask-0.2.0/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.3
+Name: pybear-dask
+Version: 0.2.0
+Summary: Python modules for data analytics applications with dask
+License: BSD-3-Clause
+Keywords: python data analytics pybear dask
+Author: Bill Sousa
+Author-email: WKSJR99@msn.com
+Maintainer: Bill Sousa
+Requires-Python: >=3.10,<3.13
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: dask (<2025.1)
+Requires-Dist: dask-ml (<2025.1)
+Requires-Dist: distributed (<2025.1)
+Requires-Dist: polars-lts-cpu (>=1.31.0,<2.0.0)
+Requires-Dist: pybear (>=0.2.0)
+Requires-Dist: scikit-learn (<1.7)
+Project-URL: Homepage, https://github.com/PylarBear/pybear-dask
+Project-URL: Repository, https://github.com/PylarBear/pybear-dask
+Description-Content-Type: text/x-rst
+
+pybear-dask
+===========
+
+|Tests|
+|Coverage|
+|Test Status 313|
+|Test Status 312|
+|Test Status 311|
+|Test Status 310|
+
+.. |Tests| image:: https://raw.githubusercontent.com/PylarBear/pybear-dask/main/.github/badges/tests-badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions
+
+.. |Coverage| image:: https://raw.githubusercontent.com/PylarBear/pybear-dask/main/.github/badges/coverage-badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions
+
+.. |Test Status 313| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py313.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py313.yml
+
+.. |Test Status 312| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py312.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py312.yml
+
+.. |Test Status 311| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py311.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py311.yml
+
+.. |Test Status 310| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py310.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py310.yml
+
+|TestPyPI Build Status|
+
+.. |TestPyPI Build Status| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/testpypi-publish.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/testpypi-publish.yml
+
+|PyPI Build Status|
+|Version|
+|PyPI Downloads|
+
+.. |PyPI Build Status| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/pypi-publish.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/pypi-publish.yml
+
+.. |Version| image:: https://img.shields.io/pypi/v/pybear-dask
+   :target: https://pypi.org/project/pybear-dask
+   :alt: PyPI Version
+
+.. |PyPI Downloads| image:: https://static.pepy.tech/badge/pybear-dask
+   :target: https://pepy.tech/project/pybear-dask/
+   :alt: PyPI Downloads
+
+.. |PythonVersion| replace:: >=3.10, <3.13
+.. |DaskVersion| replace:: <2025.1.0
+.. |DaskMLVersion| replace:: <2025.1.0
+.. |DistributedVersion| replace:: <2025.1.0
+.. |PybearVersion| replace:: >=0.1.22
+.. |PytestVersion| replace:: >=7.0.0
+
+
+
+pybear-dask is a Python computing library that supplements the pybear
+library with analogous modules that have dask capability.
+
+Website: https://github.com/PylarBear/pybear-dask
+
+License
+-------
+
+BSD 3-Clause License. See `License File <https://github.com/PylarBear/pybear-dask/blob/main/LICENSE>`__.
+
+=======
+
+Installation
+------------
+
+Dependencies
+~~~~~~~~~~~~
+
+pybear-dask requires:
+
+- Python (|PythonVersion|)
+- dask (|DaskVersion|)
+- dask-ml (|DaskMLVersion|)
+- distributed (|DistributedVersion|)
+- pybear (|PybearVersion|)
+
+User installation
+~~~~~~~~~~~~~~~~~
+
+Install pybear-dask from the online PyPI package repository using ``pip``::
+
+   (your-env) $ pip install pybear-dask
+
+Conda distributions are expected to be made available sometime after release to
+PyPI.
+
+=======
+
+Usage
+-----
+The folder structure of pybear-dask is nearly identical to scikit-learn. This
+is so those that are familiar with the scikit layout and have experience with
+writing the associated import statements have an easy transition to pybear-dask.
+The pybear-dask subfolders are *base* and *model_selection*.
+
+You can import pybear-dask's packages in the same way you would with scikit.
+Here are a few examples of how you could import and use pybear-dask modules:
+
+.. code-block:: console
+
+    from pybear-dask.model_selection import GSTCVDask
+
+    search = GSTCVDask()
+    search.fit(X, y)
+
+    from pybear-dask import model_selection as ms
+
+    search = ms.AutoGridSearchCVDask()
+    search.fit(X, y)
+
+
+=======
+
+Major Modules
+-------------
+
+AutoGridSearchCVDask
+~~~~~~~~~~~~~~~~~~~~
+Perform multiple uninterrupted passes of grid search with dask_ml GridSearchCV 
+and dask objects utilizing progressively narrower search grids.
+
+- Access via pybear-dask.model_selection.AutoGridSearchCVDask.
+
+GSTCVDask (GridSearchThresholdCV for Dask)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Perform conventional grid search on a classifier with concurrent threshold 
+search using dask objects in parallel and distributed environments. Finds the 
+global optima for the passed parameters and thresholds. Fully compliant with 
+the dask_ml/scikit-learn GridSearchCV API.
+
+- Access via pybear-dask.model_selection.GSTCVDask.
+
+AutoGSTCVDask (AutoGridSearchThresholdCV for Dask)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Perform multiple uninterrupted passes of grid search with pybear-dask GSTCVDask
+utilizing progressively narrower search grids.
+
+- Access via pybear-dask.model_selection.AutoGSTCVDask.
+
+=======
+
+Changelog
+---------
+
+See the `changelog <https://github.com/PylarBear/pybear-dask/blob/main/CHANGELOG.md>`__
+for a history of notable changes to pybear-dask.
+
+=======
+
+Development
+-----------
+
+Important links
+~~~~~~~~~~~~~~~
+
+- Official source code repo: https://github.com/PylarBear/pybear-dask
+- Download releases: https://pypi.org/project/pybear-dask/
+- Issue tracker: https://github.com/PylarBear/pybear-dask/issues
+
+Source code
+~~~~~~~~~~~
+
+You can clone the latest source code with the command::
+
+    git clone https://github.com/PylarBear/pybear-dask.git
+
+Contributing
+~~~~~~~~~~~~
+
+pybear-dask is not ready for contributions at this time!
+
+Testing
+~~~~~~~
+
+pybear-dask 0.2 is tested via GitHub Actions to run on Linux, Windows, and MacOS,
+with Python versions 3.10, 3.11, and 3.12. pybear-dask is not tested on earlier
+versions, but some features may work.
+
+If you want to test pybear-dask yourself, you will need:
+
+- pytest (|PytestVersion|)
+
+The tests are not available in the PyPI pip installation. You can get
+the tests by downloading the tarball from the pybear-dask project page on
+`pypi.org <https://pypi.org/project/pybear-dask/>`_ or cloning the pybear-dask
+repo from `GitHub <https://github.com/PylarBear/pybear-dask>`_. Once you have
+the source files in a local project folder, create a poetry environment for the
+project and install the test dependencies. After installation, launch the poetry
+environment shell and you can launch the test suite from the root of your
+pybear-dask project folder with::
+
+    (your-pybear-dask-env) you@your_computer:/path/to/pybear-dask/project$ pytest tests/
+
+Project History
+---------------
+
+This project was spun off the main pybear project just prior to the first
+public release of both. pybear-dask was spun off to ensure maximum stability
+for the main pybear project, while keeping these modules available.
+
+Help and Support
+----------------
+
+Documentation
+~~~~~~~~~~~~~
+
+Documentation is not expected to be made available via a website for this
+package. Use the documentation for similar packages in the main pybear package.
+See the repo for pybear: https://github.com/PylarBear/pybear/
+
+Communication
+~~~~~~~~~~~~~
+
+- GitHub Discussions: https://github.com/PylarBear/pybear-dask/discussions
+- Website: https://github.com/PylarBear/pybear-dask
+
+
+
+
+
+

pybear_dask-0.2.0/README.rst

@@ -0,0 +1,227 @@
+pybear-dask
+===========
+
+|Tests|
+|Coverage|
+|Test Status 313|
+|Test Status 312|
+|Test Status 311|
+|Test Status 310|
+
+.. |Tests| image:: https://raw.githubusercontent.com/PylarBear/pybear-dask/main/.github/badges/tests-badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions
+
+.. |Coverage| image:: https://raw.githubusercontent.com/PylarBear/pybear-dask/main/.github/badges/coverage-badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions
+
+.. |Test Status 313| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py313.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py313.yml
+
+.. |Test Status 312| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py312.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py312.yml
+
+.. |Test Status 311| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py311.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py311.yml
+
+.. |Test Status 310| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py310.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/matrix-tests-py310.yml
+
+|TestPyPI Build Status|
+
+.. |TestPyPI Build Status| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/testpypi-publish.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/testpypi-publish.yml
+
+|PyPI Build Status|
+|Version|
+|PyPI Downloads|
+
+.. |PyPI Build Status| image:: https://github.com/PylarBear/pybear-dask/actions/workflows/pypi-publish.yml/badge.svg
+   :target: https://github.com/PylarBear/pybear-dask/actions/workflows/pypi-publish.yml
+
+.. |Version| image:: https://img.shields.io/pypi/v/pybear-dask
+   :target: https://pypi.org/project/pybear-dask
+   :alt: PyPI Version
+
+.. |PyPI Downloads| image:: https://static.pepy.tech/badge/pybear-dask
+   :target: https://pepy.tech/project/pybear-dask/
+   :alt: PyPI Downloads
+
+.. |PythonVersion| replace:: >=3.10, <3.13
+.. |DaskVersion| replace:: <2025.1.0
+.. |DaskMLVersion| replace:: <2025.1.0
+.. |DistributedVersion| replace:: <2025.1.0
+.. |PybearVersion| replace:: >=0.1.22
+.. |PytestVersion| replace:: >=7.0.0
+
+
+
+pybear-dask is a Python computing library that supplements the pybear
+library with analogous modules that have dask capability.
+
+Website: https://github.com/PylarBear/pybear-dask
+
+License
+-------
+
+BSD 3-Clause License. See `License File <https://github.com/PylarBear/pybear-dask/blob/main/LICENSE>`__.
+
+=======
+
+Installation
+------------
+
+Dependencies
+~~~~~~~~~~~~
+
+pybear-dask requires:
+
+- Python (|PythonVersion|)
+- dask (|DaskVersion|)
+- dask-ml (|DaskMLVersion|)
+- distributed (|DistributedVersion|)
+- pybear (|PybearVersion|)
+
+User installation
+~~~~~~~~~~~~~~~~~
+
+Install pybear-dask from the online PyPI package repository using ``pip``::
+
+   (your-env) $ pip install pybear-dask
+
+Conda distributions are expected to be made available sometime after release to
+PyPI.
+
+=======
+
+Usage
+-----
+The folder structure of pybear-dask is nearly identical to scikit-learn. This
+is so those that are familiar with the scikit layout and have experience with
+writing the associated import statements have an easy transition to pybear-dask.
+The pybear-dask subfolders are *base* and *model_selection*.
+
+You can import pybear-dask's packages in the same way you would with scikit.
+Here are a few examples of how you could import and use pybear-dask modules:
+
+.. code-block:: console
+
+    from pybear-dask.model_selection import GSTCVDask
+
+    search = GSTCVDask()
+    search.fit(X, y)
+
+    from pybear-dask import model_selection as ms
+
+    search = ms.AutoGridSearchCVDask()
+    search.fit(X, y)
+
+
+=======
+
+Major Modules
+-------------
+
+AutoGridSearchCVDask
+~~~~~~~~~~~~~~~~~~~~
+Perform multiple uninterrupted passes of grid search with dask_ml GridSearchCV 
+and dask objects utilizing progressively narrower search grids.
+
+- Access via pybear-dask.model_selection.AutoGridSearchCVDask.
+
+GSTCVDask (GridSearchThresholdCV for Dask)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Perform conventional grid search on a classifier with concurrent threshold 
+search using dask objects in parallel and distributed environments. Finds the 
+global optima for the passed parameters and thresholds. Fully compliant with 
+the dask_ml/scikit-learn GridSearchCV API.
+
+- Access via pybear-dask.model_selection.GSTCVDask.
+
+AutoGSTCVDask (AutoGridSearchThresholdCV for Dask)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Perform multiple uninterrupted passes of grid search with pybear-dask GSTCVDask
+utilizing progressively narrower search grids.
+
+- Access via pybear-dask.model_selection.AutoGSTCVDask.
+
+=======
+
+Changelog
+---------
+
+See the `changelog <https://github.com/PylarBear/pybear-dask/blob/main/CHANGELOG.md>`__
+for a history of notable changes to pybear-dask.
+
+=======
+
+Development
+-----------
+
+Important links
+~~~~~~~~~~~~~~~
+
+- Official source code repo: https://github.com/PylarBear/pybear-dask
+- Download releases: https://pypi.org/project/pybear-dask/
+- Issue tracker: https://github.com/PylarBear/pybear-dask/issues
+
+Source code
+~~~~~~~~~~~
+
+You can clone the latest source code with the command::
+
+    git clone https://github.com/PylarBear/pybear-dask.git
+
+Contributing
+~~~~~~~~~~~~
+
+pybear-dask is not ready for contributions at this time!
+
+Testing
+~~~~~~~
+
+pybear-dask 0.2 is tested via GitHub Actions to run on Linux, Windows, and MacOS,
+with Python versions 3.10, 3.11, and 3.12. pybear-dask is not tested on earlier
+versions, but some features may work.
+
+If you want to test pybear-dask yourself, you will need:
+
+- pytest (|PytestVersion|)
+
+The tests are not available in the PyPI pip installation. You can get
+the tests by downloading the tarball from the pybear-dask project page on
+`pypi.org <https://pypi.org/project/pybear-dask/>`_ or cloning the pybear-dask
+repo from `GitHub <https://github.com/PylarBear/pybear-dask>`_. Once you have
+the source files in a local project folder, create a poetry environment for the
+project and install the test dependencies. After installation, launch the poetry
+environment shell and you can launch the test suite from the root of your
+pybear-dask project folder with::
+
+    (your-pybear-dask-env) you@your_computer:/path/to/pybear-dask/project$ pytest tests/
+
+Project History
+---------------
+
+This project was spun off the main pybear project just prior to the first
+public release of both. pybear-dask was spun off to ensure maximum stability
+for the main pybear project, while keeping these modules available.
+
+Help and Support
+----------------
+
+Documentation
+~~~~~~~~~~~~~
+
+Documentation is not expected to be made available via a website for this
+package. Use the documentation for similar packages in the main pybear package.
+See the repo for pybear: https://github.com/PylarBear/pybear/
+
+Communication
+~~~~~~~~~~~~~
+
+- GitHub Discussions: https://github.com/PylarBear/pybear-dask/discussions
+- Website: https://github.com/PylarBear/pybear-dask
+
+
+
+
+

pybear_dask-0.2.0/pyproject.toml

@@ -0,0 +1,83 @@
+[tool.poetry]
+name = "pybear-dask"
+version = "0.2.0"
+description = "Python modules for data analytics applications with dask"
+license = "BSD-3-clause"
+authors = ["Bill Sousa <WKSJR99@msn.com>"]
+maintainers = ["Bill Sousa"]
+readme = "README.rst"
+# The contents of the README file(s) are used to populate the Description field
+# of your distribution’s metadata (similar to long_description in setuptools).
+# When multiple files are specified they are concatenated with newlines.
+homepage = "https://github.com/PylarBear/pybear-dask"
+repository = "https://github.com/PylarBear/pybear-dask"
+#documentation
+keywords = ["python data analytics pybear dask"]
+#classifiers
+packages = [
+	{ include = "pybear_dask", from = "src"}
+]
+include = [
+    "LICENSE",
+    "README.rst",
+    "CHANGELOG.md",
+    "tests"
+]
+#exclude
+
+
+[tool.poetry.dependencies]
+# These packages are mandatory and form the core of this package’s distribution.
+python = "^3.10, <3.13"
+dask = "<2025.1"
+dask-ml = "<2025.1"
+distributed = "<2025.1"
+pybear = ">=0.2.0"    #{ version = ">=0.1.22", source = "testpypi" }
+scikit-learn = "<1.7"
+polars-lts-cpu = "^1.31.0"
+
+
+[tool.poetry.group.dev.dependencies]
+bokeh = "*"
+docutils = ">=0.20"
+graphviz = "*"
+jupyter = "*"
+notebook = "*"
+pyarrow = ">=18.0.0"
+
+
+[tool.poetry.group.test.dependencies]
+pytest = ">=7.0.0"
+pytest-cov = "*"
+pytest-html = "*"
+
+
+[tool.poetry.extras]
+# Optional dependencies. They can be opted into by apps.
+
+
+[tool.poetry.scripts]
+
+
+[tool.poetry.plugins]
+
+
+[tool.poetry.urls]
+# If you publish your package on PyPI, they will appear in the Project Links section.
+
+
+#[[tool.poetry.source]]
+#name = "testpypi"
+#url = "https://test.pypi.org/simple/"
+#priority = "explicit"
+
+
+[tool.coverage.run]
+source = ["pybear_dask"]
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+

pybear_dask-0.2.0/src/pybear_dask/__init__.py

@@ -0,0 +1,19 @@
+# Author:
+#         Bill Sousa
+#
+# License: BSD 3 clause
+#
+
+
+
+from ._version import __version__
+from ._version import __version_tuple__
+
+__all__ = [
+    "model_selection",
+    "__version__"
+]
+
+
+
+

pybear_dask-0.2.0/src/pybear_dask/_version.py

@@ -0,0 +1,38 @@
+# Author:
+#         Bill Sousa
+#
+# License: BSD 3 clause
+#
+
+
+from typing import Tuple
+from typing_extensions import Union
+import numpy as np
+
+
+try:
+    from importlib.metadata import version as get_version
+except ImportError:
+    # For older Python versions, use importlib-metadata package
+    from importlib_metadata import version as get_version
+
+
+version: str
+__version__: str
+VERSION_TUPLE = Tuple[Union[int, str], ...]
+version_tuple: VERSION_TUPLE
+__version_tuple__: VERSION_TUPLE
+
+__version__ = version = get_version('pybear-dask')
+dot_idxs = np.arange(len(__version__))[np.array(list(__version__)) == '.']
+dot_idxs = list(map(int, dot_idxs))
+__version_tuple__ = version_tuple = (
+    int(__version__[:dot_idxs[0]]),
+    int(__version__[dot_idxs[0]+1:dot_idxs[1]]),
+    int(__version__[dot_idxs[1]+1:])
+)
+
+
+
+
+