Merge pull request #34 from CarterPerez-dev/feat/9.98%

Feat/9.98%

Author: CarterPerez-dev

.gitignore

@@ -34,7 +34,7 @@ backend/.env.testing
 .env.development
 .env.production
 .env.testing
-.env
+*.env
 node_modules/
 my-react-app/build/
 AuthKey_8VA5M37ZZZ.p8
@@ -45,3 +45,7 @@ backend/context/
 backend/certgames.egg-info
 conf/nginx/logs/
 NEEDTODO.md
+
+λex/bin/
+λex/src/*.o
+λex/src/nimcache/

Justfile

@@ -0,0 +1,152 @@
+set shell := ["bash", "-cu"]
+
+compose_dev := "dev.yml"
+compose_prod := "prod.yml"
+
+admin_dir := "frontend/admin-app"
+user_dir := "frontend/user-app"
+backend_dir := "backend"
+
+default:
+    @just --list
+
+dev-build:
+    @printf '\033[96m'
+    docker compose -f {{compose_dev}} build
+
+dev-up:
+    @printf '\033[96m[dev environment initiating]\033[0m\n'
+    docker compose -f {{compose_dev}} up -d && docker compose -f {{compose_dev}} logs -f
+
+dev-stop:
+    @printf '\033[93m[halting dev containers]\033[0m\n'
+    docker compose -f {{compose_dev}} stop
+
+dev-down:
+    @printf '\033[91m[terminating dev environment]\033[0m\n'
+    docker compose -f {{compose_dev}} down
+
+dev-rebuild:
+    @printf '\033[95m[full dev cycle initiated]\033[0m\n'
+    docker compose -f {{compose_dev}} down
+    docker compose -f {{compose_dev}} build
+    docker compose -f {{compose_dev}} up -d
+    docker compose -f {{compose_dev}} logs -f
+
+prod-build:
+    @printf '\033[96m[production artifacts compiling]\033[0m\n'
+    docker compose -f {{compose_prod}} build
+
+prod-up:
+    @printf '\033[92m[production deployment initiated]\033[0m\n'
+    docker compose -f {{compose_prod}} up -d && docker compose -f {{compose_prod}} logs -f
+
+prod-stop:
+    @printf '\033[93m[production containers paused]\033[0m\n'
+    docker compose -f {{compose_prod}} stop
+
+prod-down:
+    @printf '\033[91m[production teardown executing]\033[0m\n'
+    docker compose -f {{compose_prod}} down
+
+prod-rebuild:
+    @printf '\033[95m[production full rebuild cycle]\033[0m\n'
+    docker compose -f {{compose_prod}} down
+    docker compose -f {{compose_prod}} build
+    docker compose -f {{compose_prod}} up -d
+    docker compose -f {{compose_prod}} logs -f
+
+eslint:
+    @printf '\033[95m[eslint analysis]\033[0m\n'
+    cd {{admin_dir}} && npm run lint:eslint
+    cd {{user_dir}} && npm run lint:eslint
+
+typelint:
+    @printf '\033[95m[type verification]\033[0m\n'
+    cd {{admin_dir}} && npm run lint:types
+    cd {{user_dir}} && npm run lint:types
+
+scss:
+    @printf '\033[95m[scss correction]\033[0m\n'
+    cd {{admin_dir}} && npm run lint:scss:fix
+    cd {{user_dir}} && npm run lint:scss:fix
+
+ruff:
+    @printf '\033[95m[ruff analysis]\033[0m\n'
+    ruff check {{backend_dir}}
+
+ruff-fix:
+    @printf '\033[93m[ruff correction]\033[0m\n'
+    ruff check --fix {{backend_dir}}
+
+pylint:
+    @printf '\033[95m[pylint scan]\033[0m\n'
+    pylint {{backend_dir}}
+
+mypy:
+    @printf '\033[95m[mypy verification]\033[0m\n'
+    mypy {{backend_dir}}
+
+bandit:
+    @printf '\033[91m[bandit audit]\033[0m\n'
+    bandit -r {{backend_dir}}
+
+prettier:
+    @printf '\033[96m[prettier formatting]\033[0m\n'
+    cd {{admin_dir}} && npm run format
+    cd {{user_dir}} && npm run format
+
+yapf:
+    @printf '\033[96m[yapf transformations]\033[0m\n'
+    yapf -i -r -vv {{backend_dir}}/api/
+
+nuke:
+    @printf '\033[91m[nuclear option engaged]\033[0m\n'
+    @λex/bin/nuke
+
+vitals:
+    @λex/bin/vitals
+
+tail *containers:
+    @λex/bin/tail {{containers}}
+
+rotate target:
+    @λex/bin/rotate {{target}}
+
+tunnel *args:
+    @λex/bin/tunnel {{args}}
+
+scale service count:
+    @λex/bin/scale {{service}} {{count}}
+
+dns domain:
+    @λex/bin/dns {{domain}}
+
+load endpoint:
+    @λex/bin/load {{endpoint}}
+
+compile:
+    @printf '\033[93m[compiling zig artifacts]\033[0m\n'
+    cd λex/src && zig build-exe nuke.zig -O ReleaseFast -femit-bin=../bin/nuke
+    cd λex/src && zig build-exe vitals.zig -O ReleaseFast -femit-bin=../bin/vitals
+    cd λex/src && zig build-exe load.zig -O ReleaseFast -femit-bin=../bin/load
+    @printf '\033[93m[compiling nim artifacts]\033[0m\n'
+    cd λex/src && nim c -d:release --out:../bin/tail tail.nim
+    cd λex/src && nim c -d:release --out:../bin/rotate rotate.nim
+    cd λex/src && nim c -d:release --out:../bin/scale scale.nim
+    @printf '\033[93m[preparing crystal artifacts]\033[0m\n'
+    cd λex/src && crystal build --release dns.cr -o ../bin/dns
+    @printf '\033[93m[preparing raku runtime]\033[0m\n'
+    cp λex/src/tunnel.raku λex/bin/tunnel && chmod +x λex/bin/tunnel
+    @printf '\033[92m[compilation sequence complete]\033[0m\n'
+
+verify:
+    @which zig > /dev/null || printf '\033[91mzig absent: snap install zig --classic\033[0m\n'
+    @which nim > /dev/null || printf '\033[91mnim absent: curl https://nim-lang.org/choosenim/init.sh -sSf | sh\033[0m\n'
+    @which raku > /dev/null || printf '\033[91mraku absent: apt install rakudo\033[0m\n'
+    @which crystal > /dev/null || printf '\033[91mcrystal absent: snap install crystal --classic\033[0m\n'
+
+clean:
+    @rm -f λex/bin/*
+    @rm -rf λex/src/*.o λex/src/nimcache
+    @printf '\033[92m[artifacts purged]\033[0m\n'