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.
21
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
22
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
23
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
24
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
25
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
26

Version Downloads Last updated
22.0.15 4 07/22/2025
22.0.14 6 04/28/2025
22.0.13 12 04/06/2025
22.0.12 9 03/20/2025
22.0.11 9 03/04/2025
22.0.10 10 02/25/2025
22.0.10-beta.1 8 02/25/2025
22.0.9 10 02/23/2025
21.3.1 13 01/31/2025
21.2.12 13 01/31/2025
21.2.8 10 01/25/2025
21.2.1 13 12/29/2024
21.1.7 12 12/24/2024
21.1.3 17 11/12/2024
21.1.2 18 11/20/2024
21.1.1 12 12/09/2024
21.0.29 17 12/07/2024
21.0.26 14 12/15/2024
21.0.22 16 12/03/2024
21.0.2 22 05/18/2024
20.0.34 19 05/15/2024
20.0.28 19 05/23/2024
20.0.15 25 04/10/2024
20.0.4 22 12/20/2023
20.0.1 25 04/09/2024
19.2.91 20 05/25/2024
19.2.87 20 05/23/2024
19.2.69 21 05/15/2024
19.2.67 15 05/19/2024
19.2.66 20 05/11/2024
19.2.64 15 05/25/2024
19.2.63 21 05/03/2024
19.2.61 19 05/24/2024
19.2.51 18 05/25/2024
19.2.50 15 05/25/2024
19.2.29 22 05/08/2024
19.2.26 17 05/25/2024
19.2.25 20 05/07/2024
19.2.22 19 05/09/2024
19.2.18 21 05/13/2024
19.2.17 19 05/25/2024
19.2.16 19 05/10/2024
19.2.15 19 05/22/2024
19.2.13 24 05/25/2024
19.2.12 22 05/11/2024
19.2.11 21 05/15/2024
19.2.9 15 05/21/2024
19.2.8 25 04/30/2024
19.2.4 19 05/17/2024
19.2.1 26 05/09/2024
19.1.18 21 05/06/2024
19.1.14 22 05/04/2024
19.1.13 16 05/25/2024
19.1.5 22 05/19/2024
19.1.1 20 05/02/2024
19.0.1 22 05/19/2024
18.0.1 20 04/22/2024
17.2.26 24 05/11/2024
17.2.3 18 05/25/2024
17.2.1 18 04/09/2024
17.1.1 18 05/25/2024
17.0.28 33 04/09/2024
17.0.24 15 05/25/2024
17.0.23 19 05/02/2024
17.0.21 18 05/25/2024
17.0.18 20 05/24/2024
17.0.15 21 05/06/2024
17.0.14 21 05/25/2024
17.0.13 20 05/24/2024
17.0.12 21 05/25/2024
17.0.11 16 05/25/2024
17.0.10 16 05/02/2024
17.0.9 21 05/23/2024
17.0.8 17 05/16/2024
17.0.7 21 05/24/2024
17.0.6 19 05/09/2024
17.0.5 19 05/25/2024
17.0.4 28 05/15/2024
17.0.3 21 05/05/2024
17.0.2 27 05/25/2024
17.0.1 20 05/25/2024
16.1.26 18 05/25/2024
16.1.22 16 05/25/2024
16.1.18 17 05/14/2024
16.1.16 15 05/01/2024
16.1.13 23 05/03/2024
16.1.12 20 05/07/2024
16.1.9 21 05/22/2024
16.1.4 17 05/23/2024
16.0.8 17 05/06/2024
16.0.7 23 05/13/2024
16.0.6 22 05/13/2024
16.0.5 23 05/19/2024
16.0.4 21 05/02/2024
16.0.3 24 05/15/2024
16.0.2 21 05/10/2024
16.0.1 18 05/21/2024
15.0.1 15 05/20/2024
14.0.13 18 05/06/2024
14.0.12 19 05/06/2024
14.0.11 23 05/10/2024
14.0.10 20 05/14/2024
14.0.9 19 05/11/2024
14.0.7 17 05/25/2024
14.0.6 19 05/10/2024
14.0.5 21 05/24/2024
14.0.4 18 05/25/2024
14.0.3 16 05/21/2024
13.2.32 18 05/25/2024
13.2.31 20 05/19/2024
13.2.9 20 05/09/2024
13.2.7 19 05/05/2024
13.2.5 17 05/08/2024
13.2.4 17 05/06/2024
13.2.3 20 05/16/2024
13.0.1 18 05/14/2024
12.2.26 14 05/25/2024
12.2.25 20 05/25/2024
12.2.7 24 05/25/2024
12.2.4 19 04/30/2024
12.2.1 19 05/25/2024
12.1.11 25 05/08/2024
12.1.2 18 05/07/2024
12.0.7 19 05/16/2024
12.0.2 26 05/25/2024
11.0.18 24 05/25/2024
11.0.17 22 05/25/2024
11.0.16 18 05/18/2024
11.0.13 23 05/31/2024
11.0.11 20 05/03/2024
11.0.9 14 05/10/2024
11.0.7 21 04/26/2022
11.0.5 15 05/25/2024
11.0.4 20 04/26/2022
11.0.2 16 05/19/2024
10.0.9 17 05/22/2024
10.0.8 21 05/01/2024
10.0.6 21 05/13/2024
10.0.5 18 05/01/2024
10.0.4 18 05/25/2024
9.0.6 23 05/18/2024
9.0.4 21 05/14/2024
9.0.3 21 05/25/2024
9.0.2 23 05/09/2024
8.1.1 20 05/23/2024
8.0.3 20 05/22/2024
7.1.4 22 05/23/2024
7.1.1 25 05/11/2024
7.0.15 17 05/21/2024
6.0.36 23 05/13/2024
6.0.34 19 05/07/2024
6.0.27 22 05/09/2024
6.0.25 20 05/25/2024
6.0.23 17 05/01/2024
6.0.21 21 05/02/2024
6.0.17 21 05/21/2024
6.0.14 17 05/25/2024
6.0.13 25 05/04/2024
6.0.7 21 05/25/2024
6.0.6 19 05/13/2024
6.0.5 23 05/19/2024
6.0.3 19 05/15/2024
6.0.1 23 04/26/2022
4.2.15 17 05/25/2024
4.2.12 20 05/08/2024
4.2.9 22 05/22/2024
4.2.8 27 05/14/2024
4.1.6 17 05/10/2024
3.1.1 21 05/25/2024
3.0.2 20 05/25/2024
2.2.10-beta 18 04/23/2024
2.2.9-beta 18 05/02/2024
2.2.4-beta 20 05/17/2024
2.2.2-beta 23 04/24/2024
2.1.0.247 21 05/25/2024
2.1.0.237 21 05/25/2024
2.1.0.236 20 05/25/2024
2.1.0.235 17 05/25/2024
2.1.0.234 18 05/25/2024
2.1.0.231 23 05/25/2024
2.1.0.230 16 05/03/2024
2.1.0.229 19 05/25/2024
2.1.0.227 16 05/25/2024
2.1.0.226 16 05/04/2024
2.1.0.217 17 05/02/2024
2.1.0.216 17 05/11/2024
2.1.0.215 18 05/20/2024
2.1.0.214 17 05/25/2024
2.1.0.213 20 05/25/2024
2.1.0.211 20 05/25/2024
2.1.0.210 18 05/06/2024
2.1.0.209 16 05/11/2024
2.1.0.208 15 05/07/2024
2.1.0.207 18 05/25/2024
2.1.0.206 14 05/25/2024
2.1.0.204 20 05/25/2024
2.1.0.203 16 05/04/2024
2.1.0.202 16 05/25/2024
2.1.0.201 19 05/25/2024
2.1.0.193 18 05/14/2024
2.1.0.189 18 04/26/2022
2.1.0.187 23 05/07/2024
2.1.0.186 18 05/25/2024
2.1.0.184 17 05/25/2024
2.1.0.183 13 05/11/2024
2.1.0.182 20 05/25/2024
2.1.0.181 19 05/25/2024
2.1.0.180 20 05/25/2024
2.1.0.179 19 05/08/2024
2.1.0.178 15 05/06/2024
2.1.0.177 21 05/02/2024
2.1.0.176 19 05/25/2024
2.1.0.175 18 05/16/2024
2.1.0.174 17 05/09/2024
2.1.0.173 17 04/26/2022
2.1.0.171 18 05/25/2024
2.1.0.170 21 05/25/2024
2.1.0.168 17 05/02/2024
2.1.0.164 17 05/02/2024
2.1.0.159 21 05/25/2024
2.0.0.144 23 05/04/2024
2.0.0.143 17 05/25/2024
2.0.0.142 16 05/25/2024
2.0.0.141 18 05/09/2024
2.0.0.140 20 05/19/2024
2.0.0.139 20 05/25/2024
2.0.0.138 17 05/25/2024
2.0.0.136 17 05/25/2024
2.0.0.124 25 04/09/2024
2.0.0.120 15 05/16/2024
2.0.0.119 18 05/21/2024
2.0.0.118 18 05/24/2024
2.0.0.117 21 05/25/2024
2.0.0.115 17 05/25/2024
2.0.0.113 19 05/25/2024
2.0.0.111 20 05/25/2024
2.0.0.110 19 04/26/2022
2.0.0.109 20 04/26/2022
2.0.0.108 20 05/25/2024
2.0.0.107 20 04/10/2024
2.0.0.106 20 05/25/2024
2.0.0.105 15 05/19/2024
2.0.0.104 19 04/26/2022
2.0.0.103 23 05/25/2024
2.0.0.102 20 05/12/2024
2.0.0.101 18 04/26/2022
2.0.0.100 28 04/09/2024
2.0.0.98 17 04/09/2024
1.4.0.93 18 05/20/2024
1.4.0.92 21 05/02/2024
1.4.0.89 16 05/25/2024
1.4.0.88 23 05/07/2024
1.4.0.87 16 05/09/2024
1.4.0.86 16 05/08/2024
1.4.0.85 19 05/01/2024
1.4.0.84 23 05/09/2024
1.4.0.83 20 05/10/2024
1.4.0.82 21 05/21/2024
1.4.0.81 17 05/21/2024
1.4.0.80 16 05/12/2024
1.4.0.79 20 05/01/2024
1.4.0.78 21 05/04/2024
1.4.0.77 22 05/25/2024
1.4.0.76 19 05/10/2024
1.4.0.75 19 05/19/2024
1.4.0.74 18 05/02/2024
1.4.0.73 20 05/25/2024
1.4.0.72 23 05/09/2024
1.4.0.71 18 05/25/2024
1.4.0.70 20 05/10/2024
1.4.0.69 15 05/25/2024
1.4.0.68 24 05/25/2024
1.4.0.67 18 05/23/2024
1.4.0.66 21 05/02/2024
1.4.0.65 20 05/25/2024
1.4.0.64 22 05/08/2024
1.4.0.63 20 05/14/2024
1.4.0.62 18 05/25/2024
1.4.0.61 19 05/07/2024
1.4.0.60 21 05/18/2024
1.4.0.59 16 05/21/2024
1.4.0.58 20 05/13/2024
1.4.0.57 18 05/18/2024
1.4.0.56 23 05/01/2024
1.4.0.55 16 05/16/2024
1.4.0.54 20 05/17/2024
1.4.0.53 20 05/11/2024
1.4.0.52 17 05/25/2024
1.4.0.51 21 05/17/2024
1.4.0.50 18 05/25/2024
1.4.0.49 20 05/25/2024
1.4.0.48 24 05/22/2024
1.4.0.47 24 05/14/2024
1.4.0.46 21 05/15/2024
1.4.0.45 22 05/06/2024
1.4.0.44 19 05/02/2024
1.4.0.43 20 05/09/2024
1.4.0.42 21 05/16/2024
1.4.0.41 19 05/07/2024
1.4.0.40 18 05/23/2024
1.4.0.39 19 05/19/2024
1.4.0.38 22 05/09/2024
1.4.0.37 21 05/25/2024
1.4.0.36 21 05/14/2024
1.4.0.35 18 05/05/2024
1.4.0.34 23 05/02/2024
1.4.0.33 20 05/23/2024
1.4.0.32 21 05/25/2024
1.4.0.31 20 05/07/2024
1.4.0.30 23 05/24/2024
1.4.0.29 23 05/25/2024
1.4.0.28 19 05/25/2024
1.4.0.27 20 05/25/2024
1.4.0.26 19 05/25/2024
1.4.0.25 21 05/15/2024
1.4.0.24 19 05/19/2024
1.4.0.23 22 05/25/2024
1.4.0.22 17 05/17/2024
1.4.0.21 24 05/24/2024
1.4.0.20 31 04/09/2024
1.4.0.19 23 05/23/2024
1.4.0.18 19 05/18/2024
1.4.0.17 22 05/06/2024
1.4.0.14 18 05/25/2024
1.4.0.12 17 05/25/2024
1.4.0.11 18 05/15/2024
1.2.0 16 05/25/2024