phlo-core-plugins 0.1.0__tar.gz → 0.2.3__tar.gz

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/PKG-INFO

@@ -1,17 +1,18 @@
 Metadata-Version: 2.4
 Name: phlo-core-plugins
-Version: 0.1.0
+Version: 0.2.3
 Summary: Core plugin package 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: phlo-quality>=0.1.0
 Requires-Dist: requests>=2.28.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: quality
+Requires-Dist: phlo-pandera>=0.1.0; extra == "quality"
 
 Core plugin package for Phlo.

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/pyproject.toml

@@ -1,45 +1,54 @@
 [build-system]
-requires = ["setuptools>=45", "wheel"]
 build-backend = "setuptools.build_meta"
+requires = [
+    "setuptools>=45",
+    "wheel",
+]
 
 [project]
-name = "phlo-core-plugins"
-version = "0.1.0"
-description = "Core plugin package for Phlo"
-readme = {text = "Core plugin package 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",
-    "phlo-quality>=0.1.0",
     "requests>=2.28.0",
 ]
+description = "Core plugin package for Phlo"
+name = "phlo-core-plugins"
+requires-python = ">=3.11"
+version = "0.2.3"
 
-[project.optional-dependencies]
-dev = [
-    "pytest>=7.0",
-    "pytest-cov>=4.0",
-    "ruff>=0.1.0",
-]
+[[project.authors]]
+email = "team@phlo.dev"
+name = "Phlo Team"
 
 [project.entry-points."phlo.plugins.quality"]
-null_check = "phlo_core.quality.null_check:NullCheckPlugin"
-uniqueness_check = "phlo_core.quality.uniqueness_check:UniquenessCheckPlugin"
 freshness_check = "phlo_core.quality.freshness_check:FreshnessCheckPlugin"
+null_check = "phlo_core.quality.null_check:NullCheckPlugin"
 schema_check = "phlo_core.quality.schema_check:SchemaCheckPlugin"
+uniqueness_check = "phlo_core.quality.uniqueness_check:UniquenessCheckPlugin"
 
 [project.entry-points."phlo.plugins.sources"]
 rest_api = "phlo_core.sources.rest_api:RestAPIPlugin"
 
-[tool.setuptools]
-package-dir = {"" = "src"}
+[project.license]
+text = "MIT"
 
-[tool.setuptools.packages.find]
-where = ["src"]
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "ruff>=0.1.0",
+]
+quality = ["phlo-pandera>=0.1.0"]
+
+[project.readme]
+content-type = "text/plain"
+text = "Core plugin package for Phlo."
 
 [tool.ruff]
 line-length = 100
 target-version = "py311"
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.setuptools.packages.find]
+where = ["src"]

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/src/phlo_core/__init__.py

@@ -13,4 +13,4 @@ __all__ = [
     "SchemaCheckPlugin",
     "RestAPIPlugin",
 ]
-__version__ = "0.1.0"
+__version__ = "0.2.3"

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/src/phlo_core/quality/freshness_check.py

@@ -1,16 +1,17 @@
 """Freshness check plugin."""
 
 from datetime import datetime
+from typing import Any
 
 from phlo.plugins import PluginMetadata, QualityCheckPlugin
-from phlo_quality.checks import FreshnessCheck
 
 
-class FreshnessCheckPlugin(QualityCheckPlugin[FreshnessCheck]):
+class FreshnessCheckPlugin(QualityCheckPlugin[Any]):
     """Plugin for freshness checks."""
 
     @property
     def metadata(self) -> PluginMetadata:
