feat: rename esios_data module to esios for cleaner API

client.esios_data → client.esios

Author: jsulopzs

CLAUDE.md

@@ -5,7 +5,7 @@ Python client for Datons data APIs (`pip install datons`).
 ## Structure
 
 - `src/datons/client.py` — Central `Client` with shared auth and HTTP
-- `src/datons/esios_data/` — ESIOS preprocessed data manager (first product)
+- `src/datons/esios/` — ESIOS preprocessed data manager (first product)
 - Future products go in `src/datons/<product_name>/`
 
 ## Running tests

README.md

@@ -16,18 +16,18 @@ from datons import Client
 client = Client(token="esd_live_...")
 
 # Query preprocessed I90 market data
-df = client.esios_data.query(
+df = client.esios.query(
     "SELECT unit, datetime, energy, price "
     "FROM operational_data_15min "
     "WHERE program = 'PDBF' AND date >= '2025-01-01' "
     "LIMIT 100"
 )
 
 # Dataset metadata (schema, programs, stats)
-meta = client.esios_data.metadata()
+meta = client.esios.metadata()
 
 # Search for units, companies, technologies
-results = client.esios_data.search("iberdrola")
+results = client.esios.search("iberdrola")
 ```
 
 ## Authentication

src/datons/client.py

@@ -24,12 +24,12 @@ class Client:
         from datons import Client
 
         client = Client(token="esd_live_...")
-        df = client.esios_data.query("SELECT unit, energy FROM operational_data_15min WHERE program='PDBF' LIMIT 10")
+        df = client.esios.query("SELECT unit, energy FROM operational_data_15min WHERE program='PDBF' LIMIT 10")
 
     Or with context manager::
 
         with Client(token="esd_live_...") as client:
-            df = client.esios_data.query("SELECT ...")
+            df = client.esios.query("SELECT ...")
     """
 
     def __init__(
@@ -58,16 +58,16 @@ def __init__(
         )
 
         # Lazy-initialized managers
-        self._esios_data: Any = None
+        self._esios: Any = None
 
     @property
-    def esios_data(self):
+    def esios(self):
         """Access ESIOS preprocessed data (I90, market programs)."""
-        if self._esios_data is None:
-            from datons.esios_data.manager import EsiosDataManager
+        if self._esios is None:
+            from datons.esios.manager import EsiosDataManager
 
-            self._esios_data = EsiosDataManager(self)
-        return self._esios_data
+            self._esios = EsiosDataManager(self)
+        return self._esios
 
     # -- HTTP primitives (used by managers) ------------------------------------
 

src/datons/esios_data/__init__.py src/datons/esios/__init__.pysrc/datons/esios_data/__init__.py renamed to src/datons/esios/__init__.py

@@ -1,7 +1,7 @@
 """ESIOS Data — preprocessed Spanish electricity market data from ClickHouse."""
 
-from datons.esios_data.manager import EsiosDataManager
-from datons.esios_data.models import (
+from datons.esios.manager import EsiosDataManager
+from datons.esios.models import (
     ColumnInfo,
     DimensionResult,
     MetadataResult,

src/datons/esios_data/manager.py src/datons/esios/manager.pysrc/datons/esios_data/manager.py renamed to src/datons/esios/manager.py

@@ -13,7 +13,7 @@
 
 import pandas as pd
 
-from datons.esios_data.models import (
+from datons.esios.models import (
     DimensionResult,
     MetadataResult,
     QueryResult,
@@ -36,19 +36,19 @@ class EsiosDataManager:
         client = Client(token="esd_live_...")
 
         # SQL query → DataFrame
-        df = client.esios_data.query(
+        df = client.esios.query(
             "SELECT unit, datetime, energy FROM operational_data_15min "
             "WHERE program='PDBF' AND date >= '2025-01-01' LIMIT 100"
         )
 
         # Metadata (schema, programs, stats)
-        meta = client.esios_data.metadata()
+        meta = client.esios.metadata()
 
         # Search for dimension values
-        results = client.esios_data.search("iberdrola")
+        results = client.esios.search("iberdrola")
 
         # Dimension lookup
-        techs = client.esios_data.dimensions("technology")
+        techs = client.esios.dimensions("technology")
     """
 
     def __init__(self, client: Client):
@@ -125,9 +125,9 @@ def search(
 
         Examples::
 
-            client.esios_data.search("iber")      # → Iberdrola units/companies
-            client.esios_data.search("ciclo")      # → Ciclo Combinado technology
-            client.esios_data.search("CTGN")       # → unit codes CTGN1, CTGN2...
+            client.esios.search("iber")      # → Iberdrola units/companies
+            client.esios.search("ciclo")      # → Ciclo Combinado technology
+            client.esios.search("CTGN")       # → unit codes CTGN1, CTGN2...
         """
         params: dict = {"q": q}
         if column:

src/datons/esios_data/models.py src/datons/esios/models.pysrc/datons/esios_data/models.py renamed to src/datons/esios/models.py

@@ -31,10 +31,10 @@ def test_client_context_manager():
         assert client.token == "esd_test_abc123"
 
 
-def test_esios_data_manager_lazy_init():
+def test_esios_manager_lazy_init():
     """EsiosDataManager is lazily initialized on first access."""
     client = Client(token="esd_test_abc123")
-    assert client._esios_data is None
-    _ = client.esios_data
-    assert client._esios_data is not None
+    assert client._esios is None
+    _ = client.esios
+    assert client._esios is not None
     client.close()