TestableIO.System.IO.Abstractions.Wrappers
21.0.29
Prefix Reserved
dotnet add package TestableIO.System.IO.Abstractions.Wrappers --version 21.0.29
NuGet\Install-Package TestableIO.System.IO.Abstractions.Wrappers -Version 21.0.29
<PackageReference Include="TestableIO.System.IO.Abstractions.Wrappers" Version="21.0.29" />
paket add TestableIO.System.IO.Abstractions.Wrappers --version 21.0.29
#r "nuget: TestableIO.System.IO.Abstractions.Wrappers, 21.0.29"
// Install TestableIO.System.IO.Abstractions.Wrappers as a Cake Addin #addin nuget:?package=TestableIO.System.IO.Abstractions.Wrappers&version=21.0.29 // Install TestableIO.System.IO.Abstractions.Wrappers as a Cake Tool #tool nuget:?package=TestableIO.System.IO.Abstractions.Wrappers&version=21.0.29
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.0.29)
-
.NETStandard 2.0
- System.IO.FileSystem.AccessControl (>= 5.0.0)
- TestableIO.System.IO.Abstractions (>= 21.0.29)
-
.NETStandard 2.1
- System.IO.FileSystem.AccessControl (>= 5.0.0)
- TestableIO.System.IO.Abstractions (>= 21.0.29)
-
net6.0
- TestableIO.System.IO.Abstractions (>= 21.0.29)
-
net7.0
- TestableIO.System.IO.Abstractions (>= 21.0.29)
-
net8.0
- TestableIO.System.IO.Abstractions (>= 21.0.29)
NuGet packages (13)
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. |
|
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. |
|
AppMotor.Core
The core APIs for the AppMotor framework. |
|
AspNetStatic
Transforms ASP.NET Core into a static site generator. |
GitHub repositories (8)
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.0.29 | 287,645 | 7/25/2024 | |
21.0.26 | 144,303 | 7/13/2024 | |
21.0.22 | 183,448 | 6/22/2024 | |
21.0.2 | 1,342,384 | 3/17/2024 | |
20.0.34 | 37,429 | 3/15/2024 | |
20.0.28 | 115,417 | 3/9/2024 | |
20.0.15 | 1,250,463 | 1/22/2024 | |
20.0.4 | 719,639 | 12/5/2023 | |
20.0.1 | 1,916 | 12/5/2023 | |
19.2.91 | 237,147 | 12/5/2023 | |
19.2.87 | 650,241 | 11/16/2023 | |
19.2.69 | 2,110,194 | 8/29/2023 | |
19.2.67 | 41,554 | 8/25/2023 | |
19.2.66 | 2,265 | 8/25/2023 | |
19.2.64 | 87,300 | 8/22/2023 | |
19.2.63 | 2,772 | 8/22/2023 | |
19.2.61 | 16,618 | 8/21/2023 | |
19.2.51 | 282,725 | 7/31/2023 | |
19.2.50 | 5,608 | 7/31/2023 | |
19.2.29 | 1,809,667 | 5/17/2023 | |
19.2.26 | 59,006 | 5/12/2023 | |
19.2.25 | 3,005 | 5/12/2023 | |
19.2.22 | 187,591 | 5/4/2023 | |
19.2.18 | 248,540 | 4/24/2023 | |
19.2.17 | 12,005 | 4/23/2023 | |
19.2.16 | 131,439 | 4/19/2023 | |
19.2.15 | 357,651 | 4/18/2023 | |
19.2.13 | 2,787 | 4/18/2023 | |
19.2.12 | 5,828 | 4/18/2023 | |
19.2.11 | 81,140 | 4/13/2023 | |
19.2.9 | 56,860 | 4/11/2023 | |
19.2.8 | 7,452 | 4/11/2023 | |
19.2.4 | 1,135,374 | 3/13/2023 | |
19.2.1 | 369,581 | 3/2/2023 | |
19.1.18 | 405,239 | 2/14/2023 | |
19.1.14 | 176,967 | 1/31/2023 | |
19.1.13 | 387,321 | 1/24/2023 | |
19.1.5 | 1,681,494 | 12/19/2022 | |
19.1.1 | 85,312 | 12/13/2022 | |
19.0.1 | 193,184 | 12/8/2022 | |
18.0.1 | 441,303 | 11/28/2022 | |
17.2.26 | 264,099 | 11/18/2022 |