eco-back 0.1.0__py3-none-any.whl

eco_back/database/repository.py

@@ -0,0 +1,152 @@
+"""
+Repositorio base para operaciones CRUD
+"""
+from typing import Generic, TypeVar, List, Optional, Dict, Any
+from abc import ABC, abstractmethod
+
+from .connection import DatabaseConnection
+from .models import BaseModel
+
+T = TypeVar('T', bound=BaseModel)
+
+
+class BaseRepository(ABC, Generic[T]):
+    """
+    Clase base para repositorios de base de datos
+    
+    Implementa el patrón Repository para separar la lógica de acceso a datos
+    """
+    
+    def __init__(self, db_connection: DatabaseConnection):
+        """
+        Inicializa el repositorio
+        
+        Args:
+            db_connection: Conexión a la base de datos
+        """
+        self.db = db_connection
+    
+    @property
+    @abstractmethod
+    def table_name(self) -> str:
+        """Nombre de la tabla en la base de datos"""
+        pass
+    
+    @abstractmethod
+    def _row_to_model(self, row: Dict[str, Any]) -> T:
+        """
+        Convierte una fila de la base de datos a un modelo
+        
+        Args:
+            row: Fila de la base de datos
+            
+        Returns:
+            Instancia del modelo
+        """
+        pass
+    
+    def find_by_id(self, id: int) -> Optional[T]:
+        """
+        Busca un registro por su ID
+        
+        Args:
+            id: ID del registro
+            
+        Returns:
+            Instancia del modelo o None si no se encuentra
+        """
+        query = f"SELECT * FROM {self.table_name} WHERE id = %s"
+        results = self.db.execute_query(query, (id,))
+        
+        if results:
+            return self._row_to_model(results[0])
+        return None
+    
+    def find_all(self, limit: Optional[int] = None, offset: int = 0) -> List[T]:
+        """
+        Obtiene todos los registros
+        
+        Args:
+            limit: Número máximo de registros a retornar
+            offset: Número de registros a saltar
+            
+        Returns:
+            Lista de instancias del modelo
+        """
+        query = f"SELECT * FROM {self.table_name}"
+        
+        if limit:
+            query += f" LIMIT {limit} OFFSET {offset}"
+        
+        results = self.db.execute_query(query)
+        return [self._row_to_model(row) for row in results]
+    
+    def find_where(self, conditions: Dict[str, Any]) -> List[T]:
+        """
+        Busca registros que cumplan ciertas condiciones
+        
+        Args:
+            conditions: Diccionario con las condiciones (campo: valor)
+            
+        Returns:
+            Lista de instancias del modelo
+        """
+        where_clauses = [f"{field} = %s" for field in conditions.keys()]
+        where_sql = " AND ".join(where_clauses)
+        
+        query = f"SELECT * FROM {self.table_name} WHERE {where_sql}"
+        results = self.db.execute_query(query, tuple(conditions.values()))
+        
+        return [self._row_to_model(row) for row in results]
+    
+    @abstractmethod
+    def create(self, model: T) -> T:
+        """
+        Crea un nuevo registro
+        
+        Args:
+            model: Instancia del modelo a crear
+            
+        Returns:
+            Instancia del modelo creado con su ID
+        """
+        pass
+    
+    @abstractmethod
+    def update(self, id: int, model: T) -> Optional[T]:
+        """
+        Actualiza un registro existente
+        
+        Args:
+            id: ID del registro a actualizar
+            model: Instancia del modelo con los nuevos datos
+            
+        Returns:
+            Instancia del modelo actualizado o None si no se encuentra
+        """
+        pass
+    
+    def delete(self, id: int) -> bool:
+        """
+        Elimina un registro por su ID
+        
+        Args:
+            id: ID del registro a eliminar
+            
+        Returns:
+            True si se eliminó, False si no se encontró
+        """
+        query = f"DELETE FROM {self.table_name} WHERE id = %s"
+        affected_rows = self.db.execute_update(query, (id,))
+        return affected_rows > 0
+    
+    def count(self) -> int:
+        """
+        Cuenta el número total de registros
+        
+        Returns:
+            Número de registros en la tabla
+        """
+        query = f"SELECT COUNT(*) as total FROM {self.table_name}"
+        result = self.db.execute_query(query)
+        return result[0]['total'] if result else 0

