simplified List Parameters

Author: SpocWeb

src/QuikGraph/Algorithms/Exploration/CloneableVertexGraphExplorerAlgorithm.cs

@@ -189,11 +189,14 @@ public void AddTransitionFactory([NotNull] ITransitionFactory<TVertex, TEdge> tr
             _transitionFactories.Add(transitionFactory);
         }
 
-        /// <summary>
-        /// Adds new <see cref="ITransitionFactory{TVertex,TEdge}"/>s to this algorithm.
-        /// </summary>
-        /// <param name="transitionFactories">Transition factories to add.</param>
-        /// <exception cref="T:System.ArgumentNullException"><paramref name="transitionFactories"/> is <see langword="null"/>.</exception>
+        /// <summary>Adds new <see cref="ITransitionFactory{TVertex,TEdge}"/>s to this algorithm. </summary>
+        public void AddTransitionFactories(
+            [NotNull, ItemNotNull] params ITransitionFactory<TVertex, TEdge>[] transitionFactories)
+        {
+            AddTransitionFactories(transitionFactories.AsEnumerable());
+        }
+
+        /// <summary>Adds new <see cref="ITransitionFactory{TVertex,TEdge}"/>s to this algorithm. </summary>
         public void AddTransitionFactories(
             [NotNull, ItemNotNull] IEnumerable<ITransitionFactory<TVertex, TEdge>> transitionFactories)
         {

src/QuikGraph/Algorithms/TarjanOfflineLeastCommonAncestorAlgorithm.cs

@@ -124,9 +124,13 @@ public bool TryGetVertexPairs(out IEnumerable<SEquatableEdge<TVertex>> pairs)
             return pairs != null;
         }
 
-        /// <summary>
-        /// Sets vertices pairs.
-        /// </summary>
+        /// <summary> Sets vertices pairs. </summary>
+        /// <param name="pairs">Vertices pairs.</param>
+        /// <exception cref="T:System.ArgumentNullException"><paramref name="pairs"/> is <see langword="null"/>.</exception>
+        /// <exception cref="T:System.ArgumentException"><paramref name="pairs"/> is empty or any vertex from pairs is not part of <see cref="AlgorithmBase{TGraph}.VisitedGraph"/>.</exception>
+        public void SetVertexPairs([NotNull] params SEquatableEdge<TVertex>[] pairs) => SetVertexPairs(pairs.AsEnumerable());
+
+        /// <summary> Sets vertices pairs. </summary>
         /// <param name="pairs">Vertices pairs.</param>
         /// <exception cref="T:System.ArgumentNullException"><paramref name="pairs"/> is <see langword="null"/>.</exception>
         /// <exception cref="T:System.ArgumentException"><paramref name="pairs"/> is empty or any vertex from pairs is not part of <see cref="AlgorithmBase{TGraph}.VisitedGraph"/>.</exception>

src/QuikGraph/Extensions/EdgeExtensions.cs

