etld 0.1.2__tar.gz

etld-0.1.2/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.1
+Name: etld
+Version: 0.1.2
+Summary: Official Python SDK for the ETL-D API - Stateless Data Middleware for AI Agents.
+Home-page: https://github.com/pablixnieto2/enrichermagic
+Author: ETL-D Team
+Author-email: hello@etl-d.net
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# ETL-D Python SDK
+
+Limpia, normaliza y estructura datos globales (direcciones, nombres, importes) con nuestro motor de IA asíncrono.
+
+## ¿Cómo funciona nuestra arquitectura asíncrona?
+
+A diferencia de otras APIs que te bloquean el hilo esperando una respuesta, ETL-D utiliza un sistema de colas (Celery/Redis). 
+1. **Envío:** Tú envías un lote de miles de registros.
+2. **Procesamiento:** El sistema te devuelve un `task_id` instantáneo.
+3. **Polling automático:** Nuestro SDK se queda consultando el estado por ti (en segundo plano) hasta que el trabajo termina, devolviéndote los datos limpios directamente.
+
+## Ejemplo de uso (El cliente se encarga del robot por ti)
+
+```python
+from etld import ETLDClient
+
+client = ETLDClient(api_key="TU_API_KEY")
+
+# Esta función envía los datos y se queda esperando (polling) 
+# hasta que el servidor dice "SUCCESS".
+datos_limpios = client.batch_process(
+    items=[
+        "Calle 70A No. 11 - 12, Bogotá", 
+        "152 Teheran-ro, Seoul"
+    ], 
+    entity_type="address"
+)
+
+for resultado in datos_limpios:
+    print(resultado['address_latin'])
+```

etld-0.1.2/README.md

@@ -0,0 +1,31 @@
+# ETL-D Python SDK
+
+Limpia, normaliza y estructura datos globales (direcciones, nombres, importes) con nuestro motor de IA asíncrono.
+
+## ¿Cómo funciona nuestra arquitectura asíncrona?
+
+A diferencia de otras APIs que te bloquean el hilo esperando una respuesta, ETL-D utiliza un sistema de colas (Celery/Redis). 
+1. **Envío:** Tú envías un lote de miles de registros.
+2. **Procesamiento:** El sistema te devuelve un `task_id` instantáneo.
+3. **Polling automático:** Nuestro SDK se queda consultando el estado por ti (en segundo plano) hasta que el trabajo termina, devolviéndote los datos limpios directamente.
+
+## Ejemplo de uso (El cliente se encarga del robot por ti)
+
+```python
+from etld import ETLDClient
+
+client = ETLDClient(api_key="TU_API_KEY")
+
+# Esta función envía los datos y se queda esperando (polling) 
+# hasta que el servidor dice "SUCCESS".
+datos_limpios = client.batch_process(
+    items=[
+        "Calle 70A No. 11 - 12, Bogotá", 
+        "152 Teheran-ro, Seoul"
+    ], 
+    entity_type="address"
+)
+
+for resultado in datos_limpios:
+    print(resultado['address_latin'])
+```

etld-0.1.2/etld/__init__.py

@@ -0,0 +1,22 @@
+from .client import ETLDClient
+from .models import ContextParams, AddressOutput, NameOutput, MoneyOutput
+from .exceptions import (
+    ETLDBaseException,
+    ETLDAuthenticationError,
+    ETLDRateLimitError,
+    ETLDProcessingError,
+    ETLDValidationError
+)
+
+__all__ = [
+    "ETLDClient",
+    "ContextParams",
+    "AddressOutput",
+    "NameOutput",
+    "MoneyOutput",
+    "ETLDBaseException",
+    "ETLDAuthenticationError",
+    "ETLDRateLimitError",
+    "ETLDProcessingError",
+    "ETLDValidationError",
+]

etld-0.1.2/etld/client.py

