duckguard 2.2.0__py3-none-any.whl → 3.0.0__py3-none-any.whl

{duckguard-2.2.0.dist-info → duckguard-3.0.0.dist-info}/RECORD

@@ -1,16 +1,23 @@
-duckguard/__init__.py,sha256=PIXJFJtNEFMvwJ8XN9vJtrTjpz5PH6Df_uhXKpzCQd0,3078
+duckguard/__init__.py,sha256=hi1-MykRG4918Yj_vkOcnqQOyGZXS7fmqvkKDQcW2kU,3078
 duckguard/errors.py,sha256=xhQPxCCeB3dCQspTbQf58h_DvwHP1vAb6vKI9fHYAJ0,11493
-duckguard/anomaly/__init__.py,sha256=T3uuEX-eZNyep02BLodfqz7c5jbH9QqeoZUJnYJmp88,741
+duckguard/anomaly/__init__.py,sha256=mrTyL70cOR5S7_RNc9QLADdnBimIsbAoFTbKlWiIsbw,1353
+duckguard/anomaly/baselines.py,sha256=k28CjjqBa8IaZxnIgof-wjw_Xdb7NJZImC2OJJkGXQ8,8776
 duckguard/anomaly/detector.py,sha256=voA7WS2x2p5h5cnwH3C_2ly7HdYpXLwC4jDiPL2Xleo,12443
-duckguard/anomaly/methods.py,sha256=yg696KQFSW1wna_amGmldfRca7rxREITAd3_fOFcPT0,12743
+duckguard/anomaly/methods.py,sha256=CtV2G-kowXGgz0HYvNoi2Ge7eyHUg2GwGa3oZvunS38,13475
+duckguard/anomaly/ml_methods.py,sha256=UyEr8q4K_wNq7pWgTsV23IoBI13aqm0hHIwIFjIxeas,23449
+duckguard/checks/__init__.py,sha256=aSxO02ZILHnfrGhfomQ5EN69t7NZ4yr61Etwtcv_zIw,847
+duckguard/checks/conditional.py,sha256=gYFZD_6M-IUs1MGMZeDYH-qC99dyMJ-u63r1SgcBVs8,26646
+duckguard/checks/distributional.py,sha256=Cy3YlWnSPA5QZdNT_lYuTMRLrwvU1yJGk--RGzOQ5N4,18302
+duckguard/checks/multicolumn.py,sha256=cZhvW1S9qniQACz11tPtIWsBmcBVmz0kKpEDMnZ9ub0,23623
+duckguard/checks/query_based.py,sha256=T0shCxdPOQo70KUjV_5OUZTfOm6W2PJDWUUrQzD53-0,22045
 duckguard/cli/__init__.py,sha256=s5MNXEu_MbRqyV-jeUgCIDlHRQA97a9knM_anJooTl0,87
-duckguard/cli/main.py,sha256=ODIEg5WrGTQOi-Ju5aU_2hJjV2lKOdK1Fuiv8uH5HSE,35394
+duckguard/cli/main.py,sha256=sMq5RfM0-OeXTG_jgTRGyvfw-c4iwojNGUEW8AYQ3fA,46001
 duckguard/connectors/__init__.py,sha256=BMbVyyBPI9_GAFcwkQivf2xMvHwVOHvBMuT5qZ558jc,2232
 duckguard/connectors/base.py,sha256=XzGY6_pUwDJIVNhTfgNMkcGNOBs3xxjbnQ_NeMoz4eM,1864
 duckguard/connectors/bigquery.py,sha256=b-EHAF90dbyCh387qNirkRGY0sEsPAmvy-hNCbY7ilQ,5327
 duckguard/connectors/databricks.py,sha256=vsm5wWGb6V_J1yMdXyREjy9ElR84S0aLk0NgOAbd1J4,6550
