IAEA APIpris.iaea.org ↗

"""Walkthrough: IAEA PRIS nuclear reactor data — bounded, re-runnable."""
from parse_apis.iaea_pris_power_reactor_information_system_api import (
    PRIS, ReactorNotFound
)

client = PRIS()

# List all countries with nuclear programs, take first few.
for country in client.countrysummaries.list(limit=5):
    print(country.code, country.name)

# Drill into one country's full details via the nav op.
summary = client.countrysummaries.list(limit=1).first()
detail = summary.details()
print(detail.name, detail.total_reactors, "reactors")

# Access nested typed resources on the country detail.
if detail.summary.in_operation:
    print("Operational:", detail.summary.in_operation.number_of_reactors, "reactors,",
          detail.summary.in_operation.total_reference_power_mw, "MW")

# Fetch a specific reactor by ID with typed error handling.
try:
    reactor = client.reactors.get(reactor_id="3")
    print(reactor.name, reactor.type, reactor.status)
    print("Capacity:", reactor.capacities.reference_unit_power_mw, "MW net")
    print("Grid connection:", reactor.dates.grid_connection)
    if reactor.lifetime_performance.as_of_year:
        print("Load factor:", reactor.lifetime_performance.load_factor,
              "as of", reactor.lifetime_performance.as_of_year)
except ReactorNotFound as exc:
    print(f"Reactor not found: {exc}")

# Global operational overview — singleton fetch.
ops = client.operationaloverviews.get()
print("World operational:", ops.in_operation.total_reactors, "reactors,",
      ops.in_operation.total_net_electrical_capacity_mw, "MW")

print("exercised: countrysummaries.list / details / reactors.get / operationaloverviews.get")