Struct App 

pub struct App<'a> { /* private fields */ }

Represents the application’s directories.

Main entry point to obtain any directory for your application.

These APIs will fail as last resort. If they fail it usually means the system has a problem. The system may also include specific configuration to break applications on purpose, in which case these APIs will also fail.

Implementations

impl<'a> App<'a>

pub fn new(name: &'a str) -> App<'a>

Creates a new application.

Arguments

• name: the name of the application.

returns: App

pub fn get_data(&self) -> Result<&Path, Error>

Returns the path to this application’s files.

Use this directory to store any information not intended to be user accessible.

Errors

Returns a MissingDataDir if this system doesn’t have any application writable location; this should never occur on any supported system except if such system is broken.

Returns an Io if some directory couldn’t be created.

pub fn get_cache(&self) -> Result<&Path, Error>

Returns the path to this application’s cache.

Use this directory to store cached files such as downloads, intermediate files, etc.

Errors

Returns an Io if some directory couldn’t be created.

pub fn get_documents(&self) -> Result<&Path, Error>

Returns the path to this application’s public documents.

Use this directory to store any content the user should see and alter.

Errors

Returns an Io if some directory couldn’t be created.

pub fn get_logs(&self) -> Result<&Path, Error>

Returns the path to this application’s logs.

Use this directory to store all logs. The user can view and alter this directory.

Errors

Returns an Io if some directory couldn’t be created.

pub fn get_config(&self) -> Result<&Path, Error>

Returns the path to this application’s config.

Use this directory to store all configs for the current user. This directory is not intended for direct user access.

Errors

Returns an Io if some directory couldn’t be created.

Trait Implementations

impl<'a> Clone for App<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.