python-esios 2.0.0__tar.gz → 2.0.1__tar.gz

{python_esios-2.0.0 → python_esios-2.0.1}/.github/workflows/publish.yml

@@ -24,3 +24,5 @@ jobs:
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

{python_esios-2.0.0 → python_esios-2.0.1}/.gitignore

@@ -31,6 +31,7 @@ docs/
 *.xls
 *.xlsx
 data/
+!src/esios/data/
 
 # Legacy code (superseded by src/)
 esios_legacy/

{python_esios-2.0.0 → python_esios-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-esios
-Version: 2.0.0
+Version: 2.0.1
 Summary: A Python wrapper for the ESIOS API (Spanish electricity market)
 Project-URL: Homepage, https://github.com/datons/python-esios
 Project-URL: Repository, https://github.com/datons/python-esios

{python_esios-2.0.0 → python_esios-2.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "python-esios"
-version = "2.0.0"
+version = "2.0.1"
 description = "A Python wrapper for the ESIOS API (Spanish electricity market)"
 readme = "README.md"
 license = "GPL-3.0-only"

python_esios-2.0.1/src/esios/data/catalogs/archives/__init__.py

@@ -0,0 +1,5 @@
+"""Archives catalog — static reference of all known ESIOS archives."""
+
+from esios.data.catalogs.archives.catalog import ARCHIVES_CATALOG
+
+__all__ = ["ARCHIVES_CATALOG"]

python_esios-2.0.1/src/esios/data/catalogs/archives/catalog.py

@@ -0,0 +1,163 @@
+"""Static catalog of ESIOS archives.
+
+Auto-generated by refresh.py — do not edit manually.
+"""
+
+from __future__ import annotations
+
+ARCHIVES_CATALOG: dict[int, dict[str, str]] = {
+    2: {"name": "A1_liquicomun", "description": "Avance de liquidación A1", "horizon": "M", "archive_type": "zip"},
+    3: {"name": "A2_liquicomun", "description": "Avance de liquidación A2", "horizon": "M", "archive_type": "zip"},
+    8: {"name": "C2_liquicomun", "description": "Cierre de liquidación C2", "horizon": "M", "archive_type": "zip"},
+    9: {"name": "C3_liquicomun", "description": "Cierre de liquidación C3", "horizon": "M", "archive_type": "zip"},
+    10: {"name": "C4_liquicomun", "description": "Cierre de liquidación C4", "horizon": "M", "archive_type": "zip"},
+    11: {"name": "C5_liquicomun", "description": "Cierre de liquidación C5", "horizon": "M", "archive_type": "zip"},
+    12: {"name": "C6_liquicomun", "description": "Cierre de liquidación C6", "horizon": "M", "archive_type": "zip"},
+    13: {"name": "C7_liquicomun", "description": "Cierre de liquidación C7", "horizon": "M", "archive_type": "zip"},
+    14: {"name": "C8_liquicomun", "description": "Cierre de liquidación C8", "horizon": "M", "archive_type": "zip"},
+    15: {"name": "hemeroteca_DD_ent", "description": "Fichero de hemeroteca de entrada.", "horizon": "D", "archive_type": "zip"},
+    16: {"name": "hemeroteca_DD_sal", "description": "Fichero de hemeroteca de salida", "horizon": "D", "archive_type": "zip"},
+    17: {"name": "liquicierre", "description": "Resultados de la Regulación Secundaria exigidos para la Liquidación", "horizon": "D", "archive_type": "xml"},
+    18: {"name": "totalpdbf", "description": "Programa agregado resultante del PBF", "horizon": "D", "archive_type": "xml"},
+    19: {"name": "totalrpdvpprec", "description": "Solución de Restricciones Técnicas", "horizon": "D", "archive_type": "xml"},
+    20: {"name": "totalpdvp", "description": "PVP Agregado Horizonte Diario", "horizon": "D", "archive_type": "xml"},
+    21: {"name": "totalasigsec", "description": "Asignación Regulación Secundaria", "horizon": "D", "archive_type": "xml"},
+    22: {"name": "totalrpibcirest", "description": "Solución de Restricciones Técnicas MI", "horizon": "H", "archive_type": "xml"},
+    23: {"name": "totalasigdesv", "description": "Mercado de Gestión de Desvíos", "horizon": "H", "archive_type": "xml"},
+    24: {"name": "totalasigter", "description": "Mercado de Regulación Terciaria", "horizon": "D", "archive_type": "xml"},
+    25: {"name": "totalenersec", "description": "Energía Secundaria utilizada", "horizon": "D", "archive_type": "xml"},
+    26: {"name": "totalliquicierre", "description": "Cálculo Variación Coste Fijo", "horizon": "D", "archive_type": "xml"},
+    27: {"name": "totalrp48prec", "description": "Redespachos Seguridad Tiempo Real (Horario)", "horizon": "H", "archive_type": "xml"},
+    28: {"name": "totalrp48preccierre", "description": "Redespachos Seguridad Tiempo Real (Cierre)", "horizon": "D", "archive_type": "xml"},
+    29: {"name": "totalp48", "description": "Programa Agregado P48 (Horario)", "horizon": "H", "archive_type": "xml"},
+    30: {"name": "totalp48cierre", "description": "Programa Agregado P48 (Cierre)", "horizon": "D", "archive_type": "xml"},
+    32: {"name": "I3DIA", "description": "Información agregada diaria por tecnología (I3DIA)", "horizon": "D", "archive_type": "zip"},
+    33: {"name": "IMES", "description": "Cuotas mensuales por Sujetos de Liquidación (IMES)", "horizon": "M", "archive_type": "zip"},
+    34: {"name": "I90DIA", "description": "Información de detalle por Unidad de Programación (I90DIA)", "horizon": "D", "archive_type": "zip"},
+    35: {"name": "COEF_PERD_PEN_MM", "description": "Coeficientes horarios de pérdidas en el sistema peninsular", "horizon": "M", "archive_type": "xls"},
+    36: {"name": "COEF_PERD_MEL_MM", "description": "Coeficientes horarios de pérdidas en el sistema de Melilla", "horizon": "M", "archive_type": "xls"},
+    37: {"name": "COEF_PERD_CEU_MM", "description": "Coeficientes horarios de pérdidas en el sistema de Ceuta", "horizon": "M", "archive_type": "xls"},
+    38: {"name": "COEF_PERD_CAN_MM", "description": "Coeficientes horarios de pérdidas en el sistema de Canarias", "horizon": "M", "archive_type": "xls"},
+    39: {"name": "COEF_PERD_BAL_MM", "description": "Coeficientes horarios de pérdidas en el sistema de Baleares", "horizon": "M", "archive_type": "xls"},
+    40: {"name": "COEF_KEST_MM", "description": "Coeficiente de ajuste horario estimado en el sistema peninsular y no peninsular", "horizon": "M", "archive_type": "xls"},
+    42: {"name": "Espec_Subasta_Diaria_EF", "description": "Especificación de subastas explícitas Diarias de capacidad en la interconexión con Francia", "horizon": "D", "archive_type": "pdf"},
+    43: {"name": "Espec_Subasta_Diaria_FE", "description": "Especificación de subastas explícitas Diarias de capacidad en la interconexión con Francia", "horizon": "D", "archive_type": "pdf"},
+    44: {"name": "Espec_Subasta_Intra1_EF", "description": "Especificación de subastas explícitas Intradiarias 1 de capacidad en la interconexión con Francia", "horizon": "D", "archive_type": "pdf"},
+    45: {"name": "Espec_Subasta_Intra1_FE", "description": "Especificación de subastas explícitas Intradiarias 1 de capacidad en la interconexión con Francia", "horizon": "D", "archive_type": "pdf"},
+    46: {"name": "Espec_Subasta_Intra2_EF", "description": "Especificación de subastas explícitas Intradiarias 2 de capacidad en la interconexión con Francia", "horizon": "D", "archive_type": "pdf"},
+    47: {"name": "Espec_Subasta_Intra2_FE", "description": "Especificación de subastas explícitas Intradiarias 2 de capacidad en la interconexión con Francia", "horizon": "D", "archive_type": "pdf"},
+    48: {"name": "Espec_Subasta_Mensual_EF", "description": "Especificación de subastas explícitas Mensuales de capacidad en la interconexión con Francia", "horizon": "M", "archive_type": "pdf"},
+    49: {"name": "Espec_Subasta_Mensual_FE", "description": "Especificación de subastas explícitas Mensuales de capacidad en la interconexión con Francia", "horizon": "M", "archive_type": "pdf"},
+    50: {"name": "Espec_Subasta_Anual_EF", "description": "Especificación de subastas explícitas Anuales de capacidad en la interconexión con Francia", "horizon": "A", "archive_type": "pdf"},
+    51: {"name": "Espec_Subasta_Anual_FE", "description": "Especificación de subastas explícitas Anuales de capacidad en la interconexión con Francia", "horizon": "A", "archive_type": "pdf"},
+    56: {"name": "Espec_Subasta_Intra2_EF_Cancel", "description": "Especificación de subastas explícitas Intradiarias 2 de capacidad en la interconexión con Francia", "horizon": "D", "archive_type": "pdf"},
+    57: {"name": "Espec_Subasta_Intra2_FE_Cancel", "description": "Especificación de subastas explícitas Intradiarias 2 de capacidad en la interconexión con Francia", "horizon": "D", "archive_type": "pdf"},
+    58: {"name": "Espec_Subasta_Mensual_EF_Cancel", "description": "Especificación de subastas explícitas Mensuales de capacidad en la interconexión con Francia", "horizon": "M", "archive_type": "pdf"},
+    59: {"name": "Espec_Subasta_Mensual_FE_Cancel", "description": "Especificación de subastas explícitas Mensuales de capacidad en la interconexión con Francia", "horizon": "M", "archive_type": "pdf"},
+    62: {"name": "IND_DemandaInterrumpible", "description": "IND_DemandaInterrumpible", "horizon": "D", "archive_type": "json"},
+    63: {"name": "IND_Interconexiones", "description": "IND_Interconexiones", "horizon": "D", "archive_type": "json"},
+    64: {"name": "IND_PotenciaInstalada", "description": "IND_PotenciaInstalada", "horizon": "M", "archive_type": "json"},
+    65: {"name": "IND_PrecioDesvios", "description": "IND_PrecioDesvios", "horizon": "D", "archive_type": "json"},
+    66: {"name": "IND_PrecioFinal", "description": "IND_PrecioFinal", "horizon": "D", "archive_type": "json"},
+    67: {"name": "IND_Umbrales", "description": "IND_Umbrales", "horizon": "D", "archive_type": "json"},
+    68: {"name": "INF_SUBASTA_AA", "description": "Informe anual de subastas de capacidad con Francia", "horizon": "A", "archive_type": "pdf"},
+    69: {"name": "INF_SUBASTA_MM", "description": "Informe mensual de subastas de capacidad con Francia", "horizon": "M", "archive_type": "pdf"},
+    70: {"name": "PVPC_CURV_DD", "description": "Datos origen de curva PVPC", "horizon": "D", "archive_type": "json"},
+    71: {"name": "PVPC_DETALLE_DD", "description": "PVPC Término de facturación energía activa – Desglose", "horizon": "D", "archive_type": "xls"},
+    72: {"name": "PVPC_GEN_P1_DD", "description": "Datos origen de tarifa general P1", "horizon": "D", "archive_type": "json"},
+    73: {"name": "PVPC_NOC_P1_DD", "description": "Datos origen de tarifa nocturna P1", "horizon": "D", "archive_type": "json"},
+    74: {"name": "PVPC_NOC_P2_DD", "description": "Datos origen de tarifa nocturna P2", "horizon": "D", "archive_type": "json"},
+    75: {"name": "PVPC_VHC_P1_DD", "description": "Datos origen de tarifa vehículo eléctrico P1", "horizon": "D", "archive_type": "json"},
+    76: {"name": "PVPC_VHC_P2_DD", "description": "Datos origen de tarifa vehículo eléctrico P2", "horizon": "D", "archive_type": "json"},
+    77: {"name": "PVPC_VHC_P3_DD", "description": "Datos origen de tarifa vehículo eléctrico P3", "horizon": "D", "archive_type": "json"},
+    78: {"name": "perfilconsumo", "description": "PVPC Coeficientes de perfilado", "horizon": "S", "archive_type": "xml"},
+    79: {"name": "preciovoluntariopconsumidor", "description": "PVPC por ciclo de lectura", "horizon": "D", "archive_type": "xml"},
+    80: {"name": "pvpcdesglosehorario", "description": "PVPC Término de facturación energía activa", "horizon": "D", "archive_type": "xml"},
+    81: {"name": "UnidadesFisicas", "description": "Datos Estructurales de unidades físicas", "horizon": "NA", "archive_type": "json"},
+    82: {"name": "UnidadesProgramacion", "description": "Datos estructurales de unidades de programación", "horizon": "NA", "archive_type": "json"},
+    83: {"name": "SujetosMercado", "description": "Datos estructurales de sujetos de mercado", "horizon": "NA", "archive_type": "json"},
+    84: {"name": "ParticipantesSubasta", "description": "Datos estructurales de participantes de subasta", "horizon": "NA", "archive_type": "json"},
+    87: {"name": "Resultado_Subasta_Mensual_FRA", "description": "Subastas mensuales del calendariode subastas de Francia", "horizon": "M", "archive_type": "xls"},
+    88: {"name": "Resultado_Subasta_Anual_FRA", "description": "Subastas anuales del calendariode subastas de Francia", "horizon": "A", "archive_type": "xls"},
+    89: {"name": "Descargos_AND_Planificados", "description": "Descargos Andorra", "horizon": "O", "archive_type": "xml"},
+    91: {"name": "Descargos_MAR_Planificados", "description": "Descargos Marruecos", "horizon": "O", "archive_type": "xml"},
+    93: {"name": "Descargos_POR_Planificados", "description": "Descargos Portugal", "horizon": "O", "archive_type": "xml"},
+    95: {"name": "Descargos_FRA_Planificados", "description": "Descargos Francia", "horizon": "O", "archive_type": "xml"},
+    101: {"name": "REE_InterChangeAvailab_FRA", "description": "Cambios en disponibilidad real de capacidad en interconexión con Francia", "horizon": "O", "archive_type": "xml"},
+    102: {"name": "REE_InterChangeAvailab_POR", "description": "Cambios en disponibilidad real de capacidad en interconexión con Portugal", "horizon": "O", "archive_type": "xml"},
+    105: {"name": "Indisponibilidades", "description": "Indisponibilidades de las unidades de generación y consumo", "horizon": "D", "archive_type": "xls"},
+    106: {"name": "PlanesMantenimiento", "description": "Plan de mantenimiento", "horizon": "M", "archive_type": "xls"},
+    107: {"name": "p48cierre", "description": "Cierre de programa Desagregado P48", "horizon": "D", "archive_type": "xml"},
+    108: {"name": "REE_AggGenOutput", "description": "Generación real por tipo de producción", "horizon": "QM", "archive_type": "xml"},
+    109: {"name": "REE_ActualGenOutput", "description": "Generación real por unidad física", "horizon": "D", "archive_type": "xml"},
+    110: {"name": "GenerationUnits", "description": "Generation Units Structural Data", "horizon": "NA", "archive_type": "json"},
+    111: {"name": "ProgrammingUnits", "description": "Programming Units Structural Data", "horizon": "NA", "archive_type": "json"},
+    112: {"name": "BalanceResponsibleParties", "description": "Balance Responsible Parties Structural Data", "horizon": "NA", "archive_type": "json"},
+    113: {"name": "EntitledParticipants", "description": "Entitled Participants Structural Data", "horizon": "NA", "archive_type": "json"},
+    114: {"name": "IND_DemandaPrevProg", "description": "IND_DemandaPrevProg", "horizon": "D", "archive_type": "json"},
+    115: {"name": "IND_DemandaRealGen", "description": "IND_DemandaRealGen", "horizon": "D", "archive_type": "json"},
+    116: {"name": "IND_MaxMin", "description": "IND_MaxMin", "horizon": "D", "archive_type": "json"},
+    117: {"name": "IND_MaxMinRenovEol", "description": "IND_MaxMinRenovEol", "horizon": "D", "archive_type": "json"},
+    118: {"name": "ActividadesSubactividades", "description": "Informe de actividades y subactividades", "horizon": "NA", "archive_type": "pdf"},
+    119: {"name": "AgregacionesValidas", "description": "Informe de agregaciones válidas", "horizon": "NA", "archive_type": "pdf"},
+    120: {"name": "CNAEValidos", "description": "Informe de códigos CNAE válidos", "horizon": "NA", "archive_type": "pdf"},
+    121: {"name": "Comercializadores", "description": "Informe de comercializadores", "horizon": "NA", "archive_type": "pdf"},
+    122: {"name": "Concentradores", "description": "Informe de concentradores", "horizon": "NA", "archive_type": "pdf"},
+    123: {"name": "DiscriminacionHoraria", "description": "Informe de discriminaciones horarias", "horizon": "NA", "archive_type": "pdf"},
+    124: {"name": "Distribuidores", "description": "Informe de distribuidores", "horizon": "NA", "archive_type": "pdf"},
+    125: {"name": "Fabricantes", "description": "Informe de fabricantes", "horizon": "NA", "archive_type": "pdf"},
+    126: {"name": "Magnitudes", "description": "Informe de magnitudes", "horizon": "NA", "archive_type": "pdf"},
+    127: {"name": "ModeloContadores", "description": "Informe de modelo de contadores", "horizon": "NA", "archive_type": "pdf"},
+    128: {"name": "ModeloRegistradores", "description": "Informe de modelos de registradores", "horizon": "NA", "archive_type": "pdf"},
+    129: {"name": "ModeloTransformadores", "description": "Informe de modelo de transformadores", "horizon": "NA", "archive_type": "pdf"},
+    130: {"name": "NivelesTension", "description": "Informe de niveles de tensión", "horizon": "NA", "archive_type": "pdf"},
+    131: {"name": "Provincias", "description": "Informe de provincias", "horizon": "NA", "archive_type": "pdf"},
+    132: {"name": "Representantes", "description": "Informe de representantes", "horizon": "NA", "archive_type": "pdf"},
+    133: {"name": "Subsistemas", "description": "Informe de subsistemas", "horizon": "NA", "archive_type": "pdf"},
+    134: {"name": "ZonasGeograficas", "description": "Informe de zonas geográficas", "horizon": "NA", "archive_type": "pdf"},
+    135: {"name": "TarifaAcceso", "description": "Informe de tarifas de acceso", "horizon": "NA", "archive_type": "pdf"},
+    136: {"name": "A6_liquicomun", "description": "Avance de liquidación A6", "horizon": "M", "archive_type": "zip"},
+    137: {"name": "A7_liquicomun", "description": "Avance de liquidación A7", "horizon": "M", "archive_type": "zip"},
+    139: {"name": "IND_EnergiaMensual", "description": "IND_EnergiaMensual", "horizon": "M", "archive_type": "json"},
+    140: {"name": "IND_EnergiaAnual", "description": "IND_EnergiaAnual", "horizon": "A", "archive_type": "json"},
+    142: {"name": "ConsumidoresDirectos", "description": "Informe de Consumidores Directos", "horizon": "NA", "archive_type": "pdf"},
+    143: {"name": "MotivosObjecionEdLD", "description": "Informe de Motivos Objeción EdLD", "horizon": "NA", "archive_type": "pdf"},
+    144: {"name": "MotivosObjecionEdLOS", "description": "Informe de Motivos Objeción EdLOS", "horizon": "NA", "archive_type": "pdf"},
+    145: {"name": "TiposMedidaPuntoMedida", "description": "Informe de tipos de medida de punto medida", "horizon": "NA", "archive_type": "pdf"},
+    146: {"name": "TiposMedidaPuntoFrontera", "description": "Informe de tipos de medida de punto frontera", "horizon": "NA", "archive_type": "pdf"},
+    147: {"name": "Espec_Subasta_Mensual_EP", "description": "Especificación de subastas explícitas Mensuales de capacidad en la interconexión con Portugal", "horizon": "M", "archive_type": "pdf"},
+    148: {"name": "Espec_Subasta_Mensual_PE", "description": "Especificación de subastas explícitas Mensuales de capacidad en la interconexión con Portugal", "horizon": "M", "archive_type": "pdf"},
+    149: {"name": "Espec_Subasta_Trimestral_EP", "description": "Especificación de subastas explícitas Trimestrales de capacidad en la interconexión con Portugal", "horizon": "T", "archive_type": "pdf"},
+    150: {"name": "Espec_Subasta_Trimestral_PE", "description": "Especificación de subastas explícitas Trimestrales de capacidad en la interconexión con Portugal", "horizon": "T", "archive_type": "pdf"},
+    151: {"name": "Espec_Subasta_Anual_EP", "description": "Especificación de subastas explícitas Trimestrales de capacidad en la interconexión con Portugal", "horizon": "A", "archive_type": "pdf"},
+    152: {"name": "Espec_Subasta_Anual_PE", "description": "Especificación de subastas explícitas Trimestrales de capacidad en la interconexión con Portugal", "horizon": "A", "archive_type": "pdf"},
+    159: {"name": "Resultado_Subasta_Mensual_POR", "description": "Subastas mensuales del calendario de subastas de Portugal", "horizon": "M", "archive_type": "xls"},
+    160: {"name": "Resultado_Subasta_Anual_POR", "description": "Subastas anuales del calendario de subastas de Portugal", "horizon": "A", "archive_type": "xls"},
+    161: {"name": "Resultado_Subasta_Trimestral_POR", "description": "Subastas trimestrales del calendario de subastas de Portugal", "horizon": "T", "archive_type": "xls"},
+    164: {"name": "CodigosTensiones", "description": "Informe de códigos de tensiones de suministro", "horizon": "NA", "archive_type": "pdf"},
+    165: {"name": "UnidadesConsumoGeneracion", "description": "Informe de unidades de consumo de generación", "horizon": "NA", "archive_type": "pdf"},
+    166: {"name": "CodigosAutoconsumo", "description": "Informe de códigos de autoconsumo", "horizon": "NA", "archive_type": "pdf"},
+    167: {"name": "IND_PotenciaInstaladaNacional", "description": "IND_PotenciaInstaladaNacional", "horizon": "M", "archive_type": "json"},
+    168: {"name": "IND_EnergiaMensualNacional", "description": "IND_EnergiaMensualNacional", "horizon": "M", "archive_type": "json"},
+    169: {"name": "IND_EnergiaAnualNacional", "description": "IND_EnergiaAnualNacional", "horizon": "A", "archive_type": "json"},
+    170: {"name": "IND_CoeficientesCO2", "description": "IND_CoeficientesCO2", "horizon": "NA", "archive_type": "json"},
+    171: {"name": "IND_InformacionApp", "description": "IND_InformacionApp", "horizon": "NA", "archive_type": "json"},
+    172: {"name": "IND_PreguntasApp", "description": "IND_PreguntasApp", "horizon": "NA", "archive_type": "json"},
+    173: {"name": "IND_VersionApp", "description": "IND_VersionApp", "horizon": "NA", "archive_type": "json"},
+    174: {"name": "IND_PrecioMinorista", "description": "IND_PrecioMinorista", "horizon": "D", "archive_type": "json"},
+    181: {"name": "REE_BalancingEnerBids", "description": "Mercado de Regulación Terciaria", "horizon": "QM", "archive_type": "csv"},
+    183: {"name": "IND_EnergiaAnualAutoconsumoNacional", "description": "IND_EnergiaAnualAutoconsumoNacional", "horizon": "A", "archive_type": "json"},
+    184: {"name": "IND_EnergiaMensualAutoconsumoNacional", "description": "IND_EnergiaMensualAutoconsumoNacional", "horizon": "M", "archive_type": "json"},
+    185: {"name": "ActivacionesDelServicio", "description": "Activaciones del Servicio", "horizon": "NA", "archive_type": "json"},
+    186: {"name": "ServiceActivation", "description": "Service Activation", "horizon": "NA", "archive_type": "json"},
+    187: {"name": "C2_PrecioFinal", "description": "Precio final de la energía C2", "horizon": "M", "archive_type": "zip"},
+    188: {"name": "C5_PrecioFinal", "description": "Precio final de la energía C5", "horizon": "M", "archive_type": "zip"},
+    193: {"name": "IND_Novedades", "description": "IND_Novedades", "horizon": "NA", "archive_type": "json"},
+    194: {"name": "IND_Novedades_Paso1", "description": "Json lottie Paso1", "horizon": "NA", "archive_type": "json"},
+    195: {"name": "IND_Novedades_Paso2", "description": "Json lottie Paso2", "horizon": "NA", "archive_type": "json"},
+    196: {"name": "IND_Novedades_Paso3", "description": "Json lottie Paso3", "horizon": "NA", "archive_type": "json"},
+    197: {"name": "IND_Novedades_Paso4", "description": "Json lottie Paso3", "horizon": "NA", "archive_type": "json"},
+    198: {"name": "IND_Novedades_Step1", "description": "Json lottie Step1", "horizon": "NA", "archive_type": "json"},
+    199: {"name": "IND_Novedades_Step2", "description": "Json lottie Step2", "horizon": "NA", "archive_type": "json"},
+}
+

python_esios-2.0.1/src/esios/data/catalogs/archives/refresh.py

@@ -0,0 +1,95 @@
+"""Refresh the static archives catalog by scanning the ESIOS API.
+
+Usage:
+    uv run python -m esios.data.catalogs.archives.refresh
+
+Scans archive IDs 1-200 against the live API and regenerates catalog.py.
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+
+def scan_archives(max_id: int = 200) -> dict[int, dict[str, str]]:
+    """Scan ESIOS API for all accessible archives."""
+    from esios import ESIOSClient
+
+    client = ESIOSClient()
+    catalog: dict[int, dict[str, str]] = {}
+
+    for i in range(1, max_id + 1):
+        try:
+            data = client.get(f"archives/{i}")
+            a = data.get("archive", {})
+            catalog[i] = {
+                "name": a.get("name", ""),
+                "description": a.get("description", ""),
+                "horizon": a.get("horizon", ""),
+                "archive_type": a.get("archive_type", ""),
+            }
+        except Exception:
+            continue
+
+    return catalog
+
+
+def generate_catalog_py(catalog: dict[int, dict[str, str]]) -> str:
+    """Generate the catalog.py source code."""
+    lines = [
+        '"""Static catalog of ESIOS archives.',
+        "",
+        "Auto-generated by refresh.py — do not edit manually.",
+        '"""',
+        "",
+        "from __future__ import annotations",
+        "",
+        "ARCHIVES_CATALOG: dict[int, dict[str, str]] = {",
+    ]
+
+    for id_ in sorted(catalog):
+        entry = catalog[id_]
+        name = entry["name"]
+        desc = entry["description"].replace('"', '\\"')
+        horizon = entry["horizon"]
+        atype = entry["archive_type"]
+        lines.append(
+            f'    {id_}: {{"name": "{name}", "description": "{desc}", '
+            f'"horizon": "{horizon}", "archive_type": "{atype}"}},'
+        )
+
+    lines.append("}")
+    lines.append("")
+    return "\n".join(lines)
+
+
+def main() -> None:
+    from esios.data.catalogs.archives.catalog import ARCHIVES_CATALOG
+
+    old_ids = set(ARCHIVES_CATALOG.keys())
+
+    print(f"Scanning ESIOS API for archives (IDs 1-200)...")
+    catalog = scan_archives()
+    new_ids = set(catalog.keys())
+
+    # Diff summary
+    added = new_ids - old_ids
+    removed = old_ids - new_ids
+
+    print(f"\nFound {len(catalog)} archives (was {len(old_ids)})")
+    if added:
+        print(f"  Added: {sorted(added)}")
+    if removed:
+        print(f"  Removed: {sorted(removed)}")
+    if not added and not removed:
+        print("  No changes in archive IDs.")
+
+    # Write catalog.py
+    catalog_path = Path(__file__).parent / "catalog.py"
+    catalog_path.write_text(generate_catalog_py(catalog))
+    print(f"\nWrote {catalog_path}")
+
+
+if __name__ == "__main__":
+    main()

{python_esios-2.0.0 → python_esios-2.0.1}/src/esios/managers/archives.py

@@ -76,20 +76,20 @@ class ArchiveHandle:
         date: str | None = None,
         output_dir: str | Path | None = None,
         date_type: str = "datos",
-    ) -> Path:
+    ) -> list[Path]:
         """Download archive files for a single date or date range.
 
         Files are always stored in the cache directory. If ``output_dir`` is
         provided, a copy is placed there as well.
 
-        Returns the cache directory where files were stored.
+        Returns a sorted list of downloaded/cached file paths.
         """
         if date and not (start and end):
             self.configure(date=date, date_type=date_type)
             cache_folder = self._download_single()
             if output_dir:
                 self._copy_to_output(cache_folder, Path(output_dir))
