aboutsummaryrefslogtreecommitdiff
path: root/tests/test_template_filters.py
diff options
context:
space:
mode:
authorDennis Fink2026-11-18 19:18:18 +0100
committerDennis Fink2026-11-18 19:18:18 +0100
commitbeb0131b089293512c2dab2243b9b2ff314e2387 (patch)
tree2690eaa17c689a77bccdc1268e971a96ec0e368f /tests/test_template_filters.py
parente3e195ea07fd57288d32c842689ebed7fba636f0 (diff)
downloadwebmentions-ssg-beb0131b089293512c2dab2243b9b2ff314e2387.tar.gz
webmentions-ssg-beb0131b089293512c2dab2243b9b2ff314e2387.zip
feat(core): show relative timestamps
Add reusable UTC template filters backed by `humanize` so timestamps render as relative ages while preserving machine-readable `<time datetime>` values. Keep exact UTC timestamps available in tooltips across dashboard, received, sent, detail, and public status views.
Diffstat (limited to 'tests/test_template_filters.py')
-rw-r--r--tests/test_template_filters.py42
1 files changed, 42 insertions, 0 deletions
diff --git a/tests/test_template_filters.py b/tests/test_template_filters.py
new file mode 100644
index 0000000..a2a0a87
--- /dev/null
+++ b/tests/test_template_filters.py
@@ -0,0 +1,42 @@
+# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me>
+#
+# 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(
+ '<time datetime="{{ when | utc_isoformat }}" '
+ 'title="{{ when | utc_timestamp }}">{{ when | relative_time }}</time>'
+ )
+
+ 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</time>" in rendered