feat: introduce lint.sh and pre-commit hooks for Rust and Python (#81)

* feat: introduce lint.sh and pre-commit hooks for Rust and Python

* fix: hooks, README

* makeuse: lint.sh in CI

* remove: lint.sh redirect to /dev/null

Author: redpanda-f

.github/workflows/ci.yml

@@ -8,7 +8,7 @@ on:
     branches: [main]
 
 jobs:
-  fmt-clippy:
+  lint:
     runs-on: ubuntu-latest
     timeout-minutes: 10
 
@@ -20,11 +20,8 @@ jobs:
       with:
         components: rustfmt, clippy
 
-    - name: Check formatting
-      run: cargo fmt --all -- --check
-
-    - name: Run clippy
-      run: cargo clippy --all-targets --all-features -- -D warnings
+    - name: Run lint checks
+      run: FIX=0 ./scripts/lint.sh
 
   cargo-test:
     runs-on: ubuntu-latest

README.md

@@ -31,6 +31,18 @@ For GitHub Actions, add this step before running foc-devnet:
 - run: echo '127.0.0.1 host.docker.internal' | sudo tee -a /etc/hosts
 ```
 
+**Linting (rust + python)**:
+```sh
+sudo apt install pipx && pipx ensurepath && pipx install black
+./scripts/lint.sh        # auto-fix mode (default)
+FIX=0 ./scripts/lint.sh # check-only mode (used in CI)
+```
+
+**Pre-commit hook** (optional — runs `lint.sh` before each commit):
+```sh
+./scripts/install_precommit_hooks.sh
+```
+
 ### Step 1: Initialize
 
 ```bash

scripts/install_precommit_hooks.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# install_precommit_hooks.sh — Optionally installs a pre-commit hook that runs lint.sh
+set -euo pipefail
+
+cd "$(cd "$(dirname "$0")/.." && pwd)"
+
+HOOK="$(git rev-parse --git-path hooks)/pre-commit"
+
+mkdir -p "$(dirname "$HOOK")"
+
+if [[ -e "$HOOK" && "${1:-}" != "-f" ]]; then
+  echo "Hook already exists: $HOOK (use -f to overwrite)"
+  exit 1
+fi
+
+cat > "$HOOK" << 'EOF'
+#!/usr/bin/env bash
+exec "$(git rev-parse --show-toplevel)/scripts/lint.sh"
+EOF
+
+chmod +x "$HOOK"
+echo "Installed: $HOOK"