Struct AttachGuard 

pub struct AttachGuard { /* private fields */ }

Owns an attached resource for the duration of one phase activation. Drop emits resource.detach and, when the entry’s refcount has fully drained, schedules an async close() (and emits resource.close.* events around it).

Holding the guard keeps the resource alive; releasing it lets the pool tear down the resource if no other shells reference it.

Implements Debug so test helpers like Result::expect_err accept it as the success type when the error path is the one under test.

Implementations

impl AttachGuard

pub fn resource(&self) -> Arc<dyn SharedResource>

Borrow the underlying shared resource. The guard retains ownership; the Arc clone is cheap.

pub fn key(&self) -> &ResourceKey

Resource key for the attached entry. Useful for log correlation in adapter shells.

pub async fn detach(self) -> Result<(), String>

Explicit detach. Calling this drains the refcount and (if it hits zero) awaits the resource’s close() synchronously, so the caller observes teardown completion at this point. The guard’s Drop falls back to a best-effort spawn when detach() wasn’t called explicitly.

Trait Implementations

impl Debug for AttachGuard

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

Formats the value using the given formatter.

impl Drop for AttachGuard

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.