TestableIO.System.IO.Abstractions.TestingHelpers
19.2.66
Prefix Reserved
See the version list below for details.
dotnet add package TestableIO.System.IO.Abstractions.TestingHelpers --version 19.2.66
NuGet\Install-Package TestableIO.System.IO.Abstractions.TestingHelpers -Version 19.2.66
<PackageReference Include="TestableIO.System.IO.Abstractions.TestingHelpers" Version="19.2.66" />
paket add TestableIO.System.IO.Abstractions.TestingHelpers --version 19.2.66
#r "nuget: TestableIO.System.IO.Abstractions.TestingHelpers, 19.2.66"
// Install TestableIO.System.IO.Abstractions.TestingHelpers as a Cake Addin #addin nuget:?package=TestableIO.System.IO.Abstractions.TestingHelpers&version=19.2.66 // Install TestableIO.System.IO.Abstractions.TestingHelpers as a Cake Tool #tool nuget:?package=TestableIO.System.IO.Abstractions.TestingHelpers&version=19.2.66
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.AreEqual("We can't go on together. It's not me, it's you.", ex.Message);
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 is compatible. 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 was computed. 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 is compatible. net462 was computed. 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.1
- TestableIO.System.IO.Abstractions (>= 19.2.66)
- TestableIO.System.IO.Abstractions.Wrappers (>= 19.2.66)
-
.NETStandard 2.0
- TestableIO.System.IO.Abstractions (>= 19.2.66)
- TestableIO.System.IO.Abstractions.Wrappers (>= 19.2.66)
-
.NETStandard 2.1
- TestableIO.System.IO.Abstractions (>= 19.2.66)
- TestableIO.System.IO.Abstractions.Wrappers (>= 19.2.66)
-
net5.0
- TestableIO.System.IO.Abstractions (>= 19.2.66)
- TestableIO.System.IO.Abstractions.Wrappers (>= 19.2.66)
-
net6.0
- TestableIO.System.IO.Abstractions (>= 19.2.66)
- TestableIO.System.IO.Abstractions.Wrappers (>= 19.2.66)
-
net7.0
- TestableIO.System.IO.Abstractions (>= 19.2.66)
- TestableIO.System.IO.Abstractions.Wrappers (>= 19.2.66)
NuGet packages (6)
Showing the top 5 NuGet packages that depend on TestableIO.System.IO.Abstractions.TestingHelpers:
Package | Downloads |
---|---|
System.IO.Abstractions.TestingHelpers
A set of pre-built mocks to help when testing file system interactions. |
|
Reo.Core.Testing
Package Description |
|
FastMoq.Core
Easy and fast extension of the famous Moq mocking framework for mocking and auto injection of classes when testing. |
|
SlugEnt.ResourceHealthChecker.FileSystem
Package Description |
|
Whipstaff.TestableIO.System.IO.Abstractions.TestingHelpers
Re-usable logic for testing File System abstractions. |
GitHub repositories (10)
Showing the top 5 popular GitHub repositories that depend on TestableIO.System.IO.Abstractions.TestingHelpers:
Repository | Stars |
---|---|
gui-cs/Terminal.Gui
Cross Platform Terminal UI toolkit for .NET
|
|
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 | 228,256 | 7/25/2024 |
21.0.26 | 78,240 | 7/13/2024 |
21.0.22 | 89,098 | 6/22/2024 |
21.0.2 | 508,261 | 3/17/2024 |
20.0.34 | 20,508 | 3/15/2024 |
20.0.28 | 32,325 | 3/9/2024 |
20.0.15 | 388,020 | 1/22/2024 |
20.0.4 | 249,033 | 12/5/2023 |
20.0.1 | 769 | 12/5/2023 |
19.2.91 | 170,183 | 12/5/2023 |
19.2.87 | 155,672 | 11/16/2023 |
19.2.69 | 490,716 | 8/29/2023 |
19.2.67 | 21,504 | 8/25/2023 |
19.2.66 | 858 | 8/25/2023 |
19.2.64 | 15,539 | 8/22/2023 |
19.2.63 | 1,089 | 8/22/2023 |
19.2.61 | 8,856 | 8/21/2023 |
19.2.51 | 96,635 | 7/31/2023 |
19.2.50 | 2,081 | 7/31/2023 |
19.2.29 | 492,978 | 5/17/2023 |
19.2.26 | 32,180 | 5/12/2023 |
19.2.25 | 998 | 5/12/2023 |
19.2.22 | 97,598 | 5/4/2023 |
19.2.18 | 69,095 | 4/24/2023 |
19.2.17 | 7,254 | 4/23/2023 |
19.2.16 | 17,735 | 4/19/2023 |
19.2.15 | 7,471 | 4/18/2023 |
19.2.13 | 1,036 | 4/18/2023 |
19.2.12 | 3,911 | 4/18/2023 |
19.2.11 | 28,528 | 4/13/2023 |
19.2.9 | 20,706 | 4/11/2023 |
19.2.8 | 1,893 | 4/11/2023 |
19.2.4 | 219,050 | 3/13/2023 |
19.2.1 | 86,527 | 3/2/2023 |
19.1.18 | 156,461 | 2/14/2023 |
19.1.14 | 53,987 | 1/31/2023 |
19.1.13 | 89,392 | 1/24/2023 |
19.1.5 | 222,568 | 12/19/2022 |
19.1.1 | 36,414 | 12/13/2022 |
19.0.1 | 51,335 | 12/8/2022 |
18.0.1 | 75,090 | 11/28/2022 |