// SPDX-License-Identifier: GPL-3.0-or-later package build import ( "encoding/xml" "path/filepath" "strings" "testing" "time" ) // fixedNow is the moment the blog tests build at, so that drafts and future // dates do not depend on the clock. var fixedNow = time.Date(2026, 11, 15, 12, 0, 0, 0, time.FixedZone("CET", 3600)) // withFiles returns the base site with files added or replaced; an empty value removes the file. func withFiles(extra map[string]string) map[string]string { files := baseFiles() for name, content := range extra { if content == "" { delete(files, name) continue } files[name] = content } return files } // buildWith builds the site made of files with the options changed by tune. func buildWith(t *testing.T, files map[string]string, tune func(*Options)) (string, error) { t.Helper() out := filepath.Join(t.TempDir(), "public") opts := Options{SiteDir: writeFiles(t, files), OutDir: out, Version: "1.2.3", Now: fixedNow} if tune != nil { tune(&opts) } _, err := Build(opts) return out, err } // exists reports whether the output has the file rel. func exists(t *testing.T, out, rel string) bool { t.Helper() _, err := readOutMaybe(out, rel) return err == nil } // postNews returns the news files used by the draft and future tests. func postNews() map[string]string { return map[string]string{ "news/a-draft.md": "Title: A draft\nDate: 2026-11-10T12:00:00+0100\nCategories: Secret\nDraft: true\n-\nNot yet.\n", "news/in-future.md": "Title: In the future\nDate: 2026-12-24T12:00:00+0100\nCategories: Later\n-\nSoon.\n", } } // TestDraftsAndFutureStayHidden checks that a draft and a post dated in the // future are not published anywhere, and that no category exists only for them. func TestDraftsAndFutureStayHidden(t *testing.T) { out, err := buildWith(t, withFiles(postNews()), nil) if err != nil { t.Fatalf("Build() error = %v", err) } for _, rel := range []string{"news/2026/11/a-draft.html", "news/2026/12/in-future.html", "news/category/secret.html", "news/category/later.html"} { if exists(t, out, rel) { t.Errorf("%s is published, but the post is hidden", rel) } } for _, rel := range []string{"news/index.html", "news/feed.xml", "index.html"} { got := readOut(t, out, rel) for _, hidden := range []string{"A draft", "In the future", "Secret", "Later"} { if strings.Contains(got, hidden) { t.Errorf("%s mentions %q, but the post is hidden", rel, hidden) } } } mustContain(t, "news index", readOut(t, out, "news/index.html"), "Status page") } // TestDraftsFlagShowsHiddenPosts checks the preview build. func TestDraftsFlagShowsHiddenPosts(t *testing.T) { out, err := buildWith(t, withFiles(postNews()), func(o *Options) { o.Drafts = true }) if err != nil { t.Fatalf("Build() error = %v", err) } for _, rel := range []string{"news/2026/11/a-draft.html", "news/2026/12/in-future.html", "news/category/secret.html"} { if !exists(t, out, rel) { t.Errorf("%s is missing from a build with drafts", rel) } } } // TestFuturePostAppearsWhenItsDateComes checks the moment of publication. func TestFuturePostAppearsWhenItsDateComes(t *testing.T) { later := time.Date(2026, 12, 24, 12, 0, 0, 0, time.FixedZone("CET", 3600)) out, err := buildWith(t, withFiles(postNews()), func(o *Options) { o.Now = later }) if err != nil { t.Fatalf("Build() error = %v", err) } if !exists(t, out, "news/2026/12/in-future.html") { t.Error("a post is published from the moment of its date") } if exists(t, out, "news/2026/11/a-draft.html") { t.Error("a draft stays hidden whatever the date") } } // TestNewsLanguage checks the language of the news and its errors. func TestNewsLanguage(t *testing.T) { tests := []struct { name string extra map[string]string want string }{ {"unknown language in site.json", map[string]string{ "site.json": strings.Replace(baseFiles()["site.json"], `"languages"`, `"news_language": "xx", "languages"`, 1)}, `news_language "xx"`}, {"no news page in that language", map[string]string{ "site.json": strings.Replace(baseFiles()["site.json"], `"languages"`, `"news_language": "it", "languages"`, 1)}, `content/it`}, {"post in a language the site does not have", map[string]string{ "news/tedesco.md": "Title: Deutsch\nDate: 2026-11-01T12:00:00+0100\nLanguage: de\n-\nText.\n"}, `Language "de"`}, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { _, err := buildWith(t, withFiles(tt.extra), nil) if err == nil || !strings.Contains(err.Error(), tt.want) { t.Errorf("error = %v, want one that contains %q", err, tt.want) } }) } } // monthsJSON writes the month_01..month_12 strings of a test language. func monthsJSON(names ...string) string { var b strings.Builder for i, n := range names { b.WriteString(`"month_` + string(rune('0'+(i+1)/10)) + string(rune('0'+(i+1)%10)) + `": "` + n + `", `) } return b.String() } // blogLangEn and blogLangIt are the English and Italian language files with the strings the blog features need. var ( blogLangEn = `{"lang_name": "English", "sections": "Sections", "home_link": "/", "nojs": "No JavaScript.", "powered_by": "Powered by", "back": "kmalloc.org", "version": "Version", "toc": "Contents", "history_a": "Manifesto history", "news_p": "What is new.", "news_all": "All news", "news_empty": "No news yet.", "category_h": "Category", "date_long": "{d} {month} {y}", "date_month_year": "{month} {y}", "reading_time": "{n} min read", ` + monthsJSON("January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December") + ` "post_older": "Older", "post_newer": "Newer", "post_nav": "Other news", "reply_mastodon": "Reply on Mastodon", "read_more": "Read more", "pager_label": "News pages", "pager_newer": "Newer news", "pager_older": "Older news", "pager_page": "Page {n} of {total}", "archive_h": "Archive", "archive_year_h": "Year", "archive_up": "Archive of the year", "nav": {"manifesto": "Manifesto", "people": "People", "services": "Services", "news": "News"}}` blogLangIt = `{"lang_name": "Italiano", "sections": "Sezioni", "home_link": "/it/", "nojs": "Niente JavaScript.", "powered_by": "Powered by", "back": "kmalloc.org", "version": "Versione", "toc": "Indice", "history_a": "Cronologia", "news_p": "Le novita.", "news_all": "Tutte le news", "news_empty": "Nessuna news.", "category_h": "Categoria", "date_long": "{d} {month} {y}", "date_month_year": "{month} {y}", "reading_time": "{n} min di lettura", ` + monthsJSON("gennaio", "febbraio", "marzo", "aprile", "maggio", "giugno", "luglio", "agosto", "settembre", "ottobre", "novembre", "dicembre") + ` "post_older": "Piu vecchia", "post_newer": "Piu recente", "post_nav": "Altre news", "reply_mastodon": "Rispondi su Mastodon", "read_more": "Leggi tutto", "pager_label": "Pagine delle news", "pager_newer": "News piu recenti", "pager_older": "News piu vecchie", "pager_page": "Pagina {n} di {total}", "archive_h": "Archivio", "archive_year_h": "Anno", "archive_up": "Archivio dell'anno", "nav": {"manifesto": "Manifesto", "people": "Persone", "services": "Servizi", "news": "News"}}` ) // blogPostTemplate is a post page that uses every placeholder of the blog. const blogPostTemplate = `