-            return cache_folder
+            return sorted(f for f in cache_folder.iterdir() if f.is_file())
 
         if not (start and end):
             raise ValueError("Provide 'date' or both 'start' and 'end'.")
@@ -101,7 +101,7 @@ class ArchiveHandle:
         horizon = self.metadata.get("archive", {}).get("horizon", "D")
         archive_type = self.metadata.get("archive", {}).get("archive_type", "zip")
         current = start_date
-        last_folder: Path | None = None
+        files: list[Path] = []
 
         while current <= end_date:
             if horizon == "M":
@@ -118,7 +118,7 @@ class ArchiveHandle:
                 logger.info("Cache hit: %s", cache_folder)
                 if output_dir:
                     self._copy_to_output(cache_folder, Path(output_dir))
-                last_folder = cache_folder
+                files.extend(f for f in cache_folder.iterdir() if f.is_file())
                 current = chunk_end + timedelta(days=1)
                 continue
 
@@ -136,7 +136,7 @@ class ArchiveHandle:
             # Write to cache
             cache_folder = self._cache.archive_dir(self.id, self.name, key)
             self._write_content(content, cache_folder, key, archive_type)
-            last_folder = cache_folder
+            files.extend(f for f in cache_folder.iterdir() if f.is_file())
 
             # Copy to output if requested
             if output_dir:
