check if programs are installed
Verify tools are on your system and see their versions at a
glance.
A Rust port of the original
has bash script.
has-rs checks for the presence of
command-line tools are available on your system (e.g. in
your
PATH) and reports their installed version. Pass it any
number of program names and it will tell you exactly
which ones are present and which are not.
Additionally, because a missing (non-optional) program causes it to return with a non-zero exit code, it can also be used in scripts that expect a program to be present, or even a program of a certain version.
It is designed to be a drop-in replacement for the original has bash script (referred to as "has-bash" to reduce confusion) but it also includes some great new features, quality of life improvements, and maybe even some bugfixes.
.hasrc file so
contributors can verify their environment
Linux and Windows builds are available on
the
releases page. Download the archive for your platform, extract the
has binary, and place it somewhere on your
PATH.
Releases are compatible with tools like eget2 that can install binaries directly from Forgejo/Gitea releases.
eget2 --codeberg cat-dev-null/has-rs
This project uses
just as a task
runner. Run just --list to see all
available recipes including cross-compilation targets.
git clone https://codeberg.org/cat-dev-null/has-rs
cd has-rs
just build
# or if you prefer to just use cargo
cargo build --release
Pass the tools you want to check as arguments:
$ has node npm git curl ✓ node 20.11.0 ✓ npm 10.2.4 ✓ git 2.43.0 ✓ curl 8.5.0
The exit code reflects the number of tools not found:
$ has node cargo foobar ✓ node 20.11.0 ✗ cargo ✗ foobar $ echo $? 2
Create a .hasrc file in your project root
listing one tool per line. Running has with
no arguments in that directory will check all of them.
.hasrc:git cargo just fish jq
$ has ✓ git 2.43.0 ✓ cargo 1.77.0 ✓ just 1.24.0 ✓ fish 3.7.0 ✓ jq 1.7.1
if has node npm
echo "environment is ready"
endOr with the quiet flag to suppress output:
has -q node npm && echo "ready" || echo "missing dependencies"Beyond parity with has-bash, has-rs ships a few additional features:
Attempt to detect unknown tools via
--version, as a flag rather than
only an env variable.
Check for one tool or another. Only counts as a failure if none are present.
Mark a tool optional with ?; a
missing optional tool never increments the exit
code.
End-of-line comments in .hasrc are
stripped, so you can annotate entries inline.
End-of-line comments in .hasrc are
stripped, so you can annotate entries inline.
Below is a complete list of programs that will be detected without having to
use HAS_ALLOW_UNSAFE=y or --allow-unsafe.
(Wondering what a program is? Hover over for a tooltip!)
If you think you have a program that is worth adding, feel free to submit an issue!
has-rs aims to be as compatible with the bash version as is reasonable. The list below covers everything that is intentionally different.
| Behaviour | has-rs | has-bash |
|---|---|---|
| Help output format |
clap-style (--help)
different
|
custom hand-written help |
| Version output |
has 0.2.3
different
|
v1.5.2 |
| Quiet flag |
-q and --quiet
new
|
-q only |
.hasrc comments |
Supports end-of-line new | Full-line only |
| Allowing unknown programs |
--allow-unsafe
new
|
HAS_ALLOW_UNSAFE env var
only
|
Bypassing .hasrc |
--no-rc
new
|
.hasrc is always read |
| Alternate programs |
Separated with "|"
new
|
Not supported |
| Optional programs |
End with "?"
new
|
Not supported |
| Suppressing soft errors |
--hide-optional
new
|
N/A |
| Backwards compatibility |
has-bash alias
new
|
N/A |
| Unsafe mode as compile-time default |
always-allow-unsafe feature
new
|
Not available |
Additionally, here are the programs that has-rs either newly supports or has improved upon over has-bash (as of v1.5.2):
I'm mostly pushing this to see if I can get release signing to work.
But I also renamed the Cargo package from has-rs to has-cli, for publishing to crates.io. That does not affect the program itself, though.
Also, added a step to CI to verify that the version in Cargo.toml matches the version in Cargo.lock.
--hide-optional flag supresses output of absent alternate or optional programs
A lot of other non-code related work was done since the last release:
release_notes directorychecksums.txt.hasrc file used for testing now includes comments for what each program isThe most notable update is getting has-rs up to date with has-bash v1.5.2.
HAS_ALLOW_UNSAFE) :
Other changes:
✓ instead of ✗)--no-rc flag that disables reading from the rc file if one exists? to the program name--allow-unsafe flag acts like (and supersedes) the HAS_ALLOW_UNSAFE environment variableWARNING: This release is entirely historical. Looking back it is missing some things, has bugs, and generally should not be used.
First release of has-rs!
(Supposed to be a) drop-in replacement for has-bash v1.5.0, with the following functional differences:
-q flag also has the long form --quiet-v/--version flag outputs the version, but in the Rust clap standard formatjq # needed for tooling)has-bash is an alias for hasSpecifically, at the very least: