Provisionally resolve #242 - more useful type names

This means that people reading reports will see more useful
human readable names of types which are involved in
Performances.

Author: craigfowler

CSF.Screenplay.Selenium/Actions/SingleElementPerformableAdapter.cs

@@ -18,7 +18,7 @@ namespace CSF.Screenplay.Selenium.Actions
     /// to fetch it using the WebDriver more than once.  As such, instances of this adapter (like all performables) should not be re-used.
     /// </para>
     /// </remarks>
-    public class SingleElementPerformableAdapter : IPerformable, ICanReport
+    public class SingleElementPerformableAdapter : IPerformable, ICanReport, IHasCustomTypeName
     {
         readonly ISingleElementPerformable performable;
         readonly ITarget target;
@@ -38,6 +38,10 @@ public ValueTask PerformAsAsync(ICanPerform actor, CancellationToken cancellatio
             return performable.PerformAsAsync(actor, actor.GetAbility<BrowseTheWeb>().WebDriver, lazyElement, cancellationToken);
         }
 
+        /// <inheritdoc/>
+        public string GetHumanReadableTypeName()
+            => $"{performable.GetType().FullName}, via {nameof(SingleElementPerformableAdapter)}";
+
         /// <summary>
         /// Initializes a new instance of the <see cref="SingleElementPerformableAdapter"/> class with the specified performable and target.
         /// </summary>

CSF.Screenplay.Selenium/Questions/ElementCollectionPerformableWithResultAdapter.cs

@@ -19,7 +19,7 @@ namespace CSF.Screenplay.Selenium.Questions
     /// to fetch it using the WebDriver more than once.  As such, instances of this adapter (like all performables) should not be re-used.
     /// </para>
     /// </remarks>
-    public class ElementCollectionPerformableWithResultAdapter<TResult> : IPerformableWithResult<IReadOnlyList<TResult>>, ICanReport
+    public class ElementCollectionPerformableWithResultAdapter<TResult> : IPerformableWithResult<IReadOnlyList<TResult>>, ICanReport, IHasCustomTypeName
     {
         readonly IElementCollectionPerformableWithResult<TResult> performable;
         readonly ITarget target;
@@ -39,6 +39,10 @@ public ValueTask<IReadOnlyList<TResult>> PerformAsAsync(ICanPerform actor, Cance
             return performable.PerformAsAsync(actor, actor.GetAbility<BrowseTheWeb>().WebDriver, lazyElements, cancellationToken);
         }
 
+        /// <inheritdoc/>
+        public string GetHumanReadableTypeName()
+            => $"{performable.GetHumanReadableTypeName()}, via {nameof(ElementCollectionPerformableWithResultAdapter)}";
+
         /// <summary>
         /// Initializes a new instance of the <see cref="ElementCollectionPerformableWithResultAdapter{TResult}"/> class with the specified performable and target.
         /// </summary>

CSF.Screenplay.Selenium/Questions/ElementCollectionQuery.cs

@@ -57,6 +57,10 @@ public ReportFragment GetReportFragment(Actor actor, Lazy<SeleniumElementCollect
         public ValueTask<IReadOnlyList<TResult>> PerformAsAsync(ICanPerform actor, IWebDriver webDriver, Lazy<SeleniumElementCollection> elements, CancellationToken cancellationToken = default)
             => new ValueTask<IReadOnlyList<TResult>>(elements.Value.Select(query.GetValue).ToList());
 
+        /// <inheritdoc/>
+        public string GetHumanReadableTypeName()
+            => $"{query.GetType().FullName}, via {nameof(ElementCollectionQuery)}";
+
         /// <summary>
         /// Initializes a new instance of the <see cref="ElementCollectionQuery{TResult}"/> class with the specified query.
         /// </summary>

CSF.Screenplay.Selenium/Questions/FindElement.cs

@@ -70,6 +70,9 @@ public ValueTask<SeleniumElement> PerformAsAsync(ICanPerform actor, IWebDriver w
 
         string GetElementsName(SeleniumElement element) => elementsName ?? $"{locatorBasedMatcher?.Name} within {element.Name}";
 
+        /// <inheritdoc/>
+        public string GetHumanReadableTypeName() => GetType().FullName;
+
         /// <summary>
         /// Initializes a new instance of the <see cref="FindElement"/> class.
         /// </summary>

CSF.Screenplay.Selenium/Questions/FindElements.cs

@@ -69,6 +69,9 @@ public ValueTask<SeleniumElementCollection> PerformAsAsync(ICanPerform actor, IW
 
         string GetElementsName(SeleniumElement element) => elementsName ?? $"{locatorBasedMatcher?.Name} within {element.Name}";
 
+        /// <inheritdoc/>
+        public string GetHumanReadableTypeName() => GetType().FullName;
+
         /// <summary>
         /// Initializes a new instance of the <see cref="FindElements"/> class.
         /// </summary>

CSF.Screenplay.Selenium/Questions/GetShadowRootNatively.cs

@@ -34,6 +34,9 @@ public class GetShadowRootNatively : ISingleElementPerformableWithResult<Seleniu
         public ReportFragment GetReportFragment(Actor actor, Lazy<SeleniumElement> element, IFormatsReportFragment formatter)
             => formatter.Format("{Actor} gets the Shadow Root node from {Element} using the native Selenium technique", actor, element.Value);
 
+        /// <inheritdoc/>
+        public string GetHumanReadableTypeName() => GetType().FullName;
+
         /// <inheritdoc/>
         public ValueTask<SeleniumElement> PerformAsAsync(ICanPerform actor, IWebDriver webDriver, Lazy<SeleniumElement> element, CancellationToken cancellationToken = default)
         {

CSF.Screenplay.Selenium/Questions/GetShadowRootWithJavaScript.cs

@@ -35,6 +35,9 @@ public class GetShadowRootWithJavaScript : ISingleElementPerformableWithResult<S
         public ReportFragment GetReportFragment(Actor actor, Lazy<SeleniumElement> element, IFormatsReportFragment formatter)
             => formatter.Format("{Actor} gets the Shadow Root node from {Element} using JavaScript", actor, element.Value);
 
+        /// <inheritdoc/>
+        public string GetHumanReadableTypeName() => GetType().FullName;
+
         /// <inheritdoc/>
         public async ValueTask<SeleniumElement> PerformAsAsync(ICanPerform actor, IWebDriver webDriver, Lazy<SeleniumElement> element, CancellationToken cancellationToken = default)
         {

CSF.Screenplay.Selenium/Questions/IElementCollectionPerformableWithResult.cs

@@ -21,7 +21,7 @@ namespace CSF.Screenplay.Selenium.Questions
     /// <see cref="SingleElementPerformableWithResultAdapter{TResult}"/>.
     /// </para>
     /// </remarks>
-    public interface IElementCollectionPerformableWithResult<TResult> : ICanReportForElements
+    public interface IElementCollectionPerformableWithResult<TResult> : ICanReportForElements, IHasCustomTypeName
     {
         /// <summary>
         /// Counterpart to <see cref="IPerformableWithResult{TResult}.PerformAsAsync(ICanPerform, CancellationToken)"/> except that this method also offers

CSF.Screenplay.Selenium/Questions/ISingleElementPerformableWithResult.cs

@@ -20,7 +20,7 @@ namespace CSF.Screenplay.Selenium.Questions
     /// <see cref="SingleElementPerformableWithResultAdapter{TResult}"/>.
     /// </para>
     /// </remarks>
-    public interface ISingleElementPerformableWithResult<TResult> : ICanReportForElement
+    public interface ISingleElementPerformableWithResult<TResult> : ICanReportForElement, IHasCustomTypeName
     {
         /// <summary>
         /// Counterpart to <see cref="IPerformableWithResult{TResult}.PerformAsAsync(ICanPerform, CancellationToken)"/> except that this method also offers

CSF.Screenplay.Selenium/Questions/SingleElementPerformableWithResultAdapter.cs

@@ -18,7 +18,7 @@ namespace CSF.Screenplay.Selenium.Questions
     /// to fetch it using the WebDriver more than once.  As such, instances of this adapter (like all performables) should not be re-used.
     /// </para>
     /// </remarks>
-    public class SingleElementPerformableWithResultAdapter<TResult> : IPerformableWithResult<TResult>, ICanReport
+    public class SingleElementPerformableWithResultAdapter<TResult> : IPerformableWithResult<TResult>, ICanReport, IHasCustomTypeName
     {
         readonly ISingleElementPerformableWithResult<TResult> performable;
         readonly ITarget target;
@@ -46,6 +46,10 @@ public ValueTask<TResult> PerformAsAsync(ICanPerform actor, CancellationToken ca
             }
         }
 
+        /// <inheritdoc/>
+        public string GetHumanReadableTypeName()
+            => $"{performable.GetHumanReadableTypeName()}, via {nameof(SingleElementPerformableWithResultAdapter)}";
+
         /// <summary>
         /// Initializes a new instance of the <see cref="SingleElementPerformableWithResultAdapter{TResult}"/> class with the specified performable and target.
         /// </summary>