US Independence Day Countdown

A simple utility that displays United States information and calculates the number of days until the next Independence Day celebration.

Capabilities

Display US metadata

• Displays the full name "United States of America" @test
• Displays the two-letter abbreviation "US" @test
• Correctly identifies the birthday as July 4, 1776 @test

Calculate days to next Independence Day

• Calculates the correct number of days from a given date to the next July 4th @test
• Returns 0 when the given date is July 4th @test
• Correctly handles leap years in calculation @test
• Counts to the next year's July 4th if the current date is after July 4th @test

Implementation

@generates

API

def get_us_info():
    """
    Returns a dictionary containing US metadata.

    Returns:
        dict: A dictionary with keys 'name', 'abbreviation', and 'birthday'
              where birthday is a date object representing July 4, 1776.
    """
    pass

def days_until_independence_day(from_date):
    """
    Calculates the number of days from the given date until the next Independence Day.

    Args:
        from_date: A date object representing the starting date.

    Returns:
        int: The number of days until the next July 4th (0 if the date is July 4th).
    """
    pass

Dependencies { .dependencies }

us { .dependency }

Provides United States metadata including the country's name, abbreviation, and founding date.

@satisfied-by