Update README.md

Author: NikolayPianikov

README.md

@@ -262,6 +262,7 @@ dotnet run
 - [Complex generic root arguments](readme/complex-generic-root-arguments.md)
 - [Generic builder](readme/generic-builder.md)
 - [Generic builders](readme/generic-builders.md)
+- [Generic roots](readme/generic-roots.md)
 ### Attributes
 - [Constructor ordinal attribute](readme/constructor-ordinal-attribute.md)
 - [Dependency attribute](readme/dependency-attribute.md)

readme/WebAPI.md

@@ -20,7 +20,7 @@ internal partial class Composition: ServiceProviderFactory<Composition>
         // Use the DI setup from the base class
         .DependsOn(Base)
         .Bind().As(Singleton).To<WeatherForecastService>()
-        // Provides controllers as roots
+        // Registers controllers as roots
         .Roots<ControllerBase>();
 }
 ```

readme/WebAPIPageTemplate.md

@@ -20,7 +20,7 @@ internal partial class Composition: ServiceProviderFactory<Composition>
         // Use the DI setup from the base class
         .DependsOn(Base)
         .Bind().As(Singleton).To<WeatherForecastService>()
-        // Provides controllers as roots
+        // Registers controllers as roots
         .Roots<ControllerBase>();
 }
 ```

readme/WebApp.md

@@ -20,7 +20,7 @@ internal partial class Composition: ServiceProviderFactory<Composition>
         // Use the DI setup from the base class
         .DependsOn(Base)
         .Bind().As(Singleton).To<WeatherForecastService>()
-        // Provides controllers as roots
+        // Registers controllers as roots
         .Roots<Controller>();
 }
 ```

readme/WebAppPageTemplate.md

@@ -20,7 +20,7 @@ internal partial class Composition: ServiceProviderFactory<Composition>
         // Use the DI setup from the base class
         .DependsOn(Base)
         .Bind().As(Singleton).To<WeatherForecastService>()
-        // Provides controllers as roots
+        // Registers controllers as roots
         .Roots<Controller>();
 }
 ```

readme/async-disposable-scope.md

@@ -172,8 +172,8 @@ partial class Composition: IDisposable, IAsyncDisposable
       () =>
       {
         Composition transientComposition3 = this;
-        Session localValue98 = new Session(transientComposition3);
-        return localValue98;
+        Session localValue99 = new Session(transientComposition3);
+        return localValue99;
       });
       return new Program(perBlockFunc1);
     }

readme/auto-scoped.md

@@ -129,13 +129,13 @@ partial class Composition
       {
         Composition transientComposition3 = this;
         IService transientIService2;
-        Composition localBaseComposition100 = transientComposition3;
+        Composition localBaseComposition101 = transientComposition3;
         // Creates a session
-        var localSession101 = new Composition(localBaseComposition100);
+        var localSession102 = new Composition(localBaseComposition101);
         // Provides a root
-        transientIService2 = localSession101.SessionRoot;
-        IService localValue99 = transientIService2;
-        return localValue99;
+        transientIService2 = localSession102.SessionRoot;
+        IService localValue100 = transientIService2;
+        return localValue100;
       });
       return new Program(perBlockFunc1);
     }

readme/basic-unity-use-case.md

@@ -130,9 +130,9 @@ partial class Composition
     }
 
     Clock transientClock0;
-    Clock localBuildingInstance106 = buildingInstance;
-    localBuildingInstance106.ClockService = _root._singletonClockService43;
-    transientClock0 = localBuildingInstance106;
+    Clock localBuildingInstance107 = buildingInstance;
+    localBuildingInstance107.ClockService = _root._singletonClockService43;
+    transientClock0 = localBuildingInstance107;
     return transientClock0;
   }
 }

readme/generic-roots.md