eco_back-0.1.0.dist-info/METADATA

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: eco-back
+Version: 0.1.0
+Summary: Librería Python eco-back
+Author-email: EI UNP <ecosistema@unp.gov.co>
+License: MIT
+Project-URL: Homepage, https://github.com/tuusuario/eco-back
+Project-URL: Documentation, https://github.com/tuusuario/eco-back
+Project-URL: Repository, https://github.com/tuusuario/eco-back
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: psycopg2-binary>=2.9.0
+Requires-Dist: geoalchemy2>=0.14.0
+Requires-Dist: requests>=2.31.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: flake8>=6.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
+Provides-Extra: geo
+Requires-Dist: shapely>=2.0.0; extra == "geo"
+Requires-Dist: geojson>=3.0.0; extra == "geo"
+Dynamic: license-file
+
+# eco-back
+
+Librería Python para backend con soporte para PostgreSQL/PostGIS y clientes API
+
+## Características
+
+- ✅ **Base de datos**: Conexión y operaciones con PostgreSQL
+- ✅ **PostGIS**: Operaciones geoespaciales (puntos, polígonos, búsquedas por proximidad)
+- ✅ **Cliente API**: Cliente HTTP genérico y cliente específico UNP
+- ✅ **Patrón Repository**: Implementación de patrones de diseño para acceso a datos
+
+## Descripción
+
+eco-back es una librería modular que facilita el desarrollo de aplicaciones backend, proporcionando abstracciones para bases de datos geoespaciales y consumo de APIs REST.
+
+## Instalación
+
+### Desde el código fuente
+
+```bash
+pip install -e .
+```
+
+### Para desarrollo
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Uso
+
+### Cliente de Consecutivos (UNP)
+
+```python
+from eco_back.api import Consecutivo
+
+# Crear cliente
+client = Consecutivo(base_url="https://api.unp.example.com")
+
+# Obtener consecutivo
+consecutivo = client.obtener(origen=1)
+if consecutivo:
+    print(f"Consecutivo: {consecutivo}")
+
+client.close()
+
+# Forma recomendada: usar context manager
+with Consecutivo(base_url="https://api.unp.example.com") as client:
+    consecutivo = client.obtener(origen=1)
+    # Usar el consecutivo...
+```
+
+### Cliente API Genérico
+
+```python
+from eco_back.api import APIConfig, APIClient
+
+config = APIConfig(
+    base_url="https://api.example.com",
+    timeout=30,
+    headers={"Authorization": "Bearer token"}
+)
+
+with APIClient(config) as client:
+    # GET request
+    data = client.get("/endpoint")
+    
+    # POST request
+    result = client.post("/endpoint", json={"key": "value"})
+```
+
+### Conexión básica a PostgreSQL
+
+```python
+from eco_back.database import DatabaseConfig, DatabaseConnection
+
+config = DatabaseConfig(
+    host="localhost",
+    port=5432,
+    database="mi_base_datos",
+    user="usuario",
+    password="password"
+)
+
+with DatabaseConnection(config) as db:
+    resultados = db.execute_query("SELECT * FROM tabla")
+    for row in resultados:
+        print(row)
+```
+
+### Uso de PostGIS
+
+```python
+from eco_back.database import DatabaseConfig, DatabaseConnection, PostGISHelper
+
+config = DatabaseConfig(
+    host="localhost",
+    port=5432,
+    database="mi_db_geo",
+    user="postgres",
+    password="password"
+)
+
+with DatabaseConnection(config) as db:
+    postgis = PostGISHelper(db)
+    
+    # Habilitar PostGIS
+    postgis.enable_postgis()
+    
+    # Insertar un punto geográfico
+    punto_id = postgis.insert_point(
+        table_name="ubicaciones",
+        lat=40.4168,
+        lon=-3.7038,
+        data={"nombre": "Madrid", "tipo": "ciudad"}
+    )
+    
+    # Buscar puntos cercanos (5km)
+    cercanos = postgis.find_within_distance(
+        table_name="ubicaciones",
+        lat=40.4168,
+        lon=-3.7038,
+        distance_meters=5000
+    )
+```
+
+## Desarrollo
+
+### Ejecutar tests
+
+```bash
+pytest
+```
+
+### Formatear código
+
+```bash
+black src/ tests/
+```
+
+### Linting
+
+```bash
+flake8 src/ tests/
+```
+
+### Type checking
+
+```bash
+mypy src/
+```
+
+## Licencia
+
+MIT

eco_back-0.1.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+eco_back/__init__.py,sha256=wqxLfLLFexz8P2eytcAlniZpADuCEbcT5tYhEfvh280,181
+eco_back/api/__init__.py,sha256=9moiU5H8jGlva8k65bUK49LRIkE7bcLH1SK1dk23wcM,202
+eco_back/api/client.py,sha256=b2J9ty7mRtPUsMD-YJui60B9GEa-85VAAb-sS5y1Rp8,8537
+eco_back/api/config.py,sha256=dyERZY_4lXtRjhqLaHI0F4WlgPOQ_sw35eHNWGkQNLo,1590
+eco_back/api/registro.py,sha256=mQZXYnhkI_ETGmDJ8i1XrNTEsUX29q1mLvhJZDUybLU,2887
+eco_back/database/__init__.py,sha256=Q11tisd_yRqiycXImDbXyZgr4C1ZiGM2E0Cawt1k7CE,251
+eco_back/database/config.py,sha256=WTlQQoptL8RGRM_KIWcv9NJFXbDy_KVKvdykCrX47Rw,1584
+eco_back/database/connection.py,sha256=wGafOl_0dpgtFeIwe1f6QBtyrQ2BiEbw50Yfs1E-RWA,6314
+eco_back/database/models.py,sha256=832FKC-4lfWWai0b_mtCv-H1MdHLJaaFY5NvsW8BqGs,1161
+eco_back/database/postgis.py,sha256=oTuz8OzGeFiM3Aro3Zlid31t7tJJNSvqAUYTTaYUzoI,10954
+eco_back/database/repository.py,sha256=NFh0pfvf7Pw878qOoVhR8ARMFC0CiJBQ_EwKshY8lOE,4433
+eco_back-0.1.0.dist-info/licenses/LICENSE,sha256=XKKSDU9WlUEAyPNlRhq6e2xhVNpJc097JwPZJ1rUnRE,1077
+eco_back-0.1.0.dist-info/METADATA,sha256=k-MEYCgvA2RKFIT5tfeYR8C3LhRA2Ac2SFzlxTxm0VM,4615
+eco_back-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+eco_back-0.1.0.dist-info/top_level.txt,sha256=ViJZv023782XNNFMcAsRC9iN1CU3tb8lP9wDAHacMyc,9
+eco_back-0.1.0.dist-info/RECORD,,

eco_back-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

eco_back-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eco_back-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+eco_back