feat: add InitializeFromRealDirectory

Source/Testably.Abstractions.Testing/FileSystemInitializerExtensions.cs

@@ -108,6 +108,21 @@ public static void InitializeEmbeddedResourcesFromAssembly(this IFileSystem file
 	}
 	#pragma warning restore MA0051 // Method is too long
 
+	/// <summary>
+	///     Initializes the <see cref="IFileSystem" /> from the real <paramref name="sourceDirectory" /> into the
+	///     <paramref name="targetDirectory" /> on the mock file system.
+	/// </summary>
+	/// <remarks>
+	///     If no <paramref name="targetDirectory" /> is set, the data is copied to the <paramref name="sourceDirectory" /> on
+	///     the <paramref name="fileSystem" />.
+	/// </remarks>
+	public static void InitializeFromRealDirectory(this IFileSystem fileSystem,
+		string sourceDirectory, string? targetDirectory = null)
+	{
+		using IDisposable release = fileSystem.IgnoreStatistics();
+		CopyDirectory(fileSystem, sourceDirectory, targetDirectory ?? sourceDirectory);
+	}
+
 	/// <summary>
 	///     Initializes the <see cref="IFileSystem" /> in the <paramref name="basePath" /> with test data.
 	/// </summary>
@@ -158,6 +173,30 @@ public static IDirectoryCleaner SetCurrentDirectoryToEmptyTemporaryDirectory(
 		return new DirectoryCleaner(fileSystem, prefix, logger);
 	}
 
