python-entsoe 0.5.0__py3-none-any.whl → 0.6.1__py3-none-any.whl

entsoe/.agents/skills/entsoe/SKILL.md

@@ -1,105 +1,61 @@
 ---
 name: entsoe
 description: Query European electricity market data (ENTSO-E Transparency Platform). Use when the user asks about electricity prices, load, generation, transmission, or balancing data for European countries.
-version: 1.0.0
+version: 2.0.0
 ---
 
 # ENTSO-E Data Assistant
 
-You have access to the `python-entsoe` CLI and library for querying the ENTSO-E Transparency Platform (European electricity market data).
+You have access to the `python-entsoe` library and CLI for querying the ENTSO-E Transparency Platform (European electricity market data).
 
-## CLI Reference
+## When to use what
 
-### Prices
+- **Python scripts** (default): reproducible, composable, saveable. Use for any data work the user will want to keep or iterate on.
+- **CLI**: quick one-shot lookups, exploration, sanity checks. Use when the user wants a fast answer they won't need again.
+- **If unsure**: ask the user whether they want a script or a quick CLI check.
 
-```bash
-# Day-ahead prices for one country
-entsoe prices day-ahead -s 2024-06-01 -e 2024-06-08 --country FR
-
-# Multi-country
-entsoe prices day-ahead -s 2024-06-01 -e 2024-06-08 --country FR --country ES
-```
-
-### Load
-
-```bash
-# Actual total system load
-entsoe load actual -s 2024-06-01 -e 2024-06-08 --country FR
-
-# Day-ahead load forecast
-entsoe load forecast -s 2024-06-01 -e 2024-06-08 --country FR
-```
-
-### Generation
-
-```bash
-# Actual generation per type (all types)
-entsoe generation actual -s 2024-06-01 -e 2024-06-08 --country FR
-
-# Filter by PSR type
-entsoe generation actual -s 2024-06-01 -e 2024-06-08 --country FR --psr solar --psr wind_onshore
-
-# Generation forecast (wind/solar)
-entsoe generation forecast -s 2024-06-01 -e 2024-06-08 --country FR
-
-# Installed capacity
-entsoe generation capacity -s 2024-06-01 -e 2024-06-08 --country FR
-
-# Per production unit
-entsoe generation per-plant -s 2024-06-01 -e 2024-06-08 --country FR
-```
-
-### Transmission
-
-```bash
-# Physical cross-border flows
-entsoe transmission flows -s 2024-06-01 -e 2024-06-08 --from FR --to ES
-
-# Scheduled commercial exchanges
-entsoe transmission exchanges -s 2024-06-01 -e 2024-06-08 --from FR --to ES
-
-# Net transfer capacity
-entsoe transmission capacity -s 2024-06-01 -e 2024-06-08 --from FR --to ES
-```
-
-### Balancing
+## Python Library (default)
 
-```bash
-# Imbalance prices
-entsoe balancing prices -s 2024-06-01 -e 2024-06-08 --country FR
-
-# Imbalance volumes
-entsoe balancing volumes -s 2024-06-01 -e 2024-06-08 --country FR
-```
+```python
+from entsoe import Client
 
-### Exec (ad-hoc pandas expressions)
+client = Client()  # reads config file, then ENTSOE_API_KEY env var
 
-Run any pandas expression against fetched data:
+# --- Prices ---
+df = client.prices.day_ahead("2024-06-01", "2024-06-08", country="FR")
+df = client.prices.day_ahead("2024-06-01", "2024-06-08", country=["FR", "ES"])
 
-```bash
-# Descriptive statistics on prices
-entsoe exec prices day-ahead -s 2024-06-01 -e 2024-06-08 -c FR -x "df.describe()"
+# --- Load ---
+df = client.load.actual("2024-06-01", "2024-06-08", country="FR")
+df = client.load.forecast("2024-06-01", "2024-06-08", country="FR")
 
-# Daily mean load
-entsoe exec load actual -s 2024-06-01 -e 2024-06-08 -c FR -x "df.resample('D').mean()"
+# --- Generation ---
+df = client.generation.actual("2024-06-01", "2024-06-08", country="FR")
+df = client.generation.actual("2024-06-01", "2024-06-08", country="FR", psr_type="solar")
+df = client.generation.actual("2024-06-01", "2024-06-08", country="FR", psr_type=["solar", "wind_onshore"])
+df = client.generation.forecast("2024-06-01", "2024-06-08", country="FR")
+df = client.generation.installed_capacity("2024-06-01", "2024-06-08", country="FR")
+df = client.generation.per_plant("2024-06-01", "2024-06-08", country="FR")
 
