Coverage Report

Created: 2026-05-16 06:09

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/rust/registry/src/index.crates.io-1949cf8c6b5b557f/der-0.7.10/src/decode.rs
Line
Count
Source
1
//! Trait definition for [`Decode`].
2
3
use crate::{FixedTag, Header, Reader, Result, SliceReader};
4
use core::marker::PhantomData;
5
6
#[cfg(feature = "pem")]
7
use crate::{pem::PemLabel, PemReader};
8
9
#[cfg(doc)]
10
use crate::{Length, Tag};
11
12
#[cfg(feature = "alloc")]
13
use alloc::boxed::Box;
14
15
/// Decoding trait.
16
///
17
/// This trait provides the core abstraction upon which all decoding operations
18
/// are based.
19
pub trait Decode<'a>: Sized {
20
    /// Attempt to decode this message using the provided decoder.
21
    fn decode<R: Reader<'a>>(decoder: &mut R) -> Result<Self>;
22
23
    /// Parse `Self` from the provided DER-encoded byte slice.
24
47.3k
    fn from_der(bytes: &'a [u8]) -> Result<Self> {
25
47.3k
        let mut reader = SliceReader::new(bytes)?;
26
47.3k
        let result = Self::decode(&mut reader)?;
27
31.5k
        reader.finish(result)
28
47.3k
    }
<anise::structure::semver::Semver as der::decode::Decode>::from_der
Line
Count
Source
24
23.9k
    fn from_der(bytes: &'a [u8]) -> Result<Self> {
25
23.9k
        let mut reader = SliceReader::new(bytes)?;
26
23.9k
        let result = Self::decode(&mut reader)?;
27
22.8k
        reader.finish(result)
28
23.9k
    }
<anise::structure::dataset::datatype::DataSetType as der::decode::Decode>::from_der
Line
Count
Source
24
8.80k
    fn from_der(bytes: &'a [u8]) -> Result<Self> {
25
8.80k
        let mut reader = SliceReader::new(bytes)?;
26
8.80k
        let result = Self::decode(&mut reader)?;
27
8.68k
        reader.finish(result)
28
8.80k
    }
Unexecuted instantiation: <anise::math::rotation::quaternion::EulerParameter as der::decode::Decode>::from_der
Unexecuted instantiation: <anise::structure::metadata::Metadata as der::decode::Decode>::from_der
Unexecuted instantiation: <anise::structure::location::Location as der::decode::Decode>::from_der
<anise::structure::dataset::DataSet<anise::structure::spacecraft::SpacecraftData> as der::decode::Decode>::from_der
Line
Count
Source
24
6.94k
    fn from_der(bytes: &'a [u8]) -> Result<Self> {
25
6.94k
        let mut reader = SliceReader::new(bytes)?;
26
6.94k
        let result = Self::decode(&mut reader)?;
27
0
        reader.finish(result)
28
6.94k
    }
<anise::structure::dataset::DataSet<anise::structure::planetocentric::PlanetaryData> as der::decode::Decode>::from_der
Line
Count
Source
24
2.98k
    fn from_der(bytes: &'a [u8]) -> Result<Self> {
25
2.98k
        let mut reader = SliceReader::new(bytes)?;
26
2.98k
        let result = Self::decode(&mut reader)?;
27
0
        reader.finish(result)
28
2.98k
    }
<anise::structure::dataset::DataSet<anise::structure::location::Location> as der::decode::Decode>::from_der
Line
Count
Source
24
2.34k
    fn from_der(bytes: &'a [u8]) -> Result<Self> {
25
2.34k
        let mut reader = SliceReader::new(bytes)?;
26
2.34k
        let result = Self::decode(&mut reader)?;
27
0
        reader.finish(result)
28
2.34k
    }
<anise::structure::dataset::DataSet<anise::math::rotation::quaternion::EulerParameter> as der::decode::Decode>::from_der
Line
Count
Source
24
2.32k
    fn from_der(bytes: &'a [u8]) -> Result<Self> {
25
2.32k
        let mut reader = SliceReader::new(bytes)?;
26
2.32k
        let result = Self::decode(&mut reader)?;
27
0
        reader.finish(result)
28
2.32k
    }
