ip-parser 0.1.2

ips is a terminal command line tool that parses and filters provided ip addresses. supports whitelisting and blacklisting using provided CIDRs.
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

# ips

## overview   

parses ip addresses from stdin or a provided file and takes into consideration
blacklisted and whitelisted CIDRs.

Blacklisting is done after whitelisting and thus takes precedence.

### implemented features  

- `-k` keep duplicates in output
- `-b <file>` Blacklist ips within newline-delimited File containins CIDRs or IPs
- `-w <file>` Whitelist ips within newline-delimited File containins CIDRs or IPs
- `-i` include ips within provided comma-separated CIDRs 
- `-x` eXclude ips within provided comma-separated CIDRs 

### installation

run `cargo install ip-parser` to install and `ips` to run the program.

### help output

```
ips 1.0.0

USAGE:
    ips [FLAGS] [OPTIONS] [file-name]

FLAGS:
    -h, --help               Prints help information
    -k, --keep-duplicates    non-unique output, keep any duplicates
    -V, --version            Prints version information

OPTIONS:
    -b, --blacklist-file <blacklist-file>    file that contains CIDRs & IP addrs against which to filter output (exlude)
    -i, --include <include>                  single or comma-separated CIDRs for whitelisting
    -w, --whitelist-file <whitelist-file>    file that contains CIDRs & IP addrs against which to filter output
                                             (include)
    -x, --xclude <xclude>                    single or comma-separated CIDRs for blacklisting

ARGS:
    <file-name>    file path from which to parse ip addresses. omitting this forces reading from stdin
```

### usage examples

```
$ cat testfile | ips
1.1.1.1
127.0.0.1
2.2.2.2
$ cat testfile | ips -x 2.2.2.2
1.1.1.1
127.0.0.1
$ cat testfile | ips -i 2.2.2.2
2.2.2.2
$ ips -i 2.2.2.2 testfile
2.2.2.2
$ ips -i 2.2.2.2,1.1.1.1 testfile
1.1.1.1
2.2.2.2
$
```