Struct PosixFs 

pub struct PosixFs<B: FsBackend> { /* private fields */ }

POSIX-compatible filesystem wrapper.

Wraps any FsBackend and enforces POSIX-like semantics.

Semantics Enforced

Operation	Check
read_file	Fails if path is a directory or symlink
write_file	Fails if path is a directory
append_file	Fails if path is a directory
mkdir	Fails if path exists as file (always) or dir (unless recursive)
read_dir	Fails if path is not a directory
copy	Fails if source is a directory

Example

use bashkit::{FsBackend, PosixFs, Bash};
use std::sync::Arc;

// Your simple storage backend
let backend = MyStorage::new();

// Wrap with PosixFs for POSIX semantics
let fs = Arc::new(PosixFs::new(backend));

// Use with Bash interpreter
let mut bash = Bash::builder().fs(fs).build();

Implementations

impl<B: FsBackend> PosixFs<B>

pub fn new(backend: B) -> Self

Create a new POSIX-compatible filesystem wrapper.

pub fn backend(&self) -> &B

Get a reference to the underlying backend.

Trait Implementations

impl<B: FsBackend + 'static> FileSystem for PosixFs<B>

fn read_file<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Read a file’s contents as bytes.

fn write_file<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, path: &'life1 Path, content: &'life2 [u8], ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Write contents to a file, creating it if necessary.

fn append_file<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, path: &'life1 Path, content: &'life2 [u8], ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Append contents to a file, creating it if necessary.

fn mkdir<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, recursive: bool, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Create a directory.

fn remove<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, recursive: bool, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Remove a file or directory.

fn stat<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<Metadata>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get file or directory metadata.

fn read_dir<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<Vec<DirEntry>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

List directory contents.

fn exists<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Check if a path exists.

fn rename<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, from: &'life1 Path, to: &'life2 Path, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Rename or move a file or directory. The operation is atomic; cross-backend wrappers must reject the rename before mutation when they cannot provide that guarantee.

fn copy<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, from: &'life1 Path, to: &'life2 Path, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Copy a file. Destination replacement is atomic: an error leaves it unchanged.

fn symlink<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, target: &'life1 Path, link: &'life2 Path, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Create a symbolic link.

fn read_link<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<PathBuf>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Read a symbolic link’s target.

fn chmod<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, mode: u32, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Change file permissions.

fn set_modified_time<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, time: SystemTime, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Set the last modification time for a file or directory.

fn as_search_capable(&self) -> Option<&dyn SearchCapable>

Returns a reference to this filesystem as a SearchCapable implementation, if supported.

impl<B: FsBackend + 'static> FileSystemExt for PosixFs<B>

fn usage(&self) -> FsUsage

Get current filesystem usage statistics.

fn limits(&self) -> FsLimits

Get filesystem limits.

fn mkfifo<'life0, 'life1, 'async_trait>( &'life0 self, _path: &'life1 Path, _mode: u32, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Create a named pipe (FIFO) at the given path.

fn vfs_snapshot(&self) -> Option<VfsSnapshot>

Take a snapshot of the filesystem contents for serialization.

fn vfs_restore(&self, _snapshot: &VfsSnapshot) -> Result<()>

Restore filesystem contents from a snapshot.

fn backend_kind(&self) -> &'static str

Short, stable identifier for this backend kind.

impl<B: FsBackend + 'static> From<PosixFs<B>> for Arc<dyn FileSystem>

fn from(fs: PosixFs<B>) -> Self

Converts to this type from the input type.