Struct DiskFileSystem 

pub struct DiskFileSystem { /* private fields */ }

DiskFileSystem carries serializable fields (name, root, denied_paths) inside DiskFileSystemInner alongside session-scoped state (the notify watcher, invalidator maps, weak TurboTasksApi, etc.) This is important to maintain invariants in a session and ensure invalidations work, so we never evict this data.

Implementations

impl DiskFileSystem

pub fn name(&self) -> &RcStr

pub fn root(&self) -> &RcStr

pub fn invalidate(&self)

pub fn invalidate_with_reason<R: InvalidationReason + Clone>( &self, reason: impl Fn(&Path) -> R + Sync, )

pub fn invalidate_path_and_children_with_reason<R: InvalidationReason + Clone>( &self, paths: impl IntoIterator<Item = PathBuf>, reason: impl Fn(&Path) -> R + Sync, )

pub async fn start_watching( &self, poll_interval: Option<Duration>, ) -> Result<()>

pub async fn start_watching_with_invalidation_reason( &self, poll_interval: Option<Duration>, ) -> Result<()>

pub async fn stop_watching(&self)

pub fn try_from_sys_path( &self, vc_self: ResolvedVc<DiskFileSystem>, sys_path: &Path, relative_to: Option<&FileSystemPath>, ) -> Option<FileSystemPath>

Try to convert Path to FileSystemPath. Return None if the file path leaves the filesystem root. If no relative_to argument is given, it is assumed that the sys_path is relative to the DiskFileSystem root.

Attempts to convert absolute paths to paths relative to the filesystem root, though we only attempt to do so lexically.

Assumes self is the DiskFileSystem contained in vc_self. This API is a bit awkward because:

• Path/PathBuf should not be stored in the filesystem cache, so the function cannot be a turbo_tasks::function.
• It’s a little convenient for this function to be sync.

pub fn to_sys_path(&self, fs_path: &FileSystemPath) -> PathBuf

impl DiskFileSystem

pub fn new(name: RcStr, root: Vc<RcStr>) -> Vc<Self>

Create a new instance of DiskFileSystem.

Arguments

• name - Name of the filesystem.
• root - Path to the given filesystem’s root. Should be canonicalized.

pub fn new_with_denied_paths( name: RcStr, root: Vc<RcStr>, denied_paths: Vec<RcStr>, ) -> Vc<Self>

Create a new instance of DiskFileSystem.

Arguments

• name - Name of the filesystem.
• root - Path to the given filesystem’s root. Should be canonicalized.
• denied_paths - Paths within this filesystem that are not allowed to be accessed or navigated into. These must be normalized, non-empty and relative to the fs root.

Trait Implementations

impl<'__de, __Context> BorrowDecode<'__de, __Context> for DiskFileSystem

fn borrow_decode<__D: BorrowDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given BorrowDecode.

impl Clone for DiskFileSystem

fn clone(&self) -> DiskFileSystem

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DiskFileSystem

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

Formats the value using the given formatter.

impl<__Context> Decode<__Context> for DiskFileSystem

fn decode<__D: Decoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.

impl Encode for DiskFileSystem

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), EncodeError>

Encode a given type.

impl FileSystem for DiskFileSystem

fn read(self: Vc<Self>, fs_path: FileSystemPath) -> Vc<FileContent>

fn raw_read_dir( self: Vc<Self>, fs_path: FileSystemPath, ) -> Vc<RawDirectoryContent>

fn read_link(self: Vc<Self>, fs_path: FileSystemPath) -> Vc<LinkContent>

fn write( self: Vc<Self>, fs_path: FileSystemPath, content: Vc<FileContent>, ) -> Vc<()>

fn write_link( self: Vc<Self>, fs_path: FileSystemPath, target: Vc<LinkContent>, ) -> Vc<()>

See FileSystemPath::write_symbolic_link_dir.

fn metadata(self: Vc<Self>, fs_path: FileSystemPath) -> Vc<FileMeta>

fn root(self: Vc<Self>) -> Vc<FileSystemPath>

where Self: Sized,

Returns the path to the root of the file system.

impl ShrinkToFit for DiskFileSystem

fn shrink_to_fit(&mut self)

impl TraceRawVcs for DiskFileSystem

fn trace_raw_vcs(&self, __context__: &mut TraceRawVcsContext)

fn get_raw_vcs(&self) -> Vec<RawVc>

impl ValueDebug for DiskFileSystem

fn dbg_depth<'a>( &'a self, depth: usize, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'a>>

Like dbg, but with a depth limit.

fn dbg( &self, ) -> Pin<Box<dyn Future<Output = Result<String, Error>> + Send + '_>>

impl ValueDebugFormat for DiskFileSystem

Available on debug-assertions enabled only.

fn value_debug_format<'a>(&'a self, depth: usize) -> ValueDebugFormatString<'a>

impl ValueToString for DiskFileSystem

fn to_string(self: Vc<Self>) -> Vc<RcStr>

impl ValueToStringRef for DiskFileSystem

async fn to_string_ref(&self) -> Result<RcStr>

impl VcValueType for DiskFileSystem

type Read = VcDefaultRead<DiskFileSystem>

How to read the value.

type CellMode = VcCellNewMode<DiskFileSystem>

How to update cells of this value type.

fn get_value_type_id() -> ValueTypeId

Returns the type id of the value type.

fn has_serialization() -> bool

impl NonLocalValue for DiskFileSystem

impl Upcast<Box<dyn FileSystem>> for DiskFileSystem

impl Upcast<Box<dyn ValueDebug>> for DiskFileSystem

impl Upcast<Box<dyn ValueToString>> for DiskFileSystem

impl UpcastStrict<Box<dyn FileSystem>> for DiskFileSystem

impl UpcastStrict<Box<dyn ValueDebug>> for DiskFileSystem

impl UpcastStrict<Box<dyn ValueToString>> for DiskFileSystem