Skip to content

Enterprise agent platform for building, deploying, and operating AI teammates.

5.1 KB
Raw Blame
from __future__ import annotations

import pytest

from xagent.core.utils.timezones import RAILS_ZONE_NAMES, resolve_zone


def _key(name: object) -> str | None:
    zone = resolve_zone(name)  # type: ignore[arg-type]
    return zone.key if zone is not None else None


@pytest.mark.parametrize(
    ("supplied", "expected"),
    [
        ("Australia/Melbourne", "Australia/Melbourne"),
        ("australia/melbourne", "Australia/Melbourne"),
        ("  America/New_York\t", "America/New_York"),
        ("UTC", "UTC"),
        ("utc", "UTC"),
        ("EST", "EST"),
        ("us/eastern", "US/Eastern"),
        ("Etc/GMT+10", "Etc/GMT+10"),
        # Not matched as bare cities (see below), but exact names all the same.
        ("Australia/Victoria", "Australia/Victoria"),
        ("america/argentina/san_juan", "America/Argentina/San_Juan"),
    ],
)
def test_canonical_names_resolve_to_their_canonical_key(
    supplied: str, expected: str
) -> None:
    assert _key(supplied) == expected


@pytest.mark.parametrize(
    ("supplied", "expected"),
    [
        ("Wellington", "Pacific/Auckland"),
        ("Pacific Time (US & Canada)", "America/Los_Angeles"),
        ("Canberra", "Australia/Canberra"),
        ("Melbourne", "Australia/Melbourne"),
        ("Sydney", "Australia/Sydney"),
        ("Cape Verde Is.", "Atlantic/Cape_Verde"),
        ("Nuku'alofa", "Pacific/Tongatapu"),
        ("pacific time (us & canada)", "America/Los_Angeles"),
        ("  Pacific   Time (US & Canada) ", "America/Los_Angeles"),
        ("WELLINGTON", "Pacific/Auckland"),
    ],
)
def test_rails_zone_names_resolve_to_their_iana_zone(
    supplied: str, expected: str
) -> None:
    assert _key(supplied) == expected


@pytest.mark.parametrize(
    ("supplied", "expected"),
    [
        ("Toronto", "America/Toronto"),
        ("toronto", "America/Toronto"),
        (" Vancouver ", "America/Vancouver"),
        ("Los_Angeles", "America/Los_Angeles"),
        ("los angeles", "America/Los_Angeles"),
        ("Port   of Spain", "America/Port_of_Spain"),
    ],
)
def test_a_city_ending_only_a_two_segment_zone_resolves_to_it(
    supplied: str, expected: str
) -> None:
    assert _key(supplied) == expected


def test_a_canonical_name_wins_over_a_rails_name() -> None:
    # Both are Rails keys too ("UTC" -> Etc/UTC, "Singapore" -> Asia/Singapore),
    # but an exact IANA name is taken as the caller wrote it.
    assert _key("UTC") == "UTC"
    assert _key("Singapore") == "Singapore"


def test_a_rails_name_wins_over_an_ambiguous_city() -> None:
    # As a bare city both are ambiguous (two zones each end in the same name),
    # but the Rails table names one zone for them.
    assert _key("Buenos Aires") == "America/Argentina/Buenos_Aires"
    assert _key("Istanbul") == "Europe/Istanbul"


@pytest.mark.parametrize(
    "supplied",
    [
        "Indianapolis",  # America/Indianapolis, America/Indiana/Indianapolis
        "Buenos_Aires",  # America/Buenos_Aires, America/Argentina/Buenos_Aires
        "Nicosia",  # Asia/Nicosia, Europe/Nicosia
    ],
)
def test_an_ambiguous_city_stays_unresolved(supplied: str) -> None:
    assert _key(supplied) is None


@pytest.mark.parametrize(
    "supplied",
    [
        "East",  # only Brazil/East ends in it
        "General",  # only Mexico/General ends in it
        "Eastern",
    ],
)
def test_a_legacy_country_zone_suffix_is_not_a_city(supplied: str) -> None:
    assert _key(supplied) is None


@pytest.mark.parametrize(
    "supplied",
    [
        "ACT",
        "LHI",
        "NSW",
        "North",
        "Queensland",
        "South",
        "Tasmania",
        "Victoria",  # also Victoria, BC
        "West",
        "Yancowinna",
    ],
)
def test_an_australian_legacy_region_name_is_not_a_city(supplied: str) -> None:
    # Each is the last segment of exactly one zone under a city area
    # (Australia/Victoria, ...), but names a state, territory, island, county
    # or direction.
    assert _key(supplied) is None


@pytest.mark.parametrize(
    "supplied",
    [
        "San Juan",  # America/Argentina/San_Juan; also San Juan, Puerto Rico
        "Petersburg",  # America/Indiana/Petersburg
        "Center",  # America/North_Dakota/Center
        "Salta",  # America/Argentina/Salta, its only zone
    ],
)
def test_a_city_ending_only_a_three_segment_zone_stays_unresolved(
    supplied: str,
) -> None:
    assert _key(supplied) is None


@pytest.mark.parametrize(
    "supplied",
    [
        "Not/AZone",
        "Gotham",
        "",
        "   ",
        None,
        42,
        "A" * 5000,
        "/etc/passwd",
        "../../../etc/passwd",
        "Australia/../../etc/hosts",
        "Melbourne\x00",
        "Australia/Melbourne\x00",
    ],
)
def test_an_unknown_name_stays_unresolved(supplied: object) -> None:
    assert _key(supplied) is None


@pytest.mark.parametrize(
    ("alias", "zone"),
    [
        (alias, zone)
        for alias, zone in sorted(RAILS_ZONE_NAMES.items())
        # Exact IANA names of their own, resolved before the table (see above).
        if alias not in ("UTC", "Singapore")
    ],
)
def test_every_rails_name_resolves_to_its_mapped_zone(alias: str, zone: str) -> None:
    assert _key(alias) == zone