ip2asn-cli 0.1.2

CLI for the ip2asn crate.
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

# ip2asn-cli

[![crates.io](https://img.shields.io/crates/v/ip2asn-cli.svg?style=flat-square)](https://crates.io/crates/ip2asn-cli)
[![docs.rs](https://img.shields.io/docsrs/ip2asn-cli?style=flat-square)](https://docs.rs/ip2asn-cli)

A high-performance, command-line tool for quickly looking up IP address to
Autonomous System (AS) information.

-----

## Quick Start

### Basic Lookup

The primary use is to look up an IP address directly.

```sh
# Look up a single IP
$ ip2asn 8.8.8.8
15169 | 8.8.8.8 | 8.8.8.0/24 | GOOGLE | US
```

### Advanced Usage

You can look up multiple IPs or pipe them from standard input.

```sh
# Look up multiple IPs from arguments
$ ip2asn 1.1.1.1 9.9.9.9
13335 | 1.1.1.1 | 1.1.1.0/24 | CLOUDFLARENET | US
19281 | 9.9.9.9 | 9.9.9.0/24 | QUAD9-AS-CH | CH

# Read IPs from stdin
$ echo "208.67.222.222" | ip2asn
22822 | 208.67.222.222 | 208.67.222.0/24 | OPENDNS | US
```

For scripting, JSON output is available.

```sh
$ ip2asn --json 1.1.1.1
{"ip":"1.1.1.1","found":true,"info":{"network":"1.1.1.0/24","asn":13335,"country_code":"US","organization":"CLOUDFLARENET"}}
```

-----

## Installation

Install using `cargo`:

```sh
cargo install ip2asn-cli
```

-----

## Configuration

You can control the tool's behavior by creating a configuration file at `~/.config/ip2asn/config.toml`.

**`config.toml`**
```toml
# Set to false to disable the automatic 24-hour update check.
# The `update` subcommand will still work.
# Defaults to false.
auto_update = true
```

-----

## Dataset Management

`ip2asn-cli` handles the IP-to-ASN dataset for you.

*   **Automatic Download**: On the first run, the tool downloads the latest dataset from [iptoasn.com](https://iptoasn.com).
*   **Caching**: The dataset is cached at `~/.cache/ip2asn/data.tsv.gz`.
*   **Auto-Updates**: If the cached data is over 24 hours old, the tool checks for a newer version and downloads it. This can be disabled in the configuration.
*   **Manual Updates**: You can force an update at any time with the `update` command.
    ```sh
    $ ip2asn update
    ```

-----

## License

This project is licensed under the **MIT License**.