Unexecuted instantiation: <anise::structure::planetocentric::PlanetaryData as der::decode::Decode>::from_der
Unexecuted instantiation: <anise::structure::spacecraft::SpacecraftData as der::decode::Decode>::from_der
Unexecuted instantiation: <der::document::Document as der::decode::Decode>::from_der
Unexecuted instantiation: <der::asn1::any::AnyRef as der::decode::Decode>::from_der
29
}
30
31
impl<'a, T> Decode<'a> for T
32
where
33
    T: DecodeValue<'a> + FixedTag,
34
{
35
93.5k
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
93.5k
        let header = Header::decode(reader)?;
37
88.3k
        header.tag.assert_eq(T::TAG)?;
38
85.8k
        T::decode_value(reader, header)
39
93.5k
    }
<der::asn1::octet_string::OctetStringRef as der::decode::Decode>::decode::<der::reader::nested::NestedReader<der::reader::slice::SliceReader>>
Line
Count
Source
35
691
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
691
        let header = Header::decode(reader)?;
37
538
        header.tag.assert_eq(T::TAG)?;
38
371
        T::decode_value(reader, header)
39
691
    }
<der::asn1::octet_string::OctetStringRef as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Line
Count
Source
35
38.5k
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
38.5k
        let header = Header::decode(reader)?;
37
37.9k
        header.tag.assert_eq(T::TAG)?;
38
37.4k
        T::decode_value(reader, header)
39
38.5k
    }
Unexecuted instantiation: <[anise::structure::planetocentric::phaseangle::PhaseAngle<0>; 32] as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Unexecuted instantiation: <alloc::string::String as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
<der::asn1::utf8_string::Utf8StringRef as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Line
Count
Source
35
20.8k
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
20.8k
        let header = Header::decode(reader)?;
37
17.4k
        header.tag.assert_eq(T::TAG)?;
38
16.3k
        T::decode_value(reader, header)
39
20.8k
    }
Unexecuted instantiation: <[f64; 0] as der::decode::Decode>::decode::<der::reader::nested::NestedReader<der::reader::slice::SliceReader>>
Unexecuted instantiation: <[f64; 32] as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Unexecuted instantiation: <bool as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Unexecuted instantiation: <f64 as der::decode::Decode>::decode::<der::reader::nested::NestedReader<der::reader::nested::NestedReader<der::reader::slice::SliceReader>>>
Unexecuted instantiation: <f64 as der::decode::Decode>::decode::<der::reader::nested::NestedReader<der::reader::slice::SliceReader>>
Unexecuted instantiation: <f64 as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Unexecuted instantiation: <u8 as der::decode::Decode>::decode::<der::reader::nested::NestedReader<der::reader::slice::SliceReader>>
<u8 as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Line
Count
Source
35
22.8k
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
22.8k
        let header = Header::decode(reader)?;
37
22.7k
        header.tag.assert_eq(T::TAG)?;
38
22.7k
        T::decode_value(reader, header)
39
22.8k
    }
<i32 as der::decode::Decode>::decode::<der::reader::nested::NestedReader<der::reader::slice::SliceReader>>
Line
Count
Source
35
3.00k
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
3.00k
        let header = Header::decode(reader)?;
37
2.55k
        header.tag.assert_eq(T::TAG)?;
38
2.25k
        T::decode_value(reader, header)
39
3.00k
    }
Unexecuted instantiation: <i32 as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
<u32 as der::decode::Decode>::decode::<der::reader::nested::NestedReader<der::reader::slice::SliceReader>>
Line
Count
Source
35
1.46k
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
1.46k
        let header = Header::decode(reader)?;
37
1.33k
        header.tag.assert_eq(T::TAG)?;
38
1.23k
        T::decode_value(reader, header)
39
1.46k
    }
<u32 as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Line
Count
Source
35
252
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
252
        let header = Header::decode(reader)?;
37
209
        header.tag.assert_eq(T::TAG)?;
38
181
        T::decode_value(reader, header)
39
252
    }