@@ -0,0 +1,137 @@
+#### Generic roots
+
+[![CSharp](https://img.shields.io/badge/C%23-code-blue.svg)](../tests/Pure.DI.UsageTests/Generics/GenericsRootsScenario.cs)
+
+
+```c#
+using Pure.DI;
+
+DI.Setup(nameof(Composition))
+    // This hint indicates to not generate methods such as Resolve
+    .Hint(Hint.Resolve, "Off")
+    .Bind().To<Dependency<TT>>()
+    .Bind().To<Service<TT>>()
+    // Creates OtherService manually,
+    // just for the sake of example
+    .Bind<OtherService<TT>>().To(ctx =>
+    {
+        ctx.Inject(out IDependency<TT> dependency);
+        return new OtherService<TT>(dependency);
+    })
+
+    // Specifies to define composition roots for all types inherited from IService<TT>
+    // available at compile time at the point where the method is called
+    .Roots<IService<TT>>("GetMy{type}");
+
+var composition = new Composition();
+
+// service = new Service<int>(new Dependency<int>());
+var service = composition.GetMyService_T<int>();
+
+// someOtherService = new OtherService<int>(new Dependency<int>());
+var someOtherService = composition.GetMyOtherService_T<string>();
+
+interface IDependency<T>;
+
+class Dependency<T> : IDependency<T>;
+
+interface IService<T>;
+
+class Service<T>(IDependency<T> dependency) : IService<T>;
+
+class OtherService<T>(IDependency<T> dependency) : IService<T>;
+```
+
+<details>
+<summary>Running this code sample locally</summary>
+
+- Make sure you have the [.NET SDK 9.0](https://dotnet.microsoft.com/en-us/download/dotnet/9.0) or later is installed
+```bash
+dotnet --list-sdk
+```
+- Create a net9.0 (or later) console application
+```bash
+dotnet new console -n Sample
+```
+- Add reference to NuGet package
+  - [Pure.DI](https://www.nuget.org/packages/Pure.DI)
+```bash
+dotnet add package Pure.DI
+```
+- Copy the example code into the _Program.cs_ file
+
+You are ready to run the example 🚀
+```bash
+dotnet run
+```
+
+</details>
+
+The following partial class will be generated:
+
+```c#
+partial class Composition
+{
+  private readonly Composition _root;
+
+  [OrdinalAttribute(256)]
+  public Composition()
+  {
+    _root = this;
+  }
+
+  internal Composition(Composition parentScope)
+  {
+    _root = (parentScope ?? throw new ArgumentNullException(nameof(parentScope)))._root;
+  }
+
+  [MethodImpl(MethodImplOptions.AggressiveInlining)]
+  public OtherService<T3> GetMyOtherService_T<T3>()
+  {
+    OtherService<T3> transientOtherService0;
+    IDependency<T3> localDependency97 = new Dependency<T3>();
+    transientOtherService0 = new OtherService<T3>(localDependency97);
+    return transientOtherService0;
+  }
+
+  [MethodImpl(MethodImplOptions.AggressiveInlining)]
+  public Service<T3> GetMyService_T<T3>()
+  {
+    return new Service<T3>(new Dependency<T3>());
+  }
+}
+```
+
+Class diagram:
+
+```mermaid
+---
+ config:
+  class:
+   hideEmptyMembersBox: true
+---
+classDiagram
+	DependencyᐸT3ᐳ --|> IDependencyᐸT3ᐳ
+	Composition ..> OtherServiceᐸT3ᐳ : OtherServiceᐸT3ᐳ GetMyOtherService_TᐸT3ᐳ()
+	Composition ..> ServiceᐸT3ᐳ : ServiceᐸT3ᐳ GetMyService_TᐸT3ᐳ()
+	OtherServiceᐸT3ᐳ *--  DependencyᐸT3ᐳ : IDependencyᐸT3ᐳ
+	ServiceᐸT3ᐳ *--  DependencyᐸT3ᐳ : IDependencyᐸT3ᐳ
+	namespace Pure.DI.UsageTests.Generics.GenericsRootsScenario {
+		class Composition {
+		<<partial>>
+		+OtherServiceᐸT3ᐳ GetMyOtherService_TᐸT3ᐳ()
+		+ServiceᐸT3ᐳ GetMyService_TᐸT3ᐳ()
+		}
+		class DependencyᐸT3ᐳ {
+			+Dependency()
+		}
+		class IDependencyᐸT3ᐳ {
+			<<interface>>
+		}
+		class OtherServiceᐸT3ᐳ {
+		}
+		class ServiceᐸT3ᐳ {
+		}
+	}
+```
+

readme/scope.md

@@ -170,8 +170,8 @@ partial class Composition: IDisposable
       () =>
       {
         Composition transientComposition3 = this;
-        Session localValue102 = new Session(transientComposition3);
-        return localValue102;
+        Session localValue103 = new Session(transientComposition3);
+        return localValue103;
       });
       return new Program(perBlockFunc1);
     }