Object Identifiers are a standard of the ITU used to reference objects, things, and concepts in a globally unique way. This crate provides for data structures and methods to build, parse, and format OIDs.

You can run the example code from examples/basic.rs using cargo:

cargo run --example basic

use oid::prelude::*;
let oid = ObjectIdentifier::try_from("0.1.2.3")?;

use oid::prelude::*;
let oid = ObjectIdentifier::try_from(vec![0x00, 0x01, 0x02, 0x03])?;

use oid::prelude::*;
let oid = ObjectIdentifier::try_from("0.1.2.3")?;
let oid: String = oid.into();
assert_eq!(oid, "0.1.2.3");

use oid::prelude::*;
let oid = ObjectIdentifier::try_from(vec![0x00, 0x01, 0x02, 0x03])?;
let oid: Vec<u8> = oid.into();
assert_eq!(oid, "0.1.2.3");

cargo add oid

cargo add oid --no-default-features

[dependencies]
oid = "0.1.0"

[dependencies]
oid = { default-features = false }

The build routines have been automated with cargo-make. If you're not using cargo-make, you can check [Makefile.toml] for the relevant manual build procedures.

cargo make

cargo make build_no_std

Profiles for cargo-fuzz are included for fuzzing the inputs on public method parameters.

cargo make fuzz_parse_binary

cargo make fuzz_parse_string

Thanks goes to these wonderful people (emoji key):

Benoît C. ⚠️ 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Licensed under either of Apache License, Version 2.0 or MIT license at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this library by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.