& characters",
+ ]
+
+
+@pytest.mark.parametrize("element_name", ["title", "id", "updated"])
+def test_atom_entries_contain_required_metadata(
+ atom_entries: list[ET.Element],
+ element_name: str,
+) -> None:
+ for entry in atom_entries:
+ elements = entry.findall(f"{ATOM}{element_name}")
+
+ assert len(elements) == 1
+ assert elements[0].text
+
+
+def test_atom_entry_ids_are_canonical_urls(
+ atom_entries: list[ET.Element],
+) -> None:
+ ids = [entry.findtext(f"{ATOM}id") for entry in atom_entries]
+
+ assert ids == [
+ "https://example.org/posts/newer/",
+ "https://example.org/posts/older/",
+ ]
+
+
+def test_atom_entry_dates(atom_entries: list[ET.Element]) -> None:
+ assert [entry.findtext(f"{ATOM}published") for entry in atom_entries] == [
+ "2026-01-03T11:00:00Z",
+ "2026-01-01T10:00:00Z",
+ ]
+
+ assert [entry.findtext(f"{ATOM}updated") for entry in atom_entries] == [
+ "2026-01-03T11:00:00Z",
+ "2026-01-05T12:00:00Z",
+ ]
+
+
+def test_atom_entries_have_alternate_html_links(
+ atom_entries: list[ET.Element],
+) -> None:
+ expected_urls = [
+ "https://example.org/posts/newer/",
+ "https://example.org/posts/older/",
+ ]
+
+ for entry, expected_url in zip(
+ atom_entries,
+ expected_urls,
+ strict=True,
+ ):
+ links = [
+ link
+ for link in entry.findall(f"{ATOM}link")
+ if link.get("rel") == "alternate"
+ ]
+
+ assert len(links) == 1
+ assert links[0].get("href") == expected_url
+ assert links[0].get("type") == "text/html"
+
+
+def test_atom_entries_contain_html_content(
+ atom_entries: list[ET.Element],
+) -> None:
+ for entry in atom_entries:
+ contents = entry.findall(f"{ATOM}content")
+
+ assert len(contents) == 1
+ assert contents[0].get("type") == "html"
+ assert contents[0].text
+
+
+def test_atom_entry_content_is_encoded_html(
+ atom_entries: list[ET.Element],
+) -> None:
+ for entry in atom_entries:
+ content = entry.find(f"{ATOM}content")
+
+ assert content is not None
+ assert len(content) == 0
+ assert "" in (content.text or "")
+
+
+def test_atom_entry_content_preserves_html(
+ atom_entries: list[ET.Element],
+) -> None:
+ content = atom_entries[1].findtext(f"{ATOM}content")
+
+ assert content is not None
+ assert "
" in content
+ assert "
" in content
+
+
+def entry_by_title(
+ atom_entries: list[ET.Element],
+ title: str,
+) -> ET.Element:
+ matches = [
+ entry for entry in atom_entries if entry.findtext(f"{ATOM}title") == title
+ ]
+
+ assert len(matches) == 1
+ return matches[0]
+
+
+def test_atom_entry_categories(
+ atom_entries: list[ET.Element],
+) -> None:
+ entry = entry_by_title(atom_entries, "Newer post")
+
+ categories = entry.findall(f"{ATOM}category")
+
+ assert [
+ (
+ category.get("term"),
+ category.get("scheme"),
+ category.get("label"),
+ )
+ for category in categories
+ ] == [
+ (
+ "Python",
+ "https://example.org/tags/",
+ "Python",
+ ),
+ (
+ "Scientific Computing",
+ "https://example.org/tags/",
+ "Scientific Computing",
+ ),
+ ]
+
+
+@pytest.fixture(scope="module")
+def posts_atom_feed(built_site: Path) -> ET.Element:
+ atom_path = built_site / "posts" / "atom.xml"
+
+ assert atom_path.is_file(), "Hugo did not generate posts/atom.xml"
+
+ source = atom_path.read_text(encoding="utf-8")
+
+ try:
+ return ET.fromstring(source)
+ except ET.ParseError as error:
+ pytest.fail(f"Generated posts/atom.xml is not valid XML: {error}\n\n{source}")
+
+
+def test_posts_atom_feed_metadata(
+ posts_atom_feed: ET.Element,
+) -> None:
+ assert posts_atom_feed.tag == f"{ATOM}feed"
+ assert posts_atom_feed.findtext(f"{ATOM}title") == "Test Posts"
+ assert posts_atom_feed.findtext(f"{ATOM}id") == "https://example.org/posts/"
+
+ self_link = find_link(posts_atom_feed, "self")
+ assert self_link.get("href") == "https://example.org/posts/atom.xml"
+ assert self_link.get("type") == "application/atom+xml"
+
+ alternate_link = find_link(posts_atom_feed, "alternate")
+ assert alternate_link.get("href") == "https://example.org/posts/"
+ assert alternate_link.get("type") == "text/html"
+
+
+def test_posts_atom_feed_contains_section_entries(
+ posts_atom_feed: ET.Element,
+) -> None:
+ entries = posts_atom_feed.findall(f"{ATOM}entry")
+
+ assert [entry.findtext(f"{ATOM}title") for entry in entries] == [
+ "Newer post",
+ "Older post with & characters",
+ ]
+
+
+@pytest.fixture(scope="module")
+def empty_atom_feed(built_site: Path) -> ET.Element:
+ atom_path = built_site / "empty" / "atom.xml"
+
+ assert atom_path.is_file(), "Hugo did not generate empty/atom.xml"
+
+ source = atom_path.read_text(encoding="utf-8")
+
+ try:
+ return ET.fromstring(source)
+ except ET.ParseError as error:
+ pytest.fail(f"Generated empty/atom.xml is not valid XML: {error}\n\n{source}")
+
+
+def test_empty_atom_feed_has_required_metadata(
+ empty_atom_feed: ET.Element,
+) -> None:
+ assert empty_atom_feed.findtext(f"{ATOM}title") == "Empty section"
+ assert empty_atom_feed.findtext(f"{ATOM}id") == "https://example.org/empty/"
+ assert empty_atom_feed.findtext(f"{ATOM}updated") == "2026-01-07T09:00:00Z"
+
+
+def test_empty_atom_feed_contains_no_entries(
+ empty_atom_feed: ET.Element,
+) -> None:
+ assert empty_atom_feed.findall(f"{ATOM}entry") == []
+
+
+def test_atom_feed_identifies_hugo_generator(
+ atom_feed: ET.Element,
+) -> None:
+ generators = atom_feed.findall(f"{ATOM}generator")
+
+ assert len(generators) == 1
+
+ generator = generators[0]
+
+ assert generator.text == "Hugo"
+ assert generator.get("uri") == "https://gohugo.io/"
+ version = generator.get("version")
+
+ assert version is not None
+ assert re.fullmatch(r"\d+\.\d+\.\d+", version), (
+ f"Unexpected Hugo version format: {version!r}"
+ )
+
+
+def test_atom_feed_declares_language(atom_feed: ET.Element) -> None:
+ # locale differs depending on the environment, so just check that it exists
+ assert atom_feed.get(XML_LANG)
+
+
+def test_atom_feed_contains_description(
+ atom_feed: ET.Element,
+) -> None:
+ assert atom_feed.findtext(f"{ATOM}subtitle") == "A test feed"
+
+
+def test_atom_entry_content_uses_entry_as_base_url(
+ atom_entries: list[ET.Element],
+) -> None:
+ for entry in atom_entries:
+ content = entry.find(f"{ATOM}content")
+
+ assert content is not None
+ assert content.get(
+ "{http://www.w3.org/XML/1998/namespace}base"
+ ) == entry.findtext(f"{ATOM}id")
+
+
+def test_atom_feed_respects_configured_item_limit(
+ built_site: Path,
+ atom_entries: list[ET.Element],
+) -> None:
+ assert (built_site / "posts" / "excluded_older" / "index.html").is_file()
+
+ assert [entry.findtext(f"{ATOM}title") for entry in atom_entries] == [
+ "Newer post",
+ "Older post with & characters",
+ ]
+
+
+@pytest.mark.parametrize(
+ ("html_path", "expected_feed_url"),
+ [
+ ("index.html", "https://example.org/atom.xml"),
+ (
+ "posts/index.html",
+ "https://example.org/posts/atom.xml",
+ ),
+ (
+ "empty/index.html",
+ "https://example.org/empty/atom.xml",
+ ),
+ ],
+)
+def test_html_pages_advertise_atom_feed(
+ built_site: Path,
+ html_path: str,
+ expected_feed_url: str,
+) -> None:
+ links = parse_html_links(built_site / html_path)
+
+ atom_links = [
+ link
+ for link in links
+ if link.get("rel") == "alternate" and link.get("type") == "application/atom+xml"
+ ]
+
+ assert len(atom_links) == 1
+ assert atom_links[0].get("href") == expected_feed_url
diff --git a/themes/hugo-atom-feed b/themes/hugo-atom-feed
deleted file mode 160000
index d545effe..00000000
--- a/themes/hugo-atom-feed
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit d545effed9949bf834eaed09ad423ec3e030794f