System.IO.Abstractions 22.0.14

System.IO.Abstractions NuGet Build Quality Gate Status Coverage Renovate enabled FOSSA Status

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);
        }
    }
}

Showing the top 20 packages that depend on System.IO.Abstractions.

Packages Downloads
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
16
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
15
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
14

Version Downloads Last updated
22.0.14 4 04/24/2025
22.0.13 9 04/10/2025
22.0.12 9 03/17/2025
22.0.11 11 03/01/2025
22.0.10 7 02/27/2025
22.0.10-beta.1 8 02/26/2025
22.0.9 10 02/26/2025
21.3.1 9 01/29/2025
21.2.12 12 01/29/2025
21.2.8 11 01/27/2025
21.2.1 12 01/01/2025
21.1.7 8 01/02/2025
21.1.3 11 11/21/2024
21.1.2 8 11/21/2024
21.1.1 8 11/21/2024
21.0.29 9 10/06/2024
21.0.26 9 10/06/2024
21.0.22 8 10/06/2024
21.0.2 13 10/06/2024
20.0.34 10 10/06/2024
20.0.28 11 10/06/2024
20.0.15 13 10/06/2024
20.0.4 8 10/06/2024
20.0.1 13 10/06/2024
19.2.91 9 10/06/2024
19.2.87 11 10/06/2024
19.2.69 10 10/06/2024
19.2.67 9 10/06/2024
19.2.66 13 10/06/2024
19.2.64 12 10/06/2024
19.2.63 13 10/06/2024
19.2.61 12 10/06/2024
19.2.51 9 10/06/2024
19.2.50 12 10/06/2024
19.2.29 13 10/06/2024
19.2.26 9 10/06/2024
19.2.25 12 10/06/2024
19.2.22 11 10/06/2024
19.2.18 12 10/06/2024
19.2.17 14 10/06/2024
19.2.16 8 10/06/2024
19.2.15 12 10/06/2024
19.2.13 11 10/06/2024
19.2.12 12 10/06/2024
19.2.11 13 10/06/2024
19.2.9 10 10/06/2024
19.2.8 11 10/06/2024
19.2.4 12 10/06/2024
19.2.1 9 10/06/2024
19.1.18 11 10/06/2024
19.1.14 12 10/06/2024
19.1.13 11 10/06/2024
19.1.5 11 10/06/2024
19.1.1 13 10/06/2024
19.0.1 13 10/06/2024
18.0.1 12 10/06/2024
17.2.26 14 10/06/2024
17.2.3 11 10/06/2024
17.2.1 14 10/06/2024
17.1.1 12 10/06/2024
17.0.28 13 10/06/2024
17.0.24 8 10/06/2024
17.0.23 14 10/06/2024
17.0.21 12 10/06/2024
17.0.18 11 10/06/2024
17.0.15 13 10/06/2024
17.0.14 11 10/06/2024
17.0.13 8 10/06/2024
17.0.12 11 10/06/2024
17.0.11 14 10/06/2024
17.0.10 9 10/06/2024
17.0.9 13 10/06/2024
17.0.8 14 10/06/2024
17.0.7 13 10/06/2024
17.0.6 11 10/06/2024
17.0.5 13 10/06/2024
17.0.4 14 10/06/2024
17.0.3 10 10/06/2024
17.0.2 8 10/06/2024
17.0.1 13 10/06/2024
16.1.26 14 10/06/2024
16.1.25 14 10/06/2024
16.1.24 12 10/06/2024
16.1.23 9 10/06/2024
16.1.22 10 10/06/2024
16.1.21 14 10/06/2024
16.1.20 13 10/06/2024
16.1.19 12 10/06/2024
16.1.18 9 10/06/2024
16.1.17 13 10/06/2024
16.1.16 11 10/06/2024
16.1.15 13 10/06/2024
16.1.14 11 10/06/2024
16.1.13 10 10/06/2024
16.1.12 10 10/06/2024
16.1.11 14 10/06/2024
16.1.10 13 10/06/2024
16.1.9 10 10/06/2024
16.1.8 12 10/06/2024
16.1.7 13 10/06/2024
16.1.6 11 10/06/2024
16.1.5 11 10/06/2024
16.1.4 12 10/06/2024
16.1.2 9 10/06/2024
16.1.1 10 10/06/2024
16.0.8 9 10/06/2024
16.0.7 10 10/06/2024
16.0.6 12 10/06/2024
16.0.5 13 10/06/2024
16.0.4 13 10/06/2024
16.0.3 15 10/06/2024
16.0.2 14 10/06/2024
16.0.1 13 10/06/2024
15.0.1 13 10/06/2024
14.0.13 11 10/06/2024
14.0.12 11 10/06/2024
14.0.11 13 10/06/2024
14.0.10 13 10/06/2024
14.0.9 13 10/06/2024
14.0.8 8 10/06/2024
14.0.7 9 10/06/2024
14.0.6 10 10/06/2024
14.0.5 9 10/06/2024
14.0.4 10 10/06/2024
14.0.3 13 10/06/2024
14.0.2 9 10/06/2024
14.0.1 9 10/06/2024
13.2.47 11 10/06/2024
13.2.46 12 10/06/2024
13.2.45 13 10/06/2024
13.2.43 8 10/06/2024
13.2.42 13 10/06/2024
13.2.41 12 10/06/2024
13.2.40 11 10/06/2024
13.2.39 11 10/06/2024
13.2.38 11 10/06/2024
13.2.37 11 10/06/2024
13.2.36 13 10/06/2024
13.2.35 12 10/06/2024
13.2.34 13 10/06/2024
13.2.33 13 10/06/2024
13.2.32 13 10/06/2024
13.2.31 11 10/06/2024
13.2.30 12 10/06/2024
13.2.29 9 10/06/2024
13.2.28 10 10/06/2024
13.2.27 12 10/06/2024
13.2.25 8 10/06/2024
13.2.24 9 10/06/2024
13.2.23 11 10/06/2024
13.2.22 9 10/06/2024
13.2.20 10 10/06/2024
13.2.19 12 10/06/2024
13.2.18 13 10/06/2024
13.2.17 11 10/06/2024
13.2.16 8 10/06/2024
13.2.15 9 10/06/2024
13.2.14 14 10/06/2024
13.2.13 10 10/06/2024
13.2.12 9 10/06/2024
13.2.11 11 10/06/2024
13.2.10 8 10/06/2024
13.2.9 8 10/06/2024
13.2.8 12 10/06/2024
13.2.7 10 10/06/2024
13.2.6 14 10/06/2024
13.2.5 13 10/06/2024
13.2.4 12 10/06/2024
13.2.3 10 10/06/2024
13.2.2 9 10/06/2024
13.2.1 8 10/06/2024
13.1.2 13 10/06/2024
13.1.1 12 10/06/2024
13.0.1 8 10/06/2024
12.2.27 10 10/06/2024
12.2.26 13 10/06/2024
12.2.25 10 10/06/2024
12.2.24 11 10/06/2024
12.2.23 14 10/06/2024
12.2.22 10 10/06/2024
12.2.21 8 10/06/2024
12.2.20 14 10/06/2024
12.2.19 10 10/06/2024
12.2.7 12 10/06/2024
12.2.6 15 10/06/2024
12.2.5 13 10/06/2024
12.2.4 11 10/06/2024
12.2.3 13 10/06/2024
12.2.2 13 10/06/2024
12.2.1 13 10/06/2024
12.1.11 13 10/06/2024
12.1.10 13 10/06/2024
12.1.9 13 10/06/2024
12.1.2 13 10/06/2024
12.1.1 12 10/06/2024
12.0.13 13 10/06/2024
12.0.10 11 10/06/2024
12.0.9 13 10/06/2024
12.0.8 13 10/06/2024
12.0.7 11 10/06/2024
12.0.6 14 10/06/2024
12.0.5 12 10/06/2024
12.0.4 10 10/06/2024
12.0.3 10 10/06/2024
12.0.2 12 10/06/2024
12.0.1 11 10/06/2024
11.0.18 12 10/06/2024
11.0.17 9 10/06/2024
11.0.16 11 10/06/2024
11.0.15 10 10/06/2024
11.0.14 10 10/06/2024
11.0.13 13 10/06/2024
11.0.12 12 10/06/2024
11.0.11 8 10/06/2024
11.0.10 8 10/06/2024
11.0.9 13 10/06/2024
11.0.8 13 10/06/2024
11.0.7 13 10/06/2024
11.0.6 10 10/06/2024
11.0.5 13 10/06/2024
11.0.4 13 10/06/2024
11.0.3 12 10/06/2024
11.0.2 13 10/06/2024
11.0.1 12 10/06/2024
10.0.10 10 10/06/2024
10.0.9 11 10/06/2024
10.0.8 13 10/06/2024
10.0.7 9 10/06/2024
10.0.6 13 10/06/2024
10.0.5 13 10/06/2024
10.0.4 13 10/06/2024
10.0.1 9 10/06/2024
9.0.6 13 10/06/2024
9.0.5 10 10/06/2024
9.0.4 10 10/06/2024
9.0.3 8 10/06/2024
9.0.2 12 10/06/2024
9.0.1 12 10/06/2024
8.1.1 9 10/06/2024
8.0.6 10 10/06/2024
8.0.5 13 10/06/2024
8.0.4 13 10/06/2024
8.0.3 10 10/06/2024
7.1.10 12 10/06/2024
7.1.8 11 10/06/2024
7.1.4 11 10/06/2024
7.1.3 13 10/06/2024
7.1.1 9 10/06/2024
7.0.16 8 10/06/2024
7.0.15 13 10/06/2024
7.0.7 11 10/06/2024
7.0.5 11 10/06/2024
7.0.4 12 10/06/2024
6.0.38 11 10/06/2024
6.0.36 9 10/06/2024
6.0.34 14 10/06/2024
6.0.32 11 10/06/2024
6.0.27 11 10/06/2024
6.0.25 12 10/06/2024
6.0.23 13 10/06/2024
6.0.21 10 10/06/2024
6.0.19 12 10/06/2024
6.0.17 11 10/06/2024
6.0.15 12 10/06/2024
6.0.14 13 10/06/2024
6.0.13 14 10/06/2024
6.0.11 12 10/06/2024
6.0.9 12 10/06/2024
6.0.7 12 10/06/2024
6.0.6 11 10/06/2024
6.0.5 13 10/06/2024
6.0.3 10 10/06/2024
6.0.1 9 10/06/2024
5.0.1 11 10/06/2024
4.2.17 11 10/06/2024
4.2.15 10 10/06/2024
4.2.13 13 10/06/2024
4.2.12 8 10/06/2024
4.2.10 11 10/06/2024
4.2.9 14 10/06/2024
4.2.8 14 10/06/2024
4.2.4 13 10/06/2024
4.1.6 10 10/06/2024
4.0.11 13 10/06/2024
3.1.1 12 10/06/2024
3.0.10 13 10/06/2024
3.0.2 12 10/06/2024
2.2.18-beta 13 10/06/2024
2.2.17-beta 10 10/06/2024
2.2.16-beta 12 10/06/2024
2.2.15-beta 12 10/06/2024
2.2.14-beta 10 10/06/2024
2.2.13-beta 12 10/06/2024
2.2.12-beta 9 10/06/2024
2.2.11-beta 11 10/06/2024
2.2.10-beta 13 10/06/2024
2.2.9-beta 11 10/06/2024
2.2.8-beta 13 10/06/2024
2.2.7-beta 9 10/06/2024
2.2.6-beta 10 10/06/2024
2.2.5-beta 13 10/06/2024
2.2.4-beta 10 10/06/2024
2.2.3-beta 10 10/06/2024
2.2.2-beta 13 10/06/2024
2.1.0.256 14 10/06/2024
2.1.0.247 11 10/06/2024
2.1.0.237 9 10/06/2024
2.1.0.236 13 10/06/2024
2.1.0.235 13 10/06/2024
2.1.0.234 12 10/06/2024
2.1.0.233 8 10/06/2024
2.1.0.232 12 10/06/2024
2.1.0.231 10 10/06/2024
2.1.0.230 8 10/06/2024
2.1.0.229 8 10/06/2024
2.1.0.228 11 10/06/2024
2.1.0.227 12 10/06/2024
2.1.0.226 11 10/06/2024
2.1.0.217 12 10/06/2024
2.1.0.216 13 10/06/2024
2.1.0.215 8 10/06/2024
2.1.0.214 8 10/06/2024
2.1.0.213 13 10/06/2024
2.1.0.211 14 10/06/2024
2.1.0.210 10 10/06/2024
2.1.0.209 11 10/06/2024
2.1.0.208 13 10/06/2024
2.1.0.207 11 10/06/2024
2.1.0.206 11 10/06/2024
2.1.0.205 8 10/06/2024
2.1.0.204 11 10/06/2024
2.1.0.203 12 10/06/2024
2.1.0.202 7 10/06/2024
2.1.0.201 13 10/06/2024
2.1.0.200 12 10/06/2024
2.1.0.199 9 10/06/2024
2.1.0.198 11 10/06/2024
2.1.0.197 10 10/06/2024
2.1.0.196 13 10/06/2024
2.1.0.195 11 10/06/2024
2.1.0.194 13 10/06/2024
2.1.0.193 14 10/06/2024
2.1.0.192 9 10/06/2024
2.1.0.191 12 10/06/2024
2.1.0.190 11 10/06/2024
2.1.0.189 13 10/06/2024
2.1.0.188 13 10/06/2024
2.1.0.187 13 10/06/2024
2.1.0.186 12 10/06/2024
2.1.0.185 11 10/06/2024
2.1.0.184 12 10/06/2024
2.1.0.183 9 10/06/2024
2.1.0.182 11 10/06/2024
2.1.0.181 14 10/06/2024
2.1.0.180 12 10/06/2024
2.1.0.179 13 10/06/2024
2.1.0.178 11 10/06/2024
2.1.0.177 14 10/06/2024
2.1.0.176 13 10/06/2024
2.1.0.175 13 10/06/2024
2.1.0.174 9 10/06/2024
2.1.0.173 13 10/06/2024
2.1.0.172 13 10/06/2024
2.1.0.171 13 10/06/2024
2.1.0.170 12 10/06/2024
2.1.0.169 9 10/06/2024
2.1.0.168 8 10/06/2024
2.1.0.166 12 10/06/2024
2.1.0.164 8 10/06/2024
2.1.0.163 14 10/06/2024
2.1.0.159 8 10/06/2024
2.0.0.144 12 10/06/2024
2.0.0.143 13 10/06/2024
2.0.0.142 11 10/06/2024
2.0.0.141 11 10/06/2024
2.0.0.140 12 10/06/2024
2.0.0.139 12 10/06/2024
2.0.0.138 13 10/06/2024
2.0.0.137 8 10/06/2024
2.0.0.136 11 10/06/2024
2.0.0.124 11 10/06/2024
2.0.0.123 12 10/06/2024
2.0.0.122 13 10/06/2024
2.0.0.121 13 10/06/2024
2.0.0.120 13 10/06/2024
2.0.0.119 12 10/06/2024
2.0.0.118 9 10/06/2024
2.0.0.117 11 10/06/2024
2.0.0.116 11 10/06/2024
2.0.0.115 13 10/06/2024
2.0.0.114 10 10/06/2024
2.0.0.113 13 10/06/2024
2.0.0.112 12 10/06/2024
2.0.0.111 14 10/06/2024
2.0.0.110 10 10/06/2024
2.0.0.109 10 10/06/2024
2.0.0.108 10 10/06/2024
2.0.0.107 8 10/06/2024
2.0.0.106 11 10/06/2024
2.0.0.105 11 10/06/2024
2.0.0.104 12 10/06/2024
2.0.0.103 10 10/06/2024
2.0.0.102 13 10/06/2024
2.0.0.101 13 10/06/2024
2.0.0.100 13 10/06/2024
2.0.0.99 11 10/06/2024
2.0.0.98 12 10/06/2024
1.4.0.93 12 10/06/2024
1.4.0.92 9 10/06/2024
1.4.0.89 13 10/06/2024
1.4.0.88 9 10/06/2024
1.4.0.87 12 10/06/2024
1.4.0.86 11 10/06/2024
1.4.0.85 12 10/06/2024
1.4.0.84 13 10/06/2024
1.4.0.83 13 10/06/2024
1.4.0.82 10 10/06/2024
1.4.0.81 7 10/06/2024
1.4.0.80 8 10/06/2024
1.4.0.79 12 10/06/2024
1.4.0.78 11 10/06/2024
1.4.0.77 13 10/06/2024
1.4.0.76 10 10/06/2024
1.4.0.75 11 10/06/2024
1.4.0.74 12 10/06/2024
1.4.0.73 8 10/06/2024
1.4.0.72 9 10/06/2024
1.4.0.71 13 10/06/2024
1.4.0.70 13 10/06/2024
1.4.0.69 13 10/06/2024
1.4.0.68 11 10/06/2024
1.4.0.67 10 10/06/2024
1.4.0.66 10 10/06/2024
1.4.0.65 10 10/06/2024
1.4.0.64 11 10/06/2024
1.4.0.63 13 10/06/2024
1.4.0.62 11 10/06/2024
1.4.0.61 9 10/06/2024
1.4.0.60 13 10/06/2024
1.4.0.59 11 10/06/2024
1.4.0.58 13 10/06/2024
1.4.0.57 11 10/06/2024
1.4.0.56 13 10/06/2024
1.4.0.55 13 10/06/2024
1.4.0.54 13 10/06/2024
1.4.0.53 11 10/06/2024
1.4.0.52 8 10/06/2024
1.4.0.51 9 10/06/2024
1.4.0.50 11 10/06/2024
1.4.0.49 11 10/06/2024
1.4.0.48 11 10/06/2024
1.4.0.47 12 10/06/2024
1.4.0.46 13 10/06/2024
1.4.0.45 11 10/06/2024
1.4.0.44 13 10/06/2024
1.4.0.43 13 10/06/2024
1.4.0.42 12 10/06/2024
1.4.0.41 11 10/06/2024
1.4.0.40 8 10/06/2024
1.4.0.39 10 10/06/2024
1.4.0.38 13 10/06/2024
1.4.0.37 13 10/06/2024
1.4.0.36 8 10/06/2024
1.4.0.35 11 10/06/2024
1.4.0.34 9 10/06/2024
1.4.0.33 8 10/06/2024
1.4.0.32 11 10/06/2024
1.4.0.31 12 10/06/2024
1.4.0.30 10 10/06/2024
1.4.0.29 13 10/06/2024
1.4.0.28 13 10/06/2024
1.4.0.27 13 10/06/2024
1.4.0.26 8 10/06/2024
1.4.0.25 12 10/06/2024
1.4.0.24 12 10/06/2024
1.4.0.23 8 10/06/2024
1.4.0.22 9 10/06/2024
1.4.0.21 13 10/06/2024
1.4.0.20 13 10/06/2024
1.4.0.19 10 10/06/2024
1.4.0.18 10 10/06/2024
1.4.0.17 12 10/06/2024
1.4.0.14 9 10/06/2024
1.4.0.13 13 10/06/2024
1.4.0.12 10 10/06/2024
1.4.0.11 11 10/06/2024
1.3.0 13 10/06/2024
1.2.0 9 10/06/2024