Struct sequoia_openpgp::serialize::stream::Message [−][src]
pub struct Message<'a>(_);
Streams an OpenPGP message.
Wraps an io::Write
r for use with the streaming subsystem. The
Message
is a stack of filters that create the desired message
structure. Literal data must be framed using the
LiteralWriter
filter. Once all the has been written, the
Message
must be finalized using Message::finalize
.
Implementations
impl<'a> Message<'a>
[src]
impl<'a> Message<'a>
[src]pub fn new<W: 'a + Write + Send + Sync>(w: W) -> Message<'a>ⓘ
[src]
pub fn new<W: 'a + Write + Send + Sync>(w: W) -> Message<'a>ⓘ
[src]Starts streaming an OpenPGP message.
Examples
use sequoia_openpgp as openpgp; use openpgp::serialize::stream::{Message, LiteralWriter}; let message = Message::new(&mut sink); // Construct the writer stack here. let mut message = LiteralWriter::new(message).build()?; // Write literal data to `message` here. // ... // Finalize the message. message.finalize()?;
pub fn finalize_one(self) -> Result<Option<Message<'a>>>
[src]
pub fn finalize_one(self) -> Result<Option<Message<'a>>>
[src]Finalizes the topmost writer, returning the underlying writer.
Finalizes the topmost writer, i.e. flushes any buffered data, and pops it of the stack. This allows for fine-grained control of the resulting message, but must be done with great care. If done improperly, the resulting message may be malformed.
Examples
This demonstrates how to create a compressed, signed message from a detached signature.
use std::io::Write; use std::convert::TryFrom; use sequoia_openpgp as openpgp; use openpgp::packet::{Packet, Signature, one_pass_sig::OnePassSig3}; use openpgp::serialize::Serialize; use openpgp::serialize::stream::{Message, Compressor, LiteralWriter}; let data: &[u8] = // ... let sig: Signature = // ... let message = Message::new(&mut sink); let mut message = Compressor::new(message).build()?; // First, write a one-pass-signature packet. Packet::from(OnePassSig3::try_from(&sig)?) .serialize(&mut message)?; // Then, add the literal data. let mut message = LiteralWriter::new(message).build()?; message.write_all(data)?; // Finally, pop the `LiteralWriter` off the stack to write the // signature. let mut message = message.finalize_one()?.unwrap(); Packet::from(sig).serialize(&mut message)?; // Finalize the message. message.finalize()?;
pub fn finalize(self) -> Result<()>
[src]
pub fn finalize(self) -> Result<()>
[src]Finalizes the message.
Finalizes all writers on the stack, flushing any buffered data.
Note
Failing to finalize the message may result in corrupted messages.
Examples
use sequoia_openpgp as openpgp; use openpgp::serialize::stream::{Message, LiteralWriter}; let message = Message::new(&mut sink); // Construct the writer stack here. let mut message = LiteralWriter::new(message).build()?; // Write literal data to `message` here. // ... // Finalize the message. message.finalize()?;
Trait Implementations
impl<'a> Write for Message<'a>
[src]
impl<'a> Write for Message<'a>
[src]fn write(&mut self, buf: &[u8]) -> Result<usize>
[src]
fn write(&mut self, buf: &[u8]) -> Result<usize>
[src]Write a buffer into this writer, returning how many bytes were written. Read more
fn flush(&mut self) -> Result<()>
[src]
fn flush(&mut self) -> Result<()>
[src]Flush this output stream, ensuring that all intermediately buffered contents reach their destination. Read more
fn is_write_vectored(&self) -> bool
[src]
fn is_write_vectored(&self) -> bool
[src]can_vector
)Determines if this Write
r has an efficient write_vectored
implementation. Read more
fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>
1.0.0[src]
fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>
1.0.0[src]Attempts to write an entire buffer into this writer. Read more
fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>
[src]
fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>
[src]write_all_vectored
)Attempts to write multiple buffers into this writer. Read more
Auto Trait Implementations
impl<'a> !RefUnwindSafe for Message<'a>
impl<'a> Send for Message<'a>
impl<'a> Sync for Message<'a>
impl<'a> Unpin for Message<'a>
impl<'a> !UnwindSafe for Message<'a>
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<T> Same<T> for T
impl<T> Same<T> for T
type Output = T
type Output = T
Should always be Self