A virtual file system implementation in modern C#.
- π Table of Contents
- π Introduction
- π Features
- π Documentation
- π₯ Installation
- π Use cases
- π€ Contributing
- π License
- π¬ Contact
- π Acknowledgements
- π Change log
- β¨ Contributors
When writing applications in .NET, you often need to write or read the contents of a file. .NET provides System.IO
namespace dedicated to this purpose. But how do we deal with the filesystem when testing our code?
Virtual File System is an attempt to solve this problem. Currently, this library is at an early stage of development. If you need additional functionality, I invite you to open an issue to discuss it.
A virtual file system is a data structure that represents a file system in memory. It is used to simulate a file system on a computer. It is useful for testing purposes, for example, when you want to test a file system without actually creating files on the hard drive.
- Create a virtual file system
- Create a virtual file or directory
- Print the contents of a virtual file system as a tree
- ...
Virtual File System provides a COMPLETE DOCUMENTATION of the library.
All summaries are written in English. If you want to help us translate the documentation, please open an issue to discuss it.
Note: The documentation is generated using Doraku/DefaultDocumentation tool. It is generated automatically when the project is built.
- .NET 6.0
- A C# IDE (Visual Studio, Rider, etc.)
- A C# compiler (dotnet CLI, etc.)
This library targets .NET 7.0 and uses the latest C# features. It is written in C# 11.0 and uses the new init
properties, record
types, switch
expressions, using
declarations, and more.
I invite you to read the C# 11.0 documentation to learn more about these features.
VirtualFileSystem is available on NuGet.
You can install it using the .NET Core CLI:
dotnet add package Atypical.VirtualFileSystem
or by adding a package reference to your project file:
<PackageReference Include="Atypical.VirtualFileSystem" Version="0.1.7" />
You can also clone the repository and build the project yourself.
git clone
cd VirtualFileSystem
dotnet build
// sample output (the order of the files is alphabetical)
string expected = """
vfs://
βββ superheroes
β βββ batman.txt
β βββ superman.txt
β βββ wonderwoman.txt
βββ villains
β βββ joker.txt
β βββ lexluthor.txt
β βββ penguin.txt
βββ world
βββ gotham.txt
βββ metropolis.txt
βββ themyscira.txt
""";
// create a virtual file system
IVirtualFileSystem vfs = new VFS()
// add some files (directories are created automatically)
.CreateFile("superheroes/batman.txt")
.CreateFile("superheroes/superman.txt")
.CreateFile("superheroes/wonderwoman.txt")
.CreateFile("villains/joker.txt")
.CreateFile("villains/lexluthor.txt")
.CreateFile("villains/penguin.txt")
.CreateFile("world/gotham.txt")
.CreateFile("world/metropolis.txt")
.CreateFile("world/themyscira.txt");
// get the string representation of the virtual file system
string tree = vfs.GetTree();
Contributions are welcome! Please read the CONTRIBUTION GUIDELINES first.
This project is licensed under the terms of the BSD-3-Clause license. If you use this library in your project, please consider adding a link to this repository in your project's README.
This project is maintained by Atypical Consulting. If you need help with this project, please contact us from this repository by opening an issue.
You can contact us by opening an issue on this repository.
Please see RELEASES for more information what has changed recently.