State Information Reporter

A utility to generate formatted reports about US states using their basic metadata.

Capabilities

Generate state information report

• Given a state identifier (abbreviation, name, or FIPS code), generate a formatted report containing the state's capital city and statehood year @test
• The report should be a string in the format: "{State Name}: Capital is {Capital}, became a state in {Year}" @test
• If the state is a territory without a statehood year, the report should say "not a state" instead of the year @test

Handle multiple states

• Generate a summary report for multiple states given a list of state identifiers @test
• The summary should include one line per state with their capital and statehood information @test

Find oldest states

• Given a list of state identifiers, identify which state became a state first (earliest statehood year) @test
• Return the state name and its statehood year @test
• Exclude territories from the comparison @test

Implementation

@generates

API

def generate_state_report(state_identifier: str) -> str:
    """
    Generate a formatted report for a single state.

    Args:
        state_identifier: State abbreviation, name, or FIPS code

    Returns:
        A formatted string with state name, capital, and statehood year
    """
    pass

def generate_summary_report(state_identifiers: list) -> str:
    """
    Generate a multi-line summary report for multiple states.

    Args:
        state_identifiers: List of state abbreviations, names, or FIPS codes

    Returns:
        A multi-line string with one report per state
    """
    pass

def find_oldest_state(state_identifiers: list) -> tuple:
    """
    Find the oldest state from a list of identifiers.

    Args:
        state_identifiers: List of state abbreviations, names, or FIPS codes

    Returns:
        A tuple of (state_name, statehood_year) for the oldest state
    """
    pass

Dependencies { .dependencies }

us { .dependency }

Provides US state and territory metadata including capital cities and statehood years.