-# Generation with PSR filter
-entsoe exec generation actual -s 2024-06-01 -e 2024-06-08 -c FR --psr solar -x "df.head(20)"
+# --- Transmission ---
+df = client.transmission.crossborder_flows("2024-06-01", "2024-06-08", country_from="FR", country_to="ES")
+df = client.transmission.scheduled_exchanges("2024-06-01", "2024-06-08", country_from="FR", country_to="ES")
+df = client.transmission.net_transfer_capacity("2024-06-01", "2024-06-08", country_from="FR", country_to="ES")
 
-# Transmission analysis
-entsoe exec transmission flows -s 2024-06-01 -e 2024-06-08 --from FR --to ES -x "df.describe()"
+# --- Balancing ---
+df = client.balancing.imbalance_prices("2024-06-01", "2024-06-08", country="FR")
+df = client.balancing.imbalance_volumes("2024-06-01", "2024-06-08", country="FR")
 ```
 
-### Output formats
+### Key conventions
 
-All commands support:
-
-```bash
---format table       # Default: Rich table in terminal
---format csv         # CSV output
---format json        # JSON output
---output file.csv    # Write to file instead of stdout
-```
+- **Timezone**: All string dates are interpreted in Europe/Brussels (CET) by default
+- **Auto year-splitting**: Date ranges > 1 year are automatically split into yearly API requests
+- **Rate limiting**: ENTSO-E has a 400-request/minute limit; the library handles retries
+- **Multi-value support**: Pass lists for `country` or `psr_type` to get combined results with label columns
+- **Transmission**: Uses `country_from`/`country_to`; multi-value adds a `border` column
+- **No caching**: Data is fetched fresh on each request
+- **Custom exceptions**: `ENTSOEError`, `AuthenticationError`, `APIResponseError`, `InvalidParameterError`, `NetworkError`
 
 ## Country Codes
 
@@ -143,60 +99,78 @@ Bidding zones: `DK_1`, `DK_2`, `NO_1`–`NO_5`, `SE_1`–`SE_4`, `IT_NORTH`, `IT
 | waste | Waste | B17 |
 | other | Other | B20 |
 
-Use shorthands with `--psr` (e.g. `--psr solar --psr wind_onshore`), or ENTSO-E codes (e.g. `--psr B16`).
+Use shorthands with `psr_type=` (Python) or `--psr` (CLI), e.g. `psr_type="solar"` or `--psr solar`.
 
-## Python Library
+## CLI Reference (quick lookups)
 
-```python
-from entsoe import ENTSOEClient
+### Catalog (offline)
 
-client = ENTSOEClient()  # reads config file, then ENTSOE_API_KEY env var
+```bash
+entsoe catalog list              # All data categories and endpoints
+entsoe catalog show prices       # Detailed info for a category
+entsoe catalog countries         # Country/bidding zone codes
+entsoe catalog psr               # PSR (generation) types
+entsoe catalog borders           # Border groups and interconnections
+```
+
+### Fetch data
 
+```bash
 # Prices
-df = client.prices.day_ahead("2024-06-01", "2024-06-08", country="FR")
-df = client.prices.day_ahead("2024-06-01", "2024-06-08", country=["FR", "ES"])
+entsoe prices day-ahead -s 2024-06-01 -e 2024-06-08 -c FR
+entsoe prices day-ahead -P week -c FR,ES          # Period shorthand
 
 # Load
-df = client.load.actual("2024-06-01", "2024-06-08", country="FR")
-df = client.load.forecast("2024-06-01", "2024-06-08", country="FR")
+entsoe load actual -P month -c FR
+entsoe load forecast -s 2024-06-01 -e 2024-06-08 -c FR
 
 # Generation
