driftwatch 0.2.0__tar.gz

driftwatch-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DriftWatch Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

driftwatch-0.2.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: driftwatch
+Version: 0.2.0
+Summary: Lightweight ML drift monitoring, built for real-world pipelines
+Author-email: Your Name <your.email@example.com>
+Maintainer-email: Your Name <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/YOUR_USERNAME/driftwatch
+Project-URL: Documentation, https://driftwatch.readthedocs.io
+Project-URL: Repository, https://github.com/YOUR_USERNAME/driftwatch
+Project-URL: Issues, https://github.com/YOUR_USERNAME/driftwatch/issues
+Project-URL: Changelog, https://github.com/YOUR_USERNAME/driftwatch/blob/main/CHANGELOG.md
+Keywords: machine-learning,mlops,drift-detection,monitoring,data-quality,model-monitoring
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: scipy>=1.7.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Requires-Dist: pandas-stubs>=2.0.0; extra == "dev"
+Provides-Extra: cli
+Requires-Dist: typer>=0.9.0; extra == "cli"
+Requires-Dist: rich>=13.0.0; extra == "cli"
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100.0; extra == "fastapi"
+Requires-Dist: uvicorn>=0.23.0; extra == "fastapi"
+Provides-Extra: mlflow
+Requires-Dist: mlflow>=2.0.0; extra == "mlflow"
+Provides-Extra: alerting
+Requires-Dist: httpx>=0.24.0; extra == "alerting"
+Requires-Dist: aiosmtplib>=2.0.0; extra == "alerting"
+Provides-Extra: all
+Requires-Dist: driftwatch[alerting,cli,fastapi,mlflow]; extra == "all"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.23.0; extra == "docs"
+Dynamic: license-file
+
+# DriftWatch
+
+<div align="center">
+
+**Lightweight ML drift monitoring, built for real-world pipelines**
+
+[![Documentation](https://img.shields.io/badge/docs-vincentcotella.github.io%2FDriftWatch-blue.svg)](https://vincentcotella.github.io/DriftWatch/)
+[![CI](https://github.com/VincentCotella/DriftWatch/actions/workflows/ci.yml/badge.svg)](https://github.com/VincentCotella/DriftWatch/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/driftwatch.svg)](https://pypi.org/project/driftwatch/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+---
+
+## 📖 Documentation
+
+**Read the full documentation here:** [vincentcotella.github.io/DriftWatch](https://vincentcotella.github.io/DriftWatch/)
+
+## 🚀 Features
+
+- **Simple API**: Detect drift in 3 lines of code.
+- **Multiple Detectors**: **PSI**, **KS-Test**, **Wasserstein Distance**, **Chi-Squared**.
+- **Production-Ready**:
+    - ⚡ **FastAPI Integration** (Middleware included).
+    - 🔔 **Slack Alerts** built-in.
+    - 🛠️ **CLI** for batch processing.
+- **Lightweight**: Minimal dependencies (`numpy`, `pandas`, `scipy`).
+- **Type-Safe**: 100% typed code with `mypy` support.
+
+## 📦 Installation
+
+```bash
+pip install driftwatch
+```
+
+For extras (CLI, FastAPI, Alerting):
+```bash
+pip install driftwatch[all]
+```
+
+## ⚡ Quick Start
+
+```python
+from driftwatch import Monitor
+import pandas as pd
+
+# 1. Initialize monitor with reference data (e.g., training set)
+monitor = Monitor(reference_data=pd.read_parquet("train.parquet"))
+
+# 2. Check production data for drift
+report = monitor.check(pd.read_parquet("production.parquet"))
+
+# 3. Act on results
+if report.has_drift():
+    print(f"⚠️ Drift detected! Ratio: {report.drift_ratio():.1%}")
+    print(f"Drifted features: {report.drifted_features()}")
+else:
+    print("✅ All systems normal.")
+```
+
+## 🛠️ Usage Scenarios
+
+| Scenario | Solution |
+|----------|----------|
+| **Real-time API** | Use `DriftMiddleware` in FastAPI to monitor every request. |
+| **Batch Job** | Use `driftwatch check` CLI in your Airflow/Cron jobs. |
+| **CI/CD** | Block deployments if validation data drifts from training data. |
+| **Alerting** | Send Slack notifications automatically when drift is critical. |
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](https://vincentcotella.github.io/DriftWatch/contributing/) for details.
+
+1. Fork the repo.
+2. Install dev dependencies: `pip install -e ".[dev,all]"`
+3. Run tests: `pytest`
+4. Submit a PR!
+
+## 📄 License
+
+MIT © [Vincent Cotella](https://github.com/VincentCotella)

driftwatch-0.2.0/README.md

@@ -0,0 +1,83 @@
+# DriftWatch
+
+<div align="center">
+
+**Lightweight ML drift monitoring, built for real-world pipelines**
+
+[![Documentation](https://img.shields.io/badge/docs-vincentcotella.github.io%2FDriftWatch-blue.svg)](https://vincentcotella.github.io/DriftWatch/)
+[![CI](https://github.com/VincentCotella/DriftWatch/actions/workflows/ci.yml/badge.svg)](https://github.com/VincentCotella/DriftWatch/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/driftwatch.svg)](https://pypi.org/project/driftwatch/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+---
+
+## 📖 Documentation
+
+**Read the full documentation here:** [vincentcotella.github.io/DriftWatch](https://vincentcotella.github.io/DriftWatch/)
+
+## 🚀 Features
+
+- **Simple API**: Detect drift in 3 lines of code.
+- **Multiple Detectors**: **PSI**, **KS-Test**, **Wasserstein Distance**, **Chi-Squared**.
+- **Production-Ready**:
+    - ⚡ **FastAPI Integration** (Middleware included).
+    - 🔔 **Slack Alerts** built-in.
+    - 🛠️ **CLI** for batch processing.
+- **Lightweight**: Minimal dependencies (`numpy`, `pandas`, `scipy`).
+- **Type-Safe**: 100% typed code with `mypy` support.
+
+## 📦 Installation
+
+```bash
+pip install driftwatch
+```
+
+For extras (CLI, FastAPI, Alerting):
+```bash
+pip install driftwatch[all]
+```
+
+## ⚡ Quick Start
+
+```python
+from driftwatch import Monitor
+import pandas as pd
+
+# 1. Initialize monitor with reference data (e.g., training set)
+monitor = Monitor(reference_data=pd.read_parquet("train.parquet"))
+
+# 2. Check production data for drift
+report = monitor.check(pd.read_parquet("production.parquet"))
+
+# 3. Act on results
+if report.has_drift():
+    print(f"⚠️ Drift detected! Ratio: {report.drift_ratio():.1%}")
+    print(f"Drifted features: {report.drifted_features()}")
+else:
+    print("✅ All systems normal.")
+```
+
+## 🛠️ Usage Scenarios
+
+| Scenario | Solution |
+|----------|----------|
+| **Real-time API** | Use `DriftMiddleware` in FastAPI to monitor every request. |
+| **Batch Job** | Use `driftwatch check` CLI in your Airflow/Cron jobs. |
+| **CI/CD** | Block deployments if validation data drifts from training data. |
+| **Alerting** | Send Slack notifications automatically when drift is critical. |
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](https://vincentcotella.github.io/DriftWatch/contributing/) for details.
+
+1. Fork the repo.
+2. Install dev dependencies: `pip install -e ".[dev,all]"`
+3. Run tests: `pytest`
+4. Submit a PR!
+
+## 📄 License
+
+MIT © [Vincent Cotella](https://github.com/VincentCotella)

driftwatch-0.2.0/pyproject.toml

@@ -0,0 +1,211 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "driftwatch"
+version = "0.2.0"
+description = "Lightweight ML drift monitoring, built for real-world pipelines"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Your Name", email = "your.email@example.com"}
+]
+maintainers = [
+    {name = "Your Name", email = "your.email@example.com"}
+]
+keywords = [
+    "machine-learning",
+    "mlops",
+    "drift-detection",
+    "monitoring",
+    "data-quality",
+    "model-monitoring"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "numpy>=1.21.0",
+    "pandas>=1.3.0",
+    "scipy>=1.7.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-asyncio>=0.21.0",
+    "ruff>=0.1.0",
+    "black>=23.0.0",
+    "mypy>=1.0.0",
+    "pre-commit>=3.0.0",
+    "pandas-stubs>=2.0.0",
+]
+cli = [
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+]
+fastapi = [
+    "fastapi>=0.100.0",
+    "uvicorn>=0.23.0",
+]
+mlflow = [
+    "mlflow>=2.0.0",
+]
+alerting = [
+    "httpx>=0.24.0",
+    "aiosmtplib>=2.0.0",
+]
+all = [
+    "driftwatch[cli,fastapi,mlflow,alerting]",
+]
+docs = [
+    "mkdocs>=1.5.0",
+    "mkdocs-material>=9.0.0",
+    "mkdocstrings[python]>=0.23.0",
+]
+
+[project.scripts]
+driftwatch = "driftwatch.cli.main:app"
+
+[project.urls]
+Homepage = "https://github.com/YOUR_USERNAME/driftwatch"
+Documentation = "https://driftwatch.readthedocs.io"
+Repository = "https://github.com/YOUR_USERNAME/driftwatch"
+Issues = "https://github.com/YOUR_USERNAME/driftwatch/issues"
+Changelog = "https://github.com/YOUR_USERNAME/driftwatch/blob/main/CHANGELOG.md"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+driftwatch = ["py.typed"]
+
+# ============================================================================
+# RUFF CONFIGURATION
+# ============================================================================
+[tool.ruff]
+target-version = "py39"
+line-length = 88
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+    "ARG",    # flake8-unused-arguments
+    "SIM",    # flake8-simplify
+    "TCH",    # flake8-type-checking
+    "PTH",    # flake8-use-pathlib
+    "RUF",    # Ruff-specific rules
+]
+ignore = [
+    "E501",   # line too long (handled by formatter)
+    "B008",   # do not perform function calls in argument defaults
+    "B905",   # zip without explicit strict
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["driftwatch"]
+
+# ============================================================================
+# BLACK CONFIGURATION
+# ============================================================================
+[tool.black]
+line-length = 88
+target-version = ['py39', 'py310', 'py311', 'py312']
+include = '\.pyi?$'
+
+# ============================================================================
+# MYPY CONFIGURATION
+# ============================================================================
+[tool.mypy]
+python_version = "3.9"
+mypy_path = "src"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+strict_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+show_error_codes = true
+namespace_packages = true
+explicit_package_bases = true
+
+[[tool.mypy.overrides]]
+module = [
+    "scipy.*",
+    "mlflow.*",
+    "starlette.*",
+    "fastapi.*",
+    "pandas.*",
+    "numpy.*",
+    "typer.*",
+    "rich.*",
+    "httpx.*",
+]
+ignore_missing_imports = true
+
+# ============================================================================
+# PYTEST CONFIGURATION
+# ============================================================================
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+addopts = [
+    "-v",
+    "--tb=short",
+    "--strict-markers",
+    "-ra",
+]
+markers = [
+    "slow: marks tests as slow",
+    "integration: marks tests as integration tests",
+]
+
+# ============================================================================
+# COVERAGE CONFIGURATION
+# ============================================================================
+[tool.coverage.run]
+source = ["src/driftwatch"]
+branch = true
+omit = [
+    "*/tests/*",
+    "*/__init__.py",
+    "*/integrations/*",  # Optional integrations require external deps
+    "*/cli/*",  # Optional CLI interface
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise NotImplementedError",
+    "if TYPE_CHECKING:",
+    "if __name__ == .__main__.:",
+]
+fail_under = 80
+show_missing = true

driftwatch-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

driftwatch-0.2.0/src/driftwatch/__init__.py

@@ -0,0 +1,22 @@
+"""
+DriftWatch - Lightweight ML drift monitoring, built for real-world pipelines.
+
+DriftWatch is an open-source Python library for detecting data drift and
+model drift in machine learning systems.
+
+Basic Usage:
+    >>> from driftwatch import Monitor
+    >>> monitor = Monitor(reference_data=train_df, features=["age", "income"])
+    >>> report = monitor.check(production_df)
+    >>> print(report.summary())
+"""
+
+from driftwatch.core.monitor import Monitor
+from driftwatch.core.report import DriftReport
+
+__version__ = "0.2.0"
+__all__ = [
+    "DriftReport",
+    "Monitor",
+    "__version__",
+]

driftwatch-0.2.0/src/driftwatch/cli/__init__.py

@@ -0,0 +1,5 @@
+"""Command-line interface for DriftWatch."""
+
+from driftwatch.cli.main import app
+
+__all__ = ["app"]