Skip to content

🚌 SwiftyEventBus is a publish/subscribe event bus for iOS and Swift.

License

Notifications You must be signed in to change notification settings

Maru-zhang/SwiftyEventBus

Repository files navigation

SwiftyEventBus

CI Status Carthage compatible codecov Version License Platform

SwiftyEventBus is a publish/subscribe event bus for iOS and Swift.

  • simplifies the communication between components
  • make your code simple and elegant
  • type safe
  • more advance feature: safety event, sticky event, etc...

In addition, if you want to read document, please click here.

Usage

SwiftyEventBus is very easy to use, you just need two steps:

1.Register

You can register in anywhere with any type, it will always observe until the EventSubscription object been released.

class DemoViewController: UIViewController {

    var ob: EventSubscription<String>!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        ob = EventBus.`default`.register { (x: String) in
            print(x)
        }
    }
}

2.Post

Finally, you just need to post any type that implement EventPresentable.

EventBus.default.post("Foo")

Advance

Safe Post

Sometime, you maybe post a message that no one obseving, this is unsafety behaviour, then you can use this:

EventBus.default.safePost("Foo")

If there is no observer subscribe this kind of message, EventBus.default.safePost("Foo") will raise EventBusPostError.useless Exception, you can catch it and handle this.

/// handle EventBusPostError excetion
do {
    try EventBus.default.safePost("foo")
} catch {
    // do something
}

Rx-Extension

if you project using RxSwift, maybe you need this to bridge SwiftyEventBus to Rx.

pod 'SwiftyEventBus/Rx'

after that, you can use SwiftyEventBus in RxSwift world.πŸŽ‰

var bag: DisposeBag? = DisposeBag()
EventBus.default.rx.register(String.self)
    .subscribe(onNext: { (x) in
        print(x) /// "foo"
    })
    .disposed(by: bag!)
EventBus.default.post("foo")

Example

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

Installation

CocoaPods

SwiftyEventBus is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'SwiftyEventBus'

SwiftyEventBus is also available on Carthage, please add this to Cartfile:

github "Maru-zhang/SwiftyEventBus"

Author

Maru-zhang, maru-zhang@foxmail.com

License

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