Struct TagRegistry 

pub struct TagRegistry { /* private fields */ }

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

Backing collection is a HashSet<String> — tag names are unique and case-sensitive (qBt parity). list() returns a sorted Vec<String> so HTTP responses are deterministic.

Implementations

impl TagRegistry

pub fn new(path: PathBuf) -> Self

Create a new empty registry associated with path. Does not touch disk; call Self::save to materialise.

pub fn load(path: PathBuf) -> Self

Load a registry from disk, soft-recovering from failures.

• If the file is absent → empty registry.
• If the TOML is malformed OR the schema version is unknown → rename the broken file aside (.bak / .bak.N) and return an empty registry. WARN log.
• Other I/O errors (permission, etc.) → empty registry. WARN log.

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

Return all known tag names in sorted order.

pub fn len(&self) -> usize

Number of tags in the registry.

pub fn is_empty(&self) -> bool

True iff the registry contains no tags.

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

Does a tag with the given name exist? Case-sensitive. Empty-string is rejected (never matches).

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

Create a new tag. Returns:

• Err(InvalidName) if the name fails validation.
• Err(AlreadyExists) if a tag with the same name already exists (case-sensitive). This is stricter than the HTTP surface, which is idempotent; the HTTP handler swallows AlreadyExists on createTags to match qBt’s wire semantics.
• Ok(()) on success. The new tag is in-memory only until Self::save is called.

Errors

Returns an error if the session is shut down.

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

Delete a batch of tags. Returns the subset of names that were actually removed (ignores names that were not in the registry, matching qBt’s idempotent deleteTags behaviour).

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

Persist to disk via atomic NamedTempFile::persist. The parent directory is created if it does not yet exist. A schema version header is always written so future loads can detect upgrades.

Errors

Returns an error if the I/O operation fails.

Trait Implementations

impl Clone for TagRegistry

fn clone(&self) -> TagRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TagRegistry

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

Formats the value using the given formatter.

impl Default for TagRegistry

fn default() -> TagRegistry

Returns the “default value” for a type.