@@ -144,7 +144,7 @@ class ArchiveHandle:
 
             current = chunk_end + timedelta(days=1)
 
-        return last_folder or self._cache.archive_dir(self.id, self.name, "")
+        return sorted(files)
 
     # -- Internal helpers ------------------------------------------------------
 
@@ -199,12 +199,25 @@ class ArchiveHandle:
 class ArchivesManager(BaseManager):
     """Manager for ``/archives`` endpoints."""
 
-    def list(self) -> pd.DataFrame:
-        """List all available archives as a DataFrame."""
-        data = self._get("archives")
-        df = pd.DataFrame(data.get("archives", []))
-        if "id" in df.columns:
-            df = df.set_index("id")
+    def list(self, *, source: str = "local") -> pd.DataFrame:
+        """List all available archives as a DataFrame.
+
+        Args:
+            source: ``"local"`` (default) returns the full static catalog
+                (153 archives including I90, settlements, etc.).
+                ``"api"`` queries the ESIOS API which only returns ~24 archives.
+        """
+        if source == "api":
+            data = self._get("archives", params={"date_type": "publicacion"})
+            df = pd.DataFrame(data.get("archives", []))
+            if "id" in df.columns:
+                df = df.set_index("id")
+            return df
+
+        from esios.data.catalogs.archives import ARCHIVES_CATALOG
+
+        df = pd.DataFrame.from_dict(ARCHIVES_CATALOG, orient="index")
+        df.index.name = "id"
         return df
 
     def get(self, archive_id: int) -> ArchiveHandle:
