Add fuzz testing infrastructure for Issue #299

.github/workflows/ci-fuzz.yml

@@ -0,0 +1,33 @@
+# SPDX-FileCopyrightText: Copyright (c) 2023-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+name: CI (Build + Short Fuzz)
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build-and-fuzz:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Rust (stable)
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install nightly toolchain for fuzzing
+        run: rustup toolchain install nightly
+
+      - name: Install cargo-fuzz
+        run: cargo install cargo-fuzz
+
+      - name: Build library
+        run: cargo build --release
+
+      - name: Run short fuzz test (60s)
+        run: cargo +nightly fuzz run fuzz_map_basic -- -max_total_time=60
+

.github/workflows/nightly-fuzz.yml

@@ -0,0 +1,39 @@
+# SPDX-FileCopyrightText: Copyright (c) 2023-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+name: Nightly Fuzz Testing
+
+on:
+  schedule:
+    - cron: "0 2 * * *"
+  workflow_dispatch:
+
+jobs:
+  nightly-fuzz:
+    runs-on: ubuntu-latest
+    timeout-minutes: 90
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Rust toolchains
+        run: |
+          rustup toolchain install nightly
+          rustup default nightly
+          cargo install cargo-fuzz
+
+      - name: Enable sanitizers
+        run: |
+          export RUSTFLAGS="-Zsanitizer=address"
+          export ASAN_OPTIONS=detect_leaks=1
+
+      - name: Run extended fuzzing (1h)
+        run: cargo +nightly fuzz run fuzz_map_basic -- -max_total_time=3600
+
+      - name: Upload fuzz artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: fuzz-crashes
+          path: fuzz/artifacts/fuzz_map_basic/
+

.gitignore

@@ -1,4 +1,4 @@
-.DS_Store
+.DS_Store
 .idea/
 *.bak
 *.relf
@@ -7,3 +7,4 @@ bin/
 node_modules/
 target/
 tmp/
+fuzz/artifacts/

Cargo.toml

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: Copyright (c) 2023-2025 Yegor Bugayenko
+# SPDX-FileCopyrightText: Copyright (c) 2023-2025 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
 [package]
@@ -12,6 +12,7 @@ readme = "README.md"
 license = "MIT"
 homepage = "https://github.com/yegor256/micromap"
 keywords = ["memory", "map"]
+exclude = ["fuzz"]
 categories = ["data-structures", "memory-management"]
 
 [dependencies]

fuzz/Cargo.toml

@@ -0,0 +1,26 @@
+[package]
+name = "micromap-fuzz"
+version = "0.1.0"
+edition = "2021"
+publish = false
+
+[dependencies]
+micromap = { path = "../" }
+libfuzzer-sys = "0.4"
+arbitrary = "1.3"
+
+[dev-dependencies]
+rand = "0.9.2"
+
+[profile.release]
+debug = true
+
+[workspace]
+# Keep this fuzz crate isolated from the main workspace.
+
+[package.metadata]
+cargo-fuzz = true
+
+[[bin]]
+name = "fuzz_map_basic"
+path = "fuzz_targets/fuzz_map_basic.rs"