certmagic 0.2.0

Automatic TLS certificate acquisition, renewal, and maintenance for Rust servers
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

//! Compile-only coverage for the manager API.
//!
//! This example deliberately does not call the helpers from `main`: building a
//! manager starts cache maintenance and requires a Tokio runtime plus a real
//! storage policy. The functions below are type-checked by `cargo check
//! --examples`, so API drift is caught without contacting an ACME server.

use std::future::Future;

use certmagic::{CertManager, OnDemandConfig, Result, start_maintenance, stop_maintenance};

fn configured_manager() -> CertManager {
    CertManager::builder()
        .on_demand(
            OnDemandConfig::default().with_sync_decision(|name| name.ends_with(".example.com")),
        )
        .build_or_panic()
}

fn manage_signature<'a>(
    manager: &'a CertManager,
    domains: &'a [String],
) -> impl Future<Output = Result<()>> + 'a {
    manager.manage(domains)
}

fn background_manage_signature<'a>(
    manager: &'a CertManager,
    domains: &'a [String],
) -> impl Future<Output = Result<()>> + 'a {
    manager.manage_in_background(domains)
}

fn maintenance_signatures(manager: &CertManager) {
    let observer = start_maintenance(manager);
    std::mem::drop(observer);

    // The manager-level shutdown helper remains available even if the
    // observer returned above was intentionally discarded.
    let _shutdown = stop_maintenance(manager);
}

fn main() {
    // Keep this binary side-effect free. `cargo run --example manager_compat`
    // should never create storage or spawn a maintenance task.
    let _ = (
        configured_manager as fn() -> CertManager,
        manage_signature,
        background_manage_signature,
        maintenance_signatures,
    );
}