summaryrefslogtreecommitdiffstats
path: root/guide
diff options
context:
space:
mode:
authorJustus Winter <justus@sequoia-pgp.org>2020-04-03 18:22:55 +0200
committerJustus Winter <justus@sequoia-pgp.org>2020-04-03 18:32:03 +0200
commita9ca727cab50c0c91098a7ef8aea79f5f62a1f5c (patch)
treee7122be749e5b3b26ee96969f4f9e8347fe6532b /guide
parent6494b37775ada713e8ff139ee40c5accdfcaf16a (diff)
openpgp: Unawkwardify the streaming encryptor.
Diffstat (limited to 'guide')
-rw-r--r--guide/src/chapter_02.md46
1 files changed, 15 insertions, 31 deletions
diff --git a/guide/src/chapter_02.md b/guide/src/chapter_02.md
index 3553df3f..92abd895 100644
--- a/guide/src/chapter_02.md
+++ b/guide/src/chapter_02.md
@@ -56,7 +56,7 @@ fn main() {
# sink: &mut Write, plaintext: &str, recipient: &openpgp::Cert)
# -> openpgp::Result<()> {
# // Build a vector of recipients to hand to Encryptor.
-# let mut recipients =
+# let recipients =
# recipient.keys().with_policy(policy, None).alive().revoked(false)
# .for_transport_encryption()
# .map(|ka| ka.key().into())
@@ -65,13 +65,9 @@ fn main() {
# // Start streaming an OpenPGP message.
# let message = Message::new(sink);
#
-# // We want to encrypt a literal data packet.
-# let mut encryptor = Encryptor::for_recipient(
-# message, recipients.pop().expect("No encryption key found"));
-# for r in recipients {
-# encryptor = encryptor.add_recipient(r)
-# }
-# let encryptor = encryptor.build().expect("Failed to create encryptor");
+# // We want to encrypt a literal data packet.
+# let encryptor = Encryptor::for_recipients(message, recipients)
+# .build()?;
#
# // Emit a literal data packet.
# let mut literal_writer = LiteralWriter::new(encryptor).build()?;
@@ -207,7 +203,7 @@ fn generate() -> openpgp::Result<openpgp::Cert> {
# sink: &mut Write, plaintext: &str, recipient: &openpgp::Cert)
# -> openpgp::Result<()> {
# // Build a vector of recipients to hand to Encryptor.
-# let mut recipients =
+# let recipients =
# recipient.keys().with_policy(policy, None).alive().revoked(false)
# .for_transport_encryption()
# .map(|ka| ka.key().into())
@@ -216,13 +212,9 @@ fn generate() -> openpgp::Result<openpgp::Cert> {
# // Start streaming an OpenPGP message.
# let message = Message::new(sink);
#
-# // We want to encrypt a literal data packet.
-# let mut encryptor = Encryptor::for_recipient(
-# message, recipients.pop().expect("No encryption key found"));
-# for r in recipients {
-# encryptor = encryptor.add_recipient(r)
-# }
-# let encryptor = encryptor.build().expect("Failed to create encryptor");
+# // We want to encrypt a literal data packet.
+# let encryptor = Encryptor::for_recipients(message, recipients)
+# .build()?;
#
# // Emit a literal data packet.
# let mut literal_writer = LiteralWriter::new(encryptor).build()?;
@@ -358,7 +350,7 @@ fn encrypt(policy: &dyn Policy,
sink: &mut Write, plaintext: &str, recipient: &openpgp::Cert)
-> openpgp::Result<()> {
// Build a vector of recipients to hand to Encryptor.
- let mut recipients =
+ let recipients =
recipient.keys().with_policy(policy, None).alive().revoked(false)
.for_transport_encryption()
.map(|ka| ka.key().into())
@@ -368,12 +360,8 @@ fn encrypt(policy: &dyn Policy,
let message = Message::new(sink);
// We want to encrypt a literal data packet.
- let mut encryptor = Encryptor::for_recipient(
- message, recipients.pop().expect("No encryption key found"));
- for r in recipients {
- encryptor = encryptor.add_recipient(r)
- }
- let encryptor = encryptor.build().expect("Failed to create encryptor");
+ let encryptor = Encryptor::for_recipients(message, recipients)
+ .build()?;
// Emit a literal data packet.
let mut literal_writer = LiteralWriter::new(encryptor).build()?;
@@ -523,7 +511,7 @@ Decrypted data can be read from this using [`io::Read`].
# sink: &mut Write, plaintext: &str, recipient: &openpgp::Cert)
# -> openpgp::Result<()> {
# // Build a vector of recipients to hand to Encryptor.
-# let mut recipients =
+# let recipients =
# recipient.keys().with_policy(policy, None).alive().revoked(false)
# .for_transport_encryption()
# .map(|ka| ka.key().into())
@@ -532,13 +520,9 @@ Decrypted data can be read from this using [`io::Read`].
# // Start streaming an OpenPGP message.
# let message = Message::new(sink);
#
-# // We want to encrypt a literal data packet.
-# let mut encryptor = Encryptor::for_recipient(
-# message, recipients.pop().expect("No encryption key found"));
-# for r in recipients {
-# encryptor = encryptor.add_recipient(r)
-# }
-# let encryptor = encryptor.build().expect("Failed to create encryptor");
+# // We want to encrypt a literal data packet.
+# let encryptor = Encryptor::for_recipients(message, recipients)
+# .build()?;
#
# // Emit a literal data packet.
# let mut literal_writer = LiteralWriter::new(encryptor).build()?;