Struct FreePort 

pub struct FreePort(/* private fields */);

A wrapper around a port number that guarantees the port is free and manages its lifecycle

Implementations

impl FreePort

pub fn new() -> Self

Creates a new FreePort by finding an available port

This method will attempt up to 16 times to find a free port by:

1. Generating a random port number in the range 8000-65000
2. Checking that it’s not already allocated in the global registry
3. Attempting to bind to the port to verify it’s actually free
4. Adding it to the global registry to prevent other threads from using it

Panics

Panics if unable to find a free port after 16 attempts

pub fn port(&self) -> u16

Returns the port number

pub fn as_addr(&self) -> SocketAddr

Returns the port as a formatted string for binding addresses

Trait Implementations

impl Debug for FreePort

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

Formats the value using the given formatter.

impl Default for FreePort

fn default() -> Self

Returns the “default value” for a type.

impl Drop for FreePort

fn drop(&mut self)

Automatically removes the port from the global registry when dropped

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.