nanodock 0.1.0

Zero-dependency-light Docker/Podman daemon client for container detection, port mapping, and lifecycle control
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

#!/bin/sh

# nanodock - Pre-commit hook

# Prevents committing code that doesn't pass quality gates.

#

# Install: copy this file to .git/hooks/pre-commit (or run the setup script)

#          chmod +x .git/hooks/pre-commit  (Linux/macOS)

#

# What it checks:

#   1. cargo fmt --check  - formatting

#   2. cross-target clippy - lint violations across Linux + Windows targets

#   3. cargo test          - all tests pass


set -e


ensure_cargo() {
    if command -v cargo >/dev/null 2>&1; then
        return 0

    fi


    # Git can execute hooks with a reduced PATH outside the user's shell init.

    if [ -f "$HOME/.cargo/env" ]; then
        . "$HOME/.cargo/env"

    fi


    if command -v cargo >/dev/null 2>&1; then
        return 0

    fi


    if [ -x "$HOME/.cargo/bin/cargo" ]; then
        PATH="$HOME/.cargo/bin:$PATH"
        export PATH

        return 0

    fi


    echo ""

    echo "✗ RUST TOOLCHAIN NOT FOUND"

    echo "  cargo is not available in the git hook environment."

    echo "  Install Rust or source ~/.cargo/env, then try again."

    exit 1

}

ensure_cargo


echo "╔══════════════════════════════════════════╗"

echo "║     nanodock Pre-Commit Quality Gate      ║"

echo "╚══════════════════════════════════════════╝"

echo ""


# Gate 1: Formatting

echo "→ Checking formatting..."

if ! cargo fmt --all -- --check; then
    echo ""

    echo "✗ FORMATTING FAILED"

    echo "  Run: cargo fmt"

    echo "  Then try committing again."

    exit 1

fi

echo "  ✓ Formatting OK"


# Gate 2: Clippy across the supported Linux + Windows targets

echo "→ Running cross-target clippy..."

if ! sh scripts/check-platform-clippy.sh; then
    echo ""

    echo "✗ CLIPPY FAILED"

    echo "  Fix the lint errors above or install the missing rustup targets,"

    echo "  then try committing again."

    exit 1

fi

echo "  ✓ Cross-target clippy OK"


# Gate 3: Tests

echo "→ Running tests..."

if ! cargo test --lib --tests; then
    echo ""

    echo "✗ TESTS FAILED"

    echo "  Fix the failing unit or integration tests, then try committing again."

    exit 1

fi


if ! cargo test --doc; then
    echo ""

    echo "✗ TESTS FAILED"

    echo "  Fix the failing doctests, then try committing again."

    exit 1

fi

echo "  ✓ Tests OK"


echo ""

echo "✓ All quality gates passed. Committing..."