Introduce Pulse 📡

[tokijh]

Introduce Pulse 📡

Renamed to Pulse from Signal because it conflicts with RxCocoa.Signal

Pulse has diff only when mutated
To explain in code, the results are as follows.

var messagePulse: Pulse<String?> = Pulse(wrappedValue: "Hello tokijh")
let oldMessagePulse: Pulse<String?> = message
message = "Hello tokijh"
oldMessagePulse != messagePulse // true
oldMessagePulse.value == messagePulse.value // true

Use when you want to receive an event only if the new value is assigned, even if it is the same value.
like alertMessage (See follows or PulseTests.swift)

// Reactor
private final class MyReactor: Reactor {
  struct State {
    @Pulse var alertMessage: String?
  }
  func mutate(action: Action) -> Observable<Mutation> {
    switch action {
    case let .alert(message):
      return Observable.just(Mutation.setAlertMessage(message))
    }
  }
  func reduce(state: State, mutation: Mutation) -> State {
    var newState = state
    switch mutation {
    case let .setAlertMessage(alertMessage):
      newState.alertMessage = alertMessage
    }
    return newState
  }
}
// View
reactor.pulse(\.$alertMessage)
  .compactMap { $0 } // filter nil
  .subscribe(onNext: { [weak self] (message: String) in
    self?.showAlert(message)
  })
  .disposed(by: disposeBag)
// Cases
reactor.action.onNext(.alert("Hello"))  // showAlert() is called with `Hello`
reactor.action.onNext(.alert("Hello"))  // showAlert() is called with `Hello`
reactor.action.onNext(.doSomeAction)    // showAlert() is not called
reactor.action.onNext(.alert("Hello"))  // showAlert() is called with `Hello`
reactor.action.onNext(.alert("tokijh")) // showAlert() is called with `tokijh`
reactor.action.onNext(.doSomeAction)    // showAlert() is not called

[codecov]

Codecov Report

Merging #176 (cec5136) into master (fc392a1) will decrease coverage by 0.06%.
The diff coverage is 93.75%.

@@            Coverage Diff             @@
##           master     #176      +/-   ##
==========================================
- Coverage   94.40%   94.33%   -0.07%     
==========================================
  Files           8       10       +2     
  Lines         143      159      +16     
==========================================
+ Hits          135      150      +15     
- Misses          8        9       +1     

Impacted Files	Coverage Δ
Sources/ReactorKit/Pulse.swift	92.85% <92.85%> (ø)
Sources/ReactorKit/Reactor+Pulse.swift	100.00% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update fc392a1...cec5136. Read the comment docs.

[OhKanghoon]

👍