CI: add test-docs target to compile Rust code defined in docs

Author: dannywillems

.github/workflows/ci.yaml

@@ -115,6 +115,32 @@ jobs:
         run: |
           make test-p2p
 
+  docs-tests:
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Git checkout
+        uses: actions/checkout@v4
+
+      - name: Setup build dependencies
+        run: |
+          sudo apt update
+          sudo apt install -y protobuf-compiler
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+          toolchain: 1.84
+
+      - name: Setup Rust Cache
+        uses: Swatinem/rust-cache@v2
+        with:
+          prefix-key: "v0"
+
+      - name: Test documentation code examples
+        run: |
+          make test-docs
+
   build:
     runs-on: ubuntu-22.04
     steps:

Makefile

@@ -217,6 +217,11 @@ test-release: ## Run tests in release mode
 test-vrf: ## Run VRF tests, requires nightly Rust
 	@cd vrf && cargo +nightly test --release -- -Z unstable-options --report-time
 
+.PHONY: test-docs
+test-docs: ## Run documentation tests to verify code examples compile and run
+	@echo "Testing documentation code examples..."
+	cargo test --doc
+
 # Docker build targets
 
 .PHONY: docker-build-all