Latest 1.1.0
Homepage https://github.com/keitaoouchi/FluxxKit
License MIT
Platforms ios 8.0
Frameworks Foundation
Authors

CI Status
Swift 4.0
Carthage compatible
Version
License
Platform

Overview

Unidirectional data flow for reactive programming in iOS. Flux and Reactive Programming.

FluxxKit is a porting facebook’s flux implementation in Swift.

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

More complicated real world example like below is here.

GIF

Getting Started

  1. State

    import FluxxKit
    import RxSwift
    
    final class ViewModel: StateType {
    var count = Variable<Int>(0)
    }
  2. Action

    extension ViewModel {
    enum Action: ActionType {
      case plus
      case minus
    }
    }
  3. Reducer

    extension ViewModel {
    final class Reducer: FluxxKit.Reducer<ViewModel, Action> {
      override func reduce(state: ViewModel, action: Action) {
    
        switch action {
        case .plus:
          state.count.value = state.count + 1
        case .minus:
          state.count.value = state.count - 1
        }
      }
    }
    }
  4. View

    Create store and register it to dispatcher, and bind store’s state:

    import FluxxKit
    import RxSWift
    
    final class ViewController: UIViewController {
    
    @IBOutlet var counterLabel: UILabel!
    @IBOutlet var plusButton: UIButton!
    @IBOutlet var minusButton: UIButton!
    var store = Store<ViewModel, ViewModel.Action>(
      reducer: ViewModel.Reducer()
    )
    
    override func viewDidLoad() {
      super.viewDidLoad()
    
      Dispatcher.shared.register(store: self.store)
    
      store.state.count.asObservable().observeOn(MainScheduler.instance)
        .subscribe(onNext: { [weak self] count in
          self?.counterLabel.text = "(count)"
        })
    }
    
    deinit {
      Dispatcher.shared.unregister(identifier: self.store.identifier)
    }
    }

    Dispatch action with UI action:

    @IBAction
    func onTouchPlusButton(sender: Any) {
    Dispatcher.shared.dispatch(action: ViewModel.Action.plus)
    }
    
    @IBAction
    func onTouchMinusButton(sender: Any) {
    Dispatcher.shared.dispatch(action: ViewModel.Action.minus)
    }

Architecture

(:ghost: nice diagram here :ghost:)

FLUX for Reactive Programming

FluxxKit would not emit any event when state change like flux. Instead, we have RxSwift, ReactiveSwift, ReactiveKit or something else. All the stateful things could be implemented as Observable or Stream, and ViewController could bind and react to them.

Flux

View -> Action -> Dispatcher -> (Middleware) -> Store -> Reducer -> Observable
  • When a user interacts with a View(Controller), it propagates an Action
  • through a central Dispatcher,
  • to the various Stores that hold the application’s data,
  • state transition occurs in some Store that could responds to dispatched Action,
  • which will emit new items to Observable property in these Store.

Reactive Programming

Observable ---> View
  • ViewController subscribes Store’s Observable properties,
  • and react to it.

Requirements

Target Version
iOS => 8.0
Swift => 4.0

Installation

FluxxKit is available through CocoaPods or Carthage.

CocoaPods

pod "FluxxKit"

Carthage

github "keitaoouchi/FluxxKit"

for detail, please follow the Carthage Instruction

Author

keitaoouchi, [email protected]

License

FluxxKit is available under the MIT license. See the LICENSE file for more info.

Latest podspec

{
    "name": "FluxxKit",
    "version": "1.1.0",
    "summary": "Unidirectional data flow for Reactive programming.",
    "homepage": "https://github.com/keitaoouchi/FluxxKit",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "keitaoouchi": "[email protected]"
    },
    "source": {
        "git": "https://github.com/keitaoouchi/FluxxKit.git",
        "tag": "1.1.0"
    },
    "source_files": "FluxxKit/*.{swift,h}",
    "frameworks": "Foundation",
    "platforms": {
        "ios": "8.0"
    },
    "pushed_with_swift_version": "4.0"
}

Pin It on Pinterest

Share This