-df = client.generation.actual("2024-06-01", "2024-06-08", country="FR")
-df = client.generation.actual("2024-06-01", "2024-06-08", country="FR", psr_type="solar")
-df = client.generation.actual("2024-06-01", "2024-06-08", country="FR", psr_type=["solar", "wind_onshore"])
-df = client.generation.forecast("2024-06-01", "2024-06-08", country="FR")
-df = client.generation.installed_capacity("2024-06-01", "2024-06-08", country="FR")
-df = client.generation.per_plant("2024-06-01", "2024-06-08", country="FR")
+entsoe generation actual -P week -c FR --psr solar --psr wind_onshore
+entsoe generation forecast -P week -c FR
+entsoe generation capacity -s 2024-01-01 -e 2024-12-31 -c FR
+entsoe generation per-plant -P week -c FR
 
 # Transmission
-df = client.transmission.crossborder_flows("2024-06-01", "2024-06-08", country_from="FR", country_to="ES")
-df = client.transmission.scheduled_exchanges("2024-06-01", "2024-06-08", country_from="FR", country_to="ES")
-df = client.transmission.net_transfer_capacity("2024-06-01", "2024-06-08", country_from="FR", country_to="ES")
+entsoe transmission flows -P week --from FR --to ES
+entsoe transmission exchanges -P week --border ES-*,FR-*
 
 # Balancing
-df = client.balancing.imbalance_prices("2024-06-01", "2024-06-08", country="FR")
-df = client.balancing.imbalance_volumes("2024-06-01", "2024-06-08", country="FR")
+entsoe balancing prices -P week -c FR
+entsoe balancing volumes -P week -c FR
 ```
 
-## Configuration
+### Exec (ad-hoc pandas)
+
+`exec` is a subcommand **within each namespace**:
 
 ```bash
