Struct SessionManager 

pub struct SessionManager { /* private fields */ }

Configurable session manager for storing session data in XDG directories.

This struct allows customization of the application prefix for session storage. Sessions are stored per-user in the format: ~/.local/share/{app_name}/users/{username}/session.json

Implementations

impl SessionManager

pub fn new(app_name: impl Into<String>) -> Self

Create a new session manager with a custom application name.

Arguments

• app_name - The application name to use as the directory prefix

pub fn with_data_dir( app_name: impl Into<String>, data_dir: impl Into<PathBuf>, ) -> Self

Create a session manager rooted in an explicit application data directory.

This is useful on platforms such as Android where the process does not have an XDG home, but the application has a private files directory.

pub fn get_session_path(&self, username: &str) -> Result<PathBuf>

Get the session file path for a given username using the configured app name.

Returns a path like: ~/.local/share/{app_name}/users/{username}/session.json

Arguments

• username - The Last.fm username

Returns

Returns the path where the session should be stored, or an error if the XDG data directory cannot be determined.

pub fn save_session(&self, session: &LastFmEditSession) -> Result<()>

Save a session to the XDG data directory.

This creates the necessary directory structure and saves the session as JSON to ~/.local/share/{app_name}/users/{username}/session.json

Arguments

• session - The session to save

Returns

Returns Ok(()) on success, or an error if the save fails.

pub fn load_session(&self, username: &str) -> Result<LastFmEditSession>

Load a session from the XDG data directory.

Attempts to load a session from ~/.local/share/{app_name}/users/{username}/session.json

Arguments

• username - The Last.fm username

Returns

Returns the loaded session on success, or an error if the file doesn’t exist or cannot be parsed.

pub fn session_exists(&self, username: &str) -> bool

Check if a saved session exists for the given username.

Arguments

• username - The Last.fm username

Returns

Returns true if a session file exists, false otherwise.

pub fn remove_session(&self, username: &str) -> Result<()>

Remove a saved session for the given username.

This deletes the session file from the XDG data directory.

Arguments

• username - The Last.fm username

Returns

Returns Ok(()) on success, or an error if the deletion fails.

pub fn list_saved_users(&self) -> Result<Vec<String>>

List all usernames that have saved sessions.

Scans the XDG data directory for session files and returns the usernames.

Returns

Returns a vector of usernames that have saved sessions.

pub fn app_name(&self) -> &str

Get the application name used by this session manager.

Trait Implementations

impl Clone for SessionManager

fn clone(&self) -> SessionManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionManager

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

Formats the value using the given formatter.