@@ -414,7 +414,7 @@ internal static bool SortedVertexEqualityInternal<TVertex>(
         [Pure]
         [NotNull]
         public static IEnumerable<SReversedEdge<TVertex, TEdge>> ReverseEdges<TVertex, TEdge>(
-            [NotNull, ItemNotNull] IEnumerable<TEdge> edges)
+            [NotNull, ItemNotNull] this IEnumerable<TEdge> edges)
             where TEdge : IEdge<TVertex>
         {
             if (edges is null)

src/QuikGraph/Interfaces/Graphs/IMutableEdgeListGraph.cs

@@ -1,9 +1,20 @@
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using JetBrains.Annotations;
 
 namespace QuikGraph
 {
+    /// <summary> Extension Methods for <see cref="IMutableEdgeListGraph{TVertex, TEdge}"/> </summary>
+    public static class MutableEdgeListGraph
+    {
+        /// <summary> Adds the <paramref name="edges"/> to the <paramref name="graph"/>. </summary>
+        public static int AddEdgeRange<TVertex, TEdge>(this IMutableEdgeListGraph<TVertex, TEdge> graph
+            , [NotNull, ItemNotNull] params TEdge[] edges) where TEdge : IEdge<TVertex>
+            => graph.AddEdgeRange(edges.AsEnumerable());
+
+    }
+
     /// <summary>
     /// A mutable edge list graph with vertices of type <typeparamref name="TVertex"/>
     /// and edges of type <typeparamref name="TEdge"/>.
@@ -27,9 +38,7 @@ public interface IMutableEdgeListGraph<TVertex, TEdge> : IMutableGraph<TVertex,
         /// </summary>
         event EdgeAction<TVertex, TEdge> EdgeAdded;
 
-        /// <summary>
-        /// Adds a set of edges to this graph.
-        /// </summary>
+        /// <summary> Adds the <paramref name="edges"/> to this graph. </summary>
         /// <param name="edges">Edges to add.</param>
         /// <returns>The number of edges successfully added to this graph.</returns>
         /// <exception cref="T:System.ArgumentNullException">

src/QuikGraph/Interfaces/Graphs/IMutableVertexSet.cs

@@ -1,13 +1,24 @@
 using System;
+using System.Collections;
 using System.Collections.Generic;
+using System.Linq;
 using JetBrains.Annotations;
 
 namespace QuikGraph
 {
-    /// <summary>
-    /// Represents a mutable set of vertices.
-    /// </summary>
-    /// <typeparam name="TVertex">Vertex type.</typeparam>
+    /// <summary> Extension Methods for <see cref="IMutableVertexSet{TVertex}"/> </summary>
+    public static class MutableVertexSet
+    {
+        /// <summary>
+        /// 
+        /// </summary>
+        /// <returns></returns>
+        public static int AddVertexRange<TVertex>(this IMutableVertexSet<TVertex> set
+            , [NotNull, ItemNotNull] params TVertex[] vertices) => set.AddVertexRange(vertices.AsEnumerable());
+
+    }
+
+    /// <summary> Represents a mutable set of vertices.</summary>
     public interface IMutableVertexSet<TVertex> : IVertexSet<TVertex>
     {
         /// <summary>

src/QuikGraph/Structures/Graphs/AdjacencyGraph.cs

@@ -432,6 +432,9 @@ public virtual bool AddEdge(TEdge edge)
             return AddEdgeInternal(edge);
         }
 
+        /// <inheritdoc />
+        public int AddEdgeRange(params TEdge[] edges) => AddEdgeRange(edges.AsEnumerable()); 
+
         /// <inheritdoc />
         public int AddEdgeRange(IEnumerable<TEdge> edges)
         {

src/QuikGraph/Structures/Graphs/BidirectionalGraph.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Collections;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
@@ -517,6 +518,9 @@ public virtual bool AddEdge(TEdge edge)
             return AddEdgeInternal(edge);
         }
 
+        /// <inheritdoc />
+        public int AddEdgeRange(params TEdge[] edges) => AddEdgeRange(edges.AsEnumerable());
+
         /// <inheritdoc />
         public int AddEdgeRange(IEnumerable<TEdge> edges)
         {

src/QuikGraph/Structures/Graphs/BidirectionalMatrixGraph.cs

@@ -492,6 +492,9 @@ public bool AddEdge(TEdge edge)
             throw new ParallelEdgeNotAllowedException();
         }
 
+        /// <inheritdoc />
+        public int AddEdgeRange(params TEdge[] edges) => AddEdgeRange(edges.AsEnumerable());
+
         /// <inheritdoc />
         public int AddEdgeRange(IEnumerable<TEdge> edges)
         {

src/QuikGraph/Structures/Graphs/ClusteredAdjacencyGraph.cs

@@ -226,14 +226,12 @@ public virtual bool AddVertex([NotNull] TVertex vertex)
             return Wrapped.AddVertex(vertex);
         }
 
-        /// <summary>
-        /// Adds given vertices to this graph.
-        /// </summary>
-        /// <param name="vertices">Vertices to add.</param>
+        /// <summary> Adds the <paramref name="vertices"/> to this graph. </summary>
+        /// <returns>The number of vertex added.</returns>
+        public virtual int AddVertexRange([NotNull, ItemNotNull] params TVertex[] vertices) => AddVertexRange(vertices.AsEnumerable());
+
+        /// <summary> Adds the <paramref name="vertices"/> to this graph. </summary>
         /// <returns>The number of vertex added.</returns>
-        /// <exception cref="T:System.ArgumentNullException">
-        /// <paramref name="vertices"/> is <see langword="null"/> or at least one of them is <see langword="null"/>.
-        /// </exception>
         public virtual int AddVertexRange([NotNull, ItemNotNull] IEnumerable<TVertex> vertices)
         {
             if (vertices is null)
@@ -332,6 +330,17 @@ public virtual bool AddVerticesAndEdge([NotNull] TEdge edge)
             return AddEdge(edge);
         }
 
+        /// <summary>
+        /// Adds a set of edges (and it's vertices if necessary).
+        /// </summary>
+        /// <param name="edges">Edges to add.</param>
+        /// <returns>The number of edges added.</returns>
+        /// <exception cref="T:System.ArgumentNullException">
+        /// <paramref name="edges"/> is <see langword="null"/> or at least one of them is <see langword="null"/>.
+        /// </exception>
+        public int AddVerticesAndEdgeRange([NotNull, ItemNotNull] params TEdge[] edges)
+            => AddVerticesAndEdgeRange(edges.AsEnumerable());
+
         /// <summary>
         /// Adds a set of edges (and it's vertices if necessary).
         /// </summary>
@@ -369,9 +378,15 @@ public virtual bool AddEdge([NotNull] TEdge edge)
             return Wrapped.AddEdge(edge);
         }
 
-        /// <summary>
-        /// Adds a set of edges to this graph.
-        /// </summary>
+        /// <summary> Adds a set of edges to this graph. </summary>
+        /// <param name="edges">Edges to add.</param>
+        /// <returns>The number of edges successfully added to this graph.</returns>
+        /// <exception cref="T:System.ArgumentNullException">
+        /// <paramref name="edges"/> is <see langword="null"/> or at least one of them is <see langword="null"/>.
+        /// </exception>
+        public int AddEdgeRange([NotNull, ItemNotNull] params TEdge[] edges) => AddEdgeRange(edges.AsEnumerable());
+
+        /// <summary> Adds a set of edges to this graph. </summary>
         /// <param name="edges">Edges to add.</param>
         /// <returns>The number of edges successfully added to this graph.</returns>
         /// <exception cref="T:System.ArgumentNullException">

src/QuikGraph/Structures/Graphs/EdgeListGraph.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Collections;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
@@ -136,14 +137,18 @@ private bool ContainsEdge(TVertex source, TVertex target)
         /// <param name="edge">The edge to add.</param>
         /// <returns>True if the edge was added, false otherwise.</returns>
         /// <exception cref="T:System.ArgumentNullException"><paramref name="edge"/> is <see langword="null"/>.</exception>
-        public bool AddVerticesAndEdge([NotNull] TEdge edge)
-        {
-            return AddEdge(edge);
-        }
+        public bool AddVerticesAndEdge([NotNull] TEdge edge) => AddEdge(edge);
 
-        /// <summary>
-        /// Adds a set of edges (and it's vertices if necessary).
-        /// </summary>
+        /// <summary> Adds a set of edges (and it's vertices if necessary). </summary>
+        /// <param name="edges">Edges to add.</param>
+        /// <returns>The number of edges added.</returns>
+        /// <exception cref="T:System.ArgumentNullException">
+        /// <paramref name="edges"/> is <see langword="null"/> or at least one of them is <see langword="null"/>.
+        /// </exception>
+        public int AddVerticesAndEdgeRange([NotNull, ItemNotNull] params TEdge[] edges)
+            => AddVerticesAndEdgeRange(edges.AsEnumerable());
+
+        /// <summary> Adds a set of edges (and it's vertices if necessary). </summary>
         /// <param name="edges">Edges to add.</param>
         /// <returns>The number of edges added.</returns>
         /// <exception cref="T:System.ArgumentNullException">
@@ -180,6 +185,9 @@ public bool AddEdge(TEdge edge)
             return true;
         }
 
+        /// <inheritdoc />
+        public int AddEdgeRange(params TEdge[] edges) => AddEdgeRange(edges.AsEnumerable());
+
         /// <inheritdoc />
         public int AddEdgeRange(IEnumerable<TEdge> edges)
         {