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.

• Client library getting started
• Client library API
• CLI usage guide
• Architecture overview

• 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 library
• FileFS.Client.Tests: contains tests for library's API itself
• FileFS.Extensions.DependencyInjection.Tests: tests for dependency injection project

To run all tests from solution use:

> dotnet test

• Fix Int32 size limitation for large files support (see #15
• Improve memory management, especially byte arrays by using Span (see #1)