Struct Store 

pub struct Store { /* private fields */ }

Access to an OpenPGP Certificate Directory, including efficient lookup. Returns rpgpie Certificates.

Implementations

impl Store

pub fn new() -> Result<Self, Error>

A view of the default openpgp-cert-d instance.

Creates the cert-d directory if it doesn’t exist yet.

pub fn with_base_dir(base: impl AsRef<Path>) -> Result<Self, Error>

A view of the custom openpgp-cert-d instance.

Creates the cert-d directory if it doesn’t exist yet.

pub fn insert(&self, certificate: &Certificate) -> Result<(), Error>

Insert a Certificate into the store.

FIXME: this currently fails if a version of certificate is already present in the store.

pub fn get_by_primary_fingerprint( &self, fingerprint: &str, ) -> Result<Option<Certificate>, Error>

Get Certificate by (exact) primary fingerprint

pub fn search_by_fingerprint( &self, fingerprint: &str, ) -> Result<Vec<Certificate>, Error>

Get Certificates by exact primary or subkey fingerprint

pub fn search_by_key_id(&self, key_id: &str) -> Result<Vec<Certificate>, Error>

Get Certificates by exact primary or subkey key id

pub fn search_by_email(&self, email: &str) -> Result<Vec<Certificate>, Error>

Get Certificates by exact Email string

(Returns only exact matches for the email, e.g. alice@example.org)

pub fn search_exact_user_id( &self, user_id: &str, ) -> Result<Vec<Certificate>, Error>

Get Certificates by exact User ID string

(Returns only exact matches for the full User ID string, e.g. Alice <alice@example.org>)

pub fn search_like_user_id(&self, like: &str) -> Result<Vec<Certificate>, Error>

Get Certificates by SQL match on the User ID string

The lookup mechanism compares using SQLite’s “LIKE” mechanism. So the match string must contain % or similar, for partial matches.

pub fn poll(&self, idents: &[String]) -> Result<Vec<Certificate>, Error>

Available on crate feature lookup only.

Lookup certificates from network (keyservers).

Network lookups are implicitly rate limited to “once per day”.

FIXME: combine with db lookup (this clarifies the type of ident!)