4 releases

0.2.0 Jul 12, 2021
0.1.2 Mar 30, 2020
0.1.1 Jul 8, 2019
0.1.0 May 18, 2019

#1320 in Network programming

Download history 13028/week @ 2024-06-09 14369/week @ 2024-06-16 12832/week @ 2024-06-23 14013/week @ 2024-06-30 16223/week @ 2024-07-07 14952/week @ 2024-07-14 14185/week @ 2024-07-21 14328/week @ 2024-07-28 15149/week @ 2024-08-04 14346/week @ 2024-08-11 14407/week @ 2024-08-18 13980/week @ 2024-08-25 14222/week @ 2024-09-01 13488/week @ 2024-09-08 13594/week @ 2024-09-15 14622/week @ 2024-09-22

56,816 downloads per month
Used in 16 crates (7 directly)

BSD-2-Clause

25KB
263 lines

ip_network_table

IPv4 and IPv6 network fast lookup table.

Documentation Build Status Coverage Status Crates.io

Description

This crate provides storage and retrieval of IPv4 and IPv6 network prefixes.

Currently, it uses ip_network crate, that provides IP network data structure and fork of treebitmap (fork) as backend, that provides fast lookup times, and a small memory footprint. Backend can be changed in future releases.

Usage

Add this to your Cargo.toml:

[dependencies]
ip_network = "0.4"
ip_network_table = "0.2"

this to your crate root (not necessary when your project is Rust 2018 edition):

extern crate ip_network;
extern crate ip_network_table;

and then you can use it like this:

use std::net::{IpAddr, Ipv6Addr};
use ip_network::{IpNetwork, Ipv6Network};
use ip_network_table::IpNetworkTable;

let mut table = IpNetworkTable::new();
let network = IpNetwork::new(Ipv6Addr::new(0x2001, 0xdb8, 0xdead, 0xbeef, 0, 0, 0, 0), 64).unwrap();
let ip_address = Ipv6Addr::new(0x2001, 0xdb8, 0xdead, 0xbeef, 0, 0, 0, 0x1);

assert_eq!(table.insert(network.clone(), "foo"), None);
// Get value for network from table
assert_eq!(table.longest_match(ip_address), Some((network, &"foo")));

Minimal required version of Rust compiler is 1.31 (because of ip_network crate).

Dependencies

~235KB