feat: Inheritance (#32)

* Inheritance implementation for Fluent API

* refactor(ClassInfoFactory): minor changes

* test: InheritedClass

* fix(ClassInfoFactory): compare to SpecialType in GetMembers

* test: InheritedClassProtectedMembers and InheritedClassProtectedSetters

* docs: mention inheritance in features

* fix: inheritance tests

* test: inherited record

* improve(ExampleProject): add ExchangeStudent example

* test: add failing test CanExecuteInheritedClassPrivateSetters

* fix: make test InheritedClassPrivateSetters work

* fix: InnerBodyForMethodGenerator

* refactor(ClassInfoFactory): use List instead of HashSet

* fix: commit generated file

* chore: bump nuget version

---------

Co-authored-by: Oleh Formaniuk <[email protected]>
Co-authored-by: Kevin Schaal <[email protected]>

Author: 3 people

README.md

@@ -24,7 +24,7 @@ Accompanying blog post: [www.m31coding.com>blog>fluent-api](https://www.m31codin
 - Optional (skippable) builder methods
 - Forking and branching capabilities
 - Support for returning arbitrary types
-- Support for generics and partial classes
+- Support for inheritance, generics, and partial classes
 
 ## Installing via NuGet
 
@@ -37,7 +37,7 @@ PM> Install-Package M31.FluentApi
 A package reference will be added to your `csproj` file. Moreover, since this library provides code via source code generation, consumers of your project don't need the reference to `M31.FluentApi`. Therefore, it is recommended to use the `PrivateAssets` metadata tag:
 
 ```xml
-<PackageReference Include="M31.FluentApi" Version="1.8.0" PrivateAssets="all"/>
+<PackageReference Include="M31.FluentApi" Version="1.9.0" PrivateAssets="all"/>
 ```
 
 If you would like to examine the generated code, you may emit it by adding the following lines to your `csproj` file:

src/ExampleProject/ExchangeStudent.cs

@@ -0,0 +1,14 @@
+// Non-nullable member is uninitialized
+#pragma warning disable CS8618
+// ReSharper disable All
+
+using M31.FluentApi.Attributes;
+
+namespace ExampleProject;
+
+[FluentApi]
+public class ExchangeStudent : Student
+{
+    [FluentMember(6)]
+    public string HomeCountry { get; private set; }
+}

src/ExampleProject/Program.cs

@@ -12,6 +12,14 @@
 Console.WriteLine(JsonSerializer.Serialize(student1));
 Console.WriteLine(JsonSerializer.Serialize(student2));
 
+// ExchangeStudent (inherited from Student)
+//
+
+ExchangeStudent exchangeStudent = CreateExchangeStudent.Named("Bob", "Bishop").BornOn(new DateOnly(2002, 8, 3))
+    .InSemester(2).LivingInBoston().WithUnknownMood().WhoseFriendIs("Alice").WithHomeCountry("United States");
+
+Console.WriteLine(JsonSerializer.Serialize(exchangeStudent));
+
 // Person
 //
 

src/M31.FluentApi.Generator/CodeGeneration/CodeBoardActors/InnerBodyGeneration/InnerBodyForMemberGenerator.cs

@@ -43,7 +43,7 @@ protected override void InitializeInfoField(string fieldName, MemberSymbolInfo s
         // semesterPropertyInfo = typeof(Student<T1, T2>)
         //     .GetProperty("Semester", BindingFlags.Instance | BindingFlags.NonPublic););
         string code = $"{fieldName} =" +
-                      $" typeof({CodeBoard.Info.FluentApiClassNameWithTypeParameters})" +
+                      $" typeof({symbolInfo.DeclaringClassNameWithTypeParameters})" +
                       $".Get{SymbolType(symbolInfo)}(\"{symbolInfo.Name}\", " +
                       $"{InfoFieldBindingFlagsArgument(symbolInfo)})!;";
 

src/M31.FluentApi.Generator/CodeGeneration/CodeBoardActors/InnerBodyGeneration/InnerBodyForMethodGenerator.cs

@@ -194,7 +194,7 @@ protected override void InitializeInfoField(string fieldName, MethodSymbolInfo s
         // Generic types are created via Type.MakeGenericMethodParameter(int position). In addition, a ref type is
         // specified via MakeByRefType().
         staticConstructor.AppendBodyLine($"{fieldName} = " +
-                                         $"typeof({CodeBoard.Info.FluentApiClassNameWithTypeParameters}).GetMethod(");
+                                         $"typeof({symbolInfo.DeclaringClassNameWithTypeParameters}).GetMethod(");
         staticConstructor.AppendBodyLine($"{indentation}\"{symbolInfo.Name}\",");
         staticConstructor.AppendBodyLine($"{indentation}{GetGenericParameterCount(symbolInfo.GenericInfo)},");
         staticConstructor.AppendBodyLine($"{indentation}{InfoFieldBindingFlagsArgument(symbolInfo)},");

src/M31.FluentApi.Generator/CodeGeneration/CodeBoardElements/BuilderAndTargetInfo.cs

@@ -17,14 +17,16 @@ internal BuilderAndTargetInfo(
     {
         Namespace = @namespace;
         FluentApiClassName = fluentApiClassName;
-        FluentApiClassNameWithTypeParameters = WithTypeParameters(fluentApiClassName, genericInfo);
+        FluentApiClassNameWithTypeParameters =
+            ClassInfoFactory.AugmentTypeNameWithGenericParameters(fluentApiClassName, genericInfo);
         GenericInfo = genericInfo;
         FluentApiTypeIsStruct = fluentApiTypeIsStruct;
         FluentApiTypeIsInternal = fluentApiTypeIsInternal;
         DefaultAccessModifier = fluentApiTypeIsInternal ? "internal" : "public";
         FluentApiTypeConstructorInfo = fluentApiTypeConstructorInfo;
         BuilderClassName = builderClassName;
-        BuilderClassNameWithTypeParameters = WithTypeParameters(builderClassName, genericInfo);
+        BuilderClassNameWithTypeParameters =
+            ClassInfoFactory.AugmentTypeNameWithGenericParameters(builderClassName, genericInfo);
         BuilderInstanceName = builderClassName.FirstCharToLower();
         ClassInstanceName = fluentApiClassName.FirstCharToLower();
         InitialStepInterfaceName = $"I{builderClassName}";
@@ -43,10 +45,4 @@ internal BuilderAndTargetInfo(
     internal string BuilderInstanceName { get; }
     internal string ClassInstanceName { get; }
     internal string InitialStepInterfaceName { get; }
-
-    private static string WithTypeParameters(string typeName, GenericInfo? genericInfo)
-    {
-        string parameterListInAngleBrackets = genericInfo?.ParameterListInAngleBrackets ?? string.Empty;
-        return $"{typeName}{parameterListInAngleBrackets}";
-    }
 }

src/M31.FluentApi.Generator/CodeGeneration/CodeBoardElements/FluentApiSymbolInfo.cs

@@ -5,22 +5,29 @@ namespace M31.FluentApi.Generator.CodeGeneration.CodeBoardElements;
 
 internal abstract class FluentApiSymbolInfo
 {
-    internal FluentApiSymbolInfo(string name, Accessibility accessibility, bool requiresReflection)
+    internal FluentApiSymbolInfo(
+        string name,
+        string declaringClassNameWithTypeParameters,
+        Accessibility accessibility,
+        bool requiresReflection)
     {
         Name = name;
         NameInCamelCase = Name.TrimStart('_').FirstCharToLower();
+        DeclaringClassNameWithTypeParameters = declaringClassNameWithTypeParameters;
         Accessibility = accessibility;
         RequiresReflection = requiresReflection;
     }
 
     internal string Name { get; }
     internal string NameInCamelCase { get; }
+    internal string DeclaringClassNameWithTypeParameters { get; }
     internal Accessibility Accessibility { get; }
     internal bool RequiresReflection { get; }
 
     protected bool Equals(FluentApiSymbolInfo other)
     {
         return Name == other.Name &&
+               DeclaringClassNameWithTypeParameters == other.DeclaringClassNameWithTypeParameters &&
                Accessibility == other.Accessibility &&
                RequiresReflection == other.RequiresReflection;
     }
@@ -35,6 +42,6 @@ public override bool Equals(object? obj)
 
     public override int GetHashCode()
     {
-        return new HashCode().Add(Name, Accessibility, RequiresReflection);
+        return new HashCode().Add(Name, DeclaringClassNameWithTypeParameters, Accessibility, RequiresReflection);
     }
 }

src/M31.FluentApi.Generator/CodeGeneration/CodeBoardElements/MemberSymbolInfo.cs

@@ -9,13 +9,14 @@ internal class MemberSymbolInfo : FluentApiSymbolInfo
     internal MemberSymbolInfo(
         string name,
         string type,
+        string declaringClassNameWithTypeParameters,
         Accessibility accessibility,
         bool requiresReflection,
         string typeForCodeGeneration,
         bool isNullable,
         bool isProperty,
         CollectionType? collectionType)
-        : base(name, accessibility, requiresReflection)
+        : base(name, declaringClassNameWithTypeParameters, accessibility, requiresReflection)
     {
         Type = type;
         TypeForCodeGeneration = typeForCodeGeneration;

src/M31.FluentApi.Generator/CodeGeneration/CodeBoardElements/MethodSymbolInfo.cs

@@ -8,12 +8,13 @@ internal class MethodSymbolInfo : FluentApiSymbolInfo
 {
     internal MethodSymbolInfo(
         string name,
+        string declaringClassNameWithTypeParameters,
         Accessibility accessibility,
         bool requiresReflection,
         GenericInfo? genericInfo,
         IReadOnlyCollection<ParameterSymbolInfo> parameterInfos,
         string returnType)
-        : base(name, accessibility, requiresReflection)
+        : base(name, declaringClassNameWithTypeParameters, accessibility, requiresReflection)
     {
         GenericInfo = genericInfo;
         ParameterInfos = parameterInfos;

src/M31.FluentApi.Generator/M31.FluentApi.Generator.csproj

@@ -11,7 +11,7 @@
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <SuppressDependenciesWhenPacking>true</SuppressDependenciesWhenPacking>
-    <PackageVersion>1.8.0</PackageVersion>
+    <PackageVersion>1.9.0</PackageVersion>
     <Authors>Kevin Schaal</Authors>
     <Description>The generator package for M31.FluentAPI. Don't install this package explicitly, install M31.FluentAPI instead.</Description>
     <PackageTags>fluentapi fluentbuilder fluentinterface fluentdesign fluent codegeneration</PackageTags>