Add CI.md with local CI docs, update Makefile with ci target

This commit is contained in:
2026-06-20 15:17:42 -03:00
parent 81ab921e3d
commit a345ea5898
2 changed files with 51 additions and 2 deletions
+33
View File
@@ -0,0 +1,33 @@
# Local CI
GitHub Actions is configured but requires billing to be resolved on the account.
Until then, run CI locally with one of these methods:
## Makefile
```bash
make ci
```
Runs ShellCheck, bash syntax check, and markdown lint in sequence.
## act (Docker-based)
Requires Docker Desktop running.
```bash
act -j shellcheck -W .github/workflows/ci.yml --container-architecture linux/amd64
act -j syntax -W .github/workflows/ci.yml --container-architecture linux/amd64
act -j markdown -W .github/workflows/ci.yml --container-architecture linux/amd64
```
Or all at once:
```bash
act --container-architecture linux/amd64
```
## CircleCI
A `.circleci/config.yml` is included. Connect the repo at https://circleci.com to
use it as a free CI alternative (public repos get 6000 free minutes/month).
+18 -2
View File
@@ -1,7 +1,7 @@
.PHONY: lint test build clean .PHONY: lint test build clean ci
lint: lint:
shellcheck unleash lib/*.sh shellcheck unleash lib/*.sh 2>/dev/null || brew install shellcheck && shellcheck unleash lib/*.sh
bash -n unleash lib/*.sh bash -n unleash lib/*.sh
test: test:
@@ -12,3 +12,19 @@ build:
clean: clean:
rm -f unleash-standalone.sh rm -f unleash-standalone.sh
ci:
@echo "=== ShellCheck ===" && \
for f in unleash lib/*.sh examples/*.sh; do \
[ -f "$$f" ] || continue; \
echo " $$f"; shellcheck -S warning "$$f" || fail=1; \
done && \
echo "=== Bash Syntax ===" && \
for f in unleash lib/*.sh examples/*.sh; do \
[ -f "$$f" ] || continue; \
bash -n "$$f" || fail=1; \
done && \
echo "=== Markdown ===" && \
npx markdownlint-cli '*.md' || true && \
echo "=== All checks done ===" && \
[ -z "$$fail" ] || exit 1