justfile

export RUSTFLAGS := `[ -x /usr/bin/lld ] && echo "-C link-arg=-fuse-ld=lld" || echo ''`

publish-registry := "crates-io"

cargo +args='':
    cargo {{args}}

check +args='':
    @just cargo check {{args}}

debug-build binary_name +args='':
    @just cargo build --bin {{binary_name}} {{args}}

release-build binary_name +args='':
    @just cargo build --bin {{binary_name}} --release {{args}}

verify-clean-git:
    test "$(echo `git status --porcelain` | wc -c)" -eq "1"

get-crate-version:
    @cat Cargo.toml | toml2json | jq -r '.package.version'

verify-release-tag-does-not-exist:
    VERSION=$(just get-crate-version) \
        && test -z "$(git tag | rg \"v${VERSION}\")" # Error: tag appears to exist already

# this is not really inteneded to use, just notes so I can remember next time
# how to setup cross-compile for aarch64 of x86_64 linux ubuntu
setup-cross-compile-aarch64:
    rustup target add --toolchain nightly aarch64-unknown-linux-gnu
    sudo apt-get install gcc-aarch64-linux-gnu
    # then add this to ~/.cargo/config.toml
    # 
    # ```
    # [target.aarch64-unknown-linux-gnu]
    # linker = "aarch64-linux-gnu-gcc"
    # ```

pre-release-cross-compile-aarch64:
    RUSTFLAGS='' cargo test --target aarch64-unknown-linux-gnu --no-run \
        && RUSTFLAGS='' cargo test --target aarch64-unknown-linux-gnu --features smol_str --no-run

pre-release:
    just cargo check \
        && just cargo test \
        && just cargo clippy \
        && just cargo check --features smol_str \
        && just cargo test --features smol_str \
        && just cargo clippy --features smol_str \
        && just pre-release-cross-compile-aarch64 \
        && echo "awesome job!"

publish +args='': verify-clean-git verify-release-tag-does-not-exist pre-release
    @just cargo publish --registry {{publish-registry}} {{args}}
    echo "tagging release"
    git tag "v$(just get-crate-version)"
    git push
    git push --tags
    rm -rf target/package

example name +args='':
    @just cargo build --example {{name}} {{args}}

test +args='':
    @just cargo test {{args}}

# cargo doc --open
doc +args='':
    @just cargo doc --open {{args}}

# just rebuild docs, don't open browser page again
redoc +args='': 
    @just cargo doc {{args}}

# like doc, but include private items
doc-priv +args='':
    @just cargo doc --open --document-private-items {{args}}

bench +args='':
    @just cargo bench {{args}}

update +args='':
    @just cargo update {{args}}

# blow away build dir and start all over again
rebuild:
    just cargo clean
    just update
    just test

# display env variables that will be used for building
show-build-env:
    @ env | rg RUST --color never