Merge pull request #42 from CombineCommunity/feature/use-replay-subject

Feature/use replay subject

Author: twittemb

CHANGELOG.md

@@ -1,3 +1,7 @@
+**v0.4.0 - Bane**:
+
+- replace CurrentValueSubject by a ReplaySubject in System.stream
+
 **v0.3.0 - Tyranus**:
 
 - Feedback: introduce the "on:" keyword to explicitly declare the type of state that concerns the side effect

Examples/Examples.xcodeproj/project.pbxproj

@@ -7,9 +7,9 @@
 	objects = {
 
 /* Begin PBXBuildFile section */
+		1A7057E7266167540070FD5D /* Feedbacks in Frameworks */ = {isa = PBXBuildFile; productRef = 1A7057E6266167540070FD5D /* Feedbacks */; };
+		1A7057E9266167950070FD5D /* FeedbacksTest in Frameworks */ = {isa = PBXBuildFile; productRef = 1A7057E8266167950070FD5D /* FeedbacksTest */; };
 		741C474025EC5CDB00F1231B /* Counter+TransitionsTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 741C473F25EC5CDB00F1231B /* Counter+TransitionsTests.swift */; };
-		741C475C25EC5DE100F1231B /* Feedbacks in Frameworks */ = {isa = PBXBuildFile; productRef = 741C475B25EC5DE100F1231B /* Feedbacks */; };
-		741C476625EC5E4C00F1231B /* FeedbacksTest in Frameworks */ = {isa = PBXBuildFile; productRef = 741C476525EC5E4C00F1231B /* FeedbacksTest */; };
 		742FEE2425B388DA00575CB2 /* GifList.swift in Sources */ = {isa = PBXBuildFile; fileRef = 742FEE2325B388DA00575CB2 /* GifList.swift */; };
 		742FEE2825B38B1A00575CB2 /* GifList+States.swift in Sources */ = {isa = PBXBuildFile; fileRef = 742FEE2725B38B1A00575CB2 /* GifList+States.swift */; };
 		742FEE2E25B38EEE00575CB2 /* GifOverview.swift in Sources */ = {isa = PBXBuildFile; fileRef = 742FEE2D25B38EEE00575CB2 /* GifOverview.swift */; };
@@ -66,6 +66,7 @@
 /* End PBXContainerItemProxy section */
 
 /* Begin PBXFileReference section */
+		1A5E6478266166CA00F576A9 /* Feedbacks */ = {isa = PBXFileReference; lastKnownFileType = folder; name = Feedbacks; path = ..; sourceTree = "<group>"; };
 		741C473D25EC5CDB00F1231B /* ExamplesTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = ExamplesTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
 		741C473F25EC5CDB00F1231B /* Counter+TransitionsTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "Counter+TransitionsTests.swift"; sourceTree = "<group>"; };
 		741C474125EC5CDB00F1231B /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
@@ -121,15 +122,15 @@
 			isa = PBXFrameworksBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
-				741C476625EC5E4C00F1231B /* FeedbacksTest in Frameworks */,
+				1A7057E9266167950070FD5D /* FeedbacksTest in Frameworks */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
 		7471829D25AE7B0B0098E83E /* Frameworks */ = {
 			isa = PBXFrameworksBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
-				741C475C25EC5DE100F1231B /* Feedbacks in Frameworks */,
+				1A7057E7266167540070FD5D /* Feedbacks in Frameworks */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -297,6 +298,7 @@
 		7471829725AE7B0B0098E83E = {
 			isa = PBXGroup;
 			children = (
+				1A5E6478266166CA00F576A9 /* Feedbacks */,
 				747182A225AE7B0B0098E83E /* Examples */,
 				741C473E25EC5CDB00F1231B /* ExamplesTests */,
 				747182A125AE7B0B0098E83E /* Products */,
@@ -400,7 +402,7 @@
 			);
 			name = ExamplesTests;
 			packageProductDependencies = (
-				741C476525EC5E4C00F1231B /* FeedbacksTest */,
+				1A7057E8266167950070FD5D /* FeedbacksTest */,
 			);
 			productName = ExamplesTests;
 			productReference = 741C473D25EC5CDB00F1231B /* ExamplesTests.xctest */;
@@ -420,7 +422,7 @@
 			);
 			name = Examples;
 			packageProductDependencies = (
-				741C475B25EC5DE100F1231B /* Feedbacks */,
+				1A7057E6266167540070FD5D /* Feedbacks */,
 			);
 			productName = Examples;
 			productReference = 747182A025AE7B0B0098E83E /* Examples.app */;
@@ -454,7 +456,6 @@
 			);
 			mainGroup = 7471829725AE7B0B0098E83E;
 			packageReferences = (
-				741C475A25EC5DE100F1231B /* XCRemoteSwiftPackageReference "Feedbacks" */,
 			);
 			productRefGroup = 747182A125AE7B0B0098E83E /* Products */;
 			projectDirPath = "";
