Enum BindMode 

pub enum BindMode {
    Local,
    Tailscale,
    Explicit(String),
}

How the server should bind its listeners.

Why: Captures the three meaningful bind modes so resolve_bind_addrs can return the right SocketAddr list for each without tangled string parsing. What: Three variants — local-only (default), tailscale (dual listener), or explicit (whatever the --http flag / TRUSTY_CONSOLE_BIND env var says). Test: Constructed by BindMode::from_env_and_flags; exercised below.

Variants

Local

Bind only 127.0.0.1:<port> — default.

Tailscale

Bind 127.0.0.1:<port> AND the detected Tailscale IPv4 <ts-ip>:<port>.

Explicit(String)

Bind the explicit address string (e.g. 0.0.0.0:7788 or 127.0.0.1:9000).

Implementations

impl BindMode

pub fn from_env_and_flags( explicit_http: &str, default_http: &str, tailscale_flag: bool, ) -> Self

Determine the bind mode from the env var and CLI flags.

Why: Encodes the precedence rule — explicit --http wins, then TRUSTY_CONSOLE_BIND, then --tailscale, then local default — in one place so callers never need to re-implement it. What: Reads TRUSTY_CONSOLE_BIND from the process environment and delegates to from_flags_and_bind_env; see that function for full precedence rules.

Test: test_bind_mode_* tests call from_flags_and_bind_env directly with injected values to avoid parallel-test env-var races.

pub fn from_flags_and_bind_env( explicit_http: &str, default_http: &str, tailscale_flag: bool, bind_env: Option<&str>, ) -> Self

Pure, deterministic core of bind-mode resolution (no env reads).

Why: Separating the env read from the logic makes this function fully testable without process-global env mutation — important because tests run in parallel threads and set_var/remove_var races cause flakiness.

What: Applies a four-level precedence rule — --http override > env "tailscale" > env non-empty addr > --tailscale flag > local default.

Test: test_bind_mode_* below call this function directly.

Trait Implementations

impl Clone for BindMode

fn clone(&self) -> BindMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BindMode

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

Formats the value using the given formatter.

impl Eq for BindMode

impl PartialEq for BindMode

fn eq(&self, other: &BindMode) -> 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 BindMode