Merge pull request #134 from TheBoxyBear/109-use-source-generation-for-metadata-string-conversion

Use source generation for metadata string conversion

Author: TheBoxyBear

ChartTools/Assembly.cs

@@ -0,0 +1 @@
+[assembly: System.Runtime.CompilerServices.InternalsVisibleTo("ChartTools.Tests")]

ChartTools/ChartTools.Common/Assembly.cs

@@ -0,0 +1,5 @@
+using System.Runtime.CompilerServices;
+
+[assembly: InternalsVisibleTo("ChartTools")]
+[assembly: InternalsVisibleTo("ChartTools.Generator")]
+[assembly: InternalsVisibleTo("ChartTools.Tests")]

ChartTools/ChartTools.Common/ChartTools.Common.csproj

@@ -0,0 +1,9 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
+    <RootNamespace>ChartTools</RootNamespace>
+    <LangVersion>14.0</LangVersion>
+  </PropertyGroup>
+
+</Project>

ChartTools/ChartTools.Common/FileType.cs

@@ -0,0 +1,3 @@
+namespace ChartTools;
+
+public enum FileType : byte { Chart, Ini, Midi }

ChartTools/ChartTools.Common/IsExternalInit.cs

@@ -0,0 +1,10 @@
+#if NETSTANDARD
+using System.ComponentModel;
+
+#pragma warning disable IDE0130 // Namespace does not match folder structure
+namespace System.Runtime.CompilerServices;
+#pragma warning restore IDE0130 // Namespace does not match folder structure
+
+[EditorBrowsable(EditorBrowsableState.Never)]
+public record class IsExternalInit;
+#endif

ChartTools/ChartTools.Common/Meta/MetadataGroupAttribute.cs

@@ -0,0 +1,6 @@
+using System;
+
+namespace ChartTools.Meta;
+
+[AttributeUsage(AttributeTargets.Property)]
+internal class MetadataGroupAttribute : Attribute { }

ChartTools/ChartTools.Common/Meta/MetadataKeyAttribute.cs

@@ -0,0 +1,30 @@
+using System;
+
+namespace ChartTools.Meta;
+
+/// <summary>
+/// Indicates that a property should be serialized with a specific key in a specific file format
+/// </summary>
+/// <param name="key"></param>
+[AttributeUsage(AttributeTargets.Property, Inherited = false, AllowMultiple = true)]
+internal class MetadataKeyAttribute(FileType fileType, string key)
+	: Attribute, IEquatable<MetadataKeyAttribute>
+{
+	public FileType FileType { get; } = fileType;
+
+	/// <summary>
+	/// Target key
+	/// </summary>
+	public string Key { get; } = key;
+
+	public bool ValueMappable = true;
+
+	public bool Equals(MetadataKeyAttribute other) =>
+		ReferenceEquals(other, this) ||
+		other.FileType == FileType &&
+		other.Key == Key &&
+		other.ValueMappable == ValueMappable;
+
+	public override bool Equals(object obj)
+		=> obj is MetadataKeyAttribute other && Equals(other);
+}

ChartTools/ChartTools.Generator/ChartTools.Generator.csproj

@@ -0,0 +1,22 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>netstandard2.0</TargetFramework>
+    <LangVersion>14.0</LangVersion>
+    <EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.11.0">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+    <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="5.0.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\ChartTools.Common\ChartTools.Common.csproj" OutputItemType="Analyzer" />
+  </ItemGroup>
+
+</Project>

ChartTools/ChartTools.Generator/CodeBuilder.cs

@@ -0,0 +1,85 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace ChartTools.Generator;
+
+internal class CodeBuilder(StringBuilder? builder = default)
+{
+	public CodeBuilder(string value)
+		: this(new StringBuilder(value)) { }
+
+	public CodeBuilder(int indent, StringBuilder? builder = default)
+		: this(builder)
+		=> m_indent = new('\t', indent);
+
+	public StringBuilder StringBuilder { get; } = builder ?? new();
+
+	private readonly Stack<char> m_contextStack = [];
+	private string m_indent = string.Empty;
+
+	private static readonly Dictionary<char, char> m_contextClosers = new()
+	{
+		{ '(', ')' },
+		{ '{', '}' },
+		{ '[', ']' },
+		{ '"', '"' }
+	};
+
+	public CodeBuilder StartContext(char openChar, bool newLine = true)
+	{
+		if (newLine)
+			StringBuilder.AppendLine(m_indent + openChar);
+		else
+			StringBuilder.Append(m_indent + openChar);
+
+		m_contextStack.Push(openChar);
+		m_indent += '\t';
+
+		return this;
+	}
+
+	public CodeBuilder EndContext(bool newLine = true)
+	{
+		if (m_contextStack.Count == 0)
+			throw new InvalidOperationException("No context to end.");
+
+		char openChar = m_contextStack.Pop();
+
+		if (!m_contextClosers.TryGetValue(openChar, out char closeChar))
+			throw new InvalidOperationException($"No closing character defined for '{openChar}'.");
+
+		m_indent = m_indent.Substring(0, m_indent.Length - 2);
+
+		if (newLine)
+			StringBuilder.AppendLine(m_indent + closeChar);
+		else
+			StringBuilder.Append(m_indent + closeChar);
+
+		return this;
+	}
+
+	public CodeBuilder AppendLine(string line)
+	{
+		StringBuilder.AppendLine(m_indent + line);
+		return this;
+	}
+
+	public CodeBuilder AppendLine()
+	{
+		StringBuilder.AppendLine(m_indent);
+		return this;
+	}
+
+	public CodeBuilder Append(string text)
+	{
+		StringBuilder.Append(m_indent + text);
+		return this;
+	}
+
+	public override string ToString()
+		=> StringBuilder.ToString();
+
+	public static implicit operator StringBuilder(CodeBuilder builder)
+		=> builder.StringBuilder;
+}