close_enough 0.4.0

Simple fuzzy-searching function and command line tool.
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

close_enough
===

[![Crates.io](https://img.shields.io/crates/v/close_enough.svg)](https://crates.io/crates/close_enough)
[![Docs.rs](https://docs.rs/close_enough/badge.svg)](https://docs.rs/close_enough/0.4.0/close_enough/)

Simple fuzzy-searching function and command line tool.


Installation
---

`cargo install close_enough`


### Installing the `ce` command

This is a `cd`-like command for fuzzily changing directories. See examples further down.

1.  Install `close_enough` as above
2.  Run `cle -ce-script bash > ce.sh` to generate the shell script
    - If you also want to use the `hop` command, you should use: `cle -ce-script bash --with-hop > ce.sh`
3.  Source `ce.sh` in your `.bashrc`, `.profile`, or similar

### Installing the `hop` command

This allows you to track recently used folders (you can define wrappers around `cd` or `ce` to do this automatically) and hop directly to them with a fuzzy match.

1.  Install `close_enough` as above
2.  Run `cle -hop-script bash > hop.sh` to generate the shell script
3.  Source `hop.sh` in your `.bashrc` etc.


Usage
---

### cle

```sh
~$ cle duck --inputs blue_and_gold_macaw duck_billed_platypus angry_dog
> duck_billed_platypus

~$ cle dbp --inputs blue_and_gold_macaw duck_billed_platypus angry_dog
> duck_billed_platypus
```

```sh
~$ ls
> my_file.txt  their_file.txt  your_file.txt
~$ ls | cle my
> my_file.txt
```


### ce

```sh
~$ ce my lo dir pa
~/my/long/directory/path$
```

```sh
~/my/long/directory/path$ ce ..
~/my/long/directory$
```

```sh
~/my/long/directory/path$ ce ..3
~/my$
```

```sh
~/my/long/directory/path$ ce ..my other dir pa
~/my/other/directory/path$
```

```sh
~$ ce / u lo sh
/usr/local/share$ ce ~
~$
```


### hop

```sh
~$ ce my dir 1
~/my/directories/d1$ ce .. 2
~/my/directories/d2$ cd
~$ # If you used --with-hop then hop will have tracked the d1 and d2 dirs
~$ hop to d1
~/my/directories/d1$ hop to d2
~/my/directories/d2$
```