Struct FingerQuerySpec 

pub struct FingerQuerySpec {
    pub username: Option<String>,
    pub verbose: bool,
    pub forward_host: Option<String>,
}

One {Q1}/{Q2} query this client will put on the wire.

RFC 1288 §2.3:

{Q1} ::= [{W}|{W}{S}{U}] {C}          -- local query
{Q2} ::= [{W}{S}][{U}]{H}{C}          -- forwarding query
{W}  ::= "/W"                         -- long format
{U}  ::= username
{H}  ::= @hostname
{C}  ::= CRLF

Fields

username: Option<String>

Login to ask about, or None for the empty “list everyone” query.

verbose: bool

Send /W, asking the server for the long format.

forward_host: Option<String>

@host: ask the server to relay the query. Refused unless allow_forwarding.

Implementations

impl FingerQuerySpec

pub fn from_action(action: &Value) -> Result<Self>

Validate one send_finger_query action into a spec.

The validation is the security boundary, not decoration. A username carrying @ would make a forwarding query implicitly, slipping past the allow_forwarding gate entirely; one carrying whitespace or a leading / could forge the /W token or a second field. Each is refused by name so the model is told to use forward_host rather than silently getting something else than it asked for.

pub fn to_json(&self) -> Value

Round-trip form carried by ClientActionResult::Custom and by the response event.

pub fn from_json(value: &Value) -> Result<Self>

Rebuild a spec produced by Self::to_json. Values are re-cleaned rather than trusted, so the wire encoding has exactly one place that decides what is legal.

pub fn query_text(&self) -> String

The query line without its CRLF: what the response event reports as query.

pub fn to_wire_line(&self) -> String

The bytes that go on the wire. RFC 1288 terminates every query with CRLF.

pub fn is_forwarding(&self) -> bool

True when this query asks the server to relay to another host.

Trait Implementations

impl Clone for FingerQuerySpec

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FingerQuerySpec

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

Formats the value using the given formatter.

impl Default for FingerQuerySpec

fn default() -> Self

Returns the “default value” for a type.

impl Eq for FingerQuerySpec

impl PartialEq for FingerQuerySpec

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FingerQuerySpec