Rust Cargo Check

Hook Content

The main content for this hook.

post-tool-use.json

json

{
  "hookConfig": {
    "hooks": {
      "postToolUse": {
        "script": "./.claude/hooks/rust-cargo-check.sh",
        "matchers": [
          "write",
          "edit"
        ]
      }
    }
  },
  "scriptContent": "#!/bin/bash\n\n# Read the tool input from stdin\nINPUT=$(cat)\nTOOL_NAME=$(echo \"$INPUT\" | jq -r '.tool_name')\nFILE_PATH=$(echo \"$INPUT\" | jq -r '.tool_input.file_path // .tool_input.path // \"\"')\n\nif [ -z \"$FILE_PATH\" ]; then\n  exit 0\nfi\n\n# Check if this is a Rust file or Cargo configuration\nif [[ \"$FILE_PATH\" == *.rs ]] || [[ \"$FILE_PATH\" == *Cargo.toml ]] || [[ \"$FILE_PATH\" == *Cargo.lock ]]; then\n    echo \"🦀 Rust Cargo Check - Analyzing Rust code...\"\n    echo \"📄 File: $FILE_PATH\"\n    \n    # Check if cargo is available\n    if ! command -v cargo >/dev/null 2>&1; then\n        echo \"⚠️ Cargo not found - please install Rust toolchain\"\n        echo \"💡 Install from: https://rustup.rs/\"\n        exit 1\n    fi\n    \n    # Check if we're in a Rust project\n    if [ ! -f \"Cargo.toml\" ]; then\n        echo \"⚠️ No Cargo.toml found - not a Rust project\"\n        exit 0\n    fi\n    \n    echo \"🔍 Running Rust toolchain checks...\"\n    \n    # Step 1: Run cargo check for fast compilation validation\n    echo \"⚡ Running cargo check (fast compilation check)...\"\n    if cargo check --message-format=short; then\n        echo \"✅ Cargo check passed - code compiles successfully\"\n    else\n        echo \"❌ Cargo check failed - compilation errors found\"\n        echo \"💡 Fix compilation errors before proceeding\"\n        exit 1\n    fi\n    \n    # Step 2: Run clippy for linting (if available)\n    echo \"\"\n    echo \"📋 Running clippy (Rust linter)...\"\n    if command -v cargo-clippy >/dev/null 2>&1 || cargo clippy --version >/dev/null 2>&1; then\n        if cargo clippy --message-format=short -- -W clippy::pedantic -W clippy::nursery; then\n            echo \"✅ Clippy analysis passed - no linting issues\"\n        else\n            echo \"⚠️ Clippy found linting issues (non-blocking)\"\n        fi\n    else\n        echo \"ℹ️ Clippy not available - install with: rustup component add clippy\"\n    fi\n    \n    # Step 3: Check formatting (if rustfmt is available)\n    echo \"\"\n    echo \"🎨 Checking code formatting...\"\n    if command -v rustfmt >/dev/null 2>&1; then\n        if cargo fmt -- --check; then\n            echo \"✅ Code formatting is correct\"\n        else\n            echo \"⚠️ Code formatting issues found\"\n            echo \"💡 Run 'cargo fmt' to fix formatting\"\n        fi\n    else\n        echo \"ℹ️ rustfmt not available - install with: rustup component add rustfmt\"\n    fi\n    \n    # Step 4: Security audit (if cargo-audit is available)\n    echo \"\"\n    echo \"🔒 Running security audit...\"\n    if command -v cargo-audit >/dev/null 2>&1; then\n        if cargo audit; then\n            echo \"✅ No known security vulnerabilities found\"\n        else\n            echo \"⚠️ Security vulnerabilities detected - review dependencies\"\n        fi\n    else\n        echo \"ℹ️ cargo-audit not available - install with: cargo install cargo-audit\"\n    fi\n    \n    # Step 5: Project analysis\n    echo \"\"\n    echo \"📊 Project Analysis:\"\n    \n    # Count Rust files\n    RUST_FILES=$(find . -name \"*.rs\" -not -path \"./target/*\" | wc -l)\n    echo \"  • Rust files: $RUST_FILES\"\n    \n    # Check for tests\n    TEST_FILES=$(find . -name \"*.rs\" -not -path \"./target/*\" -exec grep -l \"#\\[test\\]\\|#\\[cfg(test)\\]\" {} \\; | wc -l)\n    echo \"  • Files with tests: $TEST_FILES\"\n    \n    # Check dependencies\n    DEPENDENCIES=$(grep -c '^[a-zA-Z].*=' Cargo.toml 2>/dev/null || echo 0)\n    echo \"  • Dependencies: $DEPENDENCIES\"\n    \n    # Check for unsafe blocks\n    if find . -name \"*.rs\" -not -path \"./target/*\" -exec grep -l \"unsafe\" {} \\; | head -1 >/dev/null 2>&1; then\n        UNSAFE_COUNT=$(find . -name \"*.rs\" -not -path \"./target/*\" -exec grep -c \"unsafe\" {} \\; | awk '{sum+=$1} END {print sum}')\n        echo \"  • ⚠️ Unsafe blocks found: $UNSAFE_COUNT\"\n    fi\n    \n    echo \"\"\n    echo \"💡 Rust Development Tips:\"\n    echo \"  • Use 'cargo test' to run all tests\"\n    echo \"  • Use 'cargo build --release' for optimized builds\"\n    echo \"  • Use 'cargo doc --open' to generate and view documentation\"\n    echo \"  • Use 'cargo bench' for benchmarking (if available)\"\n    echo \"  • Consider using 'cargo watch' for continuous testing\"\n    \n    echo \"\"\n    echo \"🎯 Rust code analysis complete!\"\n    \nelse\n    echo \"ℹ️ File is not a Rust file: $FILE_PATH\"\nfi\n\nexit 0"
}

