z-rs 0.1.0

z_rs implements a directory jumping command line utility
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# z-rs

![Continuous Integration](https://github.com/suyash/z-rs/workflows/Continuous%20Integration/badge.svg)

z_rs implements a directory jumping command line utility

The original is a 200 line shell classic
https://github.com/rupa/z/blob/master/z.sh

This is an **opinionated** rewrite instead of being 1:1
with the original. Most notably, this does not override
`cd` in any way, and needs to be used instead of `cd` to
build the cache.

This provides a `z_rs` binary, which can be invoked
for configuration and lookup.

## Installation

```sh
cargo install z-rs
```

## Configuration

add

```sh
eval "$(z_rs init --cmd z --cache $HOME/.z_rs)"
```

in your shell configuration file.

The `--cmd` option is the name of the command that will
be added to the shell. For example, in this case, a `z`
command will be created.

## Usage

If configured with the command name `z`, then simply do

```sh
z foo bar
```

will try to match `foo` and `bar` and if a match is found
in the cache, will `cd` to it, otherwise error out.

Matches occur based on "frecency". The rank of a path is
how many times it has been accessed. The command will return
the highest ranked matching record. If there are multiple,
it will return the most recently accessed one.

## License

This project is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See [LICENSE-APACHE](LICENSE-APACHE) and [LICENSE-MIT](LICENSE-MIT) for details.