@@ -225,10 +238,10 @@ class ArchivesManager(BaseManager):
         date: str | None = None,
         output_dir: str | Path | None = None,
         date_type: str = "datos",
-    ) -> Path:
+    ) -> list[Path]:
         """Convenience method: get + download in one call.
 
-        Returns the cache directory where files were stored.
+        Returns a sorted list of downloaded/cached file paths.
         """
         handle = self.get(archive_id)
         return handle.download(

{python_esios-2.0.0 → python_esios-2.0.1}/src/esios/processing/i90.py

@@ -8,11 +8,15 @@ from __future__ import annotations
 
 import logging
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 import numpy as np
 import pandas as pd
 import python_calamine
 
+if TYPE_CHECKING:
+    from esios.managers.archives import ArchiveHandle
+
 logger = logging.getLogger("esios")
 
 
@@ -43,26 +47,34 @@ class I90Book:
         self.path = Path(path)
         self.metadata: dict = {}
         self.table_of_contents: dict[str, str] = {}
-        self.sheets: dict[str, I90Sheet] = {}
+        self._sheets: dict[str, I90Sheet] = {}
+        self._workbook: python_calamine.CalamineWorkbook | None = None
+        self._sheet_names: list[str] = []
         self._extract_metadata_and_toc()
 
-    def _read_excel(self) -> None:
-        with open(self.path, "rb") as f:
-            self.workbook = python_calamine.CalamineWorkbook.from_filelike(f)
-        self.sheets = {
-            name: I90Sheet(name, self.workbook, self.path, self.metadata)
-            for name in self.workbook.sheet_names
-        }
+    @property
+    def sheets(self) -> dict[str, I90Sheet]:
+        """Access already-loaded sheets."""
+        return self._sheets
+
+    def _open_workbook(self) -> python_calamine.CalamineWorkbook:
+        """Open the workbook (cached after first call)."""
+        if self._workbook is None:
+            with open(self.path, "rb") as f:
+                self._workbook = python_calamine.CalamineWorkbook.from_filelike(f)
+            self._sheet_names = self._workbook.sheet_names
+        return self._workbook
 
     def _extract_metadata_and_toc(self) -> None:
         """Extract dates and table of contents from the first sheet."""
-        self._read_excel()
-        first_sheet = self.sheets[next(iter(self.sheets))]
-        rows = first_sheet.rows
+        wb = self._open_workbook()
+        first_name = self._sheet_names[0]
+        first_sheet = I90Sheet(first_name, wb, self.path, self.metadata)
+        self._sheets[first_name] = first_sheet
 
         # Dates from row 4
-        self.metadata["date_data"] = pd.to_datetime(rows[3][0])
-        self.metadata["date_publication"] = pd.to_datetime(rows[3][2])
+        self.metadata["date_data"] = pd.to_datetime(first_sheet.rows[3][0])
+        self.metadata["date_publication"] = pd.to_datetime(first_sheet.rows[3][2])
 
         # Table of contents from row 10 onwards
         df = pd.read_excel(self.path, sheet_name=0, header=None, skiprows=9, usecols="A,B", engine="calamine")
@@ -70,12 +82,13 @@ class I90Book:
         self.table_of_contents = df.set_index("sheet_name")["description"].to_dict()
 
     def get_sheet(self, sheet_name: str) -> I90Sheet:
-        """Get and preprocess a specific sheet by name."""
-        if sheet_name not in self.sheets:
-            self._read_excel()
-        sheet = self.sheets.get(sheet_name)
-        if sheet is None:
-            raise KeyError(f"Sheet '{sheet_name}' not found in {self.path.name}")
+        """Get and preprocess a specific sheet by name (lazy — only reads on demand)."""
+        if sheet_name not in self._sheets:
+            wb = self._open_workbook()
+            if sheet_name not in self._sheet_names:
+                raise KeyError(f"Sheet '{sheet_name}' not found in {self.path.name}")
+            self._sheets[sheet_name] = I90Sheet(sheet_name, wb, self.path, self.metadata)
+        sheet = self._sheets[sheet_name]
         if sheet.df is None:
             sheet.df = sheet._preprocess()
         return sheet
@@ -83,6 +96,36 @@ class I90Book:
     def __getitem__(self, sheet_name: str) -> I90Sheet:
         return self.get_sheet(sheet_name)
 
+    @classmethod
+    def from_archive(
+        cls,
+        archive: ArchiveHandle,
+        *,
+        start: str,
+        end: str,
+    ) -> list[I90Book]:
+        """Download I90 files and parse them into I90Book objects.
+
+        Calls ``archive.download()`` (cache-aware), then parses each file.
+        Files that fail to parse are logged and skipped.
+
+        Args:
+            archive: An :class:`ArchiveHandle` from ``client.archives.get(34)``.
+            start: Start date (``"YYYY-MM-DD"``).
+            end: End date (``"YYYY-MM-DD"``).
+
+        Returns:
+            A list of successfully parsed :class:`I90Book` objects, sorted by date.
+        """
+        files = archive.download(start=start, end=end)
+        books: list[I90Book] = []
+        for f in files:
+            try:
+                books.append(cls(f))
+            except Exception as e:
+                logger.warning("Failed to parse %s: %s", f.name, e)
+        return books
+
     def __repr__(self) -> str:
         return f"<I90Book {self.path.name} sheets={len(self.sheets)}>"
 
@@ -192,7 +235,7 @@ class I90Sheet:
             columns_datetime = base_date + pd.to_timedelta(time_deltas, unit="m")
             columns_datetime = pd.DatetimeIndex(columns_datetime).tz_localize(
                 "Europe/Madrid", ambiguous="infer"
-            ).tz_convert("UTC")
+            )
 
             data = pd.DataFrame(self.rows[idx + 1 :], columns=columns)
 

python_esios-2.0.0/.claude-plugin/marketplace.json

@@ -1,15 +0,0 @@
-{
-  "name": "python-esios",
-  "owner": {
-    "name": "Datons AI",
-    "email": "jesus.lopez@datons.ai"
-  },
-  "plugins": [
-    {
-      "name": "esios",
-      "source": ".",
-      "description": "Query Spanish electricity market data (ESIOS/REE) — prices, generation, demand, I90 files, and any ESIOS indicator.",
-      "version": "2.0.0"
-    }
-  ]
-}

python_esios-2.0.0/.claude-plugin/plugin.json

@@ -1,12 +0,0 @@
-{
-  "name": "esios",
-  "description": "Query Spanish electricity market data (ESIOS/REE) — prices, generation, demand, I90 files, and any ESIOS indicator.",
-  "version": "2.0.0",
-  "author": {
-    "name": "Jesús López",
-    "email": "jesus.lopez@datons.ai"
-  },
-  "repository": "https://github.com/datons/python-esios",
-  "license": "GPL-3.0-only",
-  "keywords": ["esios", "ree", "electricity", "energy", "spain", "omie"]
-}