Struct Session 

pub struct Session { /* private fields */ }

A running pg-ephemeral container marked as a named session.

Pairs the OCI ociman::Container handle with the decoded Name taken from the container’s pg-ephemeral.session label.

Implementations

impl Session

pub fn name(&self) -> &Name

The user-facing session name.

pub fn container(&self) -> &Container

The underlying container handle.

pub fn into_ociman_container(self) -> Container

Consume this session, returning its ociman container handle.

pub async fn metadata(&self) -> Result<Metadata, MetadataError>

Read and decode pg-ephemeral crate::label::Metadata from this session’s container labels. Used by staleness detection and any other surface that needs to compare a session’s recorded configuration to current state.

pub async fn stop(self) -> Result<(), StopError>

Stop and remove the underlying container, consuming this Session.

Force-removes via the runtime, which stops the container first if it’s still running. After this call returns successfully the session no longer exists on the backend.

pub async fn list(backend: &Backend) -> Result<Vec<Self>, ListError>

List every running pg-ephemeral session on the given backend.

Containers are discovered by filtering on the crate::label::SESSION_KEY label. For each match, the container’s labels are inspected to decode the session name — so this performs one ps --filter plus one inspect per match.

pub async fn find( backend: &Backend, name: &Name, ) -> Result<Option<Self>, FindError>

Look up a session by its user-facing name.

Returns Ok(None) when no session with this name is running. Multiple matches indicate an invariant violation (the OCI name derivation enforces uniqueness on start) and surface as FindError::MultipleMatches.

Trait Implementations

impl Debug for Session

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

Formats the value using the given formatter.