Add a merge generator

Sources/Genything/Generators/Combinations/Generators+merge.swift

@@ -0,0 +1,31 @@
+// MARK: Combine
+
+extension Generators {
+    /// Returns: A generator which produces results by looping over the provided generators in order
+    ///
+    /// # Example
+    /// 
+    /// ```swift
+    /// let genA = Generators.constant("A")
+    /// let genB = Generators.constant("B")
+    ///
+    /// Generators.merge(genA, genB) // Produces values ABABABABABAB...
+    /// ```
+    ///
+    /// - Returns: The generator
+    public static func merge<G>(_ generators: [G]) -> AnyGenerator<G.T> where G: Generator {
+        Merge(generators).eraseToAnyGenerator()
+    }
+}
+
+class Merge<Source>: Generator where Source: Generator {
+    private let loop: Loop<[Source]>
+
+    init(_ sources: [Source]) {
+        self.loop = Loop(sources)
+    }
+
+    func next(_ randomSource: RandomSource) -> Source.T {
+        loop.next(randomSource).next(randomSource)
+    }
+}

Sources/Genything/Generators/Generators+iterate.swift

@@ -9,7 +9,7 @@ extension Generators {
 
 /// A Generator that generates a given `Sequence` of elements. When the generator exhausts the elements in the sequence, it will begin to return nil.
 ///
-/// - Warning: This generator is stateful and cannot be restarted. Pay attention to how it to how the reference is being retained and do not share the generator to unsuspecting consumers.
+/// - Warning: This generator is stateful and cannot be restarted. Pay attention to how the reference is being retained and do not share the generator to unsuspecting consumers.
 private class Iterate<Elements>: Generator where Elements: Swift.Sequence {
 
     /// Creates a Generator for a sequence of elements.

Sources/Genything/Generators/Generators+loop.swift

@@ -13,8 +13,8 @@ extension Generators {
 ///
 /// Since this generator will comprehensibly examine all elements of the collection it can be used to display all possible configurations or test all possible values when the problem space is small and known.
 ///
-/// - Warning: This generator is stateful and cannot be restarted. Pay attention to how it to how the reference is being retained and do not share the generator to unsuspecting consumers.
-private class Loop<Elements>: Generator where Elements: Swift.Collection {
+/// - Warning: This generator is stateful and cannot be restarted. Pay attention to how the reference is being retained and do not share the generator to unsuspecting consumers.
+class Loop<Elements>: Generator where Elements: Swift.Collection {
 
     /// Creates a Generator that loops the provided collection of elements.
     ///

Tests/GenythingTests/Generators/Generators_CollectTests.swift

@@ -0,0 +1,13 @@
+import XCTest
+@testable import Genything
+
+final class Generators_CollectTests: XCTestCase {
+    func test_collecting_to_alternate_generators() {
+        testAllSatisfy(Generators.collect([
+            Generators.constant(0),
+            Generators.constant(1)
+        ])) { values in
+            values[0] == 0 && values[1] == 1
+        }
+    }
+}

Tests/GenythingTests/Generators/Generators_MergeTests.swift

@@ -0,0 +1,17 @@
+import XCTest
+@testable import Genything
+
+final class Generators_MergeTests: XCTestCase {
+    func test_merging_generators() {
+        var curr = 0
+        testAllSatisfy(Generators.merge([
+            Generators.constant(0),
+            Generators.constant(1)
+        ])) { value in
+            defer {
+                curr = (curr + 1) % 2
+            }
+            return value == curr
+        }
+    }
+}