Struct x509_parser::certificate::X509CertificateParser

pub struct X509CertificateParser { /* private fields */ }

X.509 Certificate parser

This object is a parser builder, and allows specifying parsing options. Currently, the only option is to control deep parsing of X.509v3 extensions: a parser can decide to skip deep-parsing to be faster (the structure of extensions is still parsed, and the contents can be parsed later using the from_der method from individual extension objects).

This object uses the nom::Parser trait, which must be imported.

Example

To parse a certificate without parsing extensions:

use x509_parser::certificate::X509CertificateParser;
use x509_parser::nom::Parser;

// create a parser that will not parse extensions
let mut parser = X509CertificateParser::new()
    .with_deep_parse_extensions(false);
let res = parser.parse(DER);
match res {
    Ok((_rem, x509)) => {
        let subject = x509.subject();
        let issuer = x509.issuer();
        println!("X.509 Subject: {}", subject);
        println!("X.509 Issuer: {}", issuer);
    },
    _ => panic!("x509 parsing failed: {:?}", res),
}

Implementations

impl X509CertificateParser

pub const fn new() -> Self

pub const fn with_deep_parse_extensions(
    self,
    deep_parse_extensions: bool
) -> Self

Trait Implementations

impl Clone for X509CertificateParser

fn clone(&self) -> X509CertificateParser

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for X509CertificateParser

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Parser<&'a [u8], X509Certificate<'a>, X509Error> for X509CertificateParser

fn parse(
    &mut self,
    input: &'a [u8]
) -> IResult<&'a [u8], X509Certificate<'a>, X509Error>

A parser takes in input type, and returns a Result containing either the remaining input and the output value, or an error

fn map<G, O2>(self, g: G) -> Map<Self, G, O> where
    G: Fn(O) -> O2, 

Maps a function over the result of a parser

fn flat_map<G, H, O2>(self, g: G) -> FlatMap<Self, G, O> where
    G: FnMut(O) -> H,
    H: Parser<I, O2, E>, 

Creates a second parser from the output of the first one, then apply over the rest of the input

fn and_then<G, O2>(self, g: G) -> AndThen<Self, G, O> where
    G: Parser<O, O2, E>, 

Applies a second parser over the output of the first one

fn and<G, O2>(self, g: G) -> And<Self, G> where
    G: Parser<I, O2, E>, 

Applies a second parser after the first one, return their results as a tuple

fn or<G>(self, g: G) -> Or<Self, G> where
    G: Parser<I, O, E>, 

Applies a second parser over the input if the first one failed

fn into<O2, E2>(self) -> Into<Self, O, O2, E, E2> where
    O2: From<O>,
    E2: From<E>, 

automatically converts the parser’s output and error values to another type, as long as they implement the From trait

impl PartialEq<X509CertificateParser> for X509CertificateParser

fn eq(&self, other: &X509CertificateParser) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &X509CertificateParser) -> bool

This method tests for !=.

impl Copy for X509CertificateParser

impl StructuralPartialEq for X509CertificateParser