testcontainer/network

Types

Network

opaque </>

A Docker bridge network. Construct with create/1 (or with_network/2 for automatic cleanup) and pass the name to container.on_network/2.

pub opaque type Network

Values

create

</>

pub fn create(name: String) -> Result(Network, error.Error)

Creates a new bridge network with the given name.

name

</>

pub fn name(network: Network) -> String

The network’s name (as passed to create/1).

remove

</>

pub fn remove(network: Network) -> Result(Nil, error.Error)

Removes a network created via create/1.

with_network

</>

pub fn with_network(
  name: String,
  body: fn(Network) -> Result(a, error.Error),
) -> Result(a, error.Error)

Creates a network, runs body/1, then removes it. Cleanup runs even if body/1 returns an error or the caller process crashes (a linked guard process performs the removal asynchronously on caller down).

use net <- network.with_network(“test-net”)