This release is a pre-release and may not be stable for production use.
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. Soporta facturación con PVPC (según disponibilidad de datos de REData) y tarificación fija personalizable mediante fórmulas. Todos los datos se almacenan localmente en una base de datos SQLite. Es el corazón de la integración 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:
pip install e-data
Si quieres probar la versión dev o contribuir a su desarrollo, clona este repositorio e instala manualmente las dependencias:
pip install -r requirements.txt
Estructura
El paquete consta de varios módulos:
-
Proveedores (
providers): Conectores para consultar diferentes fuentes de datos.datadis.py: Conector para la API privada de Datadis (datos de consumo, potencia, contratos y suministros).redata.py: Conector para la API pública de REData (precios PVPC en tiempo real).
-
Servicios (
services): Capa de lógica de negocio que gestiona la sincronización y procesamiento de datos.data_service.py: Servicio para gestionar datos de telemetría (consumo, potencia, estadísticas).bill_service.py: Servicio para gestionar la facturación y cálculo de costes.
-
Modelos (
models): Definiciones de estructuras de datos usando Pydantic.supply.py: Modelos de suministros (Supply) y contratos (Contract).data.py: Modelos de datos de telemetría (Energy,Power,Statistics).bill.py: Modelos de facturación (Bill,EnergyPrice,BillingRules,PVPCBillingRules).
-
Base de datos (
database): Gestión de persistencia local con SQLite.controller.py: Controlador principal de la base de datos (EdataDB).models.py: Modelos SQLModel para las tablas de la base de datos.queries.py: Consultas SQL predefinidas.
-
Utilidades (
core): Funciones auxiliares para cálculos de tarifas, fechas, etc. -
CLI (
cli.py): Interfaz de línea de comandos para operaciones básicas.
Ejemplo de uso
Usando los servicios (recomendado)
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
import asyncio
from datetime import datetime
from edata.services.data_service import DataService
from edata.services.bill_service import BillService
from edata.models.bill import PVPCBillingRules
async def main():
# Crear el servicio de datos
data_service = DataService(
cups="ES0000000000000000XX", # Tu CUPS
datadis_user="12345678A", # Tu NIF/usuario
datadis_pwd="tu_password",
storage_path="./my_data" # Directorio para la BD
datadis_authorized_nif=None, # NIF autorizado (opcional)
)
# Actualizar todos los datos disponibles
await data_service.update()
# Obtener suministros y contratos
supplies = await data_service.get_supplies()
contracts = await data_service.get_contracts()
# Obtener datos de consumo y potencia
energy = await data_service.get_energy()
power = await data_service.get_power()
# Obtener estadísticas agregadas (diarias o mensuales)
daily_stats = await data_service.get_statistics("day")
monthly_stats = await data_service.get_statistics("month")
# Crear el servicio de facturación
bill_service = BillService(
cups="ES0000000000000000XX",
storage_path="./my_data" # Mismo directorio que data_service
)
# Definir reglas de facturación PVPC (valores por defecto españoles)
pvpc_rules = PVPCBillingRules(
p1_kw_year_eur=30.67266, # Término potencia P1 (€/kW/año)
p2_kw_year_eur=1.4243591, # Término potencia P2 (€/kW/año)
meter_month_eur=0.81, # Alquiler contador (€/mes)
market_kw_year_eur=3.113, # Otros cargos (€/kW/año)
electricity_tax=1.0511300560, # Impuesto eléctrico
iva_tax=1.21 # IVA (21%)
)
# Actualizar facturación con PVPC
start_date = datetime(2024, 1, 1)
end_date = datetime(2024, 12, 31)
await bill_service.update(start_date, end_date, billing_rules=pvpc_rules, is_pvpc=True)
# Obtener facturas calculadas
bills = await bill_service.get_bills(start_date, end_date, type_="hour")
daily_bills = await bill_service.get_bills(start_date, end_date, type_="day")
monthly_bills = await bill_service.get_bills(start_date, end_date, type_="month")
# Mostrar resumen
total_cost = sum(b.value_eur for b in bills)
print(f"Coste total: {total_cost:.2f} €")
print(f"Consumo total: {sum(e.value_kwh for e in energy):.2f} kWh")
# Ejecutar
asyncio.run(main())
Usando la CLI
El paquete incluye una interfaz de línea de comandos para operaciones básicas:
# Ver suministros disponibles
python -m edata.cli show-supplies <username>
# Descargar todos los datos de un CUPS
python -m edata.cli download-all --cups ES0000000000000000XX <username>
# Actualizar facturación con tarifa fija
python -m edata.cli update-custom-bill \
--cups ES0000000000000000XX \
--p1-kw-year-eur 30.67 \
--p2-kw-year-eur 1.42 \
--p1-kwh-eur 0.15 \
--p2-kwh-eur 0.10 \
--p3-kwh-eur 0.08 \
--meter-month-eur 0.81
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file e_data-2.0.0.dev120.tar.gz.
File metadata
- Download URL: e_data-2.0.0.dev120.tar.gz
- Upload date:
- Size: 63.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
75faab6c8b7137e2edd5c057710a2a84a4901215faf4206a2543d1efdd272da9
|
|
| MD5 |
c88ebc8de121ab7dbd818bc870e65322
|
|
| BLAKE2b-256 |
f8976e3810c6f52aaaab2e07f8216165af2db49bc070790add3a6771f565b472
|
File details
Details for the file e_data-2.0.0.dev120-py3-none-any.whl.
File metadata
- Download URL: e_data-2.0.0.dev120-py3-none-any.whl
- Upload date:
- Size: 55.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
485580d111bdabc1e880619952166eba374681d1baaf526ebd9f9987cdf54e8b
|
|
| MD5 |
cd9de4aa14ad601c938a41f01bf6e0b4
|
|
| BLAKE2b-256 |
a7b234b4c69933e75839769fb49457270eb7c9d1641d25bbb5aad1227bd04148
|
