Skip to main content

Crate qubit_fs_local

Crate qubit_fs_local 

Source
Expand description

Thin local-files adapter for qubit_fs.

§Choose a filesystem namespace

LocalFileSystems::host accesses the process host namespace and accepts absolute logical paths. LocalFileSystems::rooted opens a native root with a process-local identity; LocalFileSystems::rooted_with_id uses an identity supplied by the caller. Rooted paths are resolved from the virtual working directory, which starts at /.

§Convert host paths

Convert native host paths with host_path_to_logical before passing them to a filesystem facade. This preserves native path representation; avoid lossy string conversion.

§Resource policy

Each facade constructor takes an explicit LocalResourcePolicy. Its standard policy sets finite per-operation budgets. These are not a shared concurrency quota and do not automatically limit temporary-directory cleanup.

§Quick start

use qubit_fs_local::{LocalFileSystems, LocalResourcePolicy};

let fs = LocalFileSystems::host(LocalResourcePolicy::standard())?;
assert_eq!(fs.properties().info().id().as_str(), "local-host");

§Optional registry integration

Enable the registry feature to include the provider and inventory integration. See the user guide for registry setup and provider selection.

Modules§

spi
Public synchronous local filesystem SPI implementations.

Structs§

LocalCopyResourceLimits
Resource limits applied to recursive local copies.
LocalDeleteResourceLimits
Resource ceilings applied to each recursive local deletion request.
LocalFileSystemProvider
Creates local filesystem resolutions for accepted file: configurations.
LocalListResourceLimits
Resource limits applied to recursive local listings.
LocalResourcePolicy
Per-request provider ceilings for recursive local operations.
LocalTempCleanupControl
Shared configuration for the next cleanup attempt of associated resources.
LocalTempCleanupResourceLimits
Resource ceilings applied to one local temporary directory cleanup attempt.

Enums§

LocalDirectoryReopenPolicy
Behavior used when a recursive walker must close and later revisit a directory after reaching its open-handle budget.
LocalFileSystems
Factory for concrete host and rooted local filesystem facades.

Functions§

host_path_to_logical
Converts an absolute host-native path to a canonical logical path.