feat: add tests for guide code snippets

.cargo/deny.toml

@@ -24,5 +24,6 @@ allow = [
     "ISC",
     "MIT",
     "Unicode-3.0",
+    "Unicode-DFS-2016",
     "Zlib",
 ]

.config/nextest.toml

@@ -0,0 +1,9 @@
+[test-groups]
+# Guide doc tests build Rust project (which already uses all available CPU
+# cores) and reuse the target directory (which is shared across all tests),
+# so we limit the number of concurrently running guide doc tests to 1
+doc-code-blocks = { max-threads = 1 }
+
+[[profile.default.overrides]]
+filter = 'package(cot-test)'
+test-group = 'doc-code-blocks'

Cargo.toml

@@ -5,6 +5,7 @@ members = [
     "cot-codegen",
     "cot-core",
     "cot-macros",
+    "cot-test",
     # Examples
     "examples/admin",
     "examples/custom-error-pages",
@@ -81,9 +82,11 @@ clap = { version = "4.5.60", features = ["deprecated"] }
 clap-verbosity-flag = { version = "3", default-features = false }
 clap_complete = "4"
 clap_mangen = "0.3.0"
+comrak = { version = "0.51", default-features = false }
 cot = { version = "0.6.0", path = "cot" }
-cot_core = { version = "0.6.0", path = "cot-core" }
 cot_codegen = { version = "0.6.0", path = "cot-codegen" }
+cot-cli = { version = "0.6.0", path = "cot-cli" }
+cot_core = { version = "0.6.0", path = "cot-core" }
 cot_macros = { version = "0.6.0", path = "cot-macros" }
 criterion = "0.8"
 darling = "0.23"
@@ -105,11 +108,12 @@ http = "1.4"
 http-body = "1"
 http-body-util = "0.1.3"
 humantime = "2"
+idna = { version = "1.1", default-features = false }
 indexmap = "2"
 insta = { version = "1", features = ["filters"] }
 insta-cmd = "0.6"
 lettre = { version = "0.11.20", default-features = false }
-idna = { version = "1.1", default-features = false }
+libtest-mimic = "0.8"
 mime = "0.3"
 mime_guess = { version = "2", default-features = false }
 mockall = "0.14"

cot-test/Cargo.toml

@@ -0,0 +1,27 @@
+[package]
+name = "cot-test"
+description = "Internal crate containing various integrations tests and test utilities."
+version = "0.1.0"
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+homepage.workspace = true
+repository.workspace = true
+keywords.workspace = true
+readme.workspace = true
+authors.workspace = true
+
+[dependencies]
+comrak.workspace = true
+cot-cli = { workspace = true, features = ["test_utils"] }
+cot.workspace = true
+glob.workspace = true
+libtest-mimic.workspace = true
+
+[lints]
+workspace = true
+
+[[test]]
+name = "doc_code_blocks"
+path = "tests/doc_code_blocks.rs"
+harness = false