printwell-pdf 0.1.3

PDF manipulation features (forms, signing) for Printwell
Documentation 
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

//! Cryptographic primitives for PDF signing.
//!
//! **Note:** This feature requires a commercial license.
//! Purchase at: <https://printwell.dev/pricing>

use crate::{Result, SigningError};

/// Trust store for certificate validation.
pub struct TrustStore {
    _private: (),
}

impl TrustStore {
    /// Create a new trust store builder.
    #[must_use]
    pub const fn builder() -> TrustStoreBuilder {
        TrustStoreBuilder::new()
    }

    /// Load the system trust store.
    ///
    /// **Note:** This feature requires a commercial license.
    ///
    /// # Errors
    ///
    /// Always returns an error as this feature requires a commercial license.
    pub fn system() -> Result<Self> {
        Err(SigningError::RequiresLicense.into())
    }
}

/// Builder for `TrustStore`.
#[derive(Default)]
pub struct TrustStoreBuilder {
    _private: (),
}

impl TrustStoreBuilder {
    /// Create a new builder.
    #[must_use]
    pub const fn new() -> Self {
        Self { _private: () }
    }

    /// Add system root certificates.
    #[must_use]
    pub const fn with_system_roots(self) -> Self {
        self
    }

    /// Add certificates from a PEM file.
    ///
    /// # Errors
    ///
    /// Always returns an error as this feature requires a commercial license.
    pub fn with_pem_file(self, _path: impl AsRef<std::path::Path>) -> Result<Self> {
        Err(SigningError::RequiresLicense.into())
    }

    /// Add certificates from PEM data.
    ///
    /// # Errors
    ///
    /// Always returns an error as this feature requires a commercial license.
    pub fn with_pem_data(self, _data: &[u8]) -> Result<Self> {
        Err(SigningError::RequiresLicense.into())
    }

    /// Build the trust store.
    ///
    /// # Errors
    ///
    /// Always returns an error as this feature requires a commercial license.
    pub fn build(self) -> Result<TrustStore> {
        Err(SigningError::RequiresLicense.into())
    }
}