Struct oo7::dbus::Service

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

The entry point of communicating with a org.freedesktop.Secrets implementation.

It will automatically create a session for you and allow you to retrieve collections or create new ones.

Certain actions requires on the Secret Service implementation requires a user prompt to complete like creating a collection, locking or unlocking a collection. The library handles that automatically for you.

use oo7::dbus::Service;

let service = Service::new().await?;
let collection = service.default_collection().await?;
// Do something with the collection

}

Implementations

impl<'a> Service<'a>

pub async fn new() -> Result<Service<'a>, Error>

Create a new instance of the Service, an encrypted communication would be attempted first and would fall back to a plain one if that fails.

pub async fn plain() -> Result<Service<'a>, Error>

Create a new instance of the Service with plain algorithm.

pub async fn encrypted() -> Result<Service<'a>, Error>

Create a new instance of the Service with encrypted algorithm.

pub async fn default_collection(&self) -> Result<Collection<'a>, Error>

Retrieve the default collection.

pub async fn with_alias( &self, alias: &str ) -> Result<Option<Collection<'a>>, Error>

Find a collection with it alias.

Applications should make use of Service::default_collection instead.

pub async fn collections(&self) -> Result<Vec<Collection<'a>>, Error>

Get a list of all the available collections.

pub async fn create_collection( &self, label: &str, alias: Option<&str> ) -> Result<Collection<'a>, Error>

Create a new collection.

The alias can only be equal to DEFAULT_COLLECTION otherwise it must not be set.

pub async fn with_label( &self, label: &str ) -> Result<Option<Collection<'a>>, Error>

Find a collection with it label.

Trait Implementations

impl<'a> Debug for Service<'a>

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

Formats the value using the given formatter.