+        """Return plugin metadata for the freshness-check plugin."""
         return PluginMetadata(
             name="freshness_check",
             version="0.1.0",
@@ -24,7 +25,19 @@ class FreshnessCheckPlugin(QualityCheckPlugin[FreshnessCheck]):
         timestamp_column: str,
         max_age_hours: float,
         reference_time: datetime | None = None,
-    ) -> FreshnessCheck:
+    ) -> Any:
+        """Create a freshness check instance.
+
+        Args:
+            timestamp_column: Timestamp column used for freshness calculations.
+            max_age_hours: Maximum allowed age in hours.
+            reference_time: Optional reference time for age evaluation.
+
+        Returns:
+            Configured freshness-check instance.
+        """
+        from phlo_pandera.checks import FreshnessCheck
+
         return FreshnessCheck(
             timestamp_column=timestamp_column,
             max_age_hours=max_age_hours,

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/src/phlo_core/quality/null_check.py

@@ -1,14 +1,16 @@
 """Null check plugin."""
 
+from typing import Any
+
 from phlo.plugins import PluginMetadata, QualityCheckPlugin
-from phlo_quality.checks import NullCheck
 
 
-class NullCheckPlugin(QualityCheckPlugin[NullCheck]):
+class NullCheckPlugin(QualityCheckPlugin[Any]):
     """Plugin for NullCheck quality checks."""
 
     @property
     def metadata(self) -> PluginMetadata:
+        """Return plugin metadata for the null-check quality plugin."""
         return PluginMetadata(
             name="null_check",
             version="0.1.0",
@@ -17,5 +19,16 @@ class NullCheckPlugin(QualityCheckPlugin[NullCheck]):
             tags=["quality", "nulls"],
         )
 
-    def create_check(self, columns: list[str], allow_threshold: float = 0.0) -> NullCheck:
+    def create_check(self, columns: list[str], allow_threshold: float = 0.0) -> Any:
+        """Create a null check instance.
+
+        Args:
+            columns: Column names to validate for null values.
+            allow_threshold: Maximum allowed null ratio per column.
+
+        Returns:
+            Configured null-check instance.
+        """
+        from phlo_pandera.checks import NullCheck
+
         return NullCheck(columns=columns, allow_threshold=allow_threshold)

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/src/phlo_core/quality/schema_check.py

@@ -3,14 +3,14 @@
 from typing import Any
 
 from phlo.plugins import PluginMetadata, QualityCheckPlugin
-from phlo_quality.checks_extra import SchemaCheck
 
 
-class SchemaCheckPlugin(QualityCheckPlugin[SchemaCheck]):
+class SchemaCheckPlugin(QualityCheckPlugin[Any]):
     """Plugin for schema checks."""
 
     @property
     def metadata(self) -> PluginMetadata:
+        """Return plugin metadata for the schema-check plugin."""
         return PluginMetadata(
             name="schema_check",
             version="0.1.0",
@@ -19,5 +19,16 @@ class SchemaCheckPlugin(QualityCheckPlugin[SchemaCheck]):
             tags=["quality", "schema"],
         )
 
-    def create_check(self, schema: Any, lazy: bool = True) -> SchemaCheck:
+    def create_check(self, schema: Any, lazy: bool = True) -> Any:
+        """Create a schema check instance.
+
+        Args:
+            schema: Expected schema object for validation.
+            lazy: Whether to collect all validation errors before failing.
+
+        Returns:
+            Configured schema-check instance.
+        """
+        from phlo_pandera.checks_extra import SchemaCheck
+
         return SchemaCheck(schema=schema, lazy=lazy)

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/src/phlo_core/quality/uniqueness_check.py

@@ -1,14 +1,16 @@
 """Uniqueness check plugin."""
 
+from typing import Any
+
 from phlo.plugins import PluginMetadata, QualityCheckPlugin
-from phlo_quality.checks import UniqueCheck
 
 
-class UniquenessCheckPlugin(QualityCheckPlugin[UniqueCheck]):
+class UniquenessCheckPlugin(QualityCheckPlugin[Any]):
     """Plugin for uniqueness checks."""
 
     @property
     def metadata(self) -> PluginMetadata:
+        """Return plugin metadata for the uniqueness-check plugin."""
         return PluginMetadata(
             name="uniqueness_check",
             version="0.1.0",
@@ -17,5 +19,16 @@ class UniquenessCheckPlugin(QualityCheckPlugin[UniqueCheck]):
             tags=["quality", "uniqueness"],
         )
 
-    def create_check(self, columns: list[str], allow_threshold: float = 0.0) -> UniqueCheck:
+    def create_check(self, columns: list[str], allow_threshold: float = 0.0) -> Any:
+        """Create a uniqueness check instance.
+
+        Args:
+            columns: Column names that must be unique.
+            allow_threshold: Maximum allowed duplicate ratio.
+
+        Returns:
+            Configured uniqueness-check instance.
+        """
+        from phlo_pandera.checks import UniqueCheck
+
         return UniqueCheck(columns=columns, allow_threshold=allow_threshold)

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/src/phlo_core/sources/rest_api.py

@@ -12,6 +12,11 @@ class RestAPIPlugin(SourceConnectorPlugin):
 
     @property
     def metadata(self) -> PluginMetadata:
+        """Get plugin metadata.
+
+        Returns:
+            PluginMetadata: Metadata for the REST API source connector plugin.
+        """
         return PluginMetadata(
             name="rest_api",
             version="0.1.0",
@@ -21,6 +26,14 @@ class RestAPIPlugin(SourceConnectorPlugin):
         )
 
     def fetch_data(self, config: dict[str, Any]):
+        """Fetch records from a REST API endpoint.
+
+        Args:
+            config: Source configuration containing request and extraction options.
+
+        Yields:
+            dict[str, Any]: Records extracted from the response payload.
+        """
         url = config["url"]
         headers = config.get("headers", {})
         params = config.get("params", {})
@@ -36,10 +49,30 @@ class RestAPIPlugin(SourceConnectorPlugin):
             yield record
 
     def get_schema(self, config: dict[str, Any]) -> dict[str, str] | None:
+        """Get optional static schema for records.
+
+        Args:
+            config: Source configuration that may include a schema mapping.
+
+        Returns:
+            dict[str, str] | None: Schema mapping if present.
+        """
         return config.get("schema")
 
 
 def _extract_records(payload: Any, records_path: str | None) -> list[dict[str, Any]]:
+    """Extract record objects from a JSON payload.
+
+    Args:
+        payload: Parsed JSON response payload.
+        records_path: Dot-separated path to list or object records in payload.
+
+    Returns:
+        list[dict[str, Any]]: Normalized list of record objects.
+
+    Raises:
+        ValueError: If records path is missing or payload shape is unsupported.
+    """
     if records_path:
         current = payload
         for key in records_path.split("."):

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/src/phlo_core_plugins.egg-info/PKG-INFO

@@ -1,17 +1,18 @@
 Metadata-Version: 2.4
 Name: phlo-core-plugins
-Version: 0.1.0
+Version: 0.2.3
 Summary: Core plugin package 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: phlo-quality>=0.1.0
 Requires-Dist: requests>=2.28.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: quality
+Requires-Dist: phlo-pandera>=0.1.0; extra == "quality"
 
 Core plugin package for Phlo.

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/src/phlo_core_plugins.egg-info/requires.txt

@@ -1,8 +1,10 @@
 phlo>=0.1.0
-phlo-quality>=0.1.0
 requests>=2.28.0
 
 [dev]
 pytest>=7.0
 pytest-cov>=4.0
 ruff>=0.1.0
+
+[quality]
+phlo-pandera>=0.1.0

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/tests/test_integration_core_plugins.py

@@ -64,12 +64,16 @@ class TestServicePlugin:
 
         # Attempting to instantiate directly should fail or have abstract methods
         class ConcretePlugin(ServicePlugin):
+            """Concrete service plugin for abstract base class testing."""
+
             @property
             def metadata(self):
+                """Get test plugin metadata."""
                 return PluginMetadata("test", "1.0.0", "test")
 
             @property
             def service_definition(self):
+                """Get minimal service definition for test instantiation."""
                 return {"services": {}}
 
         plugin = ConcretePlugin()
@@ -156,19 +160,25 @@ class TestCatalogPlugin:
         from phlo.plugins.base import CatalogPlugin, PluginMetadata
 
         class MockCatalog(CatalogPlugin):
+            """Concrete catalog plugin used to validate interface behavior."""
+
             @property
             def metadata(self):
+                """Get mock catalog metadata."""
                 return PluginMetadata("mock", "1.0.0", "Mock catalog")
 
             @property
             def targets(self) -> list[str]:
+                """Get supported target engines."""
                 return ["trino"]
 
             @property
             def catalog_name(self):
+                """Get catalog identifier."""
                 return "mock"
 
             def get_properties(self):
+                """Get connector properties for the catalog."""
                 return {"connector.name": "mock"}
 
         catalog = MockCatalog()

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/tests/test_quality_plugins.py

@@ -7,30 +7,45 @@ from phlo_core.quality.uniqueness_check import UniquenessCheckPlugin
 
 
 def test_null_check_plugin():
+    """Verify null check plugin creates an expected check name."""
     plugin = NullCheckPlugin()
     check = plugin.create_check(columns=["id"])
     assert check.name == "null_check_id"
 
 
 def test_uniqueness_check_plugin():
+    """Verify uniqueness check plugin creates an expected check name."""
     plugin = UniquenessCheckPlugin()
     check = plugin.create_check(columns=["id"])
     assert check.name == "unique_check_id"
 
 
 def test_freshness_check_plugin():
+    """Verify freshness check plugin creates an expected check name."""
     plugin = FreshnessCheckPlugin()
     check = plugin.create_check(timestamp_column="ts", max_age_hours=2)
     assert check.name == "freshness_check_ts"
 
 
 def test_schema_check_plugin():
+    """Verify schema check plugin creates an expected check name."""
     plugin = SchemaCheckPlugin()
 
     class DummySchema:
+        """Minimal schema stub used by the schema check plugin test."""
+
         __name__ = "DummySchema"
 
         def validate(self, df, lazy=True):
+            """Return input dataframe unchanged.
+
+            Args:
+                df: Input dataframe-like object.
+                lazy: Validation mode flag.
+
+            Returns:
+                The unmodified input dataframe.
+            """
             return df
 
     check = plugin.create_check(schema=DummySchema)

{phlo_core_plugins-0.1.0 → phlo_core_plugins-0.2.3}/tests/test_rest_api_plugin.py

@@ -4,21 +4,32 @@ from phlo_core.sources.rest_api import RestAPIPlugin
 
 
 class DummyResponse:
+    """Simple response test double for requests.get."""
+
     def __init__(self, payload):
+        """Initialize the response with a JSON payload.
+
+        Args:
+            payload: JSON-serializable data returned by ``json()``.
+        """
         self._payload = payload
 
     def raise_for_status(self):
+        """Simulate a successful HTTP status response."""
         return None
 
     def json(self):
+        """Return the configured payload."""
         return self._payload
 
 
 def test_rest_api_plugin_fetches_records(monkeypatch):
+    """Verify the plugin yields records from a top-level list payload."""
     plugin = RestAPIPlugin()
     payload = [{"id": 1}, {"id": 2}]
 
     def dummy_get(url, headers=None, params=None, timeout=30):
+        """Return a dummy response for the request call."""
         return DummyResponse(payload)
 
     monkeypatch.setattr("phlo_core.sources.rest_api.requests.get", dummy_get)
@@ -28,10 +39,12 @@ def test_rest_api_plugin_fetches_records(monkeypatch):
 
 
 def test_rest_api_plugin_records_path(monkeypatch):
+    """Verify the plugin resolves records via a nested records path."""
     plugin = RestAPIPlugin()
     payload = {"data": {"items": [{"id": 3}]}}
 
     def dummy_get(url, headers=None, params=None, timeout=30):
+        """Return a dummy response for the request call."""
         return DummyResponse(payload)
 
     monkeypatch.setattr("phlo_core.sources.rest_api.requests.get", dummy_get)