# SPDX-FileCopyrightText: 2026 Dennis Fink # # SPDX-License-Identifier: BSD-3-Clause """Verify relative timestamps and explicit UTC timezone formatting.""" from datetime import UTC, datetime, timedelta, timezone from flask import Flask from webmentions_ssg.template_filters import relative_time, utc_isoformat, utc_timestamp def test_utc_timestamp_normalizes_naive_and_offset_aware_values() -> None: expected = "2026-11-16 08:14:03 UTC" iso_expected = "2026-11-16T08:14:03+00:00" naive = datetime(2026, 11, 16, 8, 14, 3) aware = datetime(2026, 11, 16, 10, 14, 3, tzinfo=timezone(timedelta(hours=2))) for value in (naive, aware): assert utc_isoformat(value) == iso_expected assert utc_timestamp(value) == expected def test_relative_time_humanizes_both_aware_and_naive_utc_values() -> None: three_minutes_ago = datetime.now(UTC) - timedelta(minutes=3, seconds=5) assert relative_time(three_minutes_ago) == "3 minutes ago" assert relative_time(three_minutes_ago.replace(tzinfo=None)) == "3 minutes ago" def test_template_timestamp_is_relative_with_full_utc_tooltip(app: Flask) -> None: when = datetime.now(UTC) - timedelta(minutes=3, seconds=5) template = app.jinja_env.from_string( '' ) rendered = template.render(when=when) assert f'datetime="{when.isoformat()}"' in rendered assert f'title="{when.strftime("%Y-%m-%d %H:%M:%S UTC")}"' in rendered assert ">3 minutes ago" in rendered