Struct Account 

pub struct Account { /* private fields */ }

A Fediverse account identifier of the form acct:user@host.

See RFC 7565 for the canonical definition of the acct: URI scheme.

Examples

let a = Account::parse("acct:alice@example.com").unwrap();
assert_eq!(a.user(), "alice");
assert_eq!(a.host(), "example.com");
assert_eq!(a.to_string(), "acct:alice@example.com");

// Leading `@` is tolerated:
assert_eq!(Account::parse("@alice@example.com").unwrap(), a);

Implementations

impl Account

pub fn new( user: impl Into<String>, host: impl Into<String>, ) -> Result<Self, Error>

Constructs an Account from its components.

Both must be non-empty. The host is normalised using IDNA 2008 (Unicode → ASCII Punycode, lowercased) per RFC 7565 §7, so internationalised domain names are accepted and stored in their canonical Punycode form.

Errors

Returns Error::InvalidAcct if user or host is empty, or if host contains characters that IDNA cannot map to a valid DNS label.

pub fn parse(input: &str) -> Result<Self, Error>

Parses a string into an Account.

Accepts the following forms:

• acct:user@host
• @user@host
• user@host

Errors

Returns Error::InvalidAcct if the string does not match any of the supported forms or if any component is empty.

pub fn user(&self) -> &str

Returns the local-part (username).

pub fn host(&self) -> &str

Returns the host component (always lowercase).

pub fn to_resource(&self) -> String

Returns the resource URI in canonical acct: form.

pub fn webfinger_url(&self) -> Result<Url, Error>

Builds the https://{host}/.well-known/webfinger?resource=… URL for this account.

Errors

Returns Error::InvalidUrl if the host is not a valid authority.

pub fn webfinger_url_with_scheme(&self, scheme: &str) -> Result<Url, Error>

Builds the {scheme}://{host}/.well-known/webfinger?resource=… URL for this account, allowing the caller to override the scheme.

Production code should always use Self::webfinger_url to ensure https. The override exists to support test fixtures, local development, and Tor hidden-service endpoints.

Errors

Returns Error::InvalidUrl if the resulting URL is malformed.

Trait Implementations

impl Clone for Account

fn clone(&self) -> Account

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Account

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Account

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Account

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

Formats the value using the given formatter.

impl Eq for Account

impl From<Account> for String

fn from(a: Account) -> Self

Converts to this type from the input type.

impl FromStr for Account

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Account

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Account

fn eq(&self, other: &Account) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Account

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Account

impl TryFrom<String> for Account

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: String) -> Result<Self, Self::Error>

Performs the conversion.