<der::asn1::octet_string::allocating::OctetString as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Line
Count
Source
35
67
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
67
        let header = Header::decode(reader)?;
37
50
        header.tag.assert_eq(T::TAG)?;
38
37
        T::decode_value(reader, header)
39
67
    }
<alloc::vec::Vec<der::asn1::octet_string::OctetStringRef> as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Line
Count
Source
35
934
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
934
        let header = Header::decode(reader)?;
37
885
        header.tag.assert_eq(T::TAG)?;
38
854
        T::decode_value(reader, header)
39
934
    }
Unexecuted instantiation: <alloc::vec::Vec<anise::structure::location::TerrainMask> as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
<alloc::vec::Vec<i32> as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Line
Count
Source
35
2.87k
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
2.87k
        let header = Header::decode(reader)?;
37
2.73k
        header.tag.assert_eq(T::TAG)?;
38
2.69k
        T::decode_value(reader, header)
39
2.87k
    }
<alloc::vec::Vec<u32> as der::decode::Decode>::decode::<der::reader::slice::SliceReader>
Line
Count
Source
35
1.93k
    fn decode<R: Reader<'a>>(reader: &mut R) -> Result<T> {
36
1.93k
        let header = Header::decode(reader)?;
37
1.76k
        header.tag.assert_eq(T::TAG)?;
38
1.69k
        T::decode_value(reader, header)
39
1.93k
    }
Unexecuted instantiation: <_ as der::decode::Decode>::decode::<_>
40
}
41
42
/// Dummy implementation for [`PhantomData`] which allows deriving
43
/// implementations on structs with phantom fields.
44
impl<'a, T> Decode<'a> for PhantomData<T>
45
where
46
    T: ?Sized,
47
{
48
0
    fn decode<R: Reader<'a>>(_reader: &mut R) -> Result<PhantomData<T>> {
49
0
        Ok(PhantomData)
50
0
    }
51
}
52
53
/// Marker trait for data structures that can be decoded from DER without
54
/// borrowing any data from the decoder.
55
///
56
/// This is primarily useful for trait bounds on functions which require that
57
/// no data is borrowed from the decoder, for example a PEM decoder which needs
58
/// to first decode data from Base64.
59
///
60
/// This trait is inspired by the [`DeserializeOwned` trait from `serde`](https://docs.rs/serde/latest/serde/de/trait.DeserializeOwned.html).
61
pub trait DecodeOwned: for<'a> Decode<'a> {}
62
63
impl<T> DecodeOwned for T where T: for<'a> Decode<'a> {}
64
65
/// PEM decoding trait.
66
///
67
/// This trait is automatically impl'd for any type which impls both
68
/// [`DecodeOwned`] and [`PemLabel`].
69
#[cfg(feature = "pem")]
70
pub trait DecodePem: DecodeOwned + PemLabel {
71
    /// Try to decode this type from PEM.
72
    fn from_pem(pem: impl AsRef<[u8]>) -> Result<Self>;
73
}
74
75
#[cfg(feature = "pem")]
76
impl<T: DecodeOwned + PemLabel> DecodePem for T {
77
    fn from_pem(pem: impl AsRef<[u8]>) -> Result<Self> {
78
        let mut reader = PemReader::new(pem.as_ref())?;
79
        Self::validate_pem_label(reader.type_label())?;
80
        T::decode(&mut reader)
81
    }
82
}
83
84
/// Decode the value part of a Tag-Length-Value encoded field, sans the [`Tag`]
85
/// and [`Length`].
86
pub trait DecodeValue<'a>: Sized {
87
    /// Attempt to decode this message using the provided [`Reader`].
88
    fn decode_value<R: Reader<'a>>(reader: &mut R, header: Header) -> Result<Self>;
89
}
90
91
#[cfg(feature = "alloc")]
92
impl<'a, T> DecodeValue<'a> for Box<T>
93
where
94
    T: DecodeValue<'a>,
95
{
96
0
    fn decode_value<R: Reader<'a>>(reader: &mut R, header: Header) -> Result<Self> {
97
0
        Ok(Box::new(T::decode_value(reader, header)?))
98
0
    }
99
}