route-summarization 0.1.0

Aggregate IPv4/IPv6 CIDR prefixes into their minimal covering set, with SPF ip4:/ip6: support
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

# CIDR Route Summarization (Rust)

`aggregate-cidr` collapses IPv4 and IPv6 prefixes into their minimal covering
set, with optional SPF `ip4:` / `ip6:` input and output. No dependencies.

A Rust rewrite of [nabbi/route-summarization](https://github.com/nabbi/route-summarization)
(Perl), with that version's quirks fixed.

```console
$ printf '10.0.0.0/24\n10.0.1.0/24\n2001:db8::1\n' | aggregate-cidr
10.0.0.0/23
2001:db8::1
```

To replace the Perl version in place, symlink it:
`ln -sf /usr/local/bin/aggregate-cidr /usr/local/bin/aggregateCIDR.pl`
([details and rollback](docs/perl-differences.md#switching-over)).

## Build

```bash
cargo build --release --locked     # target/release/aggregate-cidr
cargo test
```

Requires Rust 1.85 or newer.

## Docs

- [Usage](docs/usage.md): options, input formats, output, library API
- [Migrating from the Perl version](docs/perl-differences.md): symlink switch-over, rollback, what changed
- [Testing](docs/testing.md): fuzz harness and the differential test against Perl
- [Deployment](docs/deployment.md): installing, and replacing the Perl version

## License

GPL-3.0-or-later. See [LICENSE](LICENSE) and [NOTICE](NOTICE), which also covers
attribution for the original concept. The Perl version remains MIT.