ssh-encoding 0.3.0-rc.9

Pure Rust implementation of SSH data type decoders/encoders as described in RFC4251
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

use super::{PemLabel, reader::PemReader};
use crate::{Decode, Error, Reader};

/// Decoding trait for PEM documents.
///
/// This is an extension trait which is auto-impl'd for types which impl the [`Decode`],
/// [`PemLabel`], and [`Sized`] traits.
#[diagnostic::on_unimplemented(
    note = "Consider adding impls of `Decode` and `PemLabel` to `{Self}`"
)]
pub trait DecodePem: Decode + PemLabel + Sized {
    /// Decode the provided PEM-encoded string, interpreting the Base64-encoded body of the document
    /// using the [`Decode`] trait.
    ///
    /// # Errors
    /// - Returns [`Error::Pem`] in the event of PEM decoding errors.
    /// - Propagates errors returned from the [`Decode::decode`] method.
    fn decode_pem(pem: impl AsRef<[u8]>) -> Result<Self, Self::Error>;
}

impl<T: Decode + PemLabel + Sized> DecodePem for T {
    fn decode_pem(pem: impl AsRef<[u8]>) -> Result<Self, Self::Error> {
        let mut reader = PemReader::new(pem.as_ref())?;
        Self::validate_pem_label(reader.type_label()).map_err(Error::from)?;

        let ret = Self::decode(&mut reader)?;
        Ok(reader.finish(ret)?)
    }
}