phlo-pandera 0.1.0__tar.gz

phlo_pandera-0.1.0/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: phlo-pandera
+Version: 0.1.0
+Summary: Quality checks and schema utilities for Phlo
+Author-email: Phlo Team <team@phlo.dev>
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/plain
+Requires-Dist: phlo>=0.1.0
+Requires-Dist: pandas>=2.3.3
+Requires-Dist: pandera>=0.26.1
+Requires-Dist: click>=8.3.0
+Requires-Dist: rich>=14.2.0
+Provides-Extra: observatory
+Requires-Dist: phlo-observatory>=0.1.0; extra == "observatory"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+
+Quality checks and Pandera utilities for Phlo.

phlo_pandera-0.1.0/README.md

@@ -0,0 +1,82 @@
+# phlo-pandera
+
+Data quality checks and validation for Phlo.
+
+## Description
+
+Define and execute data quality checks using the `@phlo_quality` decorator. Checks emit capability specs that adapters translate into orchestrator-native checks.
+
+## Installation
+
+```bash
+pip install phlo-pandera
+# or
+phlo plugin install pandera
+```
+
+## Configuration
+
+| Variable                 | Default | Description                    |
+| ------------------------ | ------- | ------------------------------ |
+| `PANDERA_CRITICAL_LEVEL` | `error` | Severity that blocks promotion |
+
+## Auto-Configuration
+
+This package is **fully auto-configured**:
+
+| Feature                 | How It Works                                              |
+| ----------------------- | --------------------------------------------------------- |
+| **Check Discovery**     | Quality workflows auto-discovered in `workflows/quality/` |
+| **Event Emission**      | Emits `quality.result` events to HookBus                  |
+| **Adapter Integration** | Checks translate into orchestrator-native checks via adapters |
+| **Alerting**            | Failed checks auto-routed to alerting destinations        |
+
+### Event Flow
+
+```
+@phlo_quality → QualityEventEmitter → quality.result → [Alerting, Metrics, OpenMetadata]
+```
+
+## Usage
+
+### Defining Checks
+
+```python
+from phlo.quality import phlo_quality
+from phlo_pandera.checks import null_check, uniqueness_check
+
+@phlo_quality(
+    asset="bronze.users",
+    checks=[
+        null_check(column="id"),
+        uniqueness_check(column="email"),
+    ]
+)
+def validate_users():
+    pass
+```
+
+### CLI Commands
+
+```bash
+# Run quality checks
+phlo quality run --asset bronze.users
+
+# List available checks
+phlo quality list
+```
+
+## Built-in Checks
+
+| Check              | Description                         |
+| ------------------ | ----------------------------------- |
+| `null_check`       | Validates column has no NULL values |
+| `uniqueness_check` | Validates column values are unique  |
+| `range_check`      | Validates values are within range   |
+| `regex_check`      | Validates values match pattern      |
+| `freshness_check`  | Validates data is recent            |
+
+## Entry Points
+
+- `phlo.plugins.cli` - Provides `pandera` CLI commands
+- `phlo.plugins.quality` - Provides built-in check plugins

phlo_pandera-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "phlo-pandera"
+version = "0.1.0"
+description = "Quality checks and schema utilities for Phlo"
+readme = {text = "Quality checks and Pandera utilities for Phlo.", content-type = "text/plain"}
+requires-python = ">=3.11"
+authors = [
+    {name = "Phlo Team", email = "team@phlo.dev"},
+]
+license = {text = "MIT"}
+dependencies = [
+    "phlo>=0.1.0",
+    "pandas>=2.3.3",
+    "pandera>=0.26.1",
+    "click>=8.3.0",
+    "rich>=14.2.0",
+]
+
+[project.optional-dependencies]
+observatory = [
+    "phlo-observatory>=0.1.0",
+]
+dev = [
+    "pytest>=7.0",
+    "ruff>=0.1.0",
+]
+
+[project.entry-points."phlo.plugins.cli"]
+pandera = "phlo_pandera.cli_plugin:PanderaCliPlugin"
+
+[project.entry-points."phlo.plugins.observatory"]
+pandera = "phlo_pandera.observatory_plugin:PanderaObservatoryExtension"
+
+[project.entry-points."phlo.plugins.quality_providers"]
+pandera = "phlo_pandera.plugin:PanderaQualityProvider"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+phlo_pandera = [
+    "schemas/**/*.py",
+    "observatory_assets/*",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"

phlo_pandera-0.1.0/setup.cfg

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

phlo_pandera-0.1.0/src/phlo_pandera/__init__.py

@@ -0,0 +1,83 @@
+"""
+Phlo Quality Framework.
+
+Declarative quality checks that reduce boilerplate by 70%.
+
+Usage::
+
+    from phlo_pandera import NullCheck, RangeCheck, phlo_pandera
+
+    @phlo_pandera(
+        table="bronze.weather_observations",
+        checks=[
+            NullCheck(columns=["station_id", "temperature"]),
+            RangeCheck(column="temperature", min_value=-50, max_value=60),
+        ],
+    )
+    def weather_quality():
+        pass
+
+Available Checks:
+    - NullCheck: Verify no null values in specified columns
+    - RangeCheck: Verify numeric values within range
+    - FreshnessCheck: Verify data recency
+    - UniqueCheck: Verify uniqueness constraints
+    - CountCheck: Verify row count bounds
+    - SchemaCheck: Verify Pandera schema compliance
+    - CustomSQLCheck: Execute arbitrary SQL assertions
+    - PatternCheck: Verify string values match regex patterns
+"""
+
+from phlo_pandera.checks import (
+    CountCheck,
+    FreshnessCheck,
+    NullCheck,
+    QualityCheck,
+    RangeCheck,
+    UniqueCheck,
+)
+from phlo_pandera.checks_extra import CustomSQLCheck, PatternCheck, SchemaCheck
+from phlo_pandera.contract import PANDERA_CONTRACT_CHECK_NAME, QualityCheckContract, dbt_check_name
+from phlo_pandera.decorator import clear_quality_checks, get_quality_checks, phlo_pandera
+from phlo_pandera.schema_extractor import PanderaSchemaExtractor
+from phlo_pandera.reconciliation import (
+    AggregateConsistencyCheck,
+    AggregateSpec,
+    ChecksumReconciliationCheck,
+    KeyParityCheck,
+    MultiAggregateConsistencyCheck,
+    ReconciliationCheck,
+)
+
+__all__ = [
+    # Decorator (use as @phlo_pandera(...))
+    "phlo_pandera",
+    "get_quality_checks",
+    "clear_quality_checks",
+    # Base class
+    "QualityCheck",
+    # Quality checks
+    "NullCheck",
+    "RangeCheck",
+    "FreshnessCheck",
+    "UniqueCheck",
+    "CountCheck",
+    "SchemaCheck",
+    "CustomSQLCheck",
+    "PatternCheck",
+    # Reconciliation checks
+    "ReconciliationCheck",
+    "AggregateConsistencyCheck",
+    "AggregateSpec",
+    "KeyParityCheck",
+    "MultiAggregateConsistencyCheck",
+    "ChecksumReconciliationCheck",
+    # Schema extraction
+    "PanderaSchemaExtractor",
+    # Contract helpers
+    "PANDERA_CONTRACT_CHECK_NAME",
+    "QualityCheckContract",
+    "dbt_check_name",
+]
+
+__version__ = "1.0.0"