Struct SharedContainerState 

pub struct SharedContainerState { /* private fields */ }

Serializable registry of test processes and the resources they created.

Implementations

impl SharedContainerState

pub fn register_pid(&mut self, pid: u32)

Registers a live process id.

pub fn register_current_process(&mut self)

Registers the current test process and its nextest run, when present.

pub fn remember_resource(&mut self, pid: u32, resource: &str)

Records a resource (for example a per-test database name) owned by pid.

pub fn remember_current_process_resource(&mut self, resource: &str)

Records a resource owned by the current test process and nextest run.

pub fn forget_resource(&mut self, pid: u32, resource: &str)

Removes one resource from pid after the owning test cleaned it up successfully.

pub fn remember_shared_resource(&mut self, resource: &str)

Records a suite-scoped resource that must survive the producer process.

Products use this for durable test fixtures such as a migrated template database. Unlike per-process resources, these entries are never returned by Self::prune_stale; the product owns fingerprint-based invalidation and explicit cleanup.

pub fn forget_shared_resource(&mut self, resource: &str)

Removes a suite-scoped resource after explicit product cleanup.

pub fn shared_resources(&self) -> &[String]

Returns suite-scoped resources retained independently of a producer PID.

pub fn endpoint(&self) -> Option<&SharedContainerEndpoint>

Returns the last verified reusable-container endpoint.

pub fn set_endpoint(&mut self, endpoint: SharedContainerEndpoint)

Publishes the last verified reusable-container endpoint.

pub fn clear_endpoint(&mut self)

Clears an endpoint that no longer accepts a readiness probe.

pub fn live_resources(&self) -> Vec<&str>

Returns resources attributed to registered processes.

This can include resources from processes that exited during the current nextest run.

pub fn prune_stale(&mut self) -> Vec<String>

Removes entries whose process no longer exists and returns the orphaned resources.

pub fn prune_stale_before_current_execution(&mut self) -> Vec<String>

Prunes resources from previous executions while retaining dead processes from this nextest run until the run finishes.

Deferring same-run cleanup avoids interleaving large schema drops with schema creation in process-per-test database suites. A later run has a different NEXTEST_RUN_ID and reclaims the retained resources deterministically.

Trait Implementations

impl Debug for SharedContainerState

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

Formats the value using the given formatter.

impl Default for SharedContainerState

fn default() -> SharedContainerState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SharedContainerState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SharedContainerState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.