Singulink.IO.FileSystem

Singulink.IO.FileSystem is a reliable cross-platform library that provides strongly-typed file/directory path manipulation and file system access in .NET. It has been designed to encourage developers to code with explicit intent in such a way that their applications can work seamlessly and bug free across both Unix and Windows file systems under all conditions. System.IO.* has numerous pitfalls that make 99% of file system code out in the wild fragile and problematic in edge cases. It also contains behavioral inconsistencies between Unix and Windows file systems that are abstracted and handled by this library so you don't have to worry about them.

Singulink.IO.FileSystem is part of the Singulink Libraries collection. Visit https://github.com/Singulink/ to see our full list of publicly available libraries and other open-source projects.

Installation

The package is available on NuGet - simply install the Singulink.IO.FileSystem package.

Supported Runtimes: .NET 8.0+

Here are some additonal links to get you started:

  • Getting Started - Visit here first for a quick walkthrough and entry point to additional guides.
  • Problems with System.IO - Primer on some of the issues with System.IO that this library addresses.
  • API Documentation - Browse the fully documented API here.
  • Chat on Discord - Have questions or want to discuss the library? This is the place for all Singulink project discussions.
  • Github Repo - File issues, contribute pull requests or check out the code for yourself!