Add MissingScenarioDependenciesException and update documentation (#28)

* Update documentation
* Update SpecFlow packages to 3.1.86
* Add MissingScenarioDependenciesException

Author: mbhoek

README.md

@@ -11,6 +11,7 @@ Currently supports:
 * [SpecFlow v3.0 or above](https://www.nuget.org/packages/SpecFlow/3.0)
 * [Microsoft.Extensions.DependencyInjection v2.1 or above](https://www.nuget.org/packages/Microsoft.Extensions.DependencyInjection/2.1)
 
+Listed on [Available Plugins for SpecFlow](https://specflow.org/documentation/Available-Plugins/).
 Based on https://github.com/gasparnagy/SpecFlow.Autofac (now [part of SpecFlow](https://github.com/SpecFlowOSS/SpecFlow/tree/master/Plugins/SpecFlow.Autofac.SpecFlowPlugin)).
 
 ## Usage
@@ -21,18 +22,23 @@ Install plugin from NuGet into your SpecFlow project.
 PM> Install-Package SolidToken.SpecFlow.DependencyInjection
 ```
 
-Create a static method somewhere in the SpecFlow project (recommended to put it into the ```Support``` folder) that returns an Microsoft.Extensions.DependencyInjection ```IServiceCollection``` and tag it with the `[ScenarioDependencies]` attribute. Configure your dependencies for the scenario execution within the method. You also have to register the step definition classes, that you can do by either registering all classes marked with the ```[Binding]``` attribute:
+Create a static method in your SpecFlow project that returns a `Microsoft.Extensions.DependencyInjection.IServiceCollection` and tag it with the `[ScenarioDependencies]` attribute. 
+Configure your test dependencies for the scenario execution within this method. 
+Step definition classes (i.e. classes with the SpecFlow `[Binding]` attribute) are automatically added to the service collection.
 
-A typical dependency builder method probably looks like this:
+A typical dependency builder method looks like this:
 
 ```csharp
 [ScenarioDependencies]
 public static IServiceCollection CreateServices()
 {
     var services = new ServiceCollection();
 
+    // TODO: add your test dependencies here
+    // NOTE: since v0.4.0 it's no longer necessary to manually add your [Binding] classes
+
     return services;
 }
 ```
 
-Refer to ```SpecFlow.DependencyInjection.Tests``` for a typical implementation.
+Refer to `SpecFlow.DependencyInjection.Tests` for an example.

SpecFlow.DependencyInjection.Tests/SpecFlow.DependencyInjection.Tests.csproj

@@ -23,8 +23,8 @@
   <!-- .NET Core 3.1 LTS (always use latest applicable version) -->
   <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp3.1' ">
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="3.1.1" />
-    <PackageReference Include="SpecFlow.Tools.MsBuild.Generation" Version="3.1.82" />
-    <PackageReference Include="SpecFlow.xUnit" Version="3.1.82" />
+    <PackageReference Include="SpecFlow.Tools.MsBuild.Generation" Version="3.1.86" />
+    <PackageReference Include="SpecFlow.xUnit" Version="3.1.86" />
   </ItemGroup>
 
   <ItemGroup>

SpecFlow.DependencyInjection/DependencyInjectionPlugin.cs

@@ -45,9 +45,6 @@ public void Initialize(RuntimePluginEvents runtimePluginEvents, RuntimePluginPar
             };
         }
 
-        /// <summary>
-        /// Pass-through plumbing from Microsoft.Extensions.DependencyInjection to SpecFlow.BoDi.
-        /// </summary>
         private void RegisterSpecFlowDependencies(
             IObjectContainer objectContainer,
             IServiceCollection services)

SpecFlow.DependencyInjection/MissingScenarioDependenciesException.cs

@@ -0,0 +1,15 @@
+using System;
+using TechTalk.SpecFlow;
+
+namespace SolidToken.SpecFlow.DependencyInjection
+{
+    [Serializable]
+    public class MissingScenarioDependenciesException : SpecFlowException
+    {
+        public MissingScenarioDependenciesException()
+            : base("No method marked with [ScenarioDependencies] attribute found.")
+        {
+            HelpLink = @"https://github.com/solidtoken/SpecFlow.DependencyInjection#usage";
+        }
+    }
+}

SpecFlow.DependencyInjection/ScenarioDependenciesAttribute.cs

@@ -6,7 +6,7 @@ namespace SolidToken.SpecFlow.DependencyInjection
     public class ScenarioDependenciesAttribute : Attribute
     {
         /// <summary>
-        /// Automatically register all SpecFlow bindings
+        /// Automatically register all SpecFlow bindings.
         /// </summary>
         public bool AutoRegisterBindings { get; set; } = true;
     }

SpecFlow.DependencyInjection/ServiceCollectionFinder.cs

@@ -23,7 +23,7 @@ public Func<IServiceCollection> GetCreateScenarioServiceCollection()
             var services = createScenarioServiceCollection.Value;
             if (services == null)
             {
-                throw new Exception("Unable to find scenario dependencies! Mark a static method that returns a IServiceCollection with [ScenarioDependencies]!");
+                throw new MissingScenarioDependenciesException();
             }
             return services;
         }