eco-back 0.1.0__tar.gz

eco_back-0.1.0/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/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+recursive-include src *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]

eco_back-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,155 @@
+# 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/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "eco-back"
+version = "0.1.0"
+description = "Librería Python eco-back"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "EI UNP", email = "ecosistema@unp.gov.co"}
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "psycopg2-binary>=2.9.0",
+    "geoalchemy2>=0.14.0",
+    "requests>=2.31.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "black>=23.0",
+    "flake8>=6.0",
+    "mypy>=1.0",
+    "pytest-mock>=3.12.0",
+]
+geo = [
+    "shapely>=2.0.0",
+    "geojson>=3.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/tuusuario/eco-back"
+Documentation = "https://github.com/tuusuario/eco-back"
+Repository = "https://github.com/tuusuario/eco-back"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 88
+target-version = ['py38']
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --cov=eco_back --cov-report=term-missing"
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true

eco_back-0.1.0/setup.cfg

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

eco_back-0.1.0/src/eco_back/__init__.py

@@ -0,0 +1,11 @@
+"""
+eco-back - Librería Python
+"""
+
+__version__ = "0.1.0"
+
+# Módulos principales
+from . import database
+from . import api
+
+__all__ = ["database", "api", "__version__"]

eco_back-0.1.0/src/eco_back/api/__init__.py

@@ -0,0 +1,9 @@
+"""
+Módulo de cliente API para eco-back
+"""
+
+from .config import APIConfig
+from .client import APIClient
+from .registro import Consecutivo
+
+__all__ = ["APIConfig", "APIClient", "Consecutivo"]