Struct CategoryRegistry 

pub struct CategoryRegistry { /* private fields */ }

In-memory category store, persisted to a single TOML file.

All public methods that mutate state (create, edit, remove) are expected to be paired with a save call by the caller — the session actor wraps these in a single critical section to avoid tearing. Concurrent reads through get and list are safe when the registry is wrapped in a parking_lot::RwLock.

Implementations

impl CategoryRegistry

pub fn new(path: PathBuf) -> CategoryRegistry

Create a new in-memory registry bound to path. The file is not touched until the first save.

pub fn load(path: PathBuf) -> CategoryRegistry

Load a registry from its TOML file at path.

On failure this method is lenient: a missing file yields an empty registry (lazy materialisation); a malformed file is renamed to <name>.bak (or <name>.bak.N on collision) and an empty registry is returned so the session can still start.

pub fn path(&self) -> &Path

Absolute path of the backing TOML file.

pub fn len(&self) -> usize

Number of categories currently stored.

pub fn is_empty(&self) -> bool

Return true when the registry has no categories.

pub fn get(&self, name: &str) -> Option<&CategoryMetadata>

Look up a category by name. Returns None for the empty-string name (qBt convention: empty means “uncategorised”).

pub fn contains(&self, name: &str) -> bool

True when the registry contains a category with name.

pub fn list(&self) -> Vec<CategoryMetadata>

All categories as an unordered list. Callers that need stable ordering should sort by name.

pub fn create( &mut self, name: String, save_path: PathBuf, ) -> Result<(), CategoryError>

Create a new category.

Errors

Returns CategoryError::InvalidName if name fails validation, or CategoryError::AlreadyExists if a category with that name is already registered. Does NOT persist to disk — call save after successful mutation.

pub fn edit( &mut self, name: &str, save_path: PathBuf, ) -> Result<(), CategoryError>

Update the save_path for an existing category.

Errors

Returns CategoryError::NotFound if no category with name is registered, or CategoryError::InvalidName if name itself is malformed.

pub fn remove(&mut self, names: &[String]) -> Vec<String>

Remove zero or more categories. Unknown names are silently ignored (qBt behaviour). Returns the list of names that were actually removed so callers can clear the category label on any torrents that pointed at them.

pub fn save(&self) -> Result<(), CategoryError>

Atomically persist this registry to disk.

Writes to a sibling temp file in the same directory, then persist() renames into place. Creates parent directories as needed.

Errors

Returns CategoryError::Persistence on I/O failure and CategoryError::Serialise if TOML encoding fails (should be impossible given the schema is all-String + PathBuf).

Trait Implementations

impl Clone for CategoryRegistry

fn clone(&self) -> CategoryRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CategoryRegistry

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

Formats the value using the given formatter.