netaddr2

Crates.ionetaddr2
lib.rsnetaddr2
version0.10.0
sourcesrc
created_at2019-07-23 15:33:31.735924
updated_at2021-07-06 12:31:24.23731
descriptionA Rust network address parsing and arithmetic library
homepagehttps://rye.github.io/rust-netaddr2
repositoryhttps://github.com/rye/rust-netaddr2
max_upload_size
id151058
size82,592
Kristofer Rye (rye)

documentation

https://docs.rs/netaddr2

README

rust-netaddr2 (netaddr2) • Build Status codecov version downloads docs.rs

This crate is meant as a replacement for an existing reimplementation of various "netaddr" libraries that other languages have. There does exist another netaddr crate, however the author of this crate did not respond when asked about maintainership status.

What it does

NetAddr arose out of a need to mask and subnet IP space in a manner identical to that which routers and network interfaces do. Its utility may be most fully realized in the development of tooling for such purposes.

Usage

There are a few ways to use this library. Perhaps most ergonomical of these is to use the FromStr trait:

let net: NetAddr = "ff02::1/128".parse().unwrap();
let net: Netv4Addr = "203.0.113.19/29".parse().unwrap();

(More options will be added eventually.)

Vision

This crate aims to be as simple and straightforward as possible. We accomplish this by mirroring the structure of the std::net::Ip.*Addr data structures. Most of the operations on NetAddr structs are implemented through the use of traits which are implemented both on the main structures and on the enum that bridges them. These are also implemented, where appropriate, for standard library structures.

This crate has no dependencies, and will not accept any unless required for no_std support. The only part of this crate that uses std is the part that bridges with std::net::IpAddr, so a potential contribution would be to generalize std::net::IpAddr in a no_std environment.

Maintenance Status

This codebase is still not feature-complete. Check out the issue tracker if you want to contribute, and don't hesistate to ask for something in an Issue. That said, the business logic is tested and should work. We will release version 1.0 when the GitHub milestone has been fully resolved.

License

Copyright © 2019 Kristofer J. Rye

This software is released under either of:

at your discretion. Please see the license file (LICENSE.md) for more information.

Acknowledgements

We would like to thank the developers of the netaddr Ruby gem for inspiring the development and ergonomics of this project.

Commit count: 459

cargo fmt