-duckguard/connectors/factory.py,sha256=brO5ypD9nriHqWNN4x9KItq3mTtjcy5nM6eu5luS9RU,9156
-duckguard/connectors/files.py,sha256=QU5lFWf9NUv0lX_txx_CLfTzhcF7tAZtCGZOCrzX-tk,3841
+duckguard/connectors/factory.py,sha256=KA5uoN-2LPEJxNXDXpv2sKuyxTcNm2svmg9zSilgF_M,10246
+duckguard/connectors/files.py,sha256=V584kLHGLbZ3nCe2LbBdkTLcMc54VY-dSvHXKm_ffx8,4026
 duckguard/connectors/kafka.py,sha256=Oo_axyJck6gHrwLFpnGcUVKEfKqxqz-AEdlVkNBYVVE,10709
 duckguard/connectors/mongodb.py,sha256=3RI3-hiTHXQIk5cg9ZM5q2UDn5HU2wDnq-f8xj-Yc2A,7271
 duckguard/connectors/mysql.py,sha256=EW-VrZiNgOGFVnVccTR-jVrn3S6KHK6GA-Yj3kmmU5w,3875
@@ -27,43 +34,53 @@ duckguard/contracts/loader.py,sha256=iTmg9xjSAlYsBpQeTAJ1-ABQnuXs-qpMh3DH4rfN6qs
 duckguard/contracts/schema.py,sha256=pLoR4QIXs68Q93DOZqqTmPnPecCeZ4iy9lDXZMNuVmI,7032
 duckguard/contracts/validator.py,sha256=X972Ns-8UWBL8D4nCCQlNOHJas0Mc4ES8URbKqd0WLw,16432
 duckguard/core/__init__.py,sha256=pHndzrdehB0GFtlSQ46uvw8XgUQj55dVZQP1ZK-aDso,356
-duckguard/core/column.py,sha256=sQX2IxzYa3lJZFA6I8bWcA9vlYKyrz37CBdgiqGnHvY,17436
-duckguard/core/dataset.py,sha256=TSiB5cp90DRjFXBzeGMrvfGo16XQZ5AEhBRcI3UKZtM,8285
+duckguard/core/column.py,sha256=88m3WipKNdNslXNWAk4ofTf0kmNlDDAyhjDUa-Q6UGg,48326
+duckguard/core/dataset.py,sha256=kQY2ALTsid5x1NWOM5Wse60mOrLdUj8lKUs1cLK7cCo,44364
 duckguard/core/engine.py,sha256=ld_NHsWyBkVynmWyvbyQcHdXHhpIoSaRDyqAAtVx8J0,7897
-duckguard/core/result.py,sha256=Q2vsOA4X8BX0m3MpmtrkCbaIght9b7l9M_3g_GBLpRo,6378
+duckguard/core/result.py,sha256=BwmP0gNPAKVYHdyque1rDkbAhEvwFaA3PwhxaI7cY14,15178
 duckguard/core/scoring.py,sha256=42CVgxmmfo3Yb3m3Xl8qWnDgR7ndSZd8vXRwy9XSThI,16826
+duckguard/freshness/__init__.py,sha256=8XR7JxH9tz61En5DTMSDHrjhroPzvwCTVzBbBiRFexs,854
+duckguard/freshness/monitor.py,sha256=O_b4fh6unyZ2DXioX6O7KP9VpenGdLTpb9OdNb79dX8,14695
 duckguard/history/__init__.py,sha256=_O4OBEeku1X0-Jo87qA0KKwZbh-s3LwfypYTHp_mST8,970
-duckguard/history/schema.py,sha256=VQM7n9yrFl7YNte3PYMmofQikMG987TCwPFTfVS1LNQ,5818
+duckguard/history/schema.py,sha256=E3pP6u88OESmYQM08-XW8UQOmeUIFrM_JIpkQCM2f_g,9900
 duckguard/history/storage.py,sha256=0r2x2VNBUWjafZCFohy63NX4f4v4-SkyJaSCZRJUCj0,15413
 duckguard/history/trends.py,sha256=t6P3asMAPahDMK9E6sVf3nT3zFEDDZhk7n2Ice2I7BM,10702
 duckguard/integrations/__init__.py,sha256=SuqOzfdaejlMCti372FHD_R6bVaPaUmfEPG9IM6UOW0,831
 duckguard/integrations/airflow.py,sha256=pxC14Kgwou_2xWPvTfx8YWO-xg_vgFeAlGDhgGfXRyM,13195
 duckguard/integrations/dbt.py,sha256=Dw1meY-UhylDFhUZ2s47FnJGMp_gszHvadGn_hqYkSM,14101
