Struct Engine 

pub struct Engine { /* private fields */ }

App-owned local engine. Keeping its stdin open leases the server’s lifetime.

Implementations

impl Engine

pub fn new(root: PathBuf, executable: PathBuf) -> Self

Construct a manager for a fixed bundled executable and isolated app data. Unix roots reject shared write access; Windows retains inherited ACLs. Metadata admission does not provide race-proof filesystem confinement.

pub fn copy_executable(&self) -> PathBuf

Fixed bundled engine for read-only staging scans and explicit destination copies.

pub fn library_roots(&self) -> Result<Vec<PathBuf>, String>

All configured local library roots, including offline folders and while stopped. Never substitute an empty list for unreadable configuration or return credentials.

pub fn status(&mut self) -> Result<Value, String>

Public configuration never returns credentials or service keys.

pub fn start(&mut self) -> Result<Client, String>

Start or reuse only this process’s child, authenticating with a retained generated secret.

pub fn stop(&mut self) -> Result<(), String>

Disable future startup; catalog, annotations and source files are retained.

pub fn add_roots(&self, paths: &[PathBuf]) -> Result<(), String>

Register folders picked by the native dialog; scanning remains an explicit action.

pub fn scan_request(&self, full: bool, threads: u64) -> Result<Value, String>

Build an explicit scan request, preserving known unmounted roots.

pub fn accepted_scan(&self) -> Result<(), String>

Record accepted scan registration without pretending the task has completed.

pub fn root_action(&self, path: &str, action: &str) -> Result<(), String>

Explicit watched-root/exclusion changes reuse the bundled engine’s CLI rules.

pub fn configure_concerts( &self, key: Option<&str>, remove: bool, ) -> Result<Value, String>

Lock budget admission before changing a key: an occupied request cannot produce a false failed save. This local-only status projection never returns credentials or contacts the provider.

pub fn concert_key(&self) -> Result<Option<String>, String>

Read the private concert-provider key only inside native Rust operations.

pub fn concert_budget(&self) -> Result<Budget, String>

Lock the device-wide provider budget independently of the active Aède account.

pub fn fetch_keys(&self) -> Result<Value, String>

Retained service keys are private Rust data, attached only to explicit fetch requests.

pub fn keys( &mut self, fanart: &str, acoustid: &str, remove_fanart: bool, remove_acoustid: bool, ) -> Result<(), String>

Save explicitly supplied external keys; empty input preserves, removal is explicit.

Trait Implementations

impl Drop for Engine

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.