Pages are Markdown files in content/<lang>/ with a Key: value header, the news carry Title, Author, Date, Categories and Description and are published as /news/YYYY/MM/name.html, with a page for every category. The templates, the language files and site.json shrink to the chrome and the shared strings, and the footer credits motorino. The output matches the one of build.py page by page, checked with tools/compare.py and the Nu HTML Checker.
106 lines
5.8 KiB
Python
106 lines
5.8 KiB
Python
"""Tests of the one-off migration helpers (run with: python3 -m unittest discover -s tools)."""
|
|
import unittest
|
|
|
|
import migrate
|
|
|
|
|
|
class HtmlToMarkdown(unittest.TestCase):
|
|
def test_paragraph_with_inline_markup(self):
|
|
html = '<p>\nHello <strong>world</strong> and <a href="/x.html">a link</a> and <em>this</em> and <code>code</code>.\n</p>'
|
|
self.assertEqual(migrate.html_to_md(html), "Hello **world** and [a link](/x.html) and *this* and `code`.\n")
|
|
|
|
def test_link_around_code(self):
|
|
html = '<p>\nSend to <a href="bitcoin:bc1q"><code>bc1q</code></a>\n</p>'
|
|
self.assertEqual(migrate.html_to_md(html), "Send to [`bc1q`](bitcoin:bc1q)\n")
|
|
|
|
def test_heading_with_id(self):
|
|
self.assertEqual(migrate.html_to_md('<h2 id="account">Request an account</h2>'), "## Request an account {#account}\n")
|
|
self.assertEqual(migrate.html_to_md("<h1>Services</h1>"), "# Services\n")
|
|
|
|
def test_list(self):
|
|
html = '<ul>\n<li>one</li>\n<li><a href="/a">two</a></li>\n</ul>'
|
|
self.assertEqual(migrate.html_to_md(html), "- one\n- [two](/a)\n")
|
|
|
|
def test_blocks_are_separated_by_a_blank_line(self):
|
|
html = "<h1>T</h1>\n\n<p>\nBody.\n</p>\n<ul>\n<li>x</li>\n</ul>\n"
|
|
self.assertEqual(migrate.html_to_md(html), "# T\n\nBody.\n\n- x\n")
|
|
|
|
def test_table_stays_raw(self):
|
|
table = '<table class="data">\n<caption>C</caption>\n<tbody>\n<tr>\n<td data-label="Kept">14 days</td>\n</tr>\n</tbody>\n</table>'
|
|
self.assertEqual(migrate.html_to_md(table), table + "\n")
|
|
|
|
def test_comment_stays_raw(self):
|
|
self.assertEqual(migrate.html_to_md("<!-- TODO verificare: x -->"), "<!-- TODO verificare: x -->\n")
|
|
|
|
def test_raw_when_there_are_attributes_or_other_tags(self):
|
|
cases = [
|
|
'<p>\n<img class="logo" src="/logo-auto.svg" alt="kmalloc" width="112">\n</p>',
|
|
'<h1 class="hero">Technology.<br>Freedom.<br><span class="accent">Dissent.</span></h1>',
|
|
'<h2 id="v1.2">Version 1.2, <time datetime="2026-11-14">2026-11-14</time></h2>',
|
|
'<p class="note" role="note">\nA note.\n</p>',
|
|
'<p>\n<a href="https://x.org/" rel="noreferrer">shop</a>.\n</p>',
|
|
]
|
|
for html in cases:
|
|
with self.subTest(html=html):
|
|
self.assertEqual(migrate.html_to_md(html), html + "\n")
|
|
|
|
def test_unknown_text_between_blocks_fails(self):
|
|
with self.assertRaises(ValueError):
|
|
migrate.html_to_md("<p>\nfine\n</p>\nstray text\n<p>\nmore\n</p>")
|
|
|
|
|
|
class Placeholders(unittest.TestCase):
|
|
def test_restore_replaces_literal_values(self):
|
|
values = {"btc": "bc1qabc", "contact_shown": "squid (at) kmalloc.org", "gpg_key": "/squid.asc"}
|
|
md = "Write to **squid (at) kmalloc.org**. [squid.asc](/squid.asc) and bc1qabc."
|
|
self.assertEqual(migrate.restore(md, values),
|
|
"Write to **{{contact_shown}}**. [squid.asc]({{gpg_key}}) and {{btc}}.")
|
|
|
|
def test_restore_prefers_the_longest_value(self):
|
|
values = {"a": "https://x.org/", "b": "https://x.org/search?q=1"}
|
|
self.assertEqual(migrate.restore("see https://x.org/search?q=1", values), "see {{b}}")
|
|
|
|
|
|
class Content(unittest.TestCase):
|
|
def test_extract_content_between_header_and_footer(self):
|
|
page = "<body>\n<header>\n<nav>x</nav>\n</header>\n\n<h1>T</h1>\n\n<p>\nB\n</p>\n\n<footer>\nf\n</footer>\n</body>"
|
|
self.assertEqual(migrate.extract_content(page), "<h1>T</h1>\n\n<p>\nB\n</p>\n")
|
|
|
|
def test_page_file_name(self):
|
|
cases = [("/", "en", "en", "index.md"), ("/manifesto.html", "en", "en", "manifesto.md"),
|
|
("/news/", "en", "en", "news/index.md"), ("/it/", "en", "it", "index.md"),
|
|
("/it/servizi.html", "en", "it", "servizi.md")]
|
|
for path, default, lang, want in cases:
|
|
with self.subTest(path=path):
|
|
self.assertEqual(migrate.page_file(path, default, lang), want)
|
|
|
|
def test_page_header(self):
|
|
header = migrate.page_header("kmalloc.org: News", "news", "Updates.", "bare", note="", switch={"en": "/?lang=en"})
|
|
self.assertEqual(header, "Title: kmalloc.org: News\nID: news\nDescription: Updates.\nLayout: bare\nSwitch: en=/?lang=en\n-\n")
|
|
|
|
def test_page_header_with_manifesto_version(self):
|
|
header = migrate.page_header("M", "manifesto", "d", "manifesto", note="N", manifesto_version="1.0", manifesto_date="2026-11-12")
|
|
self.assertEqual(header, "Title: M\nID: manifesto\nDescription: d\nLayout: manifesto\nNote: N\n"
|
|
"ManifestoVersion: 1.0\nManifestoDate: 2026-11-12\n-\n")
|
|
|
|
def test_post_conversion(self):
|
|
old = "---\ntitle: A shop\nsummary: About the shop.\n---\n\nThere is a shop.\n"
|
|
name, text = migrate.convert_post("2026-11-14-shop.md", old)
|
|
self.assertEqual(name, "shop.md")
|
|
self.assertEqual(text, "Title: A shop\nAuthor: squid\nDate: 2026-11-14T12:00:00+0100\nCategories: News\n"
|
|
"Description: About the shop.\n-\n\nThere is a shop.\n")
|
|
|
|
def test_post_without_summary_has_no_description(self):
|
|
_, text = migrate.convert_post("2026-11-12-x.md", "---\ntitle: X\n---\nBody.\n")
|
|
self.assertNotIn("Description:", text)
|
|
|
|
def test_block_markers(self):
|
|
home = '<p>\nA\n</p>\n\n<h2 id="news">News</h2>\n\n<p>\nIntro. <a href="/news/">All</a>.\n</p>\n\n<ul>\n<li>x</li>\n</ul>\n'
|
|
self.assertEqual(migrate.mark_latest_news(home), '<p>\nA\n</p>\n\n<p>{{latest_news}}</p>\n')
|
|
news = '<h1>News</h1>\n\n<p>\nIntro.\n</p>\n\n<ul>\n<li>x</li>\n</ul>\n\n<p>\n<a href="/news/feed.xml">RSS feed</a>\n</p>\n'
|
|
self.assertEqual(migrate.mark_news_list(news),
|
|
'<h1>News</h1>\n\n<p>\nIntro.\n</p>\n\n<p>{{news_list}}</p>\n\n<p>\n<a href="/news/feed.xml">RSS feed</a>\n</p>\n')
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|