e-data 2.0.0b1__py3-none-any.whl

e_data-2.0.0b1.dist-info/METADATA

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: e-data
+Version: 2.0.0b1
+Summary: Python library for managing spanish energy data from various web providers
+Author-email: VMG <vmayorg@outlook.es>
+License: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/uvejota/python-edata
+Project-URL: Repository, https://github.com/uvejota/python-edata
+Project-URL: Issues, https://github.com/uvejota/python-edata/issues
+Keywords: energy,data,spain,electricity,consumption
+Classifier: Intended Audience :: Developers
+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
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: dateparser>=1.1.2
+Requires-Dist: holidays>=0.14.2
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: requests>=2.28.1
+Requires-Dist: voluptuous>=0.13.1
+Requires-Dist: Jinja2>=3.1.2
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: sqlmodel>=0.0.24
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.1.2; extra == "dev"
+Requires-Dist: freezegun>=1.2.1; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.1.2; extra == "test"
+Requires-Dist: freezegun>=1.2.1; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.20.0; extra == "test"
+Dynamic: license-file
+
+[![Downloads](https://pepy.tech/badge/e-data)](https://pepy.tech/project/e-data)
+[![Downloads](https://pepy.tech/badge/e-data/month)](https://pepy.tech/project/e-data)
+[![Downloads](https://pepy.tech/badge/e-data/week)](https://pepy.tech/project/e-data)
+
+# python-edata
+
+Este paquete proporciona herramientas para la descarga de tus datos de consumo eléctrico (desde Datadis.es) y su posterior procesado. La motivación principal es que conocer el consumo puede ayudarnos a reducirlo, e incluso a elegir una tarifa que mejor se adapte a nuestras necesidades. A día de hoy sus capacidades de facturación (€) son limitadas, soporta PVPC (según disponibilidad de datos de REData) y tarificación fija por tramos. Es el corazón de la integración [homeassistant-edata](https://github.com/uvejota/homeassistant-edata).
+
+_**Esta herramienta no mantiene ningún tipo de vinculación con los proveedores de datos anteriormente mencionados, simplemente consulta la información disponible y facilita su posterior análisis.**_
+
+## Instalación
+
+Puedes instalar la última versión estable mediante:
+
+``` bash
+pip install e-data
+```
+
+Si quieres probar la versión `dev` o contribuir a su desarrollo, clona este repositorio e instala manualmente las dependencias:
+
+``` bash
+make install-dev
+```
+
+## Estructura
+
+El paquete utiliza una **arquitectura basada en servicios** con los siguientes módulos:
+
+* **Conectores** (módulo `connectors`), para definir los métodos de consulta a los diferentes proveedores: Datadis y REData.
+* **Modelos** (módulo `models`), que definen las estructuras de datos usando Pydantic v2 para validación robusta. Incluye modelos para suministros, contratos, consumos, maxímetro, precios y base de datos.
+* **Servicios** (módulo `services`), que implementan la lógica de negocio para cada dominio: gestión de suministros, contratos, consumos, maxímetro, facturación y base de datos SQLite.
+* **Helper principal** (`helpers.py`), que orquesta todos los servicios y proporciona una interfaz simplificada. El `EdataHelper` permite descargar y procesar datos automáticamente, calculando más de 40 atributos de resumen.
+
+Estos módulos corresponden a la siguiente estructura del paquete:
+
+```
+edata/
+    · __init__.py
+    · const.py                  # Constantes y definiciones de atributos
+    · utils.py                  # Utilidades generales
+    · helpers.py                # Helper principal (EdataHelper)
+    · connectors/
+        · __init__.py
+        · datadis.py           # Conector API Datadis
+        · redata.py            # Conector API REData (PVPC)
+    · models/
+        · __init__.py
+        · base.py              # Modelos base con Pydantic
+        · supply.py            # Modelo de suministros
+        · contract.py          # Modelo de contratos
+        · consumption.py       # Modelo de consumos
+        · maximeter.py         # Modelo de maxímetro
+        · pricing.py           # Modelo de reglas de precios
+        · database.py          # Modelos para SQLite
+    · services/
+        · __init__.py
+        · database.py          # Servicio de base de datos SQLite
+        · supply.py            # Gestión de suministros
+        · contract.py          # Gestión de contratos
+        · consumption.py       # Gestión de consumos
+        · maximeter.py         # Gestión de maxímetro
+        · billing.py           # Gestión de facturación
+    · scripts/
+        · __init__.py
+        · dump.py              # Script interactivo de descarga
+```
+
+## Script interactivo
+
+El paquete incluye un script interactivo que facilita la descarga inicial de datos:
+
+```bash
+# Ejecutar el script interactivo
+python -m edata.scripts.dump
+
+# Con directorio personalizado
+python -m edata.scripts.dump --storage-dir /ruta/personalizada
+```
+
+Este script te guiará paso a paso para:
+1. Configurar credenciales de Datadis
+2. Seleccionar el suministro a procesar
+3. Definir el rango de fechas
+4. Descargar y almacenar todos los datos
+
+## Ejemplo de uso
+
+Partimos de que tenemos credenciales en Datadis.es. Algunas aclaraciones:
+* No es necesario solicitar API pública en el registro (se utilizará la API privada habilitada por defecto)
+* El username suele ser el NIF del titular
+* Copie el CUPS de la web de Datadis, algunas comercializadoras adhieren caracteres adicionales en el CUPS mostrado en su factura.
+* La herramienta acepta el uso de NIF autorizado para consultar el suministro de otro titular.
+
+``` python
+import asyncio
+from datetime import datetime
+import json
+
+# importamos el modelo de reglas de tarificación
+from edata.models.pricing import PricingRules
+# importamos el helper principal
+from edata.helpers import EdataHelper
+# importamos utilidades para serialización
+from edata import utils
+
+# Preparar reglas de tarificación (si se quiere)
+PRICING_RULES_PVPC = PricingRules(
+    p1_kw_year_eur=30.67266,
+    p2_kw_year_eur=1.4243591,
+    meter_month_eur=0.81,
+    market_kw_year_eur=3.113,
+    electricity_tax=1.0511300560,
+    iva_tax=1.05,
+    # podemos rellenar los siguientes campos si quisiéramos precio fijo (y no pvpc)
+    p1_kwh_eur=None,
+    p2_kwh_eur=None,
+    p3_kwh_eur=None,
+)
+
+async def main():
+    # Instanciar el helper
+    # 'datadis_authorized_nif' permite indicar el NIF de la persona que nos autoriza a consultar su CUPS.
+    # 'storage_dir_path' permite especificar dónde almacenar la base de datos local
+    edata = EdataHelper(
+                "datadis_user",
+                "datadis_password",
+                "cups",
+                datadis_authorized_nif=None,
+                pricing_rules=PRICING_RULES_PVPC, # si se le pasa None, no aplica tarificación
+                storage_dir_path=None, # por defecto usa ./edata.storage/
+            )
+
+    # Solicitar actualización de todo el histórico (los datos se almacenan en SQLite)
+    success = await edata.update(date_from=datetime(1970, 1, 1), date_to=datetime.today())
+    
+    if success:
+        # Imprimir atributos resumen calculados
+        print("Atributos calculados:")
+        for key, value in edata.attributes.items():
+            if value is not None:
+                print(f"  {key}: {value}")
+        
+        # Los datos se almacenan automáticamente en la base de datos SQLite
+        # ubicada en edata.storage/edata.db (por defecto)
+        print(f"\nDatos almacenados en la base de datos local")
+    else:
+        print("Error durante la actualización de datos")
+
+# Ejecutar el ejemplo
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Contribuir
+
+Este proyecto está en desarrollo activo. Las contribuciones son bienvenidas:
+
+1. Fork del repositorio
+2. Crear una rama para tu feature: `git checkout -b feature/nueva-funcionalidad`
+3. Commit de tus cambios: `git commit -am 'Añadir nueva funcionalidad'`
+4. Push a la rama: `git push origin feature/nueva-funcionalidad`
+5. Crear un Pull Request
+
+## Licencia
+
+Este proyecto está licenciado bajo GPLv3. Ver el archivo [LICENSE](LICENSE) para más detalles.

e_data-2.0.0b1.dist-info/RECORD

@@ -0,0 +1,21 @@
+e_data-2.0.0b1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+edata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+edata/const.py,sha256=280w4loTootYA1pgpI_KeE2qHoFQkcYXAteDWVfp4C4,1763
+edata/helpers.py,sha256=D3o0dRsIzz7qHXDW69bzLJHj-GxvVmofyO2N3KPH2lk,11871
+edata/utils.py,sha256=0A21lN1BgNdainSxjNm2Zaw7ZPu9fn5KJxK5qhuZsv4,4763
+edata/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+edata/tests/test_helpers.py,sha256=i40TZGMhzW0huY2zUoA50zhfbNe2a0YVmYPYT5BOAsI,22685
+edata/tests/connectors/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+edata/tests/connectors/test_datadis_connector.py,sha256=dDcam56rzL1C0l74YAkUZ9I41L9IRMloeGSern7dPpA,5419
+edata/tests/connectors/test_redata_connector.py,sha256=XyedugKYeGwg3jmnWXZN5BBW52lJHtCP1hHKSnQazk8,979
+edata/tests/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+edata/tests/services/test_billing_service.py,sha256=s5N3k-4etOw7pGQHYfI7TsUOPwu2j0NuZDeJ0iJu7g8,43871
+edata/tests/services/test_consumption_service.py,sha256=Azds8Cy3JCCal4R7wPGsCDgtQS7mh3az60WmteZ7ARI,36440
+edata/tests/services/test_contract_service.py,sha256=swGYufdVWPgEaIR8xHaULPnNZ8-AVBaZYlRgwfbTvV8,7870
+edata/tests/services/test_database_service.py,sha256=Xbpl69g3BiA1Gb5i29riQeWgrYeR3LrY-RPDQ4tiegI,15372
+edata/tests/services/test_maximeter_service.py,sha256=yT2Ho0d_Qo0ZuMfEWxU4bGR71N3qX4_tZ-V3eLqF3Vs,2839
+edata/tests/services/test_supply_service.py,sha256=HpLe1Cm0FmU8qZyLUrIJsFgSwlD2TNm7oTKmmhcaPcE,8761
+e_data-2.0.0b1.dist-info/METADATA,sha256=RZkHWiIMYghD7LSJ09ibxJkb2QdSG-A7g1a1m7NDGL4,8982
+e_data-2.0.0b1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+e_data-2.0.0b1.dist-info/top_level.txt,sha256=Ez-fReWtUVTMcFuH0dzCnoKIgMBHgjLaBuba8QiKC7g,6
+e_data-2.0.0b1.dist-info/RECORD,,

e_data-2.0.0b1.dist-info/WHEEL

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