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
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
//! Common code for the compression writers.
use crate::{
Error,
Result,
};
/// Compression level.
///
/// This value is used by the encoders to tune their compression
/// strategy. The level is restricted to levels commonly used by
/// compression libraries, `0` to `9`, where `0` means no compression,
/// `1` means fastest compression, `6` being a good default, and
/// meaning `9` best compression.
///
/// Note that compression is [dangerous when used naively]. To mitigate some of
/// these issues messages should [use padding].
///
/// [dangerous when used naively]: https://mailarchive.ietf.org/arch/msg/openpgp/2FQUVt6Dw8XAsaMELyo5BNlh2pM
/// [use padding]: ../serialize/stream/padding/index.html
///
/// # Examples
///
/// Write a message using the given [CompressionAlgorithm]:
///
/// [CompressionAlgorithm]: enum.CompressionAlgorithm.html
///
/// ```
/// use sequoia_openpgp as openpgp;
/// # fn main() -> openpgp::Result<()> {
/// use std::io::Write;
/// use openpgp::serialize::stream::{Message, Compressor, LiteralWriter};
/// use openpgp::serialize::stream::padding::Padder;
/// use openpgp::types::{CompressionAlgorithm, CompressionLevel};
///
/// let mut sink = Vec::new();
/// let message = Message::new(&mut sink);
/// let message = Compressor::new(message)
/// .algo(CompressionAlgorithm::Zlib)
/// # .algo(CompressionAlgorithm::Uncompressed)
/// .level(CompressionLevel::fastest())
/// .build()?;
///
/// let message = Padder::new(message).build()?;
///
/// let mut message = LiteralWriter::new(message).build()?;
/// message.write_all(b"Hello world.")?;
/// message.finalize()?;
/// # Ok(()) }
/// ```
#[derive(Copy, Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct CompressionLevel(u8);
assert_send_and_sync!(CompressionLevel);
impl Default for CompressionLevel {
fn default() -> Self {
Self(6)
}
}
impl CompressionLevel {
/// Creates a new compression level.
///
/// `level` must be in range `0..10`, where `0` means no
/// compression, `1` means fastest compression, `6` being a good
/// default, and meaning `9` best compression.
pub fn new(level: u8) -> Result<CompressionLevel> {
if level < 10 {
Ok(Self(level))
} else {
Err(Error::InvalidArgument(
format!("compression level out of range: {}", level)).into())
}
}
/// No compression.
pub fn none() -> CompressionLevel {
Self(0)
}
/// Fastest compression.
pub fn fastest() -> CompressionLevel {
Self(1)
}
/// Best compression.
pub fn best() -> CompressionLevel {
Self(9)
}
}
#[cfg(feature = "compression-deflate")]
mod into_deflate_compression {
use flate2::Compression;
use super::*;
impl From<CompressionLevel> for Compression {
fn from(l: CompressionLevel) -> Self {
Compression::new(l.0 as u32)
}
}
}
#[cfg(feature = "compression-bzip2")]
mod into_bzip2_compression {
use bzip2::Compression;
use super::*;
impl From<CompressionLevel> for Compression {
fn from(l: CompressionLevel) -> Self {
Compression::new(l.0 as u32)
}
}
}
|