prototype

connectors/base_connector.py

@@ -0,0 +1,42 @@
+"""
+Clawrity — Base Data Connector
+
+Abstract interface for data connectors.
+All connectors implement load() → pd.DataFrame.
+"""
+
+from abc import ABC, abstractmethod
+
+import pandas as pd
+
+
+class BaseConnector(ABC):
+    """Abstract base class for data source connectors."""
+
+    @abstractmethod
+    def load(self, path: str, **kwargs) -> pd.DataFrame:
+        """
+        Load data from the source.
+
+        Args:
+            path: Path to the data source
+            **kwargs: Additional arguments specific to the connector
+
+        Returns:
+            pandas DataFrame with loaded data
+        """
+        pass
+
+    @abstractmethod
+    def validate(self, df: pd.DataFrame, required_columns: list) -> bool:
+        """
+        Validate that the DataFrame has expected columns.
+
+        Args:
+            df: DataFrame to validate
+            required_columns: List of column names that must be present
+
+        Returns:
+            True if valid
+        """
+        pass