+	private static void CopyDirectory(
+		IFileSystem fileSystem, string sourceDirectory, string targetDirectory)
+	{
+		if (!Directory.Exists(sourceDirectory))
+		{
+			throw new NotSupportedException($"The directory '{sourceDirectory}' does not exist.");
+		}
+
+		fileSystem.Directory.CreateDirectory(targetDirectory);
+		foreach (string? file in Directory.EnumerateFiles(sourceDirectory))
+		{
+			string? fileName = Path.GetFileName(file);
+			fileSystem.File.WriteAllBytes(fileSystem.Path.Combine(targetDirectory, fileName),
+				File.ReadAllBytes(file));
+		}
+
+		foreach (string? directory in Directory.EnumerateDirectories(sourceDirectory))
+		{
+			string? directoryName = Path.GetFileName(directory);
+			CopyDirectory(fileSystem, directory,
+				fileSystem.Path.Combine(targetDirectory, directoryName));
+		}
+	}
+
 	private static void InitializeFileFromEmbeddedResource(this IFileSystem fileSystem,
 		string path,
 		Assembly assembly,

Tests/Api/Testably.Abstractions.Api.Tests/Expected/Testably.Abstractions.Testing_net10.0.txt

@@ -18,6 +18,7 @@ namespace Testably.Abstractions.Testing
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> Initialize<TFileSystem>(this TFileSystem fileSystem, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static void InitializeEmbeddedResourcesFromAssembly(this System.IO.Abstractions.IFileSystem fileSystem, string directoryPath, System.Reflection.Assembly assembly, string? relativePath = null, string searchPattern = "*", System.IO.SearchOption searchOption = 1) { }
+        public static void InitializeFromRealDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string sourceDirectory, string? targetDirectory = null) { }
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> InitializeIn<TFileSystem>(this TFileSystem fileSystem, string basePath, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static Testably.Abstractions.Testing.Initializer.IDirectoryCleaner SetCurrentDirectoryToEmptyTemporaryDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string? prefix = null, System.Action<string>? logger = null) { }

Tests/Api/Testably.Abstractions.Api.Tests/Expected/Testably.Abstractions.Testing_net6.0.txt

@@ -18,6 +18,7 @@ namespace Testably.Abstractions.Testing
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> Initialize<TFileSystem>(this TFileSystem fileSystem, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static void InitializeEmbeddedResourcesFromAssembly(this System.IO.Abstractions.IFileSystem fileSystem, string directoryPath, System.Reflection.Assembly assembly, string? relativePath = null, string searchPattern = "*", System.IO.SearchOption searchOption = 1) { }
+        public static void InitializeFromRealDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string sourceDirectory, string? targetDirectory = null) { }
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> InitializeIn<TFileSystem>(this TFileSystem fileSystem, string basePath, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static Testably.Abstractions.Testing.Initializer.IDirectoryCleaner SetCurrentDirectoryToEmptyTemporaryDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string? prefix = null, System.Action<string>? logger = null) { }

Tests/Api/Testably.Abstractions.Api.Tests/Expected/Testably.Abstractions.Testing_net8.0.txt

@@ -18,6 +18,7 @@ namespace Testably.Abstractions.Testing
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> Initialize<TFileSystem>(this TFileSystem fileSystem, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static void InitializeEmbeddedResourcesFromAssembly(this System.IO.Abstractions.IFileSystem fileSystem, string directoryPath, System.Reflection.Assembly assembly, string? relativePath = null, string searchPattern = "*", System.IO.SearchOption searchOption = 1) { }
+        public static void InitializeFromRealDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string sourceDirectory, string? targetDirectory = null) { }
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> InitializeIn<TFileSystem>(this TFileSystem fileSystem, string basePath, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static Testably.Abstractions.Testing.Initializer.IDirectoryCleaner SetCurrentDirectoryToEmptyTemporaryDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string? prefix = null, System.Action<string>? logger = null) { }

Tests/Api/Testably.Abstractions.Api.Tests/Expected/Testably.Abstractions.Testing_net9.0.txt

@@ -18,6 +18,7 @@ namespace Testably.Abstractions.Testing
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> Initialize<TFileSystem>(this TFileSystem fileSystem, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static void InitializeEmbeddedResourcesFromAssembly(this System.IO.Abstractions.IFileSystem fileSystem, string directoryPath, System.Reflection.Assembly assembly, string? relativePath = null, string searchPattern = "*", System.IO.SearchOption searchOption = 1) { }
+        public static void InitializeFromRealDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string sourceDirectory, string? targetDirectory = null) { }
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> InitializeIn<TFileSystem>(this TFileSystem fileSystem, string basePath, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static Testably.Abstractions.Testing.Initializer.IDirectoryCleaner SetCurrentDirectoryToEmptyTemporaryDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string? prefix = null, System.Action<string>? logger = null) { }

Tests/Api/Testably.Abstractions.Api.Tests/Expected/Testably.Abstractions.Testing_netstandard2.0.txt

@@ -14,6 +14,7 @@ namespace Testably.Abstractions.Testing
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> Initialize<TFileSystem>(this TFileSystem fileSystem, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static void InitializeEmbeddedResourcesFromAssembly(this System.IO.Abstractions.IFileSystem fileSystem, string directoryPath, System.Reflection.Assembly assembly, string? relativePath = null, string searchPattern = "*", System.IO.SearchOption searchOption = 1) { }
+        public static void InitializeFromRealDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string sourceDirectory, string? targetDirectory = null) { }
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> InitializeIn<TFileSystem>(this TFileSystem fileSystem, string basePath, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static Testably.Abstractions.Testing.Initializer.IDirectoryCleaner SetCurrentDirectoryToEmptyTemporaryDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string? prefix = null, System.Action<string>? logger = null) { }

Tests/Api/Testably.Abstractions.Api.Tests/Expected/Testably.Abstractions.Testing_netstandard2.1.txt

@@ -14,6 +14,7 @@ namespace Testably.Abstractions.Testing
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> Initialize<TFileSystem>(this TFileSystem fileSystem, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static void InitializeEmbeddedResourcesFromAssembly(this System.IO.Abstractions.IFileSystem fileSystem, string directoryPath, System.Reflection.Assembly assembly, string? relativePath = null, string searchPattern = "*", System.IO.SearchOption searchOption = 1) { }
+        public static void InitializeFromRealDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string sourceDirectory, string? targetDirectory = null) { }
         public static Testably.Abstractions.Testing.Initializer.IFileSystemInitializer<TFileSystem> InitializeIn<TFileSystem>(this TFileSystem fileSystem, string basePath, System.Action<Testably.Abstractions.Testing.FileSystemInitializerOptions>? options = null)
             where TFileSystem : System.IO.Abstractions.IFileSystem { }
         public static Testably.Abstractions.Testing.Initializer.IDirectoryCleaner SetCurrentDirectoryToEmptyTemporaryDirectory(this System.IO.Abstractions.IFileSystem fileSystem, string? prefix = null, System.Action<string>? logger = null) { }

Tests/Testably.Abstractions.Testing.Tests/FileSystemInitializerExtensionsTests.cs

@@ -1,4 +1,5 @@
-using System.Collections.Generic;
+using aweXpect.Testably;
+using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Reflection;
@@ -243,6 +244,73 @@ await That(result)
 			.Contains(x => x.EndsWith("SubResourceFile1.txt", StringComparison.Ordinal));
 	}
 