-# Store your API key persistently (recommended)
-entsoe config set api-key YOUR_KEY
+entsoe prices exec day-ahead -P week -c FR -x "df.describe()"
+entsoe load exec actual -P 7d -c FR -x "df.resample('D').mean()"
+entsoe generation exec actual -P month -c FR --psr solar -x "df.head(20)"
+entsoe transmission exec flows -P week --from FR --to ES -x "df.describe()"
+entsoe balancing exec prices -P week -c NL -x "df.describe()"
+```
 
-# Verify it's stored
-entsoe config get api-key
+### Period shorthand (`-P`)
+
+All data commands support `-P` as an alternative to `--start`/`--end`:
+
+```
+-P today, -P yesterday, -P week, -P month, -P ytd, -P 14d
+```
+
+### Output options
+
+```
+--format table|csv|json   (default: table)
+--output file.csv         (write to file instead of stdout)
 ```
 
-The config file is stored at `~/.config/entsoe/config.toml`.
+## Configuration
 
-## Key Conventions
+```bash
+entsoe config set api-key YOUR_KEY
+entsoe config get api-key
+```
 
-- **Timezone**: All string dates are interpreted in Europe/Brussels (CET) by default
-- **Auto year-splitting**: Date ranges exceeding 1 year are automatically split into yearly API requests
-- **Rate limiting**: ENTSO-E has a 400-request/minute limit; the library handles retries
-- **Multi-value support**: Pass lists for country or psr_type to get combined results with label columns
-- **Transmission**: Uses `--from`/`--to` instead of `--country`; multi-value adds a `border` column
-- **API key resolution**: config file (`~/.config/entsoe/config.toml`) > `ENTSOE_API_KEY` env var
-- **No caching**: Data is fetched fresh on each request (unlike python-esios)
-- **Custom exceptions**: `ENTSOEError`, `AuthenticationError`, `APIResponseError`, `InvalidParameterError`, `NetworkError`
+Config file: `~/.config/entsoe/config.toml`. API key resolution: config file > `ENTSOE_API_KEY` env var.

entsoe/__init__.py

@@ -3,6 +3,7 @@
 from .client import Client, ENTSOEClient
 from .exceptions import ENTSOEError, InvalidParameterError, NoDataError, RateLimitError
 from ._mappings import COUNTRY_NAMES, PSR_CODES, country_name, psr_name
+from . import catalog
 
 __version__ = "0.4.2"
 __all__ = [
@@ -14,6 +15,7 @@ __all__ = [
     "NoDataError",
     "PSR_CODES",
     "RateLimitError",
+    "catalog",
     "country_name",
     "psr_name",
 ]

entsoe/catalog.py

@@ -0,0 +1,228 @@
+"""Built-in data catalog for ENTSO-E Transparency Platform.
+
+Provides structured metadata about available data categories, endpoints,
+country codes, PSR types, and border groups — so users don't need to
+consult external documentation every time.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass(frozen=True)
+class Endpoint:
+    """A queryable data endpoint."""
+
+    name: str
+    description: str
+    method: str  # Python client method name
+    cli: str  # CLI command
+    resolution: str  # e.g. "15min", "hourly", "daily"
+    columns: tuple[str, ...]  # key columns returned
+    units: str
+    notes: str = ""
+
+
+@dataclass(frozen=True)
+class Category:
+    """A top-level data category grouping related endpoints."""
+
+    name: str
+    description: str
+    namespace: str  # Python client namespace (e.g. "prices")
+    endpoints: tuple[Endpoint, ...]
+
+
+# ── Prices ──────────────────────────────────────────────────────────────
+
+PRICES = Category(
+    name="Prices",
+    description="Day-ahead electricity market prices",
+    namespace="prices",
+    endpoints=(
+        Endpoint(
+            name="Day-Ahead Prices",
+            description="Hourly day-ahead market clearing prices per bidding zone",
+            method="client.prices.day_ahead(start, end, country='FR')",
+            cli="entsoe prices day-ahead -s 2024-06-01 -e 2024-06-08 -c FR",
+            resolution="hourly",
+            columns=("timestamp", "country", "value", "currency", "quantity_unit"),
+            units="EUR/MWh",
+        ),
+    ),
+)
+
+# ── Load ────────────────────────────────────────────────────────────────
+
+LOAD = Category(
+    name="Load",
+    description="Actual system load and day-ahead load forecasts",
+    namespace="load",
+    endpoints=(
+        Endpoint(
+            name="Actual Total Load",
+            description="Actual total electricity consumption per control area",
+            method="client.load.actual(start, end, country='FR')",
+            cli="entsoe load actual -s 2024-06-01 -e 2024-06-08 -c FR",
+            resolution="15min or hourly (varies by country)",
+            columns=("timestamp", "country", "value", "quantity_unit"),
+            units="MW",
+        ),
+        Endpoint(
+            name="Day-Ahead Load Forecast",
+            description="Day-ahead forecast of total electricity consumption",
+            method="client.load.forecast(start, end, country='FR')",
+            cli="entsoe load forecast -s 2024-06-01 -e 2024-06-08 -c FR",
+            resolution="15min or hourly (varies by country)",
+            columns=("timestamp", "country", "value", "quantity_unit"),
+            units="MW",
+        ),
+    ),
+)
+
+# ── Generation ──────────────────────────────────────────────────────────
+
+GENERATION = Category(
+    name="Generation",
+    description="Actual generation, forecasts, installed capacity, and per-plant output",
+    namespace="generation",
+    endpoints=(
+        Endpoint(
+            name="Actual Generation per Type",
+            description="Actual electricity generation broken down by fuel/technology type (PSR)",
+            method="client.generation.actual(start, end, country='FR')",
+            cli="entsoe generation actual -s 2024-06-01 -e 2024-06-08 -c FR",
+            resolution="15min or hourly",
+            columns=("timestamp", "country", "psr_type", "value", "quantity_unit"),
+            units="MW",
+            notes="Filter by PSR type: --psr solar --psr wind_onshore",
+        ),
+        Endpoint(
+            name="Generation Forecast (Wind/Solar)",
+            description="Day-ahead forecast for wind and solar generation",
+            method="client.generation.forecast(start, end, country='FR')",
+            cli="entsoe generation forecast -s 2024-06-01 -e 2024-06-08 -c FR",
+            resolution="15min or hourly",
+            columns=("timestamp", "country", "psr_type", "value", "quantity_unit"),
+            units="MW",
+        ),
+        Endpoint(
+            name="Installed Generation Capacity",
+            description="Installed generation capacity per type (updated annually or on change)",
+            method="client.generation.installed_capacity(start, end, country='FR')",
+            cli="entsoe generation capacity -s 2024-06-01 -e 2024-06-08 -c FR",
+            resolution="yearly (point-in-time)",
+            columns=("timestamp", "country", "psr_type", "value", "quantity_unit"),
+            units="MW",
+        ),
+        Endpoint(
+            name="Actual Generation per Plant",
+            description="Generation output per individual production unit (>= 100 MW)",
+            method="client.generation.per_plant(start, end, country='FR')",
+            cli="entsoe generation per-plant -s 2024-06-01 -e 2024-06-08 -c FR",
+            resolution="15min or hourly",
+            columns=("timestamp", "country", "unit_name", "psr_type", "value", "quantity_unit"),
+            units="MW",
+        ),
+    ),
+)
+
+# ── Transmission ────────────────────────────────────────────────────────
+
+TRANSMISSION = Category(
+    name="Transmission",
+    description="Cross-border physical flows, scheduled exchanges, and transfer capacity",
+    namespace="transmission",
+    endpoints=(
+        Endpoint(
+            name="Physical Cross-Border Flows",
+            description="Actual measured electricity flows between bidding zones",
+            method="client.transmission.crossborder_flows(start, end, country_from='FR', country_to='DE_LU')",
+            cli="entsoe transmission flows -s 2024-06-01 -e 2024-06-08 --from FR --to DE_LU",
+            resolution="15min or hourly",
+            columns=("timestamp", "in_domain", "value", "quantity_unit"),
+            units="MW",
+            notes="Use --border for multi-border queries: --border FR-*, --border iberian",
+        ),
+        Endpoint(
+            name="Scheduled Commercial Exchanges",
+            description="Day-ahead scheduled commercial power exchanges between zones",
+            method="client.transmission.scheduled_exchanges(start, end, country_from='FR', country_to='ES')",
+            cli="entsoe transmission exchanges -s 2024-06-01 -e 2024-06-08 --from FR --to ES",
+            resolution="hourly",
+            columns=("timestamp", "in_domain", "value", "quantity_unit"),
+            units="MW",
+        ),
+        Endpoint(
+            name="Net Transfer Capacity",
+            description="Available transfer capacity (NTC) between bidding zones",
+            method="client.transmission.net_transfer_capacity(start, end, country_from='FR', country_to='ES')",
+            cli="entsoe transmission capacity -s 2024-06-01 -e 2024-06-08 --from FR --to ES",
+            resolution="hourly",
+            columns=("timestamp", "in_domain", "value", "quantity_unit"),
+            units="MW",
+        ),
+    ),
+)
+
+# ── Balancing ───────────────────────────────────────────────────────────
+
+BALANCING = Category(
+    name="Balancing",
+    description="System imbalance prices and volumes",
+    namespace="balancing",
+    endpoints=(
+        Endpoint(
+            name="Imbalance Prices",
+            description="System imbalance settlement prices",
+            method="client.balancing.imbalance_prices(start, end, country='FR')",
+            cli="entsoe balancing prices -s 2024-06-01 -e 2024-06-08 -c FR",
+            resolution="15min or hourly (varies by country)",
+            columns=("timestamp", "country", "value", "quantity_unit"),
+            units="EUR/MWh",
+        ),
+        Endpoint(
+            name="Imbalance Volumes",
+            description="Net system imbalance volumes",
+            method="client.balancing.imbalance_volumes(start, end, country='FR')",
+            cli="entsoe balancing volumes -s 2024-06-01 -e 2024-06-08 -c FR",
+            resolution="15min or hourly (varies by country)",
+            columns=("timestamp", "country", "value", "quantity_unit"),
+            units="MW",
+        ),
+    ),
+)
+
+# ── Full catalog ────────────────────────────────────────────────────────
+
+CATEGORIES: dict[str, Category] = {
+    "prices": PRICES,
+    "load": LOAD,
+    "generation": GENERATION,
+    "transmission": TRANSMISSION,
+    "balancing": BALANCING,
+}
+
+
+def get_category(name: str) -> Category:
+    """Look up a category by name (case-insensitive)."""
+    key = name.lower().strip()
+    if key not in CATEGORIES:
+        raise KeyError(
+            f"Unknown category '{name}'. Available: {', '.join(CATEGORIES.keys())}"
+        )
+    return CATEGORIES[key]
+
+
+def summary() -> str:
+    """Return a human-readable summary of all available data."""
+    lines = ["ENTSO-E Data Catalog", "=" * 50, ""]
+    for key, cat in CATEGORIES.items():
+        lines.append(f"{cat.name} ({cat.namespace})")
+        lines.append(f"  {cat.description}")
+        for ep in cat.endpoints:
+            lines.append(f"    - {ep.name}: {ep.description}")
+            lines.append(f"      Resolution: {ep.resolution} | Units: {ep.units}")
+        lines.append("")
+    return "\n".join(lines)

entsoe/cli/app.py

@@ -38,6 +38,7 @@ from entsoe.cli.transmission import transmission_app  # noqa: E402
 from entsoe.cli.balancing import balancing_app  # noqa: E402
 from entsoe.cli.config_cmd import config_app  # noqa: E402
 from entsoe.cli.cache_cmd import cache_app  # noqa: E402
+from entsoe.cli.catalog_cmd import catalog_app  # noqa: E402
 
 app.add_typer(prices_app, name="prices", help="Day-ahead electricity prices")
 app.add_typer(load_app, name="load", help="Actual load and load forecasts")
@@ -46,6 +47,7 @@ app.add_typer(transmission_app, name="transmission", help="Cross-border flows an
 app.add_typer(balancing_app, name="balancing", help="Imbalance prices and volumes")
 app.add_typer(config_app, name="config", help="Configuration management")
 app.add_typer(cache_app, name="cache", help="Cache management (status, clear)")
+app.add_typer(catalog_app, name="catalog", help="Browse available data, countries, PSR types, and borders")
 
 
 def main() -> None:

entsoe/cli/catalog_cmd.py

@@ -0,0 +1,148 @@
+"""CLI command: browse the built-in data catalog."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from entsoe._mappings import AREA_CODES, COUNTRY_NAMES, PSR_CODES, PSR_TYPES, BORDER_GROUPS, NEIGHBOURS
+
+catalog_app = typer.Typer(no_args_is_help=True)
+console = Console()
+
+
+@catalog_app.command("list")
+def catalog_list():
+    """List all available data categories and endpoints."""
+    from entsoe.catalog import CATEGORIES
+
+    for key, cat in CATEGORIES.items():
+        console.print(f"\n[bold]{cat.name}[/bold] — {cat.description}")
+        console.print(f"  Python: client.{cat.namespace}.*")
+        console.print(f"  CLI:    entsoe {key} <command>")
+
+        table = Table(show_header=True, padding=(0, 1))
+        table.add_column("Endpoint", style="cyan")
+        table.add_column("CLI Command", style="green")
+        table.add_column("Resolution")
+        table.add_column("Units")
+
+        for ep in cat.endpoints:
+            cli_short = ep.cli.split("entsoe ")[-1].split(" -")[0]
+            table.add_row(ep.name, cli_short, ep.resolution, ep.units)
+
+        console.print(table)
+
+
+@catalog_app.command("countries")
+def catalog_countries(
+    query: Optional[str] = typer.Argument(None, help="Filter by country name or code"),
+):
+    """List available country and bidding zone codes."""
+    table = Table(title="Country / Bidding Zone Codes", show_header=True, padding=(0, 1))
+    table.add_column("Code", style="cyan")
+    table.add_column("Name")
+    table.add_column("Neighbours", style="dim")
+
+    for code in sorted(AREA_CODES.keys()):
+        name = COUNTRY_NAMES.get(code, "")
+        if query:
+            q = query.lower()
+            if q not in code.lower() and q not in name.lower():
+                continue
+        neighbours = ", ".join(sorted(NEIGHBOURS.get(code, set())))
+        table.add_row(code, name, neighbours)
+
+    console.print(table)
+
+
+@catalog_app.command("psr")
+def catalog_psr():
+    """List available PSR (generation) types."""
+    table = Table(title="PSR Types (Generation)", show_header=True, padding=(0, 1))
+    table.add_column("Shorthand", style="cyan")
+    table.add_column("ENTSO-E Code", style="green")
+    table.add_column("Full Name")
+
+    for shorthand, code in sorted(PSR_CODES.items()):
+        full_name = PSR_TYPES.get(code, "")
+        table.add_row(shorthand, code, full_name)
+
+    console.print(table)
+
+
+@catalog_app.command("borders")
+def catalog_borders(
+    country: Optional[str] = typer.Argument(None, help="Show borders for a specific country (e.g. FR, DE_LU)"),
+):
+    """List border groups and interconnections."""
+    if country:
+        code = country.upper().strip()
+        if code not in NEIGHBOURS:
+            console.print(f"[red]Unknown country '{country}'[/red]. Use 'entsoe catalog countries' to list.")
+            raise typer.Exit(1)
+
+        name = COUNTRY_NAMES.get(code, code)
+        console.print(f"\n[bold]{name} ({code})[/bold] — {len(NEIGHBOURS[code])} interconnections:")
+
+        table = Table(show_header=True, padding=(0, 1))
+        table.add_column("Neighbour", style="cyan")
+        table.add_column("Name")
+        table.add_column("CLI (flows)")
+
+        for n in sorted(NEIGHBOURS[code]):
+            n_name = COUNTRY_NAMES.get(n, n)
+            table.add_row(n, n_name, f"entsoe transmission flows --from {code} --to {n}")
+
+        console.print(table)
+        console.print(f"\n[dim]Shortcut: entsoe transmission flows --border {code}-*[/dim]")
+    else:
+        # Show named border groups
+        console.print("\n[bold]Named Border Groups[/bold]")
+        table = Table(show_header=True, padding=(0, 1))
+        table.add_column("Group", style="cyan")
+        table.add_column("Borders")
+
+        for group_name, pairs in sorted(BORDER_GROUPS.items()):
+            unique = set()
+            for a, b in pairs:
+                key = tuple(sorted([a, b]))
+                unique.add(key)
+            border_strs = [f"{a}-{b}" for a, b in sorted(unique)]
+            table.add_row(group_name, ", ".join(border_strs[:8]) + ("..." if len(border_strs) > 8 else ""))
+
+        console.print(table)
+        console.print(f"\n[dim]Use 'entsoe catalog borders <COUNTRY>' for a specific country.[/dim]")
+
+
+@catalog_app.command("show")
+def catalog_show(
+    category: str = typer.Argument(..., help="Category name: prices, load, generation, transmission, balancing"),
+):
+    """Show detailed info for a specific data category."""
+    from entsoe.catalog import get_category
+
+    try:
+        cat = get_category(category)
+    except KeyError as e:
+        console.print(f"[red]{e}[/red]")
+        raise typer.Exit(1)
+
+    console.print(f"\n[bold]{cat.name}[/bold] — {cat.description}")
+    console.print(f"  Python namespace: client.{cat.namespace}")
+    console.print()
+
+    for ep in cat.endpoints:
+        console.print(f"  [cyan]{ep.name}[/cyan]")
+        console.print(f"    {ep.description}")
+        console.print(f"    Resolution: {ep.resolution}")
+        console.print(f"    Units: {ep.units}")
+        console.print(f"    Columns: {', '.join(ep.columns)}")
+        console.print(f"    Python: {ep.method}")
+        console.print(f"    CLI:    {ep.cli}")
+        if ep.notes:
+            console.print(f"    Notes:  {ep.notes}")
+        console.print()

{python_entsoe-0.5.0.dist-info → python_entsoe-0.6.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-entsoe
-Version: 0.5.0
+Version: 0.6.1
 Summary: Python client for the ENTSO-E Transparency Platform API
 Project-URL: Homepage, https://github.com/datons/python-entsoe
 Project-URL: Repository, https://github.com/datons/python-entsoe

{python_entsoe-0.5.0.dist-info → python_entsoe-0.6.1.dist-info}/RECORD

@@ -1,18 +1,20 @@
-entsoe/__init__.py,sha256=PlcCfCffCH2nWK7EctaFPdGo5dRbHig4zkfWa-KfBj4,492
+entsoe/__init__.py,sha256=9qzvMUzoD-CRfX1vTzWIBfpXBMdJ2MgRwJEgQQsw1fA,529
 entsoe/_http.py,sha256=XhZZy059XHh8uAP2Vsm1e7BfRwQcmGLEYdREcgaF3Tk,6608
 entsoe/_mappings.py,sha256=6-IKLtwChvM7_YG90oSRDxo3IfQUuz3Gnv17TmQgPjM,15534
 entsoe/_xml.py,sha256=222kgi8lStU0qQIU-oxiciO2WtplqKySi6qBZXbyiEc,6393
 entsoe/cache.py,sha256=rRkuQPGYg05Uo3xFW7gVltNE56M-1_E5mdEvgLoWhpM,13356
+entsoe/catalog.py,sha256=FUPg_WqLBkfl5sUgT9m8Bua7IP10NvBsakcndpUOBa0,9733
 entsoe/client.py,sha256=zHB9y2TbCRjSNe9d5c9XVt_BNZ7b8KsvJDORc5V-ypE,3542
 entsoe/exceptions.py,sha256=vqeu6_LxAtDvJziPnjbH52KV0fm63F8n2Y1lzSNp2Bs,1017
 entsoe/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-entsoe/.agents/skills/entsoe/SKILL.md,sha256=rdLGQqjuLyD-BwjLFR33erG-iO4D4tM46JOZzSi8z2Y,6717
+entsoe/.agents/skills/entsoe/SKILL.md,sha256=JsFECSkfnxyR6iFx55WBBcMJjAOaMu84vhcsPsTVWC0,6452
 entsoe/cli/__init__.py,sha256=qUGXx4zdi8dCQkq3PPPa1sgD3Q6KIhJwWeBfTub4suM,139
 entsoe/cli/_output.py,sha256=aV_3CLmOHSxTAVuYdccTWYahqTNPunCbSeoq3YZL-4A,2943
 entsoe/cli/_resolve.py,sha256=vqsJJSBCht06HlToKW47ATrQesCl2Uy851KRVjE1kFk,4737
-entsoe/cli/app.py,sha256=Hrlw97yveSJr52Z_hUZ0awMeOni95Vgefh4CtG6QJbM,1900
+entsoe/cli/app.py,sha256=_dQsejLncSFJTgOy-26Bvl7pIMXve_YD3gxP-gRVsG4,2069
 entsoe/cli/balancing.py,sha256=ZXcjTEdbx00MUL4L6116G7MwBfpffB02DgazYexq-dc,2752
 entsoe/cli/cache_cmd.py,sha256=ozbQ5apxeLBIjbPsH-Cs5rDOVBVfrzJfDPKv1anLFgY,2255
+entsoe/cli/catalog_cmd.py,sha256=TzkkecSlnlz-f2_BlRqidKN6uTJtSInR0np4BA1rQ5c,5361
 entsoe/cli/config.py,sha256=YB6IeOBGMKahcVJBGUaCN5r1vs6YILv_XbXlcKLxLiU,1663
 entsoe/cli/config_cmd.py,sha256=HfpMMv8S1kDUIid6kxX-cNirCvhDby2lSPNSD8o3qX8,923
 entsoe/cli/exec_cmd.py,sha256=KiGwOTIjYQQPEg7v51oRbpk3Cj9-7hDDCbEYXfZ_lfQ,11308
@@ -27,7 +29,7 @@ entsoe/namespaces/generation.py,sha256=V4DkvV5ai7aWYYSdZKwWyxTEv1ed4nCCq7DYyVwvc
 entsoe/namespaces/load.py,sha256=fbkwKWZifb8DOf5Rc_7c4_eFAXiqT_562r9WTMQwsuo,2160
 entsoe/namespaces/prices.py,sha256=5-hVmpxytyxPKx0eBRN7mjKDhfPUK0ZZi1nnF5zOE9A,1295
 entsoe/namespaces/transmission.py,sha256=V8zrs2CQXf1WPjJRqz7wc-ztnkfriIKXPLfYHBDJD9M,8067
-python_entsoe-0.5.0.dist-info/METADATA,sha256=wqm7PMTOHh-DdtMYKJYMF96eMS8jlrnC9E0krpECs4c,8612
-python_entsoe-0.5.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-python_entsoe-0.5.0.dist-info/entry_points.txt,sha256=tYyCheggCsGRKOq2vIjpAxBksEM7K_iGI6vHkkQLmYg,42
-python_entsoe-0.5.0.dist-info/RECORD,,
+python_entsoe-0.6.1.dist-info/METADATA,sha256=YTJB_o6J02O8cxj5izGnykIZ8uZk-SrXdkasOyze2Qo,8612
+python_entsoe-0.6.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+python_entsoe-0.6.1.dist-info/entry_points.txt,sha256=tYyCheggCsGRKOq2vIjpAxBksEM7K_iGI6vHkkQLmYg,42
+python_entsoe-0.6.1.dist-info/RECORD,,