[][src]Struct sequoia_openpgp::parse::PacketParserEOF

pub struct PacketParserEOF<'a> { /* fields omitted */ }

Information about the stream of packets parsed by the PacketParser.

Once the PacketParser reaches the end of the input stream, it returns a PacketParserResult::EOF with a PacketParserEOF. This object provides information about the parsed stream, notably whether or not the packet stream was a well-formed Message, Cert or keyring.

Examples

Parse some OpenPGP stream using a PacketParser and detects the kind of data:

use sequoia_openpgp as openpgp;
use openpgp::Packet;
use openpgp::parse::{Parse, PacketParserResult, PacketParser};

let openpgp_data: &[u8] = // ...
let mut ppr = PacketParser::from_bytes(openpgp_data)?;
while let PacketParserResult::Some(mut pp) = ppr {
    // Start parsing the next packet, recursing.
    ppr = pp.recurse()?.1;
}

if let PacketParserResult::EOF(eof) = ppr {
    if eof.is_message().is_ok() {
        // ...
    } else if eof.is_cert().is_ok() {
        // ...
    } else if eof.is_keyring().is_ok() {
        // ...
    } else {
        // ...
    }
}

Implementations

impl<'a> PacketParserEOF<'a>[src]

pub fn is_message(&self) -> Result<()>[src]

Returns whether the stream is an OpenPGP Message.

A Message has a very specific structure. Returns true if the stream is of that form, as opposed to a Cert or just a bunch of packets.

Examples

Parse some OpenPGP stream using a PacketParser and detects the kind of data:

use sequoia_openpgp as openpgp;
use openpgp::Packet;
use openpgp::parse::{Parse, PacketParserResult, PacketParser};

let openpgp_data: &[u8] = // ...
let mut ppr = PacketParser::from_bytes(openpgp_data)?;
while let PacketParserResult::Some(mut pp) = ppr {
    // Start parsing the next packet, recursing.
    ppr = pp.recurse()?.1;
}

if let PacketParserResult::EOF(eof) = ppr {
    if eof.is_message().is_ok() {
        // ...
    }
}

pub fn is_keyring(&self) -> Result<()>[src]

Returns whether the message is an OpenPGP keyring.

A keyring has a very specific structure. Returns true if the stream is of that form, as opposed to a Message or just a bunch of packets.

Examples

Parse some OpenPGP stream using a PacketParser and detects the kind of data:

use sequoia_openpgp as openpgp;
use openpgp::Packet;
use openpgp::parse::{Parse, PacketParserResult, PacketParser};

let openpgp_data: &[u8] = // ...
let mut ppr = PacketParser::from_bytes(openpgp_data)?;
while let PacketParserResult::Some(mut pp) = ppr {
    // Start parsing the next packet, recursing.
    ppr = pp.recurse()?.1;
}

if let PacketParserResult::EOF(eof) = ppr {
    if eof.is_keyring().is_ok() {
        // ...
    }
}

pub fn is_cert(&self) -> Result<()>[src]

Returns whether the message is an OpenPGP Cert.

A Cert has a very specific structure. Returns true if the stream is of that form, as opposed to a Message or just a bunch of packets.

Examples

Parse some OpenPGP stream using a PacketParser and detects the kind of data:

use sequoia_openpgp as openpgp;
use openpgp::Packet;
use openpgp::parse::{Parse, PacketParserResult, PacketParser};

let openpgp_data: &[u8] = // ...
let mut ppr = PacketParser::from_bytes(openpgp_data)?;
while let PacketParserResult::Some(mut pp) = ppr {
    // Start parsing the next packet, recursing.
    ppr = pp.recurse()?.1;
}

if let PacketParserResult::EOF(eof) = ppr {
    if eof.is_cert().is_ok() {
        // ...
    }
}

pub fn last_path(&self) -> &[usize][src]

Returns the path of the last packet.

Examples

Parse some OpenPGP stream using a PacketParser and returns the path (see PacketPile::path_ref) of the last packet:

use sequoia_openpgp as openpgp;
use openpgp::Packet;
use openpgp::parse::{Parse, PacketParserResult, PacketParser};

let openpgp_data: &[u8] = // ...
let mut ppr = PacketParser::from_bytes(openpgp_data)?;
while let PacketParserResult::Some(mut pp) = ppr {
    // Start parsing the next packet, recursing.
    ppr = pp.recurse()?.1;
}

if let PacketParserResult::EOF(eof) = ppr {
    let _ = eof.last_path();
}

pub fn last_recursion_depth(&self) -> Option<isize>[src]

The last packet's recursion depth.

A top-level packet has a recursion depth of 0. Packets in a top-level container have a recursion depth of 1, etc.

Examples

Parse some OpenPGP stream using a PacketParser and returns the recursion depth of the last packet:

use sequoia_openpgp as openpgp;
use openpgp::Packet;
use openpgp::parse::{Parse, PacketParserResult, PacketParser};

let openpgp_data: &[u8] = // ...
let mut ppr = PacketParser::from_bytes(openpgp_data)?;
while let PacketParserResult::Some(mut pp) = ppr {
    // Start parsing the next packet, recursing.
    ppr = pp.recurse()?.1;
}

if let PacketParserResult::EOF(eof) = ppr {
    let _ = eof.last_recursion_depth();
}

pub fn into_reader(self) -> Box<dyn BufferedReader<Cookie> + 'a>[src]

Returns the exhausted reader.

Trait Implementations

impl<'a> Debug for PacketParserEOF<'a>[src]

Auto Trait Implementations

impl<'a> !RefUnwindSafe for PacketParserEOF<'a>[src]

impl<'a> Send for PacketParserEOF<'a>[src]

impl<'a> Sync for PacketParserEOF<'a>[src]

impl<'a> Unpin for PacketParserEOF<'a>[src]

impl<'a> !UnwindSafe for PacketParserEOF<'a>[src]

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> Same<T> for T

type Output = T

Should always be Self

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.