Features

Key capabilities and functionality

Fast compilation checking with cargo check
Code linting with clippy
Rust best practices enforcement
Dependency validation
Performance optimization suggestions
Security vulnerability detection

Installation

Setup instructions and requirements

Claude Code Setup

Create hooks directory: mkdir -p .claude/hooks
Create hook script: .claude/hooks/rust-cargo-check.sh
Add hook configuration to your Claude Code config
Make script executable: chmod +x .claude/hooks/rust-cargo-check.sh
Restart Claude Code to activate the hook

Configuration Paths

project

.claude/hooks/

user

~/.claude/hooks/

Requirements

Claude Code CLI
Bash shell
Hook-specific dependencies (e.g., jq, prettier)

Hook Configuration

Hook setup and script content

post-tool-use-config.json

json

{
  "hooks": {
    "postToolUse": {
      "script": "./.claude/hooks/rust-cargo-check.sh",
      "matchers": [
        "write",
        "edit"
      ]
    }
  }
}

post-tool-use-script.sh

bash

#!/bin/bash

# Read the tool input from stdin
INPUT=$(cat)
TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name')
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.path // ""')

if [ -z "$FILE_PATH" ]; then
  exit 0
fi

# Check if this is a Rust file or Cargo configuration
if [[ "$FILE_PATH" == *.rs ]] || [[ "$FILE_PATH" == *Cargo.toml ]] || [[ "$FILE_PATH" == *Cargo.lock ]]; then
    echo "🦀 Rust Cargo Check - Analyzing Rust code..."
    echo "📄 File: $FILE_PATH"
    
    # Check if cargo is available
    if ! command -v cargo >/dev/null 2>&1; then
        echo "⚠️ Cargo not found - please install Rust toolchain"
        echo "💡 Install from: https://rustup.rs/"
        exit 1
    fi
    
    # Check if we're in a Rust project
    if [ ! -f "Cargo.toml" ]; then
        echo "⚠️ No Cargo.toml found - not a Rust project"
        exit 0
    fi
    
    echo "🔍 Running Rust toolchain checks..."
    
    # Step 1: Run cargo check for fast compilation validation
    echo "⚡ Running cargo check (fast compilation check)..."
    if cargo check --message-format=short; then
        echo "✅ Cargo check passed - code compiles successfully"
    else
        echo "❌ Cargo check failed - compilation errors found"
        echo "💡 Fix compilation errors before proceeding"
        exit 1
    fi
    
    # Step 2: Run clippy for linting (if available)
    echo ""
    echo "📋 Running clippy (Rust linter)..."
    if command -v cargo-clippy >/dev/null 2>&1 || cargo clippy --version >/dev/null 2>&1; then
        if cargo clippy --message-format=short -- -W clippy::pedantic -W clippy::nursery; then
            echo "✅ Clippy analysis passed - no linting issues"
        else
            echo "⚠️ Clippy found linting issues (non-blocking)"
        fi
    else
        echo "ℹ️ Clippy not available - install with: rustup component add clippy"
    fi
    
    # Step 3: Check formatting (if rustfmt is available)
    echo ""
    echo "🎨 Checking code formatting..."
    if command -v rustfmt >/dev/null 2>&1; then
        if cargo fmt -- --check; then
            echo "✅ Code formatting is correct"
        else
            echo "⚠️ Code formatting issues found"
            echo "💡 Run 'cargo fmt' to fix formatting"
        fi
    else
        echo "ℹ️ rustfmt not available - install with: rustup component add rustfmt"
    fi
    
    # Step 4: Security audit (if cargo-audit is available)
    echo ""
    echo "🔒 Running security audit..."
    if command -v cargo-audit >/dev/null 2>&1; then
        if cargo audit; then
            echo "✅ No known security vulnerabilities found"
        else
            echo "⚠️ Security vulnerabilities detected - review dependencies"
        fi
    else
        echo "ℹ️ cargo-audit not available - install with: cargo install cargo-audit"
    fi
    
    # Step 5: Project analysis
    echo ""
    echo "📊 Project Analysis:"
    
    # Count Rust files
    RUST_FILES=$(find . -name "*.rs" -not -path "./target/*" | wc -l)
    echo "  • Rust files: $RUST_FILES"
    
    # Check for tests
    TEST_FILES=$(find . -name "*.rs" -not -path "./target/*" -exec grep -l "#\[test\]\|#\[cfg(test)\]" {} \; | wc -l)
    echo "  • Files with tests: $TEST_FILES"
    
    # Check dependencies
    DEPENDENCIES=$(grep -c '^[a-zA-Z].*=' Cargo.toml 2>/dev/null || echo 0)
    echo "  • Dependencies: $DEPENDENCIES"
    
    # Check for unsafe blocks
    if find . -name "*.rs" -not -path "./target/*" -exec grep -l "unsafe" {} \; | head -1 >/dev/null 2>&1; then
        UNSAFE_COUNT=$(find . -name "*.rs" -not -path "./target/*" -exec grep -c "unsafe" {} \; | awk '{sum+=$1} END {print sum}')
        echo "  • ⚠️ Unsafe blocks found: $UNSAFE_COUNT"
    fi
    
    echo ""
    echo "💡 Rust Development Tips:"
    echo "  • Use 'cargo test' to run all tests"
    echo "  • Use 'cargo build --release' for optimized builds"
    echo "  • Use 'cargo doc --open' to generate and view documentation"
    echo "  • Use 'cargo bench' for benchmarking (if available)"
    echo "  • Consider using 'cargo watch' for continuous testing"
    
    echo ""
    echo "🎯 Rust code analysis complete!"
    
