rama::net::address

Struct Authority

pub struct Authority {
    pub user_info: Option<Basic>,
    pub address: HostWithOptPort,
}

Available on crate feature net only.

Expand description

A Host with optionally a port and/or user-info (Basic).

§Examples

example.com
127.0.0.1
example.com:80
127.0.0.1:80
joe@example.com:80
joe:secret@example.com

Fields§

§user_info: Option<Basic>§address: HostWithOptPort

Implementations§

§

impl Authority

pub const fn new(addr: HostWithOptPort) -> Authority

Creates a new Authority from a HostWithOptPort.

pub const fn new_with_user_info( addr: HostWithOptPort, user_info: Basic, ) -> Authority

Creates a new Authority from a HostWithOptPort and user-info (Basic).

pub const fn local_ipv4() -> Authority

creates a new local ipv4 Authority without a port.

§Example

use rama_net::address::Authority;

let addr = Authority::local_ipv4();
assert_eq!("127.0.0.1", addr.to_string());

pub const fn local_ipv4_with_port(port: u16) -> Authority

creates a new local ipv4 Authority with the given port

§Example

use rama_net::address::Authority;

let addr = Authority::local_ipv4_with_port(8080);
assert_eq!("127.0.0.1:8080", addr.to_string());

pub const fn local_ipv6() -> Authority

creates a new local ipv6 Authority without a port.

§Example

use rama_net::address::Authority;

let addr = Authority::local_ipv6();
assert_eq!("::1", addr.to_string());

pub const fn local_ipv6_with_port(port: u16) -> Authority

creates a new local ipv6 Authority with the given port.

§Example

use rama_net::address::Authority;

let addr = Authority::local_ipv6_with_port(8080);
assert_eq!("[::1]:8080", addr.to_string());

pub const fn default_ipv4() -> Authority

creates a default ipv4 Authority without a port

§Example

use rama_net::address::Authority;

let addr = Authority::default_ipv4_with_port(8080);
assert_eq!("0.0.0.0:8080", addr.to_string());

pub const fn default_ipv4_with_port(port: u16) -> Authority

creates a default ipv4 Authority with the given port

§Example

use rama_net::address::Authority;

let addr = Authority::default_ipv4_with_port(8080);
assert_eq!("0.0.0.0:8080", addr.to_string());

pub const fn default_ipv6() -> Authority

creates a new default ipv6 Authority without a port.

§Example

use rama_net::address::Authority;

let addr = Authority::default_ipv6();
assert_eq!("::", addr.to_string());

pub const fn default_ipv6_with_port(port: u16) -> Authority

creates a new default ipv6 Authority with the given port.

§Example

use rama_net::address::Authority;

let addr = Authority::default_ipv6_with_port(8080);
assert_eq!("[::]:8080", addr.to_string());

pub const fn broadcast_ipv4() -> Authority

creates a new broadcast ipv4 Authority without a port

§Example

use rama_net::address::Authority;

let addr = Authority::broadcast_ipv4();
assert_eq!("255.255.255.255", addr.to_string());

pub const fn broadcast_ipv4_with_port(port: u16) -> Authority

creates a new broadcast ipv4 Authority with the given port

§Example

use rama_net::address::Authority;

let addr = Authority::broadcast_ipv4_with_port(8080);
assert_eq!("255.255.255.255:8080", addr.to_string());

pub const fn example_domain() -> Authority

Creates a new example domain Authority without a port.

pub const fn example_domain_http() -> Authority

Creates a new example domain HostWithOptPort for the http default port.

pub const fn example_domain_https() -> Authority

Creates a new example domain HostWithOptPort for the https default port.

pub const fn example_domain_with_port(port: u16) -> Authority

Creates a new example domain HostWithOptPort for the given port.

pub const fn localhost_domain() -> Authority

Creates a new localhost domain HostWithOptPort without a port.

pub const fn localhost_domain_http() -> Authority

Creates a new localhost domain HostWithOptPort for the http default port.

pub const fn localhost_domain_https() -> Authority

Creates a new localhost domain HostWithOptPort for the https default port.

pub const fn localhost_domain_with_port(port: u16) -> Authority

Creates a new localhost domain HostWithOptPort for the given port.

pub fn with_host(self, host: Host) -> Authority

Set Host of Authority

pub fn set_host(&mut self, host: Host) -> &mut Authority

Set Host of Authority

pub fn maybe_with_port(self, port: Option<u16>) -> Authority

(un)set port (u16) of Authority

pub fn maybe_set_port(&mut self, port: Option<u16>) -> &mut Authority

(un)set port (u16) of Authority

pub fn with_port(self, port: u16) -> Authority

(un)set port (u16) of Authority

pub fn set_port(&mut self, port: u16) -> &mut Authority

(un)set port (u16) of Authority

pub fn without_port(self) -> Authority

(un)set port (u16) of Authority

pub fn unset_port(&mut self) -> &mut Authority

(un)set port (u16) of Authority

pub fn maybe_with_user_info(self, user_info: Option<Basic>) -> Authority

(un)set user-info (Basic) of Authority

pub fn maybe_set_user_info( &mut self, user_info: Option<Basic>, ) -> &mut Authority

(un)set user-info (Basic) of Authority

pub fn with_user_info(self, user_info: Basic) -> Authority

(un)set user-info (Basic) of Authority

pub fn set_user_info(&mut self, user_info: Basic) -> &mut Authority

(un)set user-info (Basic) of Authority

pub fn without_user_info(self) -> Authority

(un)set user-info (Basic) of Authority

pub fn unset_user_info(&mut self) -> &mut Authority

(un)set user-info (Basic) of Authority

Trait Implementations§

§

impl Clone for Authority

§

fn clone(&self) -> Authority

Returns a duplicate of the value. Read more

1.0.0 · Source§

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

Performs copy-assignment from source. Read more

§

impl Debug for Authority

§

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

Formats the value using the given formatter. Read more

§

impl<'de> Deserialize<'de> for Authority

§

fn deserialize<D>( deserializer: D, ) -> Result<Authority, <D as Deserializer<'de>>::Error>
where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

§

impl Display for Authority

§

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

Formats the value using the given formatter. Read more

§