ichwh 0.1.2

An async implementation of `which`
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

# `ichwh` - an async implementation of GNU `which`

[![Crates.io](https://img.shields.io/crates/v/ichwh)][cratesio]
[![Gitlab pipeline status](https://img.shields.io/gitlab/pipeline/avandesa/ichwh-rs)][pipeline]

`ichwh` aims to be a fully-async clone of [GNU `which`][gnu], compatible with the three major
operating systems. The main job of `which` is to search for executables on the current `PATH`.

This crate is similar to the synchronous [`which`][which-sync-crate] crate. The main difference is
that `ichwh` is asynchronous, and provides a `which_all` method.

[cratesio]: https://crates.io/crates/ichwh
[pipeline]: https://gitlab.com/avandesa/ichwh-rs/pipelines

[gnu]: https://carlowood.github.io/which/
[which-sync-crate]: https://crates.io/crates/which

## Usage

In `Cargo.toml`:

```toml
ichwh = "*"
```

In your source files:

```rust
use ichwh::which;

let path_to_python = which("python").await.unwrap();
assert_eq!(path_to_python.to_str().unwrap(), "/usr/bin/python");
```

## Testing

Run tests with `cargo test`. The tests will create a set of temporary test folders. They are rooted
at `/tmp/ichwh-test-<num>` (`%TEMP%/...` on windows), where `<num>` is the number of minutes since
the unix epoch. If all tests pass, the folders will be cleaned up. Any failing tests will preserve
their test folders for inspection and debugging.

## Contributing

See CONTRIBUTING.md.