Struct AppState 

pub struct AppState {
    pub project_root: PathBuf,
    pub out_dir: PathBuf,
    pub docs_dir: PathBuf,
    pub base: String,
    pub port: u16,
    pub reload_tx: Sender<ReloadEvent>,
    /* private fields */
}

Shared, cheaply-clonable state behind every handler. Clone bumps the Arc/broadcast handle.

Fields

project_root: PathBuf

out_dir: PathBuf

docs_dir: PathBuf

Canonicalized docs/ dir — the write-guard root.

base: String

Site base path (e.g. /docs), normalized to a leading-slash, no-trailing-slash form; empty when the site is served at the root. The built HTML prefixes every asset/nav/wikilink URL with this, so the dev server must strip it off incoming request paths before resolving them against out_dir.

port: u16

The loopback port the server is bound to. Used by the Host-header allowlist to defeat DNS-rebinding (see handlers::loopback_guard).

reload_tx: Sender<ReloadEvent>

Implementations

impl AppState

pub fn new( project_root: PathBuf, out_dir: PathBuf, docs_dir: PathBuf, port: u16, reload_tx: Sender<ReloadEvent>, ) -> Self

Construct an AppState. Initializes the self-write suppression clock.

pub fn with_engine(self, engine: DevState) -> Self

Attach the incremental build engine. Builder-style so the new() call sites (including tests) stay untouched. Only serve_async sets one.

pub fn with_base(self, base: &str) -> Self

Set the site base path, normalized to a leading-slash, no-trailing-slash form (docs / /docs/ / docs/ all become /docs; empty stays empty). Builder-style so the existing new() call sites stay untouched.

pub fn note_self_write(&self)

Record that the editor just wrote a doc on disk. The watcher will skip the next change it sees within [SELF_WRITE_SUPPRESS] as a duplicate.

pub fn take_self_write_suppression(&self) -> bool

Whether a watcher event right now should be suppressed as the echo of a recent editor write. Consumes the marker so only one rebuild is skipped.

Trait Implementations

impl Clone for AppState

fn clone(&self) -> AppState

Returns a duplicate of the value.

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

Performs copy-assignment from source.