{{post_title}}

{{post_summary}} {{post_meta}} {{post_body}} {{post_mastodon}} {{post_nav}} ` // blogBaseTemplate is the base template with the Open Graph placeholders. const blogBaseTemplate = ` {{title_html}} {{article_meta}} {{alt_links}} {{header}} {{content}} {{footer}} ` // blogSite is the base site with the blog language strings and templates. func blogSite(extra map[string]string) map[string]string { files := map[string]string{ "lang/en.json": blogLangEn, "lang/it.json": blogLangIt, "templates/post.html": blogPostTemplate, "templates/base.html": blogBaseTemplate, "news/shop.md": "Title: A shop\nAuthor: squid\nDate: 2026-11-14T12:00:00+0100\nCategories: FLUG\nDescription: About the shop.\nMastodon: https://social.kmalloc.org/@squid/115\n-\nThere is a shop.\n", } for k, v := range extra { files[k] = v } return withFiles(files) } // TestPostPageHasTheBlogFields checks the long date, the byline, the summary, // the reading time, the Mastodon link and the links to the other news. func TestPostPageHasTheBlogFields(t *testing.T) { out, err := buildWith(t, blogSite(nil), nil) if err != nil { t.Fatalf("Build() error = %v", err) } shop := readOut(t, out, "news/2026/11/shop.html") mustContain(t, "shop post", shop, `

About the shop.

`, `

· squid · FLUG · 1 min read

`, `

Reply on Mastodon

`, `