Update to 1.3.1 (Hotfix)

 - Added: Packaged with XML Documentation files.

 - Refactor: Reflected changes to concrete classes, into API endpoint interfaces.

Author: ApacheTech

ApacheTech.Common.DependencyInjection/Abstractions/IServiceCollection.ObsoleteMethods.cs

@@ -0,0 +1,109 @@
+using System;
+
+namespace ApacheTech.Common.DependencyInjection.Abstractions
+{
+    public partial interface IServiceCollection
+    {
+        /// <summary>
+        ///     Registers a raw service descriptor, pre-populated with meta-data for the service.
+        /// </summary>
+        /// <param name="descriptor">The pre-populated descriptor for the service to register.</param>
+        /// <seealso cref="ServiceDescriptor"/>
+        [Obsolete("Use Add() instead. Method will be removed during in the major release cycle.")]
+        void Register(ServiceDescriptor descriptor);
+
+        /// <summary>
+        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        /// </summary>
+        /// <param name="implementationType">The type of implementation to use.</param>
+        /// <seealso cref="ServiceLifetime.Singleton"/>
+        [Obsolete("Use AddSingleton() instead. Method will be removed during in the major release cycle.")]
+        void RegisterSingleton(Type implementationType);
+
+        /// <summary>
+        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        /// </summary>
+        /// <param name="serviceType">The type of service to register.</param>
+        /// <param name="implementationType">The type of implementation to use.</param>
+        /// <seealso cref="ServiceLifetime.Singleton"/>
+        [Obsolete("Use AddSingleton() instead. Method will be removed during in the major release cycle.")]
+        void RegisterSingleton(Type serviceType, Type implementationType);
+
+        /// <summary>
+        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        /// </summary>
+        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <seealso cref="ServiceLifetime.Singleton"/>
+        [Obsolete("Use AddSingleton() instead. Method will be removed during in the major release cycle.")]
+        void RegisterSingleton<TService>() where TService : class;
+
+        /// <summary>
+        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        /// </summary>
+        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <typeparam name="TImplementation">The type of implementation to use.</typeparam>
+        /// <seealso cref="ServiceLifetime.Singleton"/>
+        [Obsolete("Use AddSingleton() instead. Method will be removed during in the major release cycle.")]
+        void RegisterSingleton<TService, TImplementation>() where TImplementation : TService;
+
+        /// <summary>
+        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        /// </summary>
+        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <param name="implementationFactory">The factory that creates the service.</param>
+        /// <seealso cref="ServiceLifetime.Singleton"/>
+        [Obsolete("Use AddSingleton() instead. Method will be removed during in the major release cycle.")]
+        void RegisterSingleton<TService>(Func<IServiceResolver, TService> implementationFactory) where TService : class;
+
+        /// <summary>
+        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        /// </summary>
+        /// <typeparam name="TService">The instance to register.</typeparam>
+        /// <seealso cref="ServiceLifetime.Singleton"/>
+        [Obsolete("Use AddSingleton() instead. Method will be removed during in the major release cycle.")]
+        void RegisterSingleton<TService>(TService implementation);
+
+        /// <summary>
+        ///     Registers a service as a singleton. A new instance of the service will be created each time it is resolved.
+        /// </summary>
+        /// <param name="implementationType">The type of implementation to use.</param>
+        /// <seealso cref="ServiceLifetime.Transient"/>
+        [Obsolete("Use AddTransient() instead. Method will be removed during in the major release cycle.")]
+        void RegisterTransient(Type implementationType);
+
+        /// <summary>
+        ///     Registers a service as a singleton. A new instance of the service will be created each time it is resolved.
+        /// </summary>
+        /// <param name="serviceType">The type of service to register.</param>
+        /// <param name="implementationType">The type of implementation to use.</param>
+        /// <seealso cref="ServiceLifetime.Transient"/>
+        [Obsolete("Use AddTransient() instead. Method will be removed during in the major release cycle.")]
+        void RegisterTransient(Type serviceType, Type implementationType);
+
+        /// <summary>
+        ///     Registers a service as a singleton. A new instance of the service will be created each time it is resolved.
+        /// </summary>
+        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <seealso cref="ServiceLifetime.Transient"/>
+        [Obsolete("Use AddTransient() instead. Method will be removed during in the major release cycle.")]
+        void RegisterTransient<TService>() where TService : class;
+
+        /// <summary>
+        ///     Registers a service as a singleton. A new instance of the service will be created each time it is resolved.
+        /// </summary>
+        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <typeparam name="TImplementation">The type of implementation to use.</typeparam>
+        /// <seealso cref="ServiceLifetime.Transient"/>
+        [Obsolete("Use AddTransient() instead. Method will be removed during in the major release cycle.")]
+        void RegisterTransient<TService, TImplementation>() where TImplementation : TService;
+
+        /// <summary>
+        /// Registers a service as a singleton. A new instance of the service will be created each time it is resolved.
+        /// </summary>
+        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <param name="implementationFactory">The factory that creates the service.</param>
+        /// <seealso cref="ServiceLifetime.Transient" />
+        [Obsolete("Use AddTransient() instead. Method will be removed during in the major release cycle.")]
+        void RegisterTransient<TService>(Func<IServiceResolver, TService> implementationFactory) where TService : class;
+    }
+}