@@ -0,0 +1,112 @@
+import requests
+import time
+from typing import List, Optional, Dict, Any, Union
+from .models import ContextParams, AddressOutput, NameOutput, MoneyOutput
+from .exceptions import (
+    ETLDAuthenticationError,
+    ETLDRateLimitError,
+    ETLDProcessingError,
+    ETLDValidationError
+)
+
+class ETLDClient:
+    def __init__(self, api_key: str, base_url: str = "https://api.etl-d.net"):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.session = requests.Session()
+        self.session.headers.update({
+            "X-API-KEY": self.api_key,
+            "Content-Type": "application/json",
+            "User-Agent": "etld-python-sdk/0.1.0"
+        })
+
+    def _handle_response(self, response: requests.Response) -> Dict[str, Any]:
+        if response.status_code == 401 or response.status_code == 403:
+            raise ETLDAuthenticationError(f"Invalid API Key: {response.text}")
+        elif response.status_code == 429:
+            raise ETLDRateLimitError(f"Rate limit exceeded: {response.text}")
+        elif response.status_code == 422:
+            raise ETLDValidationError(f"Validation Error: {response.json().get('detail')}")
+        
+        try:
+            response.raise_for_status()
+        except requests.exceptions.HTTPError as e:
+            raise ETLDProcessingError(f"API Request failed: {str(e)}")
+            
+        return response.json()
+
+    def enrich_address(self, address: str, context: Optional[Union[Dict[str, Any], ContextParams]] = None) -> AddressOutput:
+        if isinstance(context, ContextParams):
+            context = context.to_dict()
+        
+        payload = {
+            "address_line": address,
+            "context": context or {}
+        }
+        
+        data = self._handle_response(self.session.post(f"{self.base_url}/v1/enrich/address", json=payload))
+        return AddressOutput(**data)
+
+    def enrich_name(self, name: str, context: Optional[Union[Dict[str, Any], ContextParams]] = None) -> NameOutput:
+        if isinstance(context, ContextParams):
+            context = context.to_dict()
+            
+        payload = {
+            "full_name": name,
+            "context": context or {}
+        }
+        
+        data = self._handle_response(self.session.post(f"{self.base_url}/v1/enrich/name", json=payload))
+        return NameOutput(**data)
+
+    def enrich_amount(self, amount: str, context: Optional[Union[Dict[str, Any], ContextParams]] = None) -> MoneyOutput:
+        if isinstance(context, ContextParams):
+            context = context.to_dict()
+            
+        payload = {
+            "amount_string": amount,
+            "context": context or {}
+        }
+        
+        data = self._handle_response(self.session.post(f"{self.base_url}/v1/enrich/amount", json=payload))
+        return MoneyOutput(**data)
+
+    def batch_process(
+        self, 
+        items: List[str], 
+        entity_type: str, 
+        context: Optional[Union[Dict[str, Any], ContextParams]] = None,
+        poll_interval: int = 2,
+        max_retries: int = 30
+    ) -> List[Any]:
+        if isinstance(context, ContextParams):
+            context = context.to_dict()
+            
+        payload = {
+            "items": items,
+            "context": context or {}
+        }
+        
+        # 1. Start Batch
+        start_data = self._handle_response(
+            self.session.post(f"{self.base_url}/v1/enrich/batch/{entity_type}", json=payload)
+        )
+        task_id = start_data.get("task_id")
+        
+        # 2. Poll
+        retries = 0
+        while retries < max_retries:
+            status_data = self._handle_response(
+                self.session.get(f"{self.base_url}/v1/enrich/batch/{task_id}")
+            )
+            
+            status = status_data.get("status")
+            if status == "SUCCESS":
+                return status_data.get("results", [])
+            elif status == "FAILURE":
+                raise ETLDProcessingError(f"Batch processing failed: {status_data.get('error')}")
+            
+            time.sleep(poll_interval)
+            retries += 1
+            
+        raise ETLDProcessingError(f"Batch processing timed out for task {task_id}")

etld-0.1.2/etld/exceptions.py

@@ -0,0 +1,19 @@
+class ETLDBaseException(Exception):
+    """Base exception for ETL-D SDK"""
+    pass
+
+class ETLDAuthenticationError(ETLDBaseException):
+    """Raised when API key is invalid or missing"""
+    pass
+
+class ETLDRateLimitError(ETLDBaseException):
+    """Raised when API rate limit is exceeded"""
+    pass
+
+class ETLDProcessingError(ETLDBaseException):
+    """Raised when there is an error processing the request"""
+    pass
+
+class ETLDValidationError(ETLDBaseException):
+    """Raised when request validation fails"""
+    pass

