2017-08-28 17:41:32 +02:00
# has
2014-03-04 23:16:26 +01:00
2019-04-04 12:39:17 +02:00
`has` checks presence of various command line tools on the PATH and reports their installed version.
2014-03-04 23:16:26 +01:00
2023-07-28 15:30:34 +02:00
[![Build Status ](https://github.com/kdabir/has/actions/workflows/main.yml/badge.svg )](https://github.com/kdabir/has/actions/workflows/main.yml)
2018-02-03 22:52:36 +01:00
[![Open Source Helpers ](https://www.codetriage.com/kdabir/has/badges/users.svg )](https://www.codetriage.com/kdabir/has)
2018-01-31 05:00:14 +01:00
2018-04-08 19:03:10 +02:00
[![demo ](demo.svg )](demo.svg)
2019-07-13 10:51:20 +02:00
## Quick Start 🚴
2014-03-04 23:16:26 +01:00
2019-07-13 10:51:20 +02:00
Just [install ](#installing ) the `has` script, (there is no dependency apart from `bash` itself). From the command line, pass the list of commands you want to check as arguments to `has` , for example:
2014-03-04 23:16:26 +01:00
2019-04-04 12:39:17 +02:00
```console
$ has node npm java git gradle
✔ node 8.2.1
✔ npm 5.3.0
✔ java 1.8.0
✔ git 2.14.1
✔ gradle 4.0.1
```
2014-03-04 23:16:26 +01:00
2019-07-13 10:41:04 +02:00
If everything is good `has` exits with status code `0` . The exit status code reflects number of commands **not found** on your path.
2017-08-29 08:31:11 +02:00
2019-04-04 12:39:17 +02:00
```console
$ has node go javac
✔ node 8.2.1
✔ go 1.8.3
✘ javac
```
2017-08-29 08:31:11 +02:00
And echo the status:
2019-04-04 12:39:17 +02:00
```console
$ echo $?
1
```
2017-08-29 08:31:11 +02:00
2019-07-13 10:41:04 +02:00
## Use `has` in scripts
`has` can be used in shell scripts to check presence of tool in very readable way
```bash
if has node
then echo you have what it takes 🎉
fi
```
**Pro Tip**: the `has` in above command can be replaced with the entire curl command for to ensure portability of script → `if curl -sL https://git.io/_has | bash -s node then ...`
## Installing 🚀
2017-08-28 18:57:04 +02:00
2019-07-13 10:51:20 +02:00
`has` is a single bash script that does it all. You can [download ](https://raw.githubusercontent.com/kdabir/has/master/has ) the script and make it available on your `$PATH` . However, to make it even simpler, just follow *one* of these methods.
2018-11-17 06:21:49 +01:00
2019-07-13 10:51:20 +02:00
### Homebrew (MacOS) 🍺
2019-06-28 08:24:43 +02:00
Just run the following:
```bash
brew install kdabir/tap/has
```
2018-11-17 06:21:49 +01:00
### Cloning the Repo
2019-04-04 12:39:17 +02:00
Just execute the following command in a terminal: it clones `has` repo and installs it into your path.
2017-08-28 18:57:04 +02:00
2019-04-04 12:39:17 +02:00
```bash
git clone https://github.com/kdabir/has.git & & cd has & & sudo make install
```
2017-08-29 08:31:11 +02:00
2019-04-04 12:39:17 +02:00
For a non-root installation:
```bash
git clone https://github.com/kdabir/has.git
cd has
make PREFIX=$HOME/.local install
```
To update just do a `git fetch` or `make update` followed by the appropriate `make install` command.
2018-11-17 06:21:49 +01:00
2018-11-27 04:00:33 +01:00
### Downloading to a file
2018-11-17 06:21:49 +01:00
2019-04-04 12:39:17 +02:00
```bash
curl -sL https://git.io/_has > /usr/local/bin/has
```
2018-11-17 06:21:49 +01:00
2019-04-04 12:39:17 +02:00
```bash
curl -sL https://git.io/_has | sudo tee /usr/local/bin/has >/dev/null
```
2018-11-17 06:21:49 +01:00
2019-04-04 12:39:17 +02:00
These commands are safe to be called multiple times as well (to update `has` )
2017-08-29 08:31:11 +02:00
2023-07-28 14:53:19 +02:00
### asdf users
```
asdf plugin add has https://github.com/sylvainmetayer/asdf-has
asdf install has 1.4.0
```
2019-04-04 12:39:17 +02:00
### Running directly off the Internet
2017-08-28 18:57:04 +02:00
2019-04-04 12:39:17 +02:00
If you are lazy, you can run `has` directly off the Internet as well:
2017-08-28 18:57:04 +02:00
2019-04-04 12:39:17 +02:00
```console
curl -sL https://git.io/_has | bash -s git node npm
✔ git 2.17.1
✔ node 11.11.0
✔ npm 6.7.0
```
2017-08-28 18:57:04 +02:00
2019-04-04 12:39:17 +02:00
**ProTip**: if that's too much typing every time, setup an alias in your `.bashrc` /`.zshrc` file:
```.bashrc
alias has="curl -sL https://git.io/_has | bash -s"
```
2017-08-28 18:57:04 +02:00
2017-08-31 16:59:01 +02:00
And use it
2017-08-28 18:57:04 +02:00
2019-04-04 12:39:17 +02:00
```console
$ has git
✔ git 2.17.1
$ type has
has is aliased to `curl -sL https://git.io/_has | bash -s'
```
2017-08-28 18:57:04 +02:00
2018-11-27 04:00:33 +01:00
## Command not understood by has?
2017-09-12 06:14:51 +02:00
Let's say `$ has foobar` returns `foobar not understood` , because `has` may not have whitelisted `foobar` .
2023-07-28 14:53:47 +02:00
In such cases, pass `HAS_ALLOW_UNSAFE=y has foobar` . This should still check for existence of `foobar` and tries to detect version as well.
2017-10-14 08:58:53 +02:00
2019-07-13 10:51:20 +02:00
> the value must exactly be `y` for it to work.
2018-11-27 04:00:33 +01:00
## The `.hasrc` file
2018-11-16 12:20:36 +01:00
2019-04-04 12:39:17 +02:00
`has` looks for `.hasrc` file in the directory from where `has` command is issued. This file can contain commands that `has`
2018-11-16 12:20:36 +01:00
will check for. List one command per line. Lines starting with `#` are treated as comments.
Following is example of `.hasrc` file:
2019-04-04 12:39:17 +02:00
```hs
2018-11-16 12:20:36 +01:00
# tools
git
curl
# interpreters
ruby
node
2019-04-04 12:39:17 +02:00
```
2018-11-16 12:20:36 +01:00
2019-04-04 12:39:17 +02:00
When `has` is run in directory containing this file, it produces:
2018-11-16 12:20:36 +01:00
2019-04-04 12:39:17 +02:00
```console
2018-11-16 12:20:36 +01:00
$ has
✔ git 2.19.1
✔ curl 7.54.0
✔ ruby 2.3.1
✔ node 10.7.0
2019-04-04 12:39:17 +02:00
```
2018-11-16 12:20:36 +01:00
Also, CLI arguments passed to `has` are additive to `.hasrc` file. For example, in the same dir, if the following command is fired,
2019-04-04 12:39:17 +02:00
`has` checks for both commands passed from cli args and provided in `.hasrc` file.
2018-11-16 12:20:36 +01:00
2019-04-04 12:39:17 +02:00
```bash
2018-11-16 12:20:36 +01:00
$ has java
✔ java 11.0.1
✔ git 2.19.1
✔ curl 7.54.0
✔ ruby 2.3.1
✔ node 10.7.0
```
2018-11-17 06:21:49 +01:00
**Pro Tip**: commit `.hasrc` file in root of your project. This can work as a quick check for confirming presence all command
2018-11-16 12:49:46 +01:00
line tools required to build and run your project.
2019-04-04 12:39:17 +02:00
On machines that don't even have `has` installed, your project's `.hasrc` is honored by this command:
2018-11-16 12:49:46 +01:00
2019-04-04 12:39:17 +02:00
`curl -sL https://git.io/_has | bash -s`
2018-11-16 12:49:46 +01:00
2019-04-04 12:39:17 +02:00
> take a look at [.hasrc](https://github.com/kdabir/has/blob/master/.hasrc) file for this repo.
2017-10-14 08:58:53 +02:00
## Contributing
2017-08-28 19:20:44 +02:00
2019-04-04 12:39:17 +02:00
1. Star the repo, tweet about it, spread the word
2017-10-14 08:58:53 +02:00
2. Update the documentation (i.e. the README file)
3. Adding support for more commands
4. Adding more features to `has`
2017-08-31 11:17:13 +02:00
2019-07-24 14:26:00 +02:00
## Adding more tools
Verify version for each command (#43)
Thanks to contributions by @sdolenc
* docker files
* list tools for testing
* test packages
* github actions
* documentation
* ensure expected command count
* output count of individual tools tested
* test: eb rg podman subl brunch grunt gulp heroku netlify sls java brew gor, heroku, mvn, netlify, netlifyctl, php5, gcloud, hub, coreutils, brunch, code, kotlin, sbt, go, ant, gem, rake, autojump, groovy, aws, perl6, sbt, scala, lein
2020-04-25 13:18:24 +02:00
The current list of supported packages can be viewed with `bash tests/packages_all.sh`
2019-07-24 14:26:00 +02:00
If the command you wish to include supports any of `-v` , `--version` , `-version` , `version` , `-V` then you can find
corresponding function which can be called to check presence and extract version. However, for many tools version
extraction may not work and you will need to add custom parsing of command's output. The `has` script is commented
to guide developers about what needs to be done to add more tools.
Verify version for each command (#43)
Thanks to contributions by @sdolenc
* docker files
* list tools for testing
* test packages
* github actions
* documentation
* ensure expected command count
* output count of individual tools tested
* test: eb rg podman subl brunch grunt gulp heroku netlify sls java brew gor, heroku, mvn, netlify, netlifyctl, php5, gcloud, hub, coreutils, brunch, code, kotlin, sbt, go, ant, gem, rake, autojump, groovy, aws, perl6, sbt, scala, lein
2020-04-25 13:18:24 +02:00
`/tests/test_all_packages.bats` will test every package has supports. This includes newly added commands so please add new packages to
- `alpine.Dockerfile` and `ubuntu.Dockerfile` to install the tool OR
- `packages_alpine_skip.txt` and `packages_ubuntu_skip.txt` to exclude the package from the tests
2019-07-24 14:26:00 +02:00
2018-11-16 12:20:36 +01:00
## Adding Features
If you are contributing a feature, please ensure to check current tests. Add test cases for your feature. Tests are
2018-11-16 14:13:35 +01:00
executed using the excellent [bats ](https://github.com/bats-core/bats-core ) testing framework. Add tests and run `make test`
2018-11-16 12:20:36 +01:00
2023-07-28 14:51:15 +02:00
Raise the PR and **make sure the tests pass** on [GitHub Actions ](https://github.com/kdabir/has/actions ).
2019-04-04 12:39:17 +02:00
### ♥