Crate eagre_asn1

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.

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:

struct User {
    pub username: String,
    pub password_hash: Vec<u8>,
    pub age: i32,
    pub admin: bool,
}

der_sequence!{
    User:
        username:      NOTAG                       TYPE String,
        password_hash: IMPLICIT TAG CONTEXT 12;    TYPE Vec<u8>,
        age:           EXPLICIT TAG APPLICATION 1; TYPE i32,
        admin:         NOTAG                       TYPE bool,
}

And serializing is as easy as:

use eagre_asn1::der::DER;

let some_user = User { ... };
let encoded = some_user.der_bytes().unwrap();
Send to far away planet
let decoded = User::der_from_bytes(encoded).unwrap();
assert_eq!(some_user, decoded);

Modules

der	DER Implementation
types	Asn1 Types
xer	UNFINISHED XER Implementation

Macros

der_choice	Macro to create choice implementation for enum
der_enumerated	Macro to create enumeration implementation for enum
der_sequence	Macro to create sequence implementation for a struct
implement_xer	Deprecated!