Enum PtTargetAddr

#[non_exhaustive]
pub enum PtTargetAddr {
    IpPort(SocketAddr),
    HostPort(String, u16),
    None,
}

An address that an be passed to a pluggable transport to tell it where to connect (typically, to a bridge).

Not every transport accepts all kinds of addresses.

This is semantically very similar to Option<BridgeAddr>, but it has some of its own conversion methods and bespoke FromStr and Display.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

IpPort(SocketAddr)

An IP address and port for a Tor relay.

This is the only address type supported by the BuiltIn transport.

HostPort(String, u16)

A hostname-and-port target address. Some transports may support this.

None

A completely absent target address. Some transports support this.

Implementations

impl PtTargetAddr

fn as_bridge_ref(&self) -> Option<BridgeAddrInner<&SocketAddr, &str>>

Obtain an Option<BridgeAddrInner> containing references

This is a useful helper for display-like implementations, which can then implement for PtTargetAddr in terms of the impls for BridgeAddrInner.

(See the code comment for PtTargetAddr.)

Trait Implementations

impl Clone for PtTargetAddr

fn clone(&self) -> PtTargetAddr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PtTargetAddr

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PtTargetAddr

where Self: FromStr, <Self as FromStr>::Err: Display,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PtTargetAddr

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

Formats the value using the given formatter.

impl From<Option<BridgeAddr>> for PtTargetAddr

fn from(pt: Option<BridgeAddr>) -> PtTargetAddr

Converts to this type from the input type.

impl From<PtTargetAddr> for Option<BridgeAddr>

fn from(pt: PtTargetAddr) -> Option<BridgeAddr>

Converts to this type from the input type.

impl FromStr for PtTargetAddr

type Err = BridgeAddrError

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 HasAddrs for PtTargetAddr

fn addrs(&self) -> &[SocketAddr]

Return the addresses listed for this server.

impl Hash for PtTargetAddr

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 PtTargetAddr

fn eq(&self, other: &PtTargetAddr) -> 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 Redactable for PtTargetAddr

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

As Display::fmt, but produce a redacted representation.

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

As Debug::fmt, but produce a redacted representation.

fn redacted(&self) -> Redacted<&Self>

Return a smart pointer that will display or debug this object as its redacted form.

fn maybe_redacted(&self, redact: bool) -> MaybeRedacted<&Self>

Return a smart pointer that redacts this object if redact is true.

impl Serialize for PtTargetAddr

where Self: Display,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for PtTargetAddr

impl StructuralPartialEq for PtTargetAddr