-duckguard/notifications/__init__.py,sha256=vR81YTbbq_chW2A9P18k8ZiAgM9VSENbloRoVeJLtF4,1063
+duckguard/notifications/__init__.py,sha256=qEfUvt7d_WXlbsGlLB-FaNF4ksLtAyO8JXi1JCdo89w,1541
+duckguard/notifications/email.py,sha256=jwgxec8r6NUNqrxz3v5B4A3UL0-ZdxnJZhXQXWgMWH4,17168
 duckguard/notifications/formatter.py,sha256=Z2vGMpLdqPWYaYTaVtVjYnIbNU8Haer-7efohZ5IZxM,3991
 duckguard/notifications/notifiers.py,sha256=e-UBvoskFSzIwlCFTxIFdkI-z54zZeEeSQkvOvgV6JI,11703
 duckguard/profiler/__init__.py,sha256=a16GYeeFDZzwCemTsTuzO3Ih4M7_hOPb9hS8yt-nHzU,169
 duckguard/profiler/auto_profile.py,sha256=KbAkty-HrpNbTribi2uD17Fcsb-UiV5eG4zZsbyBOL4,12267
+duckguard/profiler/distribution_analyzer.py,sha256=I_jnDUtEG260yu7zEBU-2vHRIeYpAzuF-HKX99i8MGU,12644
+duckguard/profiler/outlier_detector.py,sha256=5c28HEWC4UobBVYsVnNRzJJvm1uz6BKXNfmZfJDlQ2A,15928
+duckguard/profiler/pattern_matcher.py,sha256=ue1x57fcQBivW9w3WjaAB-KDamjguK1D2H0r1cnpnPk,9387
+duckguard/profiler/quality_scorer.py,sha256=R7cfzPTxL6tMSb-cuNgCygquz92tXmB6BMEPmVZKmD0,13896
 duckguard/pytest_plugin/__init__.py,sha256=GuhFPvINnpoVSxhvCX9b5dymzdhsn2KZhXU6okk4xQU,168
 duckguard/pytest_plugin/plugin.py,sha256=SA1dvkZ0MYyNyRXzuqelreEo2zK0XTsNZeYwUYd3Gy0,4949
 duckguard/reporting/__init__.py,sha256=R7Fm--yEiuOb_II-Qo7MGXYyCNhsGnVsMVuAzZT6rIM,199
 duckguard/reporting/console.py,sha256=GvXFqKLLkU-LQb1FNkS7HI-NQYbHpQCSBYI4FSUDOMw,3026
 duckguard/reporting/json_report.py,sha256=dqUry9akuPRwNz4ysUM6ZP6ZCXl77nA_Z7mXG-1VGKA,3509
 duckguard/reports/__init__.py,sha256=JGGZ2IJFVOutcQaZ8kpjDDKJru9e5EsVi91au2VFKsk,1025
-duckguard/reports/html_reporter.py,sha256=mcvk_C1qoXFjzhcPLvDh3XlGP513kcLMpIsx_xARUW4,20734
+duckguard/reports/html_reporter.py,sha256=_8jzHg6WzC4xqXgqzHzYQTjE4vXbQGP-p1FUKmYAtuU,20670
 duckguard/reports/pdf_reporter.py,sha256=u6zuV24y9YCBlpDwDObHTSrVE9W9beTIqj-UQyvA8jQ,3094
 duckguard/rules/__init__.py,sha256=XYVasAnu8ErJ-Cvsqeh1mX5zxqd1wk-sM4OzuBJn72Y,813
-duckguard/rules/executor.py,sha256=0MKi4mA0Ig873J7JDKpE_O2OJsBFSx6w2jgcGQWl_8w,20720
-duckguard/rules/generator.py,sha256=h8sawDPDauw-ipU-gktDw1z4MMbKHgbt6hQq7QLwqVE,10989
+duckguard/rules/executor.py,sha256=AL32_0CwLZCg4oP64jIV1a6gL94WT0pjMnYurA3BWx0,43410
+duckguard/rules/generator.py,sha256=h8NWcRsqBqj4xEddavFRlnWZfCi3eoXsqWyIJmxPGeo,11184
 duckguard/rules/loader.py,sha256=gzFihSX6w3lpldEXVUn0Ysh9MAOEXh3ABNqJrVlGEng,14622