@@ -789,26 +790,13 @@
 		};
 /* End XCConfigurationList section */
 
-/* Begin XCRemoteSwiftPackageReference section */
-		741C475A25EC5DE100F1231B /* XCRemoteSwiftPackageReference "Feedbacks" */ = {
-			isa = XCRemoteSwiftPackageReference;
-			repositoryURL = "git@github.com:CombineCommunity/Feedbacks.git";
-			requirement = {
-				kind = exactVersion;
-				version = 0.3.0;
-			};
-		};
-/* End XCRemoteSwiftPackageReference section */
-
 /* Begin XCSwiftPackageProductDependency section */
-		741C475B25EC5DE100F1231B /* Feedbacks */ = {
+		1A7057E6266167540070FD5D /* Feedbacks */ = {
 			isa = XCSwiftPackageProductDependency;
-			package = 741C475A25EC5DE100F1231B /* XCRemoteSwiftPackageReference "Feedbacks" */;
 			productName = Feedbacks;
 		};
-		741C476525EC5E4C00F1231B /* FeedbacksTest */ = {
+		1A7057E8266167950070FD5D /* FeedbacksTest */ = {
 			isa = XCSwiftPackageProductDependency;
-			package = 741C475A25EC5DE100F1231B /* XCRemoteSwiftPackageReference "Feedbacks" */;
 			productName = FeedbacksTest;
 		};
 /* End XCSwiftPackageProductDependency section */

Examples/Examples.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved

@@ -5,6 +5,7 @@
 //  Created by Thibault Wittemberg on 2021-01-12.
 //
 
+import Dispatch
 import Feedbacks
 
 // define a namespace for this app's system
@@ -55,5 +56,5 @@ extension CounterApp.System {
                 On(CounterApp.Events.Decrease.self, transitionTo: CounterApp.States.Decreasing(counter: state.counter.decrease(), isPaused: false))
             }
         }
-    }
+    }.execute(on: DispatchQueue(label: "Counter Queue"))
 }

Examples/Examples/CounterApp/System/CounterApp+System.swift

@@ -32,10 +32,7 @@ extension GifDetail.System {
 
             Feedbacks {
                 Feedback(on: GifDetail.States.Loading.self, strategy: .cancelOnNewState, perform: loadSideEffect)
-                    .execute(on: DispatchQueue(label: "Load Gif Queue"))
-
                 Feedback(on: GifDetail.States.TogglingFavorite.self, strategy: .cancelOnNewState, perform: toggleFavoriteSideEffect)
-                    .execute(on: DispatchQueue(label: "Toggle Favorite Queue"))
             }
             .onStateReceived {
                 print("GifDetail: New state has been received: \($0)")
@@ -64,6 +61,6 @@ extension GifDetail.System {
                     On(GifDetail.Events.LoadingHasFailed.self, transitionTo: GifDetail.States.Failed())
                 }
             }
-        }
+        }.execute(on: DispatchQueue(label: "Load Gif Queue"))
     }
 }

Examples/Examples/GiphyApp/Features/GifDetail/System/GifDetail+System.swift

@@ -26,7 +26,6 @@ extension GifList.System {
 
             Feedbacks {
                 Feedback(on: GifList.States.Loading.self , strategy: .cancelOnNewState, perform: loadSideEffect)
-                    .execute(on: DispatchQueue(label: "Load Gifs Queue"))
             }
             .onStateReceived {
                 print("GifList: New state has been received: \($0)")
@@ -64,6 +63,6 @@ extension GifList.System {
                     On(GifList.Events.Refresh.self, transitionTo: GifList.States.Loading())
                 }
             }
-        }
+        }.execute(on: DispatchQueue(label: "Load Gifs Queue"))
     }
 }

Examples/Examples/GiphyApp/Features/GifList/System/GifList+System.swift

