Struct Handle 

pub struct Handle {
    pub port: u16,
    /* private fields */
}

A server running on its own thread; dropping it stops the server.

Fields

port: u16

Implementations

impl Handle

pub fn set_library(&self, lib: Shared)

Serves lib from the next request on, keeping the port. The old library is left as it is (its owner still holds it), and the new one joins library/history.

pub fn library(&self) -> Shared

The library being served now.

pub fn set_history(&self, paths: Vec<String>)

Replaces what library/history reports (Eagle reports its recent libraries list), newest first. Duplicates are dropped.

pub fn set_token(&self, token: &str)

Sets the Developer token. A request carrying it as token (in the query string, or in a POST body) is served whatever its Host header says. An empty token turns this off.

pub fn set_preferences(&self, preferences: Value)

Sets the preferences application/info reports, in Eagle’s shape ({"general": {...}, "developer": {...}, ...}). Values are strings where Eagle uses strings ("true", "false").

pub fn set_ai_search(&self, ai: Arc<dyn AiSearch>)

Hands over what answers the aiSearch/* routes. Without one they answer that AI Search isn’t installed.

pub fn take_preferences(&self) -> Option<Value>

The preferences, if a request changed them since the last call or Handle::set_preferences (preferences/collect/on and off set general.showCollectModal).

Trait Implementations

impl Drop for Handle

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.