6 releases (3 breaking)
|0.4.0||Mar 29, 2019|
|0.3.1||Mar 27, 2019|
|0.3.0||Dec 14, 2018|
|0.2.1||Nov 16, 2018|
|0.1.0||Dec 27, 2017|
#214 in Encoding
10,392 downloads per month
Used in 42 crates (8 directly)
This is a simple library for parsing DER-encoded data.
In particular, this library automates the process of understanding the DER encoded objects in an ASN.1 data stream. These tokens can then be parsed by your library, based on the ASN.1 description in your format.
For convenience, we create the traits
FromASN to abstract the
ability to decode a type from an ASN.1 token stream. If your type implements one
of these traits, your program or library can then use the convenience functions
der_decode to do all the parsing work in one action.
A small ASN.1 parsing library for Rust. In particular, this library is used to translate the binary DER encoding of an ASN.1-formatted document into the core primitives of ASN.1. It is assumed that you can do what you need to from there.
The critical items for this document are the traits
The first takes your data type and encodes it into a
Vec of simple ASN.1
ASN1Blocks). The latter inverts the process.
Items that implement
ToASN1 can be used with the function
to provide single-step encoding of a data type to binary DER encoding.
Similarly, items that are
FromASN can be single-step decoded using
the helper function
You can implement one or both traits, depending on your needs. If you do implement both, the obvious encode/decode quickcheck property is strongly advised.
For decoding schemes that require the actual bytes associated with the
binary representation, we also provide
FromASN1WithBody. This can be
used with the offset information in the primitive
ASN1Blocks to, for
example, validate signatures in X509 documents.
Finally, this library supports ASN.1 class information. I'm still not sure why it's useful, but there it is.
Please send any bug reports, patches, and curses to the GitHub repository