feat: generate JSON converter (#73)

Directory.Build.props

@@ -26,7 +26,7 @@
     <PackageTags>
       generator;source;enum;enumeration;reflection;attribute;tostring;isdefined;enummember;description;display;
       shortname;resourcetype;resource;parse;tryparse;ignorecase;stringcomparison;factory;extension;validation;
-      codegen;fast
+      codegen;fast;json;jsonconverter
     </PackageTags>
   </PropertyGroup>
 

README.md

@@ -169,6 +169,30 @@ This will generate the following methods:
   - TryCreateFromDescription(string?, StringComparison)
   - TryCreateFromDescription(string?)
 
+### JSON Serialization
+
+Besindes the member name, supports the [EnumMemberAttribute](https://learn.microsoft.com/en-us/dotnet/api/system.runtime.serialization.enummemberattribute) and [JsonPropertyNameAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.text.json.serialization.jsonpropertynameattribute) attributes.
+
+Example:
+
+```csharp
+[JsonConverterGenerator]
+[JsonConverter(typeof(SeasonJsonConverter))]
+public enum Season
+{
+    [EnumMember(Value = "\ud83c\udf31")]
+    Spring = 1,
+    [EnumMember(Value = "\u2600\ufe0f")]
+    Summer,
+    [EnumMember(Value = "\ud83c\udf42")]
+    Autumn,
+    [EnumMember(Value = "\u26c4")]
+    Winter
+}
+```
+
+This will generate the following JSON converter: [SeasonJsonConverter](./tests/EnumUtilities.IntegrationTests/Generated/Raiqub.Generators.EnumUtilities/Raiqub.Generators.EnumUtilities.EnumUtilitiesGenerator/Raiqub.Generators.EnumUtilities.IntegrationTests.Models.SeasonJsonConverter.g.cs).
+
 ## Contributing
 
 If something is not working for you or if you think that the source file

src/EnumUtilities.Abstractions/EnumGeneratorAttribute.cs

@@ -1,6 +1,7 @@
-namespace Raiqub.Generators.EnumUtilities;
+using System.Diagnostics.CodeAnalysis;
+
+namespace Raiqub.Generators.EnumUtilities;
 
 [AttributeUsage(AttributeTargets.Enum)]
-public sealed class EnumGeneratorAttribute : Attribute
-{
-}
+[ExcludeFromCodeCoverage]
+public sealed class EnumGeneratorAttribute : Attribute;

src/EnumUtilities.Abstractions/EnumUtilities.Abstractions.csproj

@@ -1,9 +1,9 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
-    <PropertyGroup>
-        <TargetFramework>netstandard2.0</TargetFramework>
-        <IsPackable>false</IsPackable>
-        <RootNamespace>Raiqub.Generators.EnumUtilities</RootNamespace>
-    </PropertyGroup>
+  <PropertyGroup>
+    <TargetFramework>netstandard2.0</TargetFramework>
+    <IsPackable>false</IsPackable>
+    <RootNamespace>Raiqub.Generators.EnumUtilities</RootNamespace>
+  </PropertyGroup>
 
 </Project>

src/EnumUtilities.Abstractions/JsonConverterGeneratorAttribute.cs

@@ -0,0 +1,11 @@
+using System.Diagnostics.CodeAnalysis;
+
+namespace Raiqub.Generators.EnumUtilities;
+
+[AttributeUsage(AttributeTargets.Enum)]
+[ExcludeFromCodeCoverage]
+public sealed class JsonConverterGeneratorAttribute : Attribute
+{
+    public bool AllowIntegerValues { get; set; } = true;
+    public object? DeserializationFailureFallbackValue { get; set; }
+}

src/EnumUtilities/CodeWriters/EnumExtensionsWriter.cs

@@ -500,6 +500,9 @@ public EnumExtensionsWriter(StringBuilder builder) : base(builder)
 
     public override string GetFileName() => $"{Model.Namespace ?? "_"}.{Model.Name}Extensions.g.cs";
 
+    protected override bool CanGenerateFor(EnumToGenerate model) =>
+        (model.SelectedGenerators & SelectedGenerators.MainGenerator) != 0;
+
 
         #line default
         #line hidden

src/EnumUtilities/CodeWriters/EnumExtensionsWriter.tt

@@ -194,4 +194,7 @@ using System;
     }
 
     public override string GetFileName() => $"{Model.Namespace ?? "_"}.{Model.Name}Extensions.g.cs";
+
+    protected override bool CanGenerateFor(EnumToGenerate model) =>
+        (model.SelectedGenerators & SelectedGenerators.MainGenerator) != 0;
 #>

src/EnumUtilities/CodeWriters/EnumFactoryWriter.cs

@@ -1071,6 +1071,9 @@ public EnumFactoryWriter(StringBuilder builder) : base(builder)
 
     public override string GetFileName() => $"{Model.Namespace ?? "_"}.{Model.Name}Factory.g.cs";
 
+    protected override bool CanGenerateFor(EnumToGenerate model) =>
+        (model.SelectedGenerators & SelectedGenerators.MainGenerator) != 0;
+
 
         #line default
         #line hidden

src/EnumUtilities/CodeWriters/EnumFactoryWriter.tt

@@ -519,4 +519,7 @@ using System.Globalization;
     }
 
     public override string GetFileName() => $"{Model.Namespace ?? "_"}.{Model.Name}Factory.g.cs";
+
+    protected override bool CanGenerateFor(EnumToGenerate model) =>
+        (model.SelectedGenerators & SelectedGenerators.MainGenerator) != 0;
 #>