+	[Fact]
+	public async Task InitializeFromRealDirectory_ShouldCopyFileToTargetDirectory()
+	{
+		MockFileSystem fileSystem = new();
+		string tempPath = Path.Combine(Path.GetTempPath(), Path.GetRandomFileName());
+		try
+		{
+			Directory.CreateDirectory(tempPath);
+			string filePath = Path.Combine(tempPath, "test.txt");
+			File.WriteAllText(filePath, "Hello, World!");
+
+			fileSystem.InitializeFromRealDirectory(tempPath, "foo");
+
+			await That(fileSystem).HasDirectory("foo");
+			await That(fileSystem).HasFile("foo/test.txt").WithContent("Hello, World!");
+		}
+		finally
+		{
+			Directory.Delete(tempPath, true);
+		}
+	}
+
+	[Fact]
+	public async Task
+		InitializeFromRealDirectory_ShouldRecursivelyCopyDirectoriesToTargetDirectory()
+	{
+		MockFileSystem fileSystem = new();
+		string tempPath = Path.Combine(Path.GetTempPath(), Path.GetRandomFileName());
+		try
+		{
+			Directory.CreateDirectory(tempPath);
+			Directory.CreateDirectory(Path.Combine(tempPath, "subdir"));
+			File.WriteAllText(Path.Combine(tempPath, "subdir", "test1.txt"), "foo");
+			File.WriteAllText(Path.Combine(tempPath, "subdir", "test2.txt"), "bar");
+
+			fileSystem.InitializeFromRealDirectory(tempPath);
+
+			await That(fileSystem).HasDirectory(fileSystem.Path.Combine(tempPath, "subdir"));
+			await That(fileSystem).HasFile(fileSystem.Path.Combine(tempPath, "subdir", "test1.txt"))
+				.WithContent("foo");
+			await That(fileSystem).HasFile(fileSystem.Path.Combine(tempPath, "subdir", "test2.txt"))
+				.WithContent("bar");
+		}
+		finally
+		{
+			Directory.Delete(tempPath, true);
+		}
+	}
+
+	[Fact]
+	public async Task
+		InitializeFromRealDirectory_WhenDirectoryDoesNotExist_ShouldThrowNotSupportedException()
+	{
+		MockFileSystem fileSystem = new();
+		string tempPath = Path.Combine(Path.GetTempPath(), Path.GetRandomFileName());
+		while (Directory.Exists(tempPath))
+		{
+			tempPath = Path.Combine(Path.GetTempPath(), Path.GetRandomFileName());
+		}
+
+		void Act()
+			=> fileSystem.InitializeFromRealDirectory(tempPath, "foo");
+
+		await That(Act).Throws<NotSupportedException>()
+			.WithMessage($"The directory '{tempPath}' does not exist.");
+	}
+
 	[Theory]
 	[AutoData]
 	public async Task InitializeIn_MissingDrive_ShouldCreateDrive(string directoryName)