Struct TestServers 

pub struct TestServers { /* private fields */ }

Docker-based SMB test servers for integration testing.

Starts Samba containers on construction, stops on drop. Each server type has a factory method returning a connected SmbClient.

Consumers can also skip TestServers entirely and use the compose files directly for E2E or manual testing via write_compose_files.

Implementations

impl TestServers

pub async fn start() -> Result<Self>

Start the minimal set: guest + auth containers.

This is the fastest option (~2 seconds). Use start_all if you need all 14 containers.

pub async fn start_all() -> Result<Self>

Start all 14 consumer containers.

pub fn start_blocking() -> Result<Self>

Blocking version of start_all for use in LazyLock statics.

Example

use std::sync::LazyLock;
use smb2::testing::TestServers;

static SERVERS: LazyLock<TestServers> = LazyLock::new(|| {
    TestServers::start_blocking().unwrap()
});

pub async fn guest_client(&self) -> Result<SmbClient>

Guest-access server. No credentials needed.

pub async fn auth_client(&self, user: &str, pass: &str) -> Result<SmbClient>

Auth-required server. Needs username and password.

pub async fn both_client(&self) -> Result<SmbClient>

Mixed server, guest connection. Can access the “public” share only.

pub async fn both_client_auth( &self, user: &str, pass: &str, ) -> Result<SmbClient>

Mixed server, authenticated connection. Can access both “public” and “private” shares.

pub async fn readonly_client(&self) -> Result<SmbClient>

Read-only server. Writes return errors.

pub async fn many_shares_client(&self) -> Result<SmbClient>

Server with 50 shares for testing share enumeration at scale.

pub async fn unicode_client(&self) -> Result<SmbClient>

Server with unicode share and file names (CJK, emoji, accented characters).

pub async fn longnames_client(&self) -> Result<SmbClient>

Server with 200+ character filenames. Tests path truncation.

pub async fn deepnest_client(&self) -> Result<SmbClient>

Server with 50-level deep directory tree. Tests navigation overflow.

pub async fn many_files_client(&self) -> Result<SmbClient>

Server with 10,000+ files in one directory.

pub async fn windows_client(&self) -> Result<SmbClient>

Windows-like server (server string in smb.conf). Tests OS detection.

pub async fn synology_client(&self) -> Result<SmbClient>

Synology-like server (server string in smb.conf). Tests NAS-specific UI.

pub async fn linux_client(&self) -> Result<SmbClient>

Generic Linux Samba server. Most common real-world server type.

pub async fn flaky_client(&self) -> Result<SmbClient>

Flaky server (5 seconds up, 5 seconds down). Tests error recovery UI.

pub async fn slow_client(&self) -> Result<SmbClient>

Slow server (200ms latency). Tests loading states and timeouts.

Trait Implementations

impl Drop for TestServers

fn drop(&mut self)

Executes the destructor for this type.

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.