language-servers/ruff
1
0
Fork 0
mirror of https://github.com/astral-sh/ruff.git synced 2025-10-01 22:31:47 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 5

[red-knot] Improve Vfs and FileSystem documentation (#11856)

Browse source
This commit is contained in:
Micha Reiser 2024-06-13 12:49:27 +01:00 • committed by GitHub
parent 73370fe798
commit c5bc368e43
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 10 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

11
crates/ruff_db/src/file_system.rs
View file

@ -13,11 +13,14 @@ mod os;
pub type Result<T> = std::io::Result<T>;
/// A file system that can be used to read and write files.
/// An abstraction over `std::fs` with features tailored to Ruff's needs.
///
/// The file system is agnostic to the actual storage medium, it could be a real file system, a combination
/// of a real file system and an in-memory file system in the case of an LSP where unsaved changes are stored in memory,
/// or an all in-memory file system for testing.
/// Provides a file system agnostic API to interact with files and directories.
/// Abstracting the file system operations enables:
///
/// * Accessing unsaved or even untitled files in the LSP use case
/// * Testing with an in-memory file system
/// * Running Ruff in a WASM environment without needing to stub out the full `std::fs` API.
pub trait FileSystem {
/// Reads the metadata of the file or directory at `path`.
fn metadata(&self, path: &FileSystemPath) -> Result<Metadata>;