pub struct PersistedExtraction { /* private fields */ }Expand description
Extracted output whose cleanup responsibility has been transferred.
Implementations§
Source§impl PersistedExtraction
impl PersistedExtraction
Sourcepub fn members(&self) -> &[ExtractedMember]
pub fn members(&self) -> &[ExtractedMember]
Returns member evidence in declaration order.
Sourcepub fn cleanup(self) -> Result<(), ExtractionError>
pub fn cleanup(self) -> Result<(), ExtractionError>
Empties the retained operation-owned extraction root through the retained root handle.
The crate empties the owned tree through the retained directory handle. It never removes the root directory itself and never traverses the root pathname, so a foreign directory, file, symlink, or reparse point installed at the recorded pathname is never touched.
§Contract
Okmeans the owned root object held no entries at the final handle-relative listing: the owned tree was emptied.ErrwithExtractionErrorKind::CleanupFailedmeans the owned root could not be fully emptied. The residue may be partially emptied, its emptiness is not guaranteed, andExtractionError::residue_pathnames the recorded root path.
The residual directory is the caller’s to remove: this crate never
removes it and offers no convenience that removes it by pathname.
Because this call consumes the value, capture the residual path from
root before calling it.
The recorded root path is advisory: if the root was renamed or replaced by a third party, the crate emptied the owned object and left whatever occupies the recorded pathname untouched.
Sourcepub fn into_bound_sources(self) -> Result<BoundExtraction, ExtractionError>
pub fn into_bound_sources(self) -> Result<BoundExtraction, ExtractionError>
Converts every member into an object-bound staging source.
This is the handle-backed handoff: each returned BoundMember owns
the already-open readable member object created by the atomic
handle-relative write, rewound to byte zero, so later staging reads
the verified object instead of re-resolving the recorded pathname or
member name. Call this before any staging; a root rename or member
replacement afterwards cannot redirect the bound objects.
Member handles are closed when their BoundMember is consumed or
dropped. Run cleanup only after bound handles are consumed or closed
(see BoundExtraction::into_members); residue remains acceptable
under the same semantics as cleanup.