System.IO.Abstractions 22.0.15

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.
20
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
19
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
18
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
17

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