ApacheTech.Common.DependencyInjection/Abstractions/IServiceCollection.cs

@@ -6,100 +6,100 @@
 namespace ApacheTech.Common.DependencyInjection.Abstractions
 {
     /// <summary>
-    ///     An IOC Container, which holds references to registered types of services, and their instances.
+    ///     An IOC Container, which holds references to Added types of services, and their instances.
     /// </summary>
-    public interface IServiceCollection
+    public partial interface IServiceCollection
     {
         /// <summary>
-        ///     Registers a raw service descriptor, pre-populated with meta-data for the service.
+        ///     Adds a raw service descriptor, pre-populated with meta-data for the service.
         /// </summary>
-        /// <param name="descriptor">The pre-populated descriptor for the service to register.</param>
+        /// <param name="descriptor">The pre-populated descriptor for the service to add.</param>
         /// <seealso cref="ServiceDescriptor"/>
-        void Register(ServiceDescriptor descriptor);
+        void Add(ServiceDescriptor descriptor);
 
         /// <summary>
-        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        ///     Adds a service as a singleton. Only one instance of the service will be created within the container.
         /// </summary>
         /// <param name="implementationType">The type of implementation to use.</param>
         /// <seealso cref="ServiceLifetime.Singleton"/>
-        void RegisterSingleton(Type implementationType);
+        void AddSingleton(Type implementationType);
 
         /// <summary>
-        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        ///     Adds a service as a singleton. Only one instance of the service will be created within the container.
         /// </summary>
-        /// <param name="serviceType">The type of service to register.</param>
+        /// <param name="serviceType">The type of service to add.</param>
         /// <param name="implementationType">The type of implementation to use.</param>
         /// <seealso cref="ServiceLifetime.Singleton"/>
-        void RegisterSingleton(Type serviceType, Type implementationType);
+        void AddSingleton(Type serviceType, Type implementationType);
 
         /// <summary>
-        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        ///     Adds a service as a singleton. Only one instance of the service will be created within the container.
         /// </summary>
-        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <typeparam name="TService">The type of service to add.</typeparam>
         /// <seealso cref="ServiceLifetime.Singleton"/>
         /// 
-        void RegisterSingleton<TService>() where TService : class;
+        void AddSingleton<TService>() where TService : class;
 
         /// <summary>
-        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        ///     Adds a service as a singleton. Only one instance of the service will be created within the container.
         /// </summary>
-        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <typeparam name="TService">The type of service to add.</typeparam>
         /// <typeparam name="TImplementation">The type of implementation to use.</typeparam>
         /// <seealso cref="ServiceLifetime.Singleton"/>
-        void RegisterSingleton<TService, TImplementation>() where TImplementation : TService;
+        void AddSingleton<TService, TImplementation>() where TImplementation : TService;
 
         /// <summary>
-        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        ///     Adds a service as a singleton. Only one instance of the service will be created within the container.
         /// </summary>
-        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <typeparam name="TService">The type of service to add.</typeparam>
         /// <param name="implementationFactory">The factory that creates the service.</param>
         /// <seealso cref="ServiceLifetime.Singleton"/>
-        void RegisterSingleton<TService>(Func<IServiceResolver, TService> implementationFactory) where TService : class;
+        void AddSingleton<TService>(Func<IServiceResolver, TService> implementationFactory) where TService : class;
 
         /// <summary>
-        ///     Registers a service as a singleton. Only one instance of the service will be created within the container.
+        ///     Adds a service as a singleton. Only one instance of the service will be created within the container.
         /// </summary>
-        /// <typeparam name="TService">The instance to register.</typeparam>
+        /// <typeparam name="TService">The instance to add.</typeparam>
         /// <seealso cref="ServiceLifetime.Singleton"/>
-        void RegisterSingleton<TService>(TService implementation);
+        void AddSingleton<TService>(TService implementation);
 
         /// <summary>
-        ///     Registers a service as a singleton. A new instance of the service will be created each time it is resolved.
+        ///     Adds a service as a singleton. A new instance of the service will be created each time it is resolved.
         /// </summary>
         /// <param name="implementationType">The type of implementation to use.</param>
         /// <seealso cref="ServiceLifetime.Transient"/>
-        void RegisterTransient(Type implementationType);
+        void AddTransient(Type implementationType);
 
         /// <summary>
-        ///     Registers a service as a singleton. A new instance of the service will be created each time it is resolved.
+        ///     Adds a service as a singleton. A new instance of the service will be created each time it is resolved.
         /// </summary>
-        /// <param name="serviceType">The type of service to register.</param>
+        /// <param name="serviceType">The type of service to add.</param>
         /// <param name="implementationType">The type of implementation to use.</param>
         /// <seealso cref="ServiceLifetime.Transient"/>
-        void RegisterTransient(Type serviceType, Type implementationType);
+        void AddTransient(Type serviceType, Type implementationType);
 
         /// <summary>
-        ///     Registers a service as a singleton. A new instance of the service will be created each time it is resolved.
+        ///     Adds a service as a singleton. A new instance of the service will be created each time it is resolved.
         /// </summary>
-        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <typeparam name="TService">The type of service to add.</typeparam>
         /// <seealso cref="ServiceLifetime.Transient"/>
-        void RegisterTransient<TService>() where TService : class;
+        void AddTransient<TService>() where TService : class;
 
         /// <summary>
-        ///     Registers a service as a singleton. A new instance of the service will be created each time it is resolved.
+        ///     Adds a service as a singleton. A new instance of the service will be created each time it is resolved.
         /// </summary>
-        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <typeparam name="TService">The type of service to add.</typeparam>
         /// <typeparam name="TImplementation">The type of implementation to use.</typeparam>
         /// <seealso cref="ServiceLifetime.Transient"/>
-        void RegisterTransient<TService, TImplementation>() where TImplementation : TService;
+        void AddTransient<TService, TImplementation>() where TImplementation : TService;
 
         /// <summary>
-        ///     Registers a service as a singleton. A new instance of the service will be created each time it is resolved.
+        ///     Adds a service as a singleton. A new instance of the service will be created each time it is resolved.
         /// </summary>
-        /// <typeparam name="TService">The type of service to register.</typeparam>
+        /// <typeparam name="TService">The type of service to add.</typeparam>
         /// <param name="implementationFactory">The factory that creates the service.</param>
         /// <seealso cref="ServiceLifetime.Transient"/>
-        void RegisterTransient<TService>(Func<IServiceResolver, TService> implementationFactory) where TService : class;
+        void AddTransient<TService>(Func<IServiceResolver, TService> implementationFactory) where TService : class;
 
         /// <summary>
         ///     Build a service resolver, to access services within this collection.

ApacheTech.Common.DependencyInjection/ApacheTech.Common.DependencyInjection.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
 	<PropertyGroup>
-		<Version>1.3.0.0</Version>
+		<Version>1.3.1.0</Version>
 
 		<ApplicationIcon>__Icon.ico</ApplicationIcon>
 		<AssemblyName>ApacheTech.Common.DependencyInjection</AssemblyName>
@@ -39,6 +39,16 @@
 
 		<TargetFramework>netstandard2.0</TargetFramework>
 		<Title>Minimal Dependency Injection Engine</Title>
+		<AllowUnsafeBlocks>False</AllowUnsafeBlocks>
+		<GenerateDocumentationFile>True</GenerateDocumentationFile>
+	</PropertyGroup>
+
+	<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
+	  <TreatWarningsAsErrors>True</TreatWarningsAsErrors>
+	</PropertyGroup>
+
+	<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
+	  <TreatWarningsAsErrors>True</TreatWarningsAsErrors>
 	</PropertyGroup>
 
 	<ItemGroup>