Official implementation of the IPGen Spec in Rust
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Rust IPGen Library

Official implementation of the IPGen Spec in Rust

Build Status Latest Version Docs

IPGen is a library for generating unique and reproducible IP addresses in Rust. The IP addresses generated by this library are highly unique (depending on your subnet prefix), yet if you pass it the same input it will produce the same IP address. You can also generate the IP addresses using our command line tool.

Getting Started

Add ipgen as a dependency in your Cargo.toml file.

ipgen = "0.0.4"

Use it in your program as follows:-

extern crate ipgen;

fn main() {
  // Compute subnet ID
  let subnet = ipgen::subnet("App 1"); 
  assert_eq!("ba3d".to_string(), subnet);
  // Or compute an IPv6 address
  // Note you can also pass in an IPv4 network to generate an IPv4
  let ip = ipgen::ip("App 1", "fd52:f6b0:3162::/48").unwrap();
  assert_eq!("fd52:f6b0:3162:46a1:2a4f:89e8:8aed:1327".to_string(), ip.to_string());