Struct Keyring 

pub struct Keyring {
    pub keys: Vec<KeyEntry>,
}

The on-disk registry (keys.json).

Fields

keys: Vec<KeyEntry>

Implementations

impl Keyring

pub fn load_default() -> Result<Keyring, KeyringError>

Load from the default config path. A missing file yields an empty registry (reading records nothing).

pub fn load_from(path: &Path) -> Result<Keyring, KeyringError>

Load from a specific path. A missing file yields an empty registry.

pub fn save_default(&self) -> Result<PathBuf, KeyringError>

Persist to the default config path, creating parent dirs. Opt-in: only call this from an explicit user action. Returns the path written.

pub fn save_to(&self, path: &Path) -> Result<(), KeyringError>

Persist to a specific path, creating parent dirs. Opt-in.

pub fn add(&mut self, entry: KeyEntry) -> Result<(), KeyringError>

Add a new entry. Rejects duplicate names and duplicate serials.

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

Remove the entry with name. Returns true if one was removed.

pub fn by_name(&self, name: &str) -> Option<&KeyEntry>

pub fn by_serial(&self, serial: &str) -> Option<&KeyEntry>

pub fn name_for(&self, serial: Option<&str>) -> Option<&str>

The friendly name for a connected device’s serial, if one is registered. Used by list to annotate devices.

pub fn resolve<'a>( &self, name: &str, connected: &'a [ConnectedKey], ) -> Result<&'a ConnectedKey, ResolveError>

Resolve a --name to a connected device by matching serials.

Trait Implementations

impl Clone for Keyring

fn clone(&self) -> Keyring

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Keyring

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

Formats the value using the given formatter.

impl Default for Keyring

fn default() -> Keyring

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Keyring

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Keyring

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.