just/justfile

277 lines
5.8 KiB
Makefile
Raw Normal View History

#!/usr/bin/env -S just --justfile
# ^ A shebang isn't required, but allows a justfile to be executed
# like a script, with `./justfile test`, for example.
alias t := test
2017-11-16 23:30:08 -08:00
alias c := check
2017-11-16 23:30:08 -08:00
log := "warn"
export JUST_LOG := log
2024-01-08 23:52:15 -08:00
watch +args='test':
cargo watch --clear --exec '{{ args }}'
2024-07-16 11:27:29 -07:00
[group: "testing"]
[doc: "Run just test suite"]
test:
cargo test
2017-11-16 23:30:08 -08:00
ci: lint build-book
cargo test --all
2024-07-16 11:27:29 -07:00
# Run lint checks
[group: "code-checking"]
lint:
2023-10-16 20:07:09 -07:00
cargo clippy --all --all-targets -- --deny warnings
./bin/forbid
cargo fmt --all -- --check
cargo update --locked --package just
2024-07-16 11:27:29 -07:00
[group: "testing"]
[doc: "Run fuzz tests"]
2018-10-13 03:12:35 -07:00
fuzz:
cargo +nightly fuzz run fuzz-compiler
2018-10-13 03:12:35 -07:00
run:
cargo run
# only run tests matching PATTERN
2024-07-16 11:27:29 -07:00
[group: "testing"]
filter PATTERN:
cargo test {{PATTERN}}
2024-07-16 11:27:29 -07:00
# Build just
[group: "developer-workflow"]
2016-10-28 15:25:59 -07:00
build:
cargo build
2016-10-28 15:25:59 -07:00
2024-07-16 11:27:29 -07:00
[group: "code-checking"]
fmt:
cargo fmt --all
2024-07-16 11:27:29 -07:00
[group: "code-checking"]
shellcheck:
shellcheck www/install.sh
2024-07-16 11:27:29 -07:00
# Generate the just manpage
[group: "documentation"]
man:
2024-06-05 12:17:05 -07:00
mkdir -p man
2024-05-15 00:28:50 -07:00
cargo run -- --man > man/just.1
2024-07-16 11:27:29 -07:00
# View the Just manpage
[group: "documentation"]
view-man: man
man man/just.1
# add git log messages to changelog
2024-07-16 11:27:29 -07:00
[group: "developer-workflow"]
update-changelog:
echo >> CHANGELOG.md
git log --pretty='format:- %s' >> CHANGELOG.md
2024-07-16 11:27:29 -07:00
# Update the contributors file
[group: "developer-workflow"]
update-contributors:
cargo run --release --package update-contributors
2024-07-16 11:27:29 -07:00
[group: "code-checking"]
2022-01-30 12:16:10 -08:00
check: fmt clippy test forbid
#!/usr/bin/env bash
set -euxo pipefail
git diff --no-ext-diff --quiet --exit-code
2022-01-30 12:16:10 -08:00
VERSION=`sed -En 's/version[[:space:]]*=[[:space:]]*"([^"]+)"/\1/p' Cargo.toml | head -1`
grep "^\[$VERSION\]" CHANGELOG.md
2019-04-15 23:39:18 -07:00
outdated:
cargo outdated -R
# publish current GitHub master branch
2024-07-16 11:27:29 -07:00
[group: "developer-workflow"]
publish:
#!/usr/bin/env bash
set -euxo pipefail
rm -rf tmp/release
git clone git@github.com:casey/just.git tmp/release
cd tmp/release
! grep '<sup>master</sup>' README.md
VERSION=`sed -En 's/version[[:space:]]*=[[:space:]]*"([^"]+)"/\1/p' Cargo.toml | head -1`
git tag -a $VERSION -m "Release $VERSION"
git push origin $VERSION
cargo publish
cd ../..
rm -rf tmp/release
2016-10-08 17:55:17 -07:00
2024-07-16 11:27:29 -07:00
[group: "documentation"]
[doc: "Search for master version note subscripts in the README"]
readme-version-notes:
grep '<sup>master</sup>' README.md
2024-07-16 11:27:29 -07:00
[group: "developer-workflow"]
[doc: "Push to GitHub"]
push: check
! git branch | grep '* master'
git push github
2024-07-16 11:27:29 -07:00
[group: "developer-workflow"]
[doc: "Create a pull request"]
pr: push
gh pr create --web
# clean up feature branch BRANCH
done BRANCH=`git rev-parse --abbrev-ref HEAD`:
git checkout master
git diff --no-ext-diff --quiet --exit-code
git pull --rebase github master
git diff --no-ext-diff --quiet --exit-code {{BRANCH}}
git branch -D {{BRANCH}}
# install just from crates.io
install:
cargo install -f just
# install development dependencies
install-dev-deps:
rustup install nightly
rustup update nightly
cargo +nightly install cargo-fuzz
cargo install cargo-check
cargo install cargo-watch
cargo install mdbook mdbook-linkcheck
# everyone's favorite animate paper clip
2024-07-16 11:27:29 -07:00
[group: "code-checking"]
2017-11-30 09:13:13 -08:00
clippy:
cargo clippy --all --all-targets --all-features
2021-05-10 23:58:05 -07:00
forbid:
./bin/forbid
2021-05-10 23:58:05 -07:00
# count non-empty lines of code
2024-07-16 11:27:29 -07:00
[group: "developer-workflow"]
2016-10-27 09:50:06 -07:00
sloc:
@cat src/*.rs | sed '/^\s*$/d' | wc -l
2016-10-27 09:50:06 -07:00
2017-11-16 23:30:08 -08:00
replace FROM TO:
sd '{{FROM}}' '{{TO}}' src/*.rs
2017-11-16 13:25:24 -08:00
2024-07-16 11:27:29 -07:00
[group: "demo-recipes"]
test-quine:
cargo run -- quine
2016-10-03 23:55:55 -07:00
# make a quine, compile it, and verify it
2024-07-16 11:27:29 -07:00
[group: "demo-recipes"]
quine:
mkdir -p tmp
@echo '{{quine-text}}' > tmp/gen0.c
cc tmp/gen0.c -o tmp/gen0
./tmp/gen0 > tmp/gen1.c
cc tmp/gen1.c -o tmp/gen1
./tmp/gen1 > tmp/gen2.c
diff tmp/gen1.c tmp/gen2.c
rm -r tmp
@echo 'It was a quine!'
2016-09-27 22:49:17 -07:00
quine-text := '
int printf(const char*, ...);
int main() {
char *s =
"int printf(const char*, ...);"
"int main() {"
" char *s = %c%s%c;"
" printf(s, 34, s, 34);"
" return 0;"
"}";
printf(s, 34, s, 34);
return 0;
}
'
2024-07-16 11:27:29 -07:00
[group: "documentation"]
render-readme:
#!/usr/bin/env ruby
require 'github/markup'
$rendered = GitHub::Markup.render("README.adoc", File.read("README.adoc"))
File.write('tmp/README.html', $rendered)
2024-07-16 11:27:29 -07:00
[group: "documentation"]
watch-readme:
just render-readme
fswatch -ro README.adoc | xargs -n1 -I{} just render-readme
2024-07-16 11:27:29 -07:00
# Test shell completions
[group: "testing"]
test-completions:
./tests/completions/just.bash
2024-07-16 11:27:29 -07:00
[group: "documentation"]
2022-06-12 18:02:09 -07:00
build-book:
cargo run --package generate-book
mdbook build book/en
mdbook build book/zh
2023-01-16 00:42:34 -08:00
convert-integration-test test:
cargo expand --test integration {{test}} | \
sed \
-E \
-e 's/#\[cfg\(test\)\]/#\[test\]/' \
-e 's/^ *let test = //' \
-e 's/^ *test[.]/./' \
-e 's/;$//' \
-e 's/crate::test::Test/Test/' \
-e 's/\.run\(\)/.run();/'
# run all polyglot recipes
2024-07-16 11:27:29 -07:00
[group: "demo-recipes"]
polyglot: _python _js _perl _sh _ruby
_python:
#!/usr/bin/env python3
print('Hello from python!')
2016-10-07 17:56:39 -07:00
_js:
#!/usr/bin/env node
console.log('Greetings from JavaScript!')
2016-10-07 17:56:39 -07:00
_perl:
#!/usr/bin/env perl
print "Larry Wall says Hi!\n";
2016-10-07 17:56:39 -07:00
_sh:
#!/usr/bin/env sh
hello='Yo'
echo "$hello from a shell script!"
2016-10-07 17:56:39 -07:00
_nu:
#!/usr/bin/env nu
let hellos = ["Greetings", "Yo", "Howdy"]
$hellos | each {|el| print $"($el) from a nushell script!" }
_ruby:
#!/usr/bin/env ruby
puts "Hello from ruby!"
# Print working directory, for demonstration purposes!
2024-07-16 11:27:29 -07:00
[group: "demo-recipes"]
pwd:
echo {{invocation_directory()}}
2024-07-16 11:27:29 -07:00
[group: "testing"]
test-bash-completions:
rm -rf tmp
mkdir -p tmp/bin
cargo build
cp target/debug/just tmp/bin
./tmp/bin/just --completions bash > tmp/just.bash
echo 'mod foo' > tmp/justfile
echo 'bar:' > tmp/foo.just
cd tmp && PATH="`realpath bin`:$PATH" bash --init-file just.bash
# Local Variables:
# mode: makefile
# End:
# vim: set ft=make :