[WIP]音击Ogkr的基础框架（空的Parser Generator，还有官谱测试）

Author: Starrah

chart/ogk/OgkChart.cs

@@ -0,0 +1,8 @@
+using MuConvert.chart;
+
+namespace MuConvert.ogk;
+
+public class OgkChart: BaseChart<OgkNote>
+{
+    
+}

chart/ogk/OgkNote.cs

@@ -0,0 +1,8 @@
+using MuConvert.chart;
+
+namespace MuConvert.ogk;
+
+public class OgkNote: BaseNote
+{
+    
+}

generator/ogk/OgkrGenerator.cs

@@ -0,0 +1,12 @@
+using MuConvert.generator;
+using MuConvert.utils;
+
+namespace MuConvert.ogk;
+
+public class OgkrGenerator: IGenerator<OgkChart>
+{
+    public (string, List<Alert>) Generate(OgkChart chart)
+    {
+        throw new NotImplementedException();
+    }
+}

parser/ogk/OgkrParser.cs

@@ -0,0 +1,12 @@
+using MuConvert.parser;
+using MuConvert.utils;
+
+namespace MuConvert.ogk;
+
+public class OgkrParser: IParser<OgkChart>
+{
+    public (OgkChart, List<Alert>) Parse(string text)
+    {
+        throw new NotImplementedException();
+    }
+}

tests/mai/MA2转Simai测试.cs

@@ -43,7 +43,7 @@ private void TestChart(TestInput c)
 
 /// <summary>
 /// 按 Simai 文法 <c>chart: (notations ',')*</c> 将谱面切成顶层逗号分段，并在每个分段上复现与
-/// <see cref="MuConvert.parser.simai.SimaiParser"/> 一致的 <c>now</c> / <c>step</c> 推进规则，
+/// <see cref="MuConvert.mai.SimaiParser"/> 一致的 <c>now</c> / <c>step</c> 推进规则，
 /// 得到 (时刻, 原文) 序列；不构造 Note，不把片段再交给 SimaiParser。
 /// </summary>
 internal static partial class SimaiCommaTimeline

tests/mai/TestUtils.cs

@@ -197,5 +197,5 @@ public string MA2
         }
     }
 
-    public override string ToString() => $"{Path.GetFileName(Path.GetDirectoryName(Maidata))}-lv{LevelId}";
+    public override string ToString() => $"{Path.GetFileName(Dir)}-lv{LevelId}";
 }

tests/ogk/OgkrTestUtils.cs

@@ -0,0 +1,35 @@
+namespace MuConvert.Tests.ogk;
+
+internal static class OgkrTestUtils
+{
+    // 查找到测试数据的根目录(tests/ogk/testset)
+    public static DirectoryInfo FindTestsetRoot()
+    {
+        var dir = AppContext.BaseDirectory;
+        while (dir != null && !File.Exists(Path.Combine(dir, "MuConvert.Tests.csproj")))
+            dir = Path.GetDirectoryName(dir);
+        return new DirectoryInfo(Path.Combine(dir ?? throw new DirectoryNotFoundException("Could not locate repo root."), "ogk", "testset"));
+    }
+
+    public static IEnumerable<object[]> GetTestInputs(string dataDir)
+    {
+        var testsetRoot = Path.Combine(FindTestsetRoot().FullName, dataDir);
+        if (!Directory.Exists(testsetRoot))
+            throw new DirectoryNotFoundException($"Testset root not found: {testsetRoot}");
+
+        foreach (var ogkrPath in Directory.EnumerateFiles(testsetRoot, "*.ogkr", SearchOption.AllDirectories)
+                     .OrderBy(p => p, StringComparer.Ordinal))
+        {
+            yield return [new OgkrTestInput(ogkrPath)];
+        }
+    }
+}
+
+public record OgkrTestInput(string OgkrPath)
+{
+    public string Dir => Path.GetDirectoryName(OgkrPath)!;
+    public string SongName => Path.GetFileName(Dir);
+    public string DifficultyId => Path.GetFileNameWithoutExtension(OgkrPath).Split('_').LastOrDefault() ?? "";
+
+    public override string ToString() => $"{SongName}-{DifficultyId}";
+}

tests/ogk/Ogkr测试.cs

@@ -0,0 +1,29 @@
+using System.Text;
+using MuConvert.ogk;
+using Xunit.Abstractions;
+
+namespace MuConvert.Tests.ogk;
+
+public class Ogkr测试
+{
+    private readonly ITestOutputHelper _output;
+
+    public Ogkr测试(ITestOutputHelper output) => _output = output;
+
+    public static IEnumerable<object[]> GetTestInputs(string dataDir) => OgkrTestUtils.GetTestInputs(dataDir);
+
+    [Theory]
+    [MemberData(nameof(GetTestInputs), "官谱")]
+    public void 解析Ogkr再生成回去(OgkrTestInput c)
+    {
+        var ogkrText = File.ReadAllText(c.OgkrPath, Encoding.UTF8);
+
+        var (chart, parseAlerts) = new OgkrParser().Parse(ogkrText);
+        var (resultText, generateAlerts) = new OgkrGenerator().Generate(chart);
+
+        _output.WriteLine(string.Join('\n', parseAlerts));
+        _output.WriteLine(string.Join('\n', generateAlerts));
+        
+        Assert.Equal(ogkrText, resultText);
+    }
+}