etld-0.1.2/etld/models.py

@@ -0,0 +1,53 @@
+from dataclasses import dataclass, field
+from typing import Optional, List, Any, Dict
+
+@dataclass
+class ContextParams:
+    timezone: str = "UTC"
+    locale: str = "en_US"
+    target_currency: Optional[str] = None
+    transliterate: bool = False
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {k: v for k, v in self.__dict__.items() if v is not None}
+
+@dataclass
+class AddressOutput:
+    street: Optional[str] = None
+    house_number: Optional[str] = None
+    floor_unit: Optional[str] = None
+    postal_code: Optional[str] = None
+    city: Optional[str] = None
+    state: Optional[str] = None
+    country: Optional[str] = None
+    type: Optional[str] = None
+    address_latin: Optional[str] = None
+    error: Optional[str] = None
+
+@dataclass
+class NameOutput:
+    title: Optional[str] = None
+    first: Optional[str] = None
+    middle: Optional[str] = None
+    last: Optional[str] = None
+    suffix: Optional[str] = None
+    nickname: Optional[str] = None
+    gender: Optional[str] = None
+    confidence: Optional[str] = None
+    name_latin: Optional[str] = None
+
+@dataclass
+class MoneyOutput:
+    float_value: Optional[float] = None
+    currency: Optional[str] = None
+    currency_symbol: Optional[str] = None
+    clean_string: Optional[str] = None
+    conversion_required: Optional[bool] = None
+    error: Optional[str] = None
+
+@dataclass
+class BatchResponse:
+    task_id: str
+    status: str
+    results: Optional[List[Any]] = None
+    error: Optional[str] = None

etld-0.1.2/etld.egg-info/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.1
+Name: etld
+Version: 0.1.2
+Summary: Official Python SDK for the ETL-D API - Stateless Data Middleware for AI Agents.
+Home-page: https://github.com/pablixnieto2/enrichermagic
+Author: ETL-D Team
+Author-email: hello@etl-d.net
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# ETL-D Python SDK
+
+Limpia, normaliza y estructura datos globales (direcciones, nombres, importes) con nuestro motor de IA asíncrono.
+
+## ¿Cómo funciona nuestra arquitectura asíncrona?
+
+A diferencia de otras APIs que te bloquean el hilo esperando una respuesta, ETL-D utiliza un sistema de colas (Celery/Redis). 
+1. **Envío:** Tú envías un lote de miles de registros.
+2. **Procesamiento:** El sistema te devuelve un `task_id` instantáneo.
+3. **Polling automático:** Nuestro SDK se queda consultando el estado por ti (en segundo plano) hasta que el trabajo termina, devolviéndote los datos limpios directamente.
+
+## Ejemplo de uso (El cliente se encarga del robot por ti)
+
+```python
+from etld import ETLDClient
+
+client = ETLDClient(api_key="TU_API_KEY")
+
+# Esta función envía los datos y se queda esperando (polling) 
+# hasta que el servidor dice "SUCCESS".
+datos_limpios = client.batch_process(
+    items=[
+        "Calle 70A No. 11 - 12, Bogotá", 
+        "152 Teheran-ro, Seoul"
+    ], 
+    entity_type="address"
+)
+
+for resultado in datos_limpios:
+    print(resultado['address_latin'])
+```

etld-0.1.2/etld.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+setup.py
+etld/__init__.py
+etld/client.py
+etld/exceptions.py
+etld/models.py
+etld.egg-info/PKG-INFO
+etld.egg-info/SOURCES.txt
+etld.egg-info/dependency_links.txt
+etld.egg-info/requires.txt
+etld.egg-info/top_level.txt

etld-0.1.2/etld.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

etld-0.1.2/etld.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

etld-0.1.2/etld.egg-info/top_level.txt

@@ -0,0 +1 @@
+etld

etld-0.1.2/setup.cfg

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

etld-0.1.2/setup.py

@@ -0,0 +1,22 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="etld",
+    version="0.1.2",
+    author="ETL-D Team",
+    author_email="hello@etl-d.net",
+    description="Official Python SDK for the ETL-D API - Stateless Data Middleware for AI Agents.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/pablixnieto2/enrichermagic",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.25.0",
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.7',
+)