-duckguard/rules/schema.py,sha256=KkUAUjQBNbDLRX_XfiXc6DH8EdK4Zbd3NqupKjkoZjc,9326
+duckguard/rules/schema.py,sha256=EcmJfib-wSDDNwBphXN75Jn84BzgEvbVCQmIOdgr4DE,12693
+duckguard/schema_history/__init__.py,sha256=q7Kofw5PxbJlXTLzXNZyhvpsrYDKJl1OScWVwEGYIkY,949
+duckguard/schema_history/analyzer.py,sha256=NRDQCjhPstmp6zD7Co0D4D6jVSJ9SB-iAmv4GUQdvJc,14396
+duckguard/schema_history/tracker.py,sha256=ZuMYX8knruiodXd22KoGaT7MgQBElDjekNz73aSwkqI,8468
 duckguard/semantic/__init__.py,sha256=FbX60d-Qf7qaVEhnSTy9NzKiXZt66A1G-NZdhvi3TIY,847
 duckguard/semantic/analyzer.py,sha256=2be1oofe-owBhTg-Dy88-wihaoTQ7DPxf1NuA1sgfR0,8297
-duckguard/semantic/detector.py,sha256=YUAPj-CEiKQCQn2BjnL5gzETH4N4ffV1EIdGcD4r3ms,14872
+duckguard/semantic/detector.py,sha256=MPdb2Rv9VGQBko7nmPk4-Kjga_XVjPZdHCr29gdET0M,15665
 duckguard/semantic/validators.py,sha256=8Zu3vwPwh79U09zGf4_PpcwV85_hbNCwRHcxTIQ7G_I,10945
 duckguard/validators/__init__.py,sha256=g717IM5xlVLCTg1nLRRccLAFHCsbRO-IgjzG4H6K32A,268
-duckguard-2.2.0.dist-info/METADATA,sha256=nX1ekQ3XILAlHloEG3r5c6we5FZxvVmrYEUIkd2mQnM,11632
-duckguard-2.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-duckguard-2.2.0.dist-info/entry_points.txt,sha256=teP6JdXUvY20E9P44TW_Z24xuQtXMgnCyOuWtd_KIYU,108
-duckguard-2.2.0.dist-info/licenses/LICENSE,sha256=1Li9P3fainL-epQ9kEHZWKDScWtp4inPd6AkhUTJStk,3841
-duckguard-2.2.0.dist-info/RECORD,,
+duckguard-3.0.0.dist-info/METADATA,sha256=bkRQeGGM5c3BcvOZpJeHx4byCHWctL1jgCDHa7VR5kc,31770
+duckguard-3.0.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+duckguard-3.0.0.dist-info/entry_points.txt,sha256=teP6JdXUvY20E9P44TW_Z24xuQtXMgnCyOuWtd_KIYU,108
+duckguard-3.0.0.dist-info/licenses/LICENSE,sha256=1Li9P3fainL-epQ9kEHZWKDScWtp4inPd6AkhUTJStk,3841
+duckguard-3.0.0.dist-info/RECORD,,

duckguard-2.2.0.dist-info/METADATA

