Struct AppPaths 

pub struct AppPaths { /* private fields */ }

Where one app keeps its files, the same API on every target:

	Linux	macOS	Web
data	$XDG_DATA_HOME/<id>	~/Library/Application Support/<id>	opfs://<profile>/<id>/data
config	$XDG_CONFIG_HOME/<id>	~/Library/Application Support/<id>	opfs://<profile>/<id>/config
cache	$XDG_CACHE_HOME/<id>	~/Library/Caches/<id>	opfs://<profile>/<id>/cache
state	$XDG_STATE_HOME/<id>	~/Library/Application Support/<id>	opfs://<profile>/<id>/state
runtime	$XDG_RUNTIME_DIR/<id>	$TMPDIR/<id>	memory, for the page’s lifetime
user_dir	xdg-user-dirs	~/Documents, …	unsupported

On native targets these are exactly data_dir and the other per-user directories with the id joined on. When one does not resolve (no home directory), durable storage falls back to memory rather than to a path relative to wherever the process started.

The id is one path component, typically the app’s reverse-DNS id. Bytes that cannot appear in one (/, \, :, %, control characters) are percent-escaped, as are the ids ., .. and the empty id, so no id can name a location outside its own.

Implementations

impl AppPaths

pub fn for_app(id: &str) -> AppPaths

The app’s locations in this user’s (or on the web, the page’s profile’s) storage.

pub fn under(root: impl Into<PathBuf>, id: &str) -> AppPaths

Everything below root/<id>: data, config, cache, state and runtime subdirectories, and no user folders, workspace or fonts. For tests and for hosts that give each app a sandbox directory.

pub fn memory(id: &str) -> AppPaths

Everything in memory, for tests; nothing outlives the process.

pub fn with_profile(self, profile: &str) -> AppPaths

Keep web storage in profile’s tree. Native per-user directories belong to one profile already, so native targets and scoped paths resolve as before.

pub fn id(&self) -> &str

The id as it appears in locations, escaped where needed.

pub fn data(&self) -> Location

Durable files the app owns: documents, databases, downloads it manages.

pub fn config(&self) -> Location

Settings the user chose.

pub fn cache(&self) -> Location

Files the app can rebuild, which the system may delete.

pub fn state(&self) -> Location

State worth keeping across restarts but not worth backing up: history, window layout, logs.

pub fn runtime(&self) -> Result<Location, Unsupported<Feature>>

Scratch space for this login session (on the web, this page).

Errors

[Unsupported] when the session has no private runtime directory (Linux without $XDG_RUNTIME_DIR, macOS without $TMPDIR).

pub fn user_dir(&self, dir: UserDir) -> Result<Location, Unsupported<Feature>>

One of the user’s content folders.

Errors

[Unsupported] on the web, for scoped paths, and when the user has no such folder (disabled in user-dirs.dirs, or no home directory).

pub fn workspace_root(&self) -> Result<Location, Unsupported<Feature>>

The collaborative workspace the host mounted for this app: $TILO_WORKSPACE_ROOT when absolute, else /var/workspace on a Tilo Linux session ($TILO_WORKSPACE_ID set).

Errors

[Unsupported] on the web, for scoped paths, and when no workspace is mounted.

pub fn font_root(&self) -> Result<Location, Unsupported<Feature>>

The directory holding the Tilo font catalog: where the OS image installs it on Linux, the app bundle’s Contents/Resources/fonts on macOS. Only the location is resolved; readers verify what they use.

Errors

[Unsupported] on the web (fonts arrive as data), for scoped paths, and on macOS when the app does not run from a bundle.

Trait Implementations

impl Clone for AppPaths

fn clone(&self) -> AppPaths

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AppPaths

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

Formats the value using the given formatter.

impl PartialEq for AppPaths

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

impl StructuralPartialEq for AppPaths