TestableIO.System.IO.Abstractions.Wrappers
21.1.7
Prefix Reserved
dotnet add package TestableIO.System.IO.Abstractions.Wrappers --version 21.1.7
NuGet\Install-Package TestableIO.System.IO.Abstractions.Wrappers -Version 21.1.7
<PackageReference Include="TestableIO.System.IO.Abstractions.Wrappers" Version="21.1.7" />
paket add TestableIO.System.IO.Abstractions.Wrappers --version 21.1.7
#r "nuget: TestableIO.System.IO.Abstractions.Wrappers, 21.1.7"
// Install TestableIO.System.IO.Abstractions.Wrappers as a Cake Addin #addin nuget:?package=TestableIO.System.IO.Abstractions.Wrappers&version=21.1.7 // Install TestableIO.System.IO.Abstractions.Wrappers as a Cake Tool #tool nuget:?package=TestableIO.System.IO.Abstractions.Wrappers&version=21.1.7
At the core of the library is IFileSystem
and FileSystem
. Instead of calling methods like File.ReadAllText
directly, use IFileSystem.File.ReadAllText
. We have exactly the same API, except that ours is injectable and testable.
Usage
dotnet add package TestableIO.System.IO.Abstractions.Wrappers
Note: This NuGet package is also published as System.IO.Abstractions
but we suggest to use the prefix to make clear that this is not an official .NET package.
public class MyComponent
{
readonly IFileSystem fileSystem;
// <summary>Create MyComponent with the given fileSystem implementation</summary>
public MyComponent(IFileSystem fileSystem)
{
this.fileSystem = fileSystem;
}
/// <summary>Create MyComponent</summary>
public MyComponent() : this(
fileSystem: new FileSystem() //use default implementation which calls System.IO
)
{
}
public void Validate()
{
foreach (var textFile in fileSystem.Directory.GetFiles(@"c:\", "*.txt", SearchOption.TopDirectoryOnly))
{
var text = fileSystem.File.ReadAllText(textFile);
if (text != "Testing is awesome.")
throw new NotSupportedException("We can't go on together. It's not me, it's you.");
}
}
}
Test helpers
The library also ships with a series of test helpers to save you from having to mock out every call, for basic scenarios. They are not a complete copy of a real-life file system, but they'll get you most of the way there.
dotnet add package TestableIO.System.IO.Abstractions.TestingHelpers
Note: This NuGet package is also published as System.IO.Abstractions.TestingHelpers
but we suggest to use the prefix to make clear that this is not an official .NET package.
[Test]
public void MyComponent_Validate_ShouldThrowNotSupportedExceptionIfTestingIsNotAwesome()
{
// Arrange
var fileSystem = new MockFileSystem(new Dictionary<string, MockFileData>
{
{ @"c:\myfile.txt", new MockFileData("Testing is meh.") },
{ @"c:\demo\jQuery.js", new MockFileData("some js") },
{ @"c:\demo\image.gif", new MockFileData(new byte[] { 0x12, 0x34, 0x56, 0xd2 }) }
});
var component = new MyComponent(fileSystem);
try
{
// Act
component.Validate();
}
catch (NotSupportedException ex)
{
// Assert
Assert.That(ex.Message, Is.EqualTo("We can't go on together. It's not me, it's you."));
return;
}
Assert.Fail("The expected exception was not thrown.");
}
We even support casting from the .NET Framework's untestable types to our testable wrappers:
FileInfo SomeApiMethodThatReturnsFileInfo()
{
return new FileInfo("a");
}
void MyFancyMethod()
{
var testableFileInfo = (FileInfoBase)SomeApiMethodThatReturnsFileInfo();
...
}
Mock support
Since version 4.0 the top-level APIs expose interfaces instead of abstract base classes (these still exist, though), allowing you to completely mock the file system. Here's a small example, using Moq:
[Test]
public void Test1()
{
var watcher = Mock.Of<IFileSystemWatcher>();
var file = Mock.Of<IFile>();
Mock.Get(file).Setup(f => f.Exists(It.IsAny<string>())).Returns(true);
Mock.Get(file).Setup(f => f.ReadAllText(It.IsAny<string>())).Throws<OutOfMemoryException>();
var unitUnderTest = new SomeClassUsingFileSystemWatcher(watcher, file);
Assert.Throws<OutOfMemoryException>(() => {
Mock.Get(watcher).Raise(w => w.Created += null, new System.IO.FileSystemEventArgs(System.IO.WatcherChangeTypes.Created, @"C:\Some\Directory", "Some.File"));
});
Mock.Get(file).Verify(f => f.Exists(It.IsAny<string>()), Times.Once);
Assert.True(unitUnderTest.FileWasCreated);
}
public class SomeClassUsingFileSystemWatcher
{
private readonly IFileSystemWatcher _watcher;
private readonly IFile _file;
public bool FileWasCreated { get; private set; }
public SomeClassUsingFileSystemWatcher(IFileSystemWatcher watcher, IFile file)
{
this._file = file;
this._watcher = watcher;
this._watcher.Created += Watcher_Created;
}
private void Watcher_Created(object sender, System.IO.FileSystemEventArgs e)
{
FileWasCreated = true;
if(_file.Exists(e.FullPath))
{
var text = _file.ReadAllText(e.FullPath);
}
}
}
Related projects
System.IO.Abstractions.Extensions
provides convenience functionality on top of the core abstractions.System.IO.Abstractions.Analyzers
provides Roslyn analyzers to help use abstractions over static methods.Testably.Abstractions
provides alternative test helpers and additional abstractions.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- TestableIO.System.IO.Abstractions (>= 21.1.7)
-
.NETStandard 2.0
- System.IO.FileSystem.AccessControl (>= 5.0.0)
- TestableIO.System.IO.Abstractions (>= 21.1.7)
-
.NETStandard 2.1
- System.IO.FileSystem.AccessControl (>= 5.0.0)
- TestableIO.System.IO.Abstractions (>= 21.1.7)
-
net6.0
- TestableIO.System.IO.Abstractions (>= 21.1.7)
-
net7.0
- TestableIO.System.IO.Abstractions (>= 21.1.7)
-
net8.0
- TestableIO.System.IO.Abstractions (>= 21.1.7)
NuGet packages (20)
Showing the top 5 NuGet packages that depend on TestableIO.System.IO.Abstractions.Wrappers:
Package | Downloads |
---|---|
System.IO.Abstractions
A set of abstractions to help make file system interactions testable. |
|
TestableIO.System.IO.Abstractions.TestingHelpers
A set of pre-built mocks to help when testing file system interactions. |
|
FluentStorage
FluentStorage, originally known as Storage.NET, is a polycloud .NET cloud storage library to interface with multiple cloud providers from a single unified interface. Provides Blob storage (AWS S3, GCP, FTP, SFTP, Azure Blob/File/Event Hub/Data Lake) and Messaging (AWS SQS, Azure Queue/ServiceBus). Supports .NET 5+ and .NET Standard 2.0+. Pure C#. MIT license. Commercial use allowed. |
|
stryker
All stryker mutation test logic is contained in this library. This package does not include a runner. Use this package if you want to extend stryker with your own runner. |
|
Asv.IO
Package Description |
GitHub repositories (9)
Showing the top 5 popular GitHub repositories that depend on TestableIO.System.IO.Abstractions.Wrappers:
Repository | Stars |
---|---|
Kareadita/Kavita
Kavita is a fast, feature rich, cross platform reading server. Built with the goal of being a full solution for all your reading needs. Setup your own server and share your reading collection with your friends and family.
|
|
stryker-mutator/stryker-net
Mutation testing for .NET core and .NET framework!
|
|
NethermindEth/nethermind
A robust execution client for Ethereum node operators.
|
|
recyclarr/recyclarr
Automatically sync TRaSH Guides to your Sonarr and Radarr instances
|
|
prom3theu5/aspirational-manifests
Handle deployments of .NET Aspire AppHost Projects
|
Version | Downloads | Last updated | |
---|---|---|---|
21.1.7 | 98,704 | 12/3/2024 | |
21.1.3 | 344,943 | 11/8/2024 | |
21.1.2 | 6,726 | 11/8/2024 | |
21.1.1 | 6,488 | 11/7/2024 | |
21.0.29 | 1,881,700 | 7/25/2024 | |
21.0.26 | 307,970 | 7/13/2024 | |
21.0.22 | 332,188 | 6/22/2024 | |
21.0.2 | 1,869,778 | 3/17/2024 | |
20.0.34 | 52,976 | 3/15/2024 | |
20.0.28 | 150,739 | 3/9/2024 | |
20.0.15 | 1,539,010 | 1/22/2024 | |
20.0.4 | 881,764 | 12/5/2023 | |
20.0.1 | 2,305 | 12/5/2023 | |
19.2.91 | 273,797 | 12/5/2023 | |
19.2.87 | 711,897 | 11/16/2023 | |
19.2.69 | 2,494,355 | 8/29/2023 | |
19.2.67 | 47,150 | 8/25/2023 | |
19.2.66 | 2,604 | 8/25/2023 | |
19.2.64 | 104,766 | 8/22/2023 | |
19.2.63 | 3,126 | 8/22/2023 | |
19.2.61 | 20,039 | 8/21/2023 | |
19.2.51 | 299,836 | 7/31/2023 | |
19.2.50 | 6,214 | 7/31/2023 | |
19.2.29 | 1,977,525 | 5/17/2023 | |
19.2.26 | 68,056 | 5/12/2023 | |
19.2.25 | 3,371 | 5/12/2023 | |
19.2.22 | 202,266 | 5/4/2023 | |
19.2.18 | 263,208 | 4/24/2023 | |
19.2.17 | 12,427 | 4/23/2023 | |
19.2.16 | 139,308 | 4/19/2023 | |
19.2.15 | 373,802 | 4/18/2023 | |
19.2.13 | 3,145 | 4/18/2023 | |
19.2.12 | 6,637 | 4/18/2023 | |
19.2.11 | 83,396 | 4/13/2023 | |
19.2.9 | 64,870 | 4/11/2023 | |
19.2.8 | 7,892 | 4/11/2023 | |
19.2.4 | 1,261,316 | 3/13/2023 | |
19.2.1 | 398,861 | 3/2/2023 | |
19.1.18 | 425,625 | 2/14/2023 | |
19.1.14 | 190,342 | 1/31/2023 | |
19.1.13 | 408,701 | 1/24/2023 | |
19.1.5 | 2,118,492 | 12/19/2022 | |
19.1.1 | 91,855 | 12/13/2022 | |
19.0.1 | 216,556 | 12/8/2022 | |
18.0.1 | 475,211 | 11/28/2022 | |
17.2.26 | 281,267 | 11/18/2022 |