@@ -1,351 +0,0 @@
-Metadata-Version: 2.4
-Name: duckguard
-Version: 2.2.0
-Summary: A Python-native data quality tool with AI superpowers, built on DuckDB for speed
-Project-URL: Homepage, https://github.com/XDataHubAI/duckguard
-Project-URL: Documentation, https://github.com/XDataHubAI/duckguard
-Project-URL: Repository, https://github.com/XDataHubAI/duckguard
-Author: DuckGuard Team
-License-Expression: Elastic-2.0
-License-File: LICENSE
-Keywords: data-engineering,data-quality,data-validation,duckdb,testing
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: Other/Proprietary License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Database
-Classifier: Topic :: Software Development :: Testing
-Requires-Python: >=3.10
-Requires-Dist: duckdb>=1.0.0
-Requires-Dist: packaging>=21.0
-Requires-Dist: pyarrow>=14.0.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: pyyaml>=6.0.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: typer>=0.9.0
-Provides-Extra: airflow
-Requires-Dist: apache-airflow>=2.5.0; extra == 'airflow'
-Provides-Extra: all
-Requires-Dist: anthropic>=0.18.0; extra == 'all'
-Requires-Dist: apache-airflow>=2.5.0; extra == 'all'
-Requires-Dist: databricks-sql-connector>=2.0.0; extra == 'all'
-Requires-Dist: google-cloud-bigquery>=3.0.0; extra == 'all'
-Requires-Dist: jinja2>=3.0.0; extra == 'all'
-Requires-Dist: kafka-python>=2.0.0; extra == 'all'
-Requires-Dist: openai>=1.0.0; extra == 'all'
-Requires-Dist: oracledb>=1.0.0; extra == 'all'
-Requires-Dist: psycopg2-binary>=2.9.0; extra == 'all'
-Requires-Dist: pymongo>=4.0.0; extra == 'all'
-Requires-Dist: pymysql>=1.0.0; extra == 'all'
-Requires-Dist: pyodbc>=4.0.0; extra == 'all'
-Requires-Dist: redshift-connector>=2.0.0; extra == 'all'
-Requires-Dist: snowflake-connector-python>=3.0.0; extra == 'all'
-Requires-Dist: weasyprint>=60.0; extra == 'all'
-Provides-Extra: bigquery
-Requires-Dist: google-cloud-bigquery>=3.0.0; extra == 'bigquery'
-Provides-Extra: databases
-Requires-Dist: databricks-sql-connector>=2.0.0; extra == 'databases'
-Requires-Dist: google-cloud-bigquery>=3.0.0; extra == 'databases'
-Requires-Dist: kafka-python>=2.0.0; extra == 'databases'
-Requires-Dist: oracledb>=1.0.0; extra == 'databases'
-Requires-Dist: psycopg2-binary>=2.9.0; extra == 'databases'
-Requires-Dist: pymongo>=4.0.0; extra == 'databases'
-Requires-Dist: pymysql>=1.0.0; extra == 'databases'
-Requires-Dist: pyodbc>=4.0.0; extra == 'databases'
-Requires-Dist: redshift-connector>=2.0.0; extra == 'databases'
-Requires-Dist: snowflake-connector-python>=3.0.0; extra == 'databases'
-Provides-Extra: databricks
-Requires-Dist: databricks-sql-connector>=2.0.0; extra == 'databricks'
-Provides-Extra: dev
-Requires-Dist: black>=23.0.0; extra == 'dev'
-Requires-Dist: mypy>=1.0.0; extra == 'dev'
-Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
-Requires-Dist: pytest>=7.0.0; extra == 'dev'
-Requires-Dist: ruff>=0.1.0; extra == 'dev'
-Provides-Extra: kafka
-Requires-Dist: kafka-python>=2.0.0; extra == 'kafka'
-Provides-Extra: llm
-Requires-Dist: anthropic>=0.18.0; extra == 'llm'
-Requires-Dist: openai>=1.0.0; extra == 'llm'
-Provides-Extra: mongodb
-Requires-Dist: pymongo>=4.0.0; extra == 'mongodb'
-Provides-Extra: mysql
-Requires-Dist: pymysql>=1.0.0; extra == 'mysql'
-Provides-Extra: oracle
-Requires-Dist: oracledb>=1.0.0; extra == 'oracle'
-Provides-Extra: postgres
-Requires-Dist: psycopg2-binary>=2.9.0; extra == 'postgres'
-Provides-Extra: redshift
-Requires-Dist: redshift-connector>=2.0.0; extra == 'redshift'
-Provides-Extra: reports
-Requires-Dist: jinja2>=3.0.0; extra == 'reports'
-Requires-Dist: weasyprint>=60.0; extra == 'reports'
-Provides-Extra: snowflake
-Requires-Dist: snowflake-connector-python>=3.0.0; extra == 'snowflake'
-Provides-Extra: sqlserver
-Requires-Dist: pyodbc>=4.0.0; extra == 'sqlserver'
-Description-Content-Type: text/markdown
-
-# DuckGuard
-
-Data quality that just works. Python-native, DuckDB-powered, 10x faster.
-
-[![PyPI version](https://img.shields.io/pypi/v/duckguard.svg)](https://pypi.org/project/duckguard/)
-[![Downloads](https://static.pepy.tech/badge/duckguard)](https://pepy.tech/project/duckguard)
-[![GitHub stars](https://img.shields.io/github/stars/XDataHubAI/duckguard?style=social)](https://github.com/XDataHubAI/duckguard/stargazers)
-[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
-[![License: Elastic-2.0](https://img.shields.io/badge/License-Elastic--2.0-blue.svg)](https://www.elastic.co/licensing/elastic-license)
-[![CI](https://github.com/XDataHubAI/duckguard/actions/workflows/ci.yml/badge.svg)](https://github.com/XDataHubAI/duckguard/actions/workflows/ci.yml)
-
-[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/XDataHubAI/duckguard/blob/main/examples/getting_started.ipynb)
-[![Kaggle](https://kaggle.com/static/images/open-in-kaggle.svg)](https://kaggle.com/kernels/welcome?src=https://github.com/XDataHubAI/duckguard/blob/main/examples/getting_started.ipynb)
-
-```bash
-pip install duckguard
-
-# With optional features
-pip install duckguard[reports]   # HTML/PDF reports
-pip install duckguard[airflow]   # Airflow integration
-pip install duckguard[all]       # All features
-```
-
-## 60-Second Demo
-
-```bash
-# CLI - instant data quality check
-duckguard check data.csv
-
-# Auto-generate validation rules
-duckguard discover data.csv --output duckguard.yaml
-```
-
-```python
-# Python - feels like pytest
-from duckguard import connect
-
-orders = connect("data/orders.csv")
-
-assert orders.row_count > 0
-assert orders.customer_id.null_percent < 5
-assert orders.amount.between(0, 10000)
-assert orders.status.isin(['pending', 'shipped', 'delivered'])
-```
-
-## Key Features
-
-| Feature | Description |
-|---------|-------------|
-| **Quality Scoring** | Get A-F grades for your data |
-| **YAML Rules** | Define checks in simple YAML files |
-| **Semantic Detection** | Auto-detect emails, phones, SSNs, PII |
-| **Data Contracts** | Schema + SLAs with breaking change detection |
-| **Anomaly Detection** | Z-score, IQR, and percent change methods |
-| **pytest Integration** | Data tests alongside unit tests |
-| **Slack/Teams Alerts** | Get notified when checks fail |
-| **Row-Level Errors** | See exactly which rows failed |
-| **dbt Integration** | Export rules as dbt tests |
-| **HTML/PDF Reports** | Generate beautiful shareable reports |
-| **Historical Tracking** | Store and analyze quality trends over time |
-| **Airflow Operator** | Native integration for data pipelines |
-| **GitHub Action** | CI/CD data quality gates |
-
-## Quick Examples
-
-### Quality Score
-```python
-quality = orders.score()
-print(f"Grade: {quality.grade}")  # A, B, C, D, or F
-```
-
-### YAML Rules
-```yaml
-# duckguard.yaml
-dataset: orders
-rules:
-  - order_id is not null
-  - order_id is unique
-  - amount >= 0
-  - status in ['pending', 'shipped', 'delivered']
-```
-
-```python
-from duckguard import load_rules, execute_rules
-result = execute_rules(load_rules("duckguard.yaml"), dataset=orders)
-```
-
-### PII Detection
-```python
-from duckguard.semantic import SemanticAnalyzer
-analysis = SemanticAnalyzer().analyze(orders)
-print(f"PII found: {analysis.pii_columns}")
-```
-
-### Anomaly Detection
-```python
-from duckguard import detect_anomalies
-report = detect_anomalies(orders, method="zscore")
-```
-
-### Data Contracts
-```python
-from duckguard import generate_contract, validate_contract
-contract = generate_contract(orders)
-result = validate_contract(contract, new_orders)
-```
-
-### Slack/Teams Notifications
-```python
-from duckguard.notifications import SlackNotifier
-
-slack = SlackNotifier(webhook_url="https://hooks.slack.com/...")
-# Or set DUCKGUARD_SLACK_WEBHOOK env var
-
-result = execute_rules(rules, dataset=orders)
-if not result.passed:
-    slack.send_failure_alert(result)
-```
-
-### Row-Level Error Debugging
-```python
-# See exactly which rows failed validation
-result = orders.quantity.between(1, 100)
-if not result.passed:
-    print(result.summary())
-    # Sample of 10 failing rows (total: 25):
-    #   Row 5: quantity=150 - Value 150 is outside range [1, 100]
-    #   Row 12: quantity=200 - Value 200 is outside range [1, 100]
-
-    # Get failed values as list
-    print(result.get_failed_values())  # [150, 200, ...]
-```
-
-### dbt Integration
-```python
-from duckguard import load_rules
-from duckguard.integrations import dbt
-
-# Export DuckGuard rules to dbt schema.yml
-rules = load_rules("duckguard.yaml")
-dbt.export_to_schema(rules, "models/schema.yml")
-
-# Generate dbt singular tests
-dbt.generate_singular_tests(rules, "tests/")
-
-# Import dbt tests as DuckGuard rules
-rules = dbt.import_from_dbt("models/schema.yml")
-```
-
-### HTML/PDF Reports
-```python
-from duckguard import execute_rules, load_rules
-from duckguard.reports import generate_html_report, generate_pdf_report
-
-result = execute_rules(load_rules("duckguard.yaml"), dataset=orders)
-
-# Generate beautiful HTML report
-generate_html_report(result, "report.html", title="Orders Quality Report")
-
-# Generate PDF report (requires weasyprint)
-generate_pdf_report(result, "report.pdf")
-```
-
-### Historical Tracking
-```python
-from duckguard.history import HistoryStorage, TrendAnalyzer
-
-# Store validation results
-storage = HistoryStorage()  # Uses ~/.duckguard/history.db
-run_id = storage.store(result)
-
-# Query historical runs
-runs = storage.get_runs("orders.csv", limit=10)
-
-# Analyze quality trends
-analyzer = TrendAnalyzer(storage)
-trend = analyzer.analyze("orders.csv", days=30)
-print(f"Trend: {trend.score_trend}, Pass rate: {trend.pass_rate}%")
-```
-
-### Airflow Integration
-```python
-from duckguard.integrations.airflow import DuckGuardOperator
-
-# Use in your Airflow DAG
-validate_orders = DuckGuardOperator(
-    task_id="validate_orders",
-    source="s3://bucket/orders.parquet",
-    config="duckguard.yaml",
-    fail_on_error=True,
-    store_history=True,
-)
-```
-
-### GitHub Action
-```yaml
-# .github/workflows/data-quality.yml
-- uses: XDataHubAI/duckguard/.github/actions/duckguard-check@main
-  with:
-    source: data/orders.csv
-    config: duckguard.yaml
-    fail-on-warning: false
-```
-
-## Supported Sources
-
-**Files:** CSV, Parquet, JSON, Excel
-**Cloud:** S3, GCS, Azure Blob
-**Databases:** PostgreSQL, MySQL, SQLite, Snowflake, BigQuery, Redshift, Databricks, SQL Server, Oracle, MongoDB
-**Formats:** Delta Lake, Apache Iceberg
-
-```python
-# Connect to anything
-orders = connect("s3://bucket/orders.parquet")
-orders = connect("postgres://localhost/db", table="orders")
-orders = connect("snowflake://account/db", table="orders")
-```
-
-## CLI Commands
-
-```bash
-duckguard check <file>       # Run quality checks
-duckguard discover <file>    # Auto-generate rules
-duckguard contract generate  # Create data contract
-duckguard contract validate  # Validate against contract
-duckguard anomaly <file>     # Detect anomalies
-duckguard report <file>      # Generate HTML/PDF report
-duckguard history            # View validation history
-duckguard history --trend    # Analyze quality trends
-```
-
-## Column Methods
-
-```python
-# Statistics
-col.null_percent, col.unique_percent
-col.min, col.max, col.mean, col.stddev
-
-# Validations
-col.between(0, 100)
-col.matches(r'^\d{5}$')
-col.isin(['a', 'b', 'c'])
-col.has_no_duplicates()
-```
-
-## Performance
-
-Built on DuckDB for speed:
-
-| | Pandas/GX | DuckGuard |
-|---|---|---|
-| 1GB CSV | 45s, 4GB RAM | 4s, 200MB RAM |
-
-## Contributing
-
-We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
-## License
-
-Elastic License 2.0 - see [LICENSE](LICENSE)