else
    echo "ℹ️ File is not a Rust file: $FILE_PATH"
fi

exit 0

Use Cases

Common scenarios and applications

Validate Rust code compilation before commits
Catch common Rust programming errors early
Enforce Rust coding standards with clippy
Check dependency compatibility
Identify performance improvement opportunities
Ensure code follows Rust best practices
Run security analysis on Rust code
Validate Cargo.toml configuration changes

Troubleshooting

Common issues and solutions

Cargo check fails with 'No Cargo.toml found' in monorepos
Hook searches from file directory upward but may fail in nested workspaces. Add cd logic to find workspace root: while [ ! -f Cargo.toml ] && [ $(pwd) != / ]; do cd ..; done before running cargo commands.
Target directory compilation artifacts cause slow check times
Cargo check reuses incremental compilation from target/. Ensure .gitignore excludes target/ but preserve it locally. Use cargo clean selectively or CARGO_TARGET_DIR to separate hook builds from development builds.
Cargo audit fails when offline or network restricted environments
Script treats cargo-audit as optional but doesn't handle network errors. Add CARGO_NET_OFFLINE=true check or wrap in: timeout 5s cargo audit || echo 'Audit skipped (offline)' to prevent hanging on network unavailable.
Multiple Rust files changed simultaneously trigger concurrent checks
PostToolUse fires per operation causing parallel cargo check processes. Add flock-based locking: { flock -n 200 || exit 0; cargo check; } 200>/tmp/cargo-check.lock to serialize executions and prevent resource contention.
Hook executes before file write completes showing stale errors
PostToolUse hooks fire after tool completion but file system may buffer writes. Add small delay: sleep 0.1 before cargo check, or verify file timestamp: [ "$FILE_PATH" -nt /tmp/last-check ] to ensure fresh content is analyzed.

Reviews (0)

Sort by:

Loading reviews...

Automate with Claude Hooks

Get the latest automation hooks delivered weekly.

Join our community of Claude power users. No spam, unsubscribe anytime.

Claude Code Setup

Configuration Paths

Requirements

Reviews (0)

Category

Source

Accessibility Checker

API Endpoint Documentation Generator

Auto Code Formatter Hook