asn1 0.24.0

ASN.1 (DER) parser and writer for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160

# rust-asn1

[![Dependency Status][deps-rs-image]][deps-rs-link]
[![Documentation][docs-rs-image]][docs-rs-link]

This is a Rust library for parsing and generating ASN.1 data (DER only).

## Installation

Add `asn1` to your `Cargo.toml`:

```console
$ cargo add asn1
```

Builds on Rust 1.83.0 and newer.

`rust-asn1` is compatible with `#![no_std]` environments:

```console
$ cargo add asn1 --no-default-features
```

## Changelog

### Unreleased

### [0.24.0]

#### Added

- Added `Set`, `SetWriter`, and `SetElementWriter` types for parsing and
  writing ASN.1 `SET` values with DER ordering validation.
  ([#600](https://github.com/alex/rust-asn1/pull/600))
- Added an associated error type to the `Asn1Writable`, `SimpleAsn1Writable`
  and `Asn1DefinedByWritable` traits. Types implementing these traits can
  now return a custom error type during serialization, as long as the error
  type is convertible to `WriteError`. ([#597](https://github.com/alex/rust-asn1/pull/597))
- Added `BigInt::bit_length()` and `OwnedBigInt::bit_length()` which return
  the number of significant bits in the integer's magnitude (absolute value).
  ([#603](https://github.com/alex/rust-asn1/pull/603))
- Added `ObjectIdentifier::as_der()`. ([#598](https://github.com/alex/rust-asn1/pull/598))

#### Changes

- `SequenceWriter` is now generic over the error type, which defaults to
  `WriteError`. ([#601](https://github.com/alex/rust-asn1/pull/601))

#### Removed

- `Tag::write_to` has been removed from the public API.
  ([#604](https://github.com/alex/rust-asn1/pull/604))

### [0.23.1]

#### Added

- `Tag` now exposes a `write_to` method that writes the tag's encoded
  representation to a `WriteBuf`.

### [0.23.0]

#### Added

- `Writer` now exposes `write_explicit_element` and `write_implicit_element`
   methods that allow encoding EXPLICIT/IMPLICIT elements when the tag number
   is not known at compile time.

- `NonZero` numbers now implement `Asn1Writable`.

#### Changes

- Updated MSRV to 1.83.0.

### [0.22.0]

#### Added

- Added `Asn1Writable::encoded_length`, `SimpleAsn1Writable::data_length`, and
  `Asn1DefinedByWritable::encoded_length`. Implementing these functions reduces
  the number of re-allocations required when writing. `None` can be returned if
  it is not possible to provide an efficient implementation.

#### Changes

- Updated MSRV to 1.74.0.

### [0.21.3]

#### Added

- `BitString::new` is now `const fn`.

### [0.21.2]

#### Added

- `BigInt::new`, `BigUint::new`, and `DateTime::new` are now `const fn`.

### [0.21.1]

#### Added

- `Parser` now exposes a `peek_tag` method that returns the tag of the next
   element in the parse, without consuming that element.
   ([#532](https://github.com/alex/rust-asn1/pull/532))
- `Parser` now exposes `read_explicit_element` and `read_implicit_element`
   methods that allow parsing EXPLICIT/IMPLICIT elements when the tag number
   is not known at compile time.
- `PrintableString`, `Utf8String`, `BMPString`, and `UniversalString` now
  `#[derive(Hash)]`. ([#536](https://github.com/alex/rust-asn1/pull/536))

### [0.21.0]

#### Changes

- Updated MSRV to 1.65.0.

#### Fixes

- Fixed ["perfect derives"](https://smallcultfollowing.com/babysteps/blog/2022/04/12/implied-bounds-and-perfect-derive/)
  in conjunction with `#[derive(Asn1DefinedByRead)]` and
  `#[derive(Asn1DefinedByWrite)]`.
  ([#506](https://github.com/alex/rust-asn1/pull/506))

### [0.20.0]

#### :rotating_light: Breaking changes

- Removed `Writer::{write_explicit_element, write_optional_explicit_element, write_implicit_element, write_optional_implicit_element}`.
  These can all be better accomplished with the `asn1::Explicit` and
  `asn1::Implicit` types.

#### Fixes

- Fixed ["perfect derives"](https://smallcultfollowing.com/babysteps/blog/2022/04/12/implied-bounds-and-perfect-derive/)
  in conjunction with `#[implicit]` and `#[explicit]`.
  ([#502](https://github.com/alex/rust-asn1/pull/502))

### [0.19.0]

#### :rotating_light: Breaking changes

- `GeneralizedTime` has been renamed to `X509GeneralizedTime`. The type does
  not allow fractional seconds, however this restriction is not actually a DER
  rule, it is specific to X.509.
  ([#494](https://github.com/alex/rust-asn1/pull/494))

- `GeneralizedTime` is a new type that accepts fractional seconds
  replacing the old `GeneralizedTime`.
  ([#492](https://github.com/alex/rust-asn1/pull/492))

- `#[derive(asn1::Asn1Read)]` and `#[derive(asn1::Asn1Write)]` now implement
  ["perfect derives"](https://smallcultfollowing.com/babysteps/blog/2022/04/12/implied-bounds-and-perfect-derive/).
  ([#496](https://github.com/alex/rust-asn1/pull/496))

[deps-rs-image]: https://deps.rs/repo/github/alex/rust-asn1/status.svg
[deps-rs-link]: https://deps.rs/repo/github/alex/rust-asn1
[docs-rs-image]: https://docs.rs/asn1/badge.svg
[docs-rs-link]: https://docs.rs/asn1/