| commit | 52231cba2595ee016c0b4b22221d9848e301be2d | [log] [tgz] |
|---|---|---|
| author | Xin Li <[email protected]> | Mon Apr 29 23:12:53 2024 +0000 |
| committer | Automerger Merge Worker <[email protected]> | Mon Apr 29 23:12:53 2024 +0000 |
| tree | 0db16b037f34fb8efea7f3538a92a1925b9c002a | |
| parent | b834c4744e1235fdb98cf5a19d9a598005cffdc3 [diff] | |
| parent | e5227b4638c483de561209154a132ae9c567a17c [diff] |
[automerger skipped] Empty merge of Android 24Q2 Release (ab/11526283) to aosp-main-future am: e5227b4638 -s ours am skip reason: Merged-In I057da3b394041178ce4d0cd4041919379889efc7 with SHA-1 f0f923c40b is already in history Original change: https://googleplex-android-review.googlesource.com/c/platform/external/rust/crates/const-oid/+/27143972 Change-Id: I16f9c0fe5547d5fe39b2264999a01bcc20105f89 Signed-off-by: Automerger Merge Worker <[email protected]>
Const-friendly implementation of the ISO/IEC Object Identifier (OID) standard as defined in ITU X.660, with support for BER/DER encoding/decoding as well as heapless no_std (i.e. embedded) environments.
Object Identifiers, a.k.a. OIDs, are an International Telecommunications Union (ITU) and ISO/IEC standard for naming any object, concept, or “thing” with a globally unambiguous persistent name.
The ITU‘s X.660 standard provides the OID specification. Every OID is part of a hierarchical namespace which begins with a root OID, which is either the ITU’s root OID (0), the ISO's root OID (1), or the joint ISO/ITU root OID (2).
The following is an example of an OID, in this case identifying the rsaEncryption algorithm:
1.2.840.113549.1.1.1
For more information, see: https://en.wikipedia.org/wiki/Object_identifier
This library supports parsing OIDs in const contexts, e.g.:
use const_oid::ObjectIdentifier; pub const MY_OID: ObjectIdentifier = ObjectIdentifier::new_unwrap("1.2.840.113549.1.1.1");
The OID parser is implemented entirely in terms of const fn and without the use of proc macros.
Additionally, it also includes a const fn OID serializer, and stores the OIDs parsed from const contexts encoded using the BER/DER serialization (sans header).
This allows ObjectIdentifier to impl AsRef<[u8]> which can be used to obtain the BER/DER serialization of an OID, even one declared const.
Additionally, it impls FromStr and TryFrom<&[u8]> and functions just as well as a runtime OID library.
This crate requires Rust 1.57 at a minimum.
We may change the MSRV in the future, but it will be accompanied by a minor version bump.
Licensed under either of:
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.