DO NOT MERGE - add snapshot tests for large refactors

This patch adds snapshot testing for essentially every file that's
generated as part of the website. This should not be merged, because
The number of snapshot files is massive and a new one would have to be
added for every new post.

However, this can be very useful to test refactors of the code that
shouldn't change the output in any way. (Or if it does, these tests
make it easier to see if the changes to the output are appropriate.)

The process of using these tests would go something as follows:
- install [cargo-insta](https://insta.rs/docs/quickstart/)
- create a new branch, call it for example my-foo-refactor-testing-base
- cherry pick this commit onto that branch
- run `cargo insta test --accept` to generate the baseline snapshots
- commit all these files and push the branch (it will not be merged)
- create a new branch, e.g. my-foo-refactor, based on *-testing-base
- do your refactoring
- push your changes and create a PR against the *-testing-base branch

Now you have a nice PR that's fully snapshot tested and can go through
regular review cycles. Before merging, interactively rebase your
refactor branch, drop the snapshot-related commits and re-target the PR
to master.

Author: senekor

.github/workflows/main.yml

@@ -10,7 +10,7 @@ env:
   RUST_VERSION: 1.85.0
 
 jobs:
-  lint:
+  lint_and_test:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
@@ -22,6 +22,7 @@ jobs:
 
       - run: cargo clippy --workspace -- -D warnings
       - run: cargo fmt --check --all
+      - run: cargo test --all
 
   build:
     runs-on: ubuntu-latest

.gitignore

@@ -6,3 +6,4 @@ static/styles/vendor.css
 static/styles/app.css
 static/styles/fonts.css
 static/styles/noscript.css
+*.snap.new

Cargo.lock

@@ -21,3 +21,6 @@ chrono = "=0.4.40"
 
 [workspace]
 members = ["serve"]
+
+[dev-dependencies]
+insta = { version = "1.42.0", features = ["glob"] }

Cargo.toml

@@ -278,3 +278,26 @@ pub fn main() -> eyre::Result<()> {
 
     Ok(())
 }
+
+#[test]
+fn snapshot() {
+    main().unwrap();
+    insta::glob!("..", "site/**/*", |path| {
+        if path.is_dir() {
+            return;
+        }
+        let path = path.display().to_string();
+        let non_deterministic_files = ["releases.json", "feed.xml", "experiences.png"];
+        if non_deterministic_files
+            .into_iter()
+            .any(|f| path.ends_with(f))
+        {
+            // Skip troublesome files, e.g. they might contain timestamps.
+            return;
+        }
+        let content = fs::read(path).unwrap();
+        // insta can't deal with non-utf8 strings?
+        let content = String::from_utf8_lossy(&content).into_owned();
+        insta::assert_snapshot!(content);
+    });
+}