energy_data_retrieval.wind_catalogue.boe#

Offline BOE discovery and reviewed notice staging with technology boundaries.

The index adapter selects every Series A notice mentioning wind; it never reads MW or a lifecycle from the title. Reviewed facts require checksummed originals.

energy_data_retrieval.wind_catalogue.boe.select_wind_notices(html, *, series='A')[source]#

Select Series A wind mentions, including solar hybrids and auxiliaries.

Series B announcements require explicit series="B" selection. A selected title is a review candidate, never an automatic project record.

Parameters:
  • html (str)

  • series (str)

Return type:

list[dict[str, str]]

energy_data_retrieval.wind_catalogue.boe.issue_urls(html, daily_url)[source]#

Discover same-day extra issues; callers must fetch every returned URL.

A default daily index may show only the extraordinary issue. Discovery cannot establish completeness of content that has not yet been fetched.

Parameters:
  • html (str)

  • daily_url (str)

Return type:

list[str]

energy_data_retrieval.wind_catalogue.boe.review_daily_indexes(daily_url, originals)[source]#

Replay all discovered issues before declaring a daily title scan complete.

Missing extra issues fail closed, including when the default issue contains no wind titles. Aliased issues may repeat a notice; conflicting titles fail. This is title-discovery completeness, not an inventory of every wind project.

Parameters:
  • daily_url (str)

  • originals (dict[str, bytes])

Return type:

dict[str, Any]

energy_data_retrieval.wind_catalogue.boe.stage_boe_notices(reviews, originals, existing, *, expected_ids, now)[source]#

Stage a complete reviewed partition; keep procedural and plant scopes apart.

All new records remain excluded from capacity sums until farm boundaries are independently reconciled. Existing names require explicit reconciliation.

Parameters:
  • reviews (list[dict[str, Any]])

  • originals (dict[str, bytes])

  • existing (list[dict[str, Any]])

  • expected_ids (list[str])

  • now (str)

Return type:

tuple[list[dict[str, Any]], list[dict[str, Any]]]