Enum AcmeMode 

pub enum AcmeMode {
    Internal,
    Anonymous,
    WithEmail(String),
    Byo {
        cert: String,
        key: String,
    },
}

What ryra writes into tls.caddy on first install of caddy.

Modeled as an exhaustive enum so callers can’t smuggle a third state via empty-string sentinels — match on this and the planner, install message, and snippet renderer stay in agreement.

Variants

Internal

Self-signed via Caddy’s internal CA (LAN-friendly default). Browsers warn unless ryra’s CA is trusted.

Anonymous

Let’s Encrypt with no registration email — real certs but no renewal-notice email tied to an account.

WithEmail(String)

Let’s Encrypt with a registration email for renewal notices.

Byo

Bring-your-own certificate: Caddy serves the given cert + key files directly, issuing nothing. The right mode behind an upstream proxy that terminates the public TLS (Cloudflare in Full-Strict with an Origin CA cert), or anywhere the operator manages certs out of band.

Fields

cert: String

key: String

Implementations

impl AcmeMode

pub fn from_email(email: &str) -> Self

Convert a user-supplied Let’s Encrypt email into the matching LE mode: empty (user hit Enter at the prompt) means anonymous LE, anything else means LE with that email for renewal notices.

pub fn snippet(&self) -> String

Renders the (services_tls) { … } snippet body for this mode.

pub fn detect_from_snippet(contents: &str) -> Option<Self>

Best-effort reverse of Self::snippet: looks at the contents of tls.caddy and recognizes the three ryra-written shapes — tls internal, tls <email>, or an empty body. Returns None for user-customized snippets (Cloudflare DNS-01, BYO cert paths, arbitrary directives) so the install message can fall back to “user-managed” instead of misclassifying.

Trait Implementations

impl Clone for AcmeMode

fn clone(&self) -> AcmeMode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AcmeMode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for AcmeMode

impl PartialEq for AcmeMode

fn eq(&self, other: &AcmeMode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for AcmeMode