Struct ServiceEndpoint 

pub struct ServiceEndpoint { /* private fields */ }

Represents a service endpoint for external validation testing

Internally stores a validated URL and the server IP address. For HTTPS endpoints, the IP is used to resolve the domain locally (since we can’t rely on DNS for .local domains).

Examples

use std::net::SocketAddr;
use torrust_tracker_deployer_types::ServiceEndpoint;

// HTTP endpoint
let socket_addr: SocketAddr = "10.0.0.1:1212".parse().unwrap();
let endpoint = ServiceEndpoint::http(socket_addr, "/api/health_check").unwrap();
assert_eq!(endpoint.url().as_str(), "http://10.0.0.1:1212/api/health_check");

Implementations

impl ServiceEndpoint

pub fn http( socket_addr: SocketAddr, path: impl Into<String>, ) -> Result<ServiceEndpoint, InvalidServiceEndpointUrl>

Create a new HTTP endpoint (no TLS)

Arguments

• socket_addr - The IP address and port the service listens on
• path - The health check path (e.g., /api/health_check)

Errors

Returns an error if the socket address and path don’t form a valid URL.

pub fn https( domain: &DomainName, path: impl Into<String>, server_ip: IpAddr, ) -> Result<ServiceEndpoint, InvalidServiceEndpointUrl>

Create a new HTTPS endpoint with TLS

Arguments

• domain - The domain name for HTTPS access (required for certificate issuance)
• path - The health check path (e.g., /api/health_check)
• server_ip - The IP address to resolve the domain to

Errors

Returns an error if the domain and path don’t form a valid URL.

pub fn url(&self) -> &Url

Returns the URL for this endpoint

pub fn uses_tls(&self) -> bool

Returns true if this endpoint uses TLS (HTTPS)

pub fn server_ip(&self) -> IpAddr

Returns the server IP address

pub fn port(&self) -> u16

Returns the port for this endpoint

For HTTP: the configured port from the URL. For HTTPS: 443 (the default HTTPS port).

pub fn domain(&self) -> Option<&str>

Get the domain if this is an HTTPS endpoint

pub fn is_local_domain(&self) -> bool

Check if the domain ends with .local (for self-signed cert handling)

pub fn socket_addr(&self) -> SocketAddr

Returns the socket address for connecting to this endpoint

Combines the server IP with the port from the URL.

Trait Implementations

impl Clone for ServiceEndpoint

fn clone(&self) -> ServiceEndpoint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceEndpoint

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

Formats the value using the given formatter.

impl PartialEq for ServiceEndpoint

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