Struct UdpTrackerConfig 

pub struct UdpTrackerConfig { /* private fields */ }

UDP tracker bind configuration with domain invariants enforced at construction

This type guarantees that any instance is valid according to domain rules:

• Bind address has a non-zero port

Note: Unlike HTTP trackers, UDP does not support TLS, so there are no TLS-related validation rules.

Construction

Use UdpTrackerConfig::new() to create instances with validation:

use torrust_tracker_deployer_lib::domain::tracker::UdpTrackerConfig;

let config = UdpTrackerConfig::new(
    "0.0.0.0:6969".parse().unwrap(),
    None,
)?;

Invariants

The following invariants are enforced at construction time:

1. No dynamic ports: bind_address.port() != 0

Implementations

impl UdpTrackerConfig

pub fn new( bind_address: SocketAddr, domain: Option<DomainName>, ) -> Result<Self, UdpTrackerConfigError>

Creates a new UDP tracker configuration with validation

This is the primary way to construct a UdpTrackerConfig. All domain invariants are validated before the instance is created.

Arguments

• bind_address - Socket address to bind to (e.g., “0.0.0.0:6969”)
• domain - Optional domain for announce URLs

Errors

Returns UdpTrackerConfigError if any invariant is violated:

• DynamicPortNotSupported - if port is 0

Examples

use torrust_tracker_deployer_lib::domain::tracker::UdpTrackerConfig;
use torrust_tracker_deployer_lib::shared::DomainName;

// Basic configuration without domain
let config = UdpTrackerConfig::new(
    "0.0.0.0:6969".parse().unwrap(),
    None,
)?;

// Configuration with domain
let config_with_domain = UdpTrackerConfig::new(
    "0.0.0.0:6969".parse().unwrap(),
    Some(DomainName::new("tracker.example.com")?),
)?;

pub fn bind_address(&self) -> SocketAddr

Returns the bind address

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

Returns a reference to the domain, if configured

Trait Implementations

impl Clone for UdpTrackerConfig

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 UdpTrackerConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UdpTrackerConfig

Enables deserialization with validation through the constructor

This ensures that JSON deserialization also validates the config, maintaining the “always valid” invariant even for loaded data.

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for UdpTrackerConfig

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

Formats the value using the given formatter.

impl PartialEq for UdpTrackerConfig

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for UdpTrackerConfig

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 UdpTrackerConfig

impl TryFrom<UdpTrackerSection> for UdpTrackerConfig

Converts from application DTO to domain type using TryFrom trait

This implementation follows the standard library convention for fallible conversions, enabling use of .try_into() and TryFrom::try_from().

Example

let section = UdpTrackerSection { bind_address: "0.0.0.0:6969".to_string(), domain: None };
let config: UdpTrackerConfig = section.try_into()?;

type Error = CreateConfigError

The type returned in the event of a conversion error.

fn try_from(section: UdpTrackerSection) -> Result<Self, Self::Error>

Performs the conversion.