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§
- Local
Copy Resource Limits - Resource limits applied to recursive local copies.
- Local
Delete Resource Limits - Resource ceilings applied to each recursive local deletion request.
- Local
File System Provider - Creates local filesystem resolutions for accepted
file:configurations. - Local
List Resource Limits - Resource limits applied to recursive local listings.
- Local
Resource Policy - Per-request provider ceilings for recursive local operations.
- Local
Temp Cleanup Control - Shared configuration for the next cleanup attempt of associated resources.
- Local
Temp Cleanup Resource Limits - Resource ceilings applied to one local temporary directory cleanup attempt.
Enums§
- Local
Directory Reopen Policy - Behavior used when a recursive walker must close and later revisit a directory after reaching its open-handle budget.
- Local
File Systems - 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.