eagre-asn1

eagre-asn1 is an asn1 library for Rust.

It makes heavy use of macros to make the interface easy to use.

Currently only DER and a very small bit of xer is supported.

Documentation

Documentation can be found at https://rahix.github.io/eagre-asn1/

Example

Say you have the following asn1 structure:

User ::= SEQUENCE { username UTF8String, passwordHash [CONTEXT 12] IMPLICIT OctetString, age [APPLICATION 1] EXPLICIT Integer, admin Boolean } In Rust it would look like this:

```rust struct User { pub username: String, pub password_hash: Vec, pub age: i32, pub admin: bool, }

dersequence!{ User: username: NOTAG TYPE String, passwordhash: IMPLICIT TAG CONTEXT 12; TYPE Vec, age: EXPLICIT TAG APPLICATION 1; TYPE i32, admin: NOTAG TYPE bool, } ``` And serializing is as easy as:

```rust use eagre_asn1::der::DER;

let someuser = User { ... }; let encoded = someuser.derbytes().unwrap(); // Send to far away planet let decoded = User::derfrombytes(encoded).unwrap(); asserteq!(some_user, decoded); ```

Implemented Types

• [x] Any types::Any
• [ ] BitString types::BitString
• [ ] BMPString types::BMPString
• [x] Boolean bool
• [x] CharacterString types::CharacterString
• [x] Choice enum
• [ ] Date types::Date
• [ ] DateTime types::DateTime
• [ ] Duration std::time::Duration
• [ ] EmbeddedPDV types::EmbeddedPDV
• [x] Enumeration enum
• [ ] External
• [x] GeneralString types::GeneralString
• [x] GraphicString types::GraphicString
• [x] IA5String types::IA5String
• [ ] InstanceOf
• [x] Integer i32
• [ ] IRI
• [x] Null types::Null
• [x] NumericString types::NumericString
• [ ] ObjectClassField
• [ ] ObjectIdentifier
• [x] OctetString Vec<u8>
• [ ] PrintableString types::PrintableString
• [ ] Real f32
• [ ] RelativeIRI
• [ ] RelativeOID
• [x] Sequence struct
• [x] Sequence Of Vec<T>
• [ ] Set struct
• [ ] Set Of types::SetOf
• [x] T61String types::T61String
• [ ] Time types::Time
• [ ] TimeOfDay types::TimeOfDay
• [x] UniversalString types::UniversalString
• [x] UTF8String String or &str
• [x] VideotexString types::VideotexString
• [x] VisibleString types::VisibleString

License

eagre-asn1 is licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.