Simple single file-based filesystem.
FileFS stores file files information inside single file, called storage.
Features:
- Basic file operations: create, read, update, delete, rename, exists, list all files
- Tree-based files and directiories structure
- Import and export of external files (with buffering)
- Defragmentation of storage space (manually or automatically when there is not enough space)
- Afto-extending of storage when there is no space to allocate new file
- Exclusive access support across multiple client instances
- Debugging using verbose logging
- Thread-safe
You could find latest library and CLI release in Releases section.
- Maximum supported size of file is 2 147 483 647 bytes. This is due to Int32 and some additional challenges with streaming and in-memory copying (see #15)).
- Exclusive access works only inside 1 machine, so FileFS storage file stored at remote network will lose such feature.
- Filename are stored in fixed-sized memory blocks, so they need to have fixed maximum size.
- Defragmentation of storage with very large files may be very slow
FileFS.Cli project is a .NET Core 3.1 application, and FileFS.Client project is .NET Standard 2.1 compatible library.
For building both of them you should have .NET Core SDK 3.1 installed.
To build whole solution use:
> dotnet build
From root repository folder.
Main dependencies:
CommandLineParser(CLI)Serilog(DataAccess, Client, CLI)xUnit(Tests)Moq(Tests)StyleCop.Analysers(All projects)Microsoft.Extensions.DependencyInjection(Tests and Extensions.DependencyInjection)
There are 3 test projects:
FileFS.DataAccess.Tests: contains tests for low level part of a libraryFileFS.Client.Tests: contains tests for library's API itselfFileFS.Extensions.DependencyInjection.Tests: tests for dependency injection project
To run all tests from solution use:
> dotnet test