asn1
asn1 is a pure V Language module for X.690 Abstract Syntax Notation One (ASN.1)
Distinguished Encoding Rules (DER) encoding and decoding.
This module provides you with the ability to generate and parse ASN.1 encoded data. More precisely, it provides you with the ability to generate and parse data encoded with ASN.1’s DER (Distinguished Encoding Rules) encoding. It does not support other than DER.
Caution
This module is marked as an experimental, so its subject to change (possibly rapidly). Use with caution, submit bugs when found, and please gives feedback.
Supported ASN.1 Type
Currently supports the following basic ASN1 types:
- Boolean
- BitString
- Integer (through int, i64, and
math.big.Integer) - ObjectIdentifier
- NumericString
- Null
- Enumerated
- IA5String (ascii string)
- OctetString
- PrintableString
- UTF8String
- UTCTime
- GeneralizedTime
- VisibleString
- Sequence,
- SequenceOf
- Set
- SetOf
Features
- Supports most basic ASN.1 tag types.
- Supports single and multi-byte (high form) tag formats for tag number > 31.
- Serializing and deserializing of ASN.1 objcet to bytes and vice versa.
Code Examples
Here are some simple usage examples.
import x.encoding.asn1
fn main() {
value := asn1.Integer.from_int(32)
output := asn1.encode(value)!
assert output == [u8(0x02), 0x01, 0x20]
// you can encode (serialize) with string options
output2 := asn1.encode_with_options(value, 'context_specific:5;explicit;inner:2')!
assert output2 == [u8(0xa5), 0x03, 0x02, 0x01, 0x20]
// You can decode (deserialize) back the bytes into Element.
el := asn1.decode_with_options([u8(0xa5), 0x03, 0x02, 0x01, 0x20], 'context_specific:5;explicit;inner:2')!
// el is an Element, turn it into underlying object
int_el := el.into_object[asn1.Integer]()!
int_el_value := int_el.as_i64()!
assert int_el_value == 32
}
See more complete examples in the examples directory.
Documentation
See the documentation for more detailed information on how to use functionality in this module.
License
This project is licensed under the MIT License (see LICENSE file)