|
|
@@ -1,45 +1,24 @@
|
|
|
using System.IO.Compression;
|
|
|
-using System.Runtime.InteropServices;
|
|
|
-using System.Text;
|
|
|
-using MeloongCore;
|
|
|
-using Xunit;
|
|
|
|
|
|
namespace MeloongCore.Tests;
|
|
|
+public class FileUtilsTest : IDisposable {
|
|
|
|
|
|
-/// <summary>
|
|
|
-/// 仅在 Windows 上运行的 xUnit Fact 属性。
|
|
|
-/// FileUtils 内部使用 PathUtils.WithLongPath 添加 \\?\ 长路径前缀，该行为仅在 Windows 上有效。
|
|
|
-/// </summary>
|
|
|
-[AttributeUsage(AttributeTargets.Method)]
|
|
|
-public sealed class WindowsOnlyFactAttribute : FactAttribute {
|
|
|
- public WindowsOnlyFactAttribute() {
|
|
|
- if (!RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
|
|
|
- Skip = "FileUtils 使用 Windows 专用的长路径前缀（\\\\?\\），此测试仅在 Windows 上运行。";
|
|
|
- }
|
|
|
-}
|
|
|
-
|
|
|
-/// <summary>
|
|
|
-/// FileUtils 压缩包相关方法的单元测试。
|
|
|
-/// 覆盖 OpenZip、ExtractToDirectory、CreateZipFromDirectory 和 CreateZipFromFiles。
|
|
|
-/// </summary>
|
|
|
-public class FileUtilsZipTests : IDisposable {
|
|
|
+ #region 辅助方法
|
|
|
|
|
|
private readonly string _tempDir;
|
|
|
|
|
|
- public FileUtilsZipTests() {
|
|
|
+ public FileUtilsTest() {
|
|
|
_tempDir = Path.Combine(Path.GetTempPath(), "MeloongCoreTests_" + Guid.NewGuid().ToString("N"));
|
|
|
Directory.CreateDirectory(_tempDir);
|
|
|
}
|
|
|
|
|
|
public void Dispose() {
|
|
|
- if (Directory.Exists(_tempDir))
|
|
|
- Directory.Delete(_tempDir, recursive: true);
|
|
|
+ if (Directory.Exists(_tempDir)) Directory.Delete(_tempDir, recursive: true);
|
|
|
}
|
|
|
|
|
|
- // ──────────────────────────────────────────────────────────────────────────
|
|
|
- #region 辅助方法
|
|
|
-
|
|
|
- /// <summary>创建一个包含若干文件的临时文件夹，并返回该文件夹路径。</summary>
|
|
|
+ /// <summary>
|
|
|
+ /// 创建一个包含若干文件的临时文件夹，并返回该文件夹路径。
|
|
|
+ /// </summary>
|
|
|
private string CreateSourceDirectory(params (string relativePath, string content)[] files) {
|
|
|
string dir = Path.Combine(_tempDir, "src_" + Guid.NewGuid().ToString("N"));
|
|
|
Directory.CreateDirectory(dir);
|
|
|
@@ -51,7 +30,9 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
return dir;
|
|
|
}
|
|
|
|
|
|
- /// <summary>创建一个只含 ASCII 文件名的合法 ZIP，使用指定编码写入文件名。</summary>
|
|
|
+ /// <summary>
|
|
|
+ /// 创建一个只含 ASCII 文件名的合法 ZIP，使用指定编码写入文件名。
|
|
|
+ /// </summary>
|
|
|
private string CreateZipWithEncoding(string zipName, Encoding encoding, params (string entryName, string content)[] entries) {
|
|
|
string zipPath = Path.Combine(_tempDir, zipName);
|
|
|
using var stream = File.Create(zipPath);
|
|
|
@@ -64,7 +45,9 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
return zipPath;
|
|
|
}
|
|
|
|
|
|
- /// <summary>创建一个用于 GZip 解压测试的 .gz 文件。</summary>
|
|
|
+ /// <summary>
|
|
|
+ /// 创建一个用于 GZip 解压测试的 .gz 文件。
|
|
|
+ /// </summary>
|
|
|
private string CreateGzFile(string innerFileName, string content) {
|
|
|
string gzPath = Path.Combine(_tempDir, innerFileName + ".gz");
|
|
|
byte[] contentBytes = Encoding.UTF8.GetBytes(content);
|
|
|
@@ -74,73 +57,61 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
return gzPath;
|
|
|
}
|
|
|
|
|
|
- /// <summary>读取文件内容（兼容长路径）。</summary>
|
|
|
- private static string ReadFile(string path) => File.ReadAllText(path, Encoding.UTF8);
|
|
|
+ /// <summary>
|
|
|
+ /// 读取文件内容（兼容长路径）。
|
|
|
+ /// </summary>
|
|
|
+ private static string ReadFile(string path) {
|
|
|
+ return File.ReadAllText(path, Encoding.UTF8);
|
|
|
+ }
|
|
|
|
|
|
#endregion
|
|
|
|
|
|
- // ──────────────────────────────────────────────────────────────────────────
|
|
|
- #region OpenZip 测试
|
|
|
+ #region OpenZip
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
public void OpenZip_ValidUtf8Zip_OpensSuccessfully() {
|
|
|
string zipPath = CreateZipWithEncoding("utf8.zip", new UTF8Encoding(false, true),
|
|
|
("hello.txt", "world"));
|
|
|
-
|
|
|
using var archive = FileUtils.OpenZip(zipPath);
|
|
|
-
|
|
|
Assert.Single(archive.Entries);
|
|
|
Assert.Equal("hello.txt", archive.Entries[0].FullName);
|
|
|
}
|
|
|
-
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void OpenZip_ValidUtf8Zip_EntryContentIsCorrect() {
|
|
|
const string expectedContent = "测试内容";
|
|
|
string zipPath = CreateZipWithEncoding("utf8content.zip", new UTF8Encoding(false, true),
|
|
|
("data.txt", expectedContent));
|
|
|
-
|
|
|
using var archive = FileUtils.OpenZip(zipPath);
|
|
|
using var entryStream = archive.Entries[0].Open();
|
|
|
using var reader = new StreamReader(entryStream, Encoding.UTF8);
|
|
|
-
|
|
|
Assert.Equal(expectedContent, reader.ReadToEnd());
|
|
|
}
|
|
|
-
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void OpenZip_MultipleEntries_AllEntriesAccessible() {
|
|
|
string zipPath = CreateZipWithEncoding("multi.zip", new UTF8Encoding(false, true),
|
|
|
("a.txt", "aaa"),
|
|
|
("b.txt", "bbb"),
|
|
|
("c.txt", "ccc"));
|
|
|
-
|
|
|
using var archive = FileUtils.OpenZip(zipPath);
|
|
|
-
|
|
|
Assert.Equal(3, archive.Entries.Count);
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
public void OpenZip_InvalidFile_ThrowsInvalidDataException() {
|
|
|
string invalidPath = Path.Combine(_tempDir, "invalid.zip");
|
|
|
File.WriteAllBytes(invalidPath, [0x00, 0x01, 0x02, 0x03]); // 非 zip 数据
|
|
|
-
|
|
|
Assert.Throws<InvalidDataException>(() => FileUtils.OpenZip(invalidPath));
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
public void OpenZip_EmptyZip_ReturnsEmptyEntries() {
|
|
|
string zipPath = CreateZipWithEncoding("empty.zip", new UTF8Encoding(false, true));
|
|
|
-
|
|
|
using var archive = FileUtils.OpenZip(zipPath);
|
|
|
-
|
|
|
Assert.Empty(archive.Entries);
|
|
|
}
|
|
|
|
|
|
#endregion
|
|
|
|
|
|
- // ──────────────────────────────────────────────────────────────────────────
|
|
|
#region ExtractToDirectory 测试
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void ExtractToDirectory_ZipWithSingleFile_ExtractsCorrectly() {
|
|
|
const string fileContent = "hello extract";
|
|
|
string zipPath = CreateZipWithEncoding("single.zip", new UTF8Encoding(false, true),
|
|
|
@@ -154,7 +125,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Equal(fileContent, ReadFile(extractedFile));
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void ExtractToDirectory_ZipWithMultipleFiles_AllExtracted() {
|
|
|
string zipPath = CreateZipWithEncoding("multi_extract.zip", new UTF8Encoding(false, true),
|
|
|
("a.txt", "aaa"),
|
|
|
@@ -167,7 +138,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.True(File.Exists(Path.Combine(outDir, "b.txt")));
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void ExtractToDirectory_ZipWithSubdirectory_DirectoryStructurePreserved() {
|
|
|
string zipPath = CreateZipWithEncoding("subdir.zip", new UTF8Encoding(false, true),
|
|
|
("subdir/nested.txt", "nested content"));
|
|
|
@@ -180,7 +151,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Equal("nested content", ReadFile(nestedFile));
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void ExtractToDirectory_OutputDirectoryAutoCreated() {
|
|
|
string zipPath = CreateZipWithEncoding("autocreate.zip", new UTF8Encoding(false, true),
|
|
|
("f.txt", "x"));
|
|
|
@@ -191,35 +162,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.True(Directory.Exists(outDir));
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
- public void ExtractToDirectory_ProgressHandler_CalledForEachEntry() {
|
|
|
- string zipPath = CreateZipWithEncoding("progress.zip", new UTF8Encoding(false, true),
|
|
|
- ("a.txt", "a"),
|
|
|
- ("b.txt", "b"),
|
|
|
- ("c.txt", "c"));
|
|
|
- string outDir = Path.Combine(_tempDir, "out_progress");
|
|
|
-
|
|
|
- var progressValues = new List<double>();
|
|
|
- FileUtils.ExtractToDirectory(zipPath, outDir, progressValues.Add);
|
|
|
-
|
|
|
- Assert.Equal(3, progressValues.Count);
|
|
|
- // 进度值应单调递增，最后一个值为 1.0
|
|
|
- for (int i = 1; i < progressValues.Count; i++)
|
|
|
- Assert.True(progressValues[i] > progressValues[i - 1]);
|
|
|
- Assert.Equal(1.0, progressValues[^1], precision: 5);
|
|
|
- }
|
|
|
-
|
|
|
- [WindowsOnlyFact]
|
|
|
- public void ExtractToDirectory_ProgressHandler_Null_DoesNotThrow() {
|
|
|
- string zipPath = CreateZipWithEncoding("noprogress.zip", new UTF8Encoding(false, true),
|
|
|
- ("f.txt", "data"));
|
|
|
- string outDir = Path.Combine(_tempDir, "out_noprogress");
|
|
|
-
|
|
|
- var ex = Record.Exception(() => FileUtils.ExtractToDirectory(zipPath, outDir, null));
|
|
|
- Assert.Null(ex);
|
|
|
- }
|
|
|
-
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void ExtractToDirectory_OverwritesExistingFile() {
|
|
|
string zipPath = CreateZipWithEncoding("overwrite.zip", new UTF8Encoding(false, true),
|
|
|
("f.txt", "new content"));
|
|
|
@@ -232,7 +175,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Equal("new content", ReadFile(Path.Combine(outDir, "f.txt")));
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void ExtractToDirectory_ZipSlip_ThrowsUnauthorizedAccessException() {
|
|
|
// 手动构造一个包含路径穿越条目（../../evil.txt）的 zip
|
|
|
string zipPath = Path.Combine(_tempDir, "zipslip.zip");
|
|
|
@@ -248,7 +191,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Throws<UnauthorizedAccessException>(() => FileUtils.ExtractToDirectory(zipPath, outDir));
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void ExtractToDirectory_GzFile_ExtractsInnerFile() {
|
|
|
const string innerContent = "gzip content";
|
|
|
const string innerFileName = "inner.txt";
|
|
|
@@ -262,7 +205,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Equal(innerContent, ReadFile(extractedFile));
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void ExtractToDirectory_JarFile_ExtractsAsZip() {
|
|
|
// jar 文件实际上是 zip 格式
|
|
|
string zipPath = CreateZipWithEncoding("app.jar", new UTF8Encoding(false, true),
|
|
|
@@ -276,10 +219,9 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
|
|
|
#endregion
|
|
|
|
|
|
- // ──────────────────────────────────────────────────────────────────────────
|
|
|
#region CreateZipFromDirectory 测试
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromDirectory_SingleFile_ZipContainsFile() {
|
|
|
string srcDir = CreateSourceDirectory(("hello.txt", "hello world"));
|
|
|
string outZip = Path.Combine(_tempDir, "from_dir.zip");
|
|
|
@@ -292,7 +234,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Equal("hello.txt", archive.Entries[0].Name);
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromDirectory_MultipleFiles_AllFilesIncluded() {
|
|
|
string srcDir = CreateSourceDirectory(
|
|
|
("a.txt", "aaa"),
|
|
|
@@ -306,7 +248,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Equal(3, archive.Entries.Count);
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromDirectory_SubdirectoryFiles_StructurePreserved() {
|
|
|
string srcDir = CreateSourceDirectory(
|
|
|
("sub/file.txt", "nested"),
|
|
|
@@ -321,7 +263,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Contains(names, n => n.Contains("root.txt"));
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromDirectory_OverwritesExistingZip() {
|
|
|
string srcDir = CreateSourceDirectory(("new.txt", "new content"));
|
|
|
string outZip = Path.Combine(_tempDir, "overwrite_dir.zip");
|
|
|
@@ -338,7 +280,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Equal("new.txt", archive.Entries[0].Name);
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromDirectory_OutputDirectoryAutoCreated() {
|
|
|
string srcDir = CreateSourceDirectory(("f.txt", "x"));
|
|
|
string outZip = Path.Combine(_tempDir, "newdir", "nested.zip");
|
|
|
@@ -350,10 +292,9 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
|
|
|
#endregion
|
|
|
|
|
|
- // ──────────────────────────────────────────────────────────────────────────
|
|
|
#region CreateZipFromFiles（params 版）测试
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromFiles_Params_SingleFile_ZipContainsFile() {
|
|
|
string srcFile = Path.Combine(_tempDir, "single.txt");
|
|
|
File.WriteAllText(srcFile, "content");
|
|
|
@@ -366,7 +307,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Equal("single.txt", archive.Entries[0].Name);
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromFiles_Params_MultipleFiles_AllIncluded() {
|
|
|
string file1 = Path.Combine(_tempDir, "f1.txt");
|
|
|
string file2 = Path.Combine(_tempDir, "f2.txt");
|
|
|
@@ -383,7 +324,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Contains("f2.txt", names);
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromFiles_Params_DuplicateFileNames_ThrowsArgumentException() {
|
|
|
string file1 = Path.Combine(_tempDir, "dup", "a", "same.txt");
|
|
|
string file2 = Path.Combine(_tempDir, "dup", "b", "same.txt");
|
|
|
@@ -396,7 +337,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Throws<ArgumentException>(() => FileUtils.CreateZipFromFiles(outZip, file1, file2));
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromFiles_Params_OverwritesExistingZip() {
|
|
|
string oldFile = Path.Combine(_tempDir, "old.txt");
|
|
|
string newFile = Path.Combine(_tempDir, "new.txt");
|
|
|
@@ -414,10 +355,9 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
|
|
|
#endregion
|
|
|
|
|
|
- // ──────────────────────────────────────────────────────────────────────────
|
|
|
#region CreateZipFromFiles（IDictionary 版）测试
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromFiles_Dict_CustomEntryPath_EntryNameMatchesDictKey() {
|
|
|
string srcFile = Path.Combine(_tempDir, "source.txt");
|
|
|
File.WriteAllText(srcFile, "data");
|
|
|
@@ -433,7 +373,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Equal("custom/path/file.txt", archive.Entries[0].FullName);
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromFiles_Dict_MultipleEntries_AllIncluded() {
|
|
|
string f1 = Path.Combine(_tempDir, "d1.txt");
|
|
|
string f2 = Path.Combine(_tempDir, "d2.txt");
|
|
|
@@ -454,7 +394,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Contains("b/two.txt", fullNames);
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromFiles_Dict_FileContentPreserved() {
|
|
|
const string expectedContent = "preserved content";
|
|
|
string srcFile = Path.Combine(_tempDir, "preserve.txt");
|
|
|
@@ -472,7 +412,7 @@ public class FileUtilsZipTests : IDisposable {
|
|
|
Assert.Equal(expectedContent, reader.ReadToEnd());
|
|
|
}
|
|
|
|
|
|
- [WindowsOnlyFact]
|
|
|
+
|
|
|
public void CreateZipFromFiles_Dict_BackslashInKey_NormalizedToForwardSlash() {
|
|
|
string srcFile = Path.Combine(_tempDir, "bs.txt");
|
|
|
File.WriteAllText(srcFile, "x");
|
龙腾猫跃