Trait tor_keymgr::KeySpecifierComponent

pub trait KeySpecifierComponent {
    // Required methods
    fn to_component(&self) -> Result<Slug, Bug>;
    fn from_component(c: &Slug) -> StdResult<Self, InvalidKeyPathComponentValue>
       where Self: Sized;
    fn fmt_pretty(&self, f: &mut Formatter<'_>) -> Result;
}

A trait for serializing and deserializing specific types of Slugs.

A KeySpecifierComponent is a specific kind of Slug. A KeySpecifierComponent is always a valid Slug, but may have a more restricted charset, or more specific validation rules. A Slug is not always a valid KeySpecifierComponent instance.

If you are deriving DefaultKeySpecifier for a struct, all of its fields must implement this trait.

If you are implementing KeySpecifier and KeyInfoExtractor manually rather than by deriving DefaultKeySpecifier, you do not need to implement this trait.

Required Methods

fn to_component(&self) -> Result<Slug, Bug>

Return the Slug representation of this type.

fn from_component(c: &Slug) -> StdResult<Self, InvalidKeyPathComponentValue>

where Self: Sized,

Try to convert c into an object of this type.

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

Display the value in a human-meaningful representation

The output should be a single line (without trailing full stop).

Implementations on Foreign Types

impl KeySpecifierComponent for HsId

fn to_component(&self) -> StdResult<Slug, Bug>

fn from_component(s: &Slug) -> StdResult<Self, InvalidKeyPathComponentValue>

where Self: Sized,

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

impl KeySpecifierComponent for TimePeriod

fn to_component(&self) -> Result<Slug, Bug>

fn from_component(c: &Slug) -> StdResult<Self, InvalidKeyPathComponentValue>

where Self: Sized,

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

Implementors

impl<T: KeySpecifierComponentViaDisplayFromStr + ?Sized> KeySpecifierComponent for T