@@ -23,13 +23,14 @@ let package = Package(
     dependencies: [
         // Dependencies declare other packages that this package depends on.
         .package(url: "https://github.com/pointfreeco/combine-schedulers.git", .exact(Version("0.1.2"))),
+        .package(url: "https://github.com/CombineCommunity/CombineExt.git", .exact(Version("1.3.0")))
     ],
     targets: [
         // Targets are the basic building blocks of a package. A target can define a module or a test suite.
         // Targets can depend on other targets in this package, and on products in packages this package depends on.
         .target(
             name: "Feedbacks",
-            dependencies: [],
+            dependencies: [.product(name: "CombineExt", package: "CombineExt")],
             path: "Sources/Feedbacks"),
         .testTarget(
             name: "FeedbacksTests",

Package.resolved

@@ -96,9 +96,9 @@ In our example, one feedback takes care of increasing the volume and the other i
 
 ## Scheduling
 
-Threading is very important to make a nice responsive application. A Scheduler is the Combine way of handling threading by switching portions of reactive streams on dispatch queues, or operation queues or RunLoops.
+Threading is very important to make a nice responsive application. A Scheduler is the Combine way of handling threading by switching portions of reactive streams on dispatch queues, operation queues or RunLoops.
 
-The declarative syntax of Feedbacks allows to alter the behavior of side effects by simply applying modifiers (like you would do with SwiftUI to change the frame for instance). Modifying the scheduling of a side effect is as simple as calling the `.execute(on:)` modifier.
+The declarative syntax of Feedbacks allows to alter the behavior of a System by simply applying modifiers (like you would do with SwiftUI to change the frame for instance). Modifying the scheduling of a side effect is as simple as calling the `.execute(on:)` modifier.
 
 ```swift
 Feedbacks {
@@ -128,6 +128,52 @@ Feedbacks {
 
 Both side effects will be executed on the background queue.
 
+It is also applicable to the transitions:
+
+```swift
+Transitions {
+  From(VolumeState.self) { state in
+    On(IncreaseEvent.self, transitionTo: VolumeState(value: state.value + 1))
+    On(DecreaseEvent.self, transitionTo: VolumeState(value: state.value - 1))
+  }
+}.execute(on: DispatchQueue(label: "A background queue"))
+```
+
+ or to the whole system:
+ 
+ ```swift
+ System {
+  InitialState {
+    VolumeState(value: 10)
+  }
+	
+  Feedbacks {
+    Feedback(on: VolumeState.self, strategy: .continueOnNewState) { state -> AnyPublisher<Event, Never> in
+      if state.value >= targetedVolume {
+        return Empty().eraseToAnyPublisher()
+      }
+	
+      return Just(IncreaseEvent()).eraseToAnyPublisher()
+    }
+	    
+    Feedback(on: VolumeState.self, strategy: .continueOnNewState) { state -> AnyPublisher<Event, Never> in
+      if state.value <= targetedVolume {
+        return Empty().eraseToAnyPublisher()
+      }
+	
+      return Just(DecreaseEvent()).eraseToAnyPublisher()
+    }
+  }
+
+  Transitions {
+    From(VolumeState.self) { state in
+      On(IncreaseEvent.self, transitionTo: VolumeState(value: state.value + 1))
+      On(DecreaseEvent.self, transitionTo: VolumeState(value: state.value - 1))
+    }
+  }
+}.execute(on: DispatchQueue(label: "A background queue"))
+ ```
+
 ## Lifecycle
 
 There are typical cases where a side effect consist of an asynchronous operation (like a network call). What happens if the very same side effect is called repeatedly, not waiting for the previous ones to end? Are the operations stacked? Are they cancelled when a new one is performed?
@@ -196,9 +242,9 @@ Here is a list of the supported modifiers:
 | Modifier | Action | Can be applied to |
 | -------------- | -------------- | -------------- |
 | `.disable(disabled:)`| The target won't be executed as long as the `disabled` condition is true | <ul align="left"><li>Transition</li><li>Transitions</li><li>Feedback</li></ul> |
-| `.execute(on:)`| The target will be executed on the scheduler | <ul align="left"><li>Feedbacks</li><li>Feedback</li></ul> |
-| `.onStateReceived(perform:)`| Execute the `perform` closure each time a new state is given as an input | <ul align="left"><li>Feedbacks</li><li>Feedback</li></ul> |
-| `.onEventEmitted(perform:)`| Execute the `perform` closure each time a new event is emitted | <ul align="left"><li>Feedbacks</li><li>Feedback</li></ul> |
+| `.execute(on:)`| The target will be executed on the scheduler | <ul align="left"><li>Transitions</li><li>Feedback</li><li>Feedbacks</li><li>System</li></ul> |
+| `.onStateReceived(perform:)`| Execute the `perform` closure each time a new state is given as an input | <ul align="left"><li>Feedback</li><li>Feedbacks</li></ul> |
+| `.onEventEmitted(perform:)`| Execute the `perform` closure each time a new event is emitted | <ul align="left"><li>Feedback</li><li>Feedbacks</li></ul> |
 | `.attach(to:)`| Refer to the "How to make systems communicate" section | <ul align="left"><li>System</li><li>UISystem</li></ul> |
 | `.uiSystem(viewStateFactory:)`| Refer to the "Using Feedbacks with SwiftUI and UIKit" section | <ul align="left"><li>System</li></ul> |