Latest 3.0.0.alpha.1
Homepage https://github.com/ReactiveX/RxSwift
License MIT
Platforms ios 8.0, osx 10.10, tvos 9.0, requires ARC
Dependencies RxSwift
Frameworks XCTest
Authors

Miss Electric Eel 2016 RxSwift: ReactiveX for Swift

Travis CI platforms pod Carthage compatible

About Rx

Rx is a generic abstraction of computation expressed through Observable<Element> interface.

This is a Swift version of Rx.

It tries to port as many concepts from the original version as possible, but some concepts were adapted for more pleasant and performant integration with iOS/OSX environment.

Cross platform documentation can be found on ReactiveX.io.

Like the original Rx, its intention is to enable easy composition of asynchronous operations and event/data streams.

KVO observing, async operations and streams are all unified under abstraction of sequence. This is the reason why Rx is so simple, elegant and powerful.

I came here because I want to …

… understand
… install
… hack around
… interact
… compare
… find compatible
… see the broader vision
  • Does this exist for Android? RxJava
  • Where is all of this going, what is the future, what about reactive architectures, how do you design entire apps this way? Cycle.js – this is javascript, but RxJS is javascript version of Rx.

Usage

Here’s an example In Action
Define search for GitHub repositories …
let searchResults = searchBar.rx.text
    .throttle(0.3, scheduler: MainScheduler.instance)
    .distinctUntilChanged()
    .flatMapLatest { query -> Observable in
        if query.isEmpty {
            return Observable.just([])
        }

        return searchGitHub(query)
            .catchErrorJustReturn([])
    }
    .observeOn(MainScheduler.instance)
… then bind the results to your tableview
searchResults
    .bindTo(tableView.rx.items(cellIdentifier: "Cell")) {
        (index, repository: Repository, cell) in
        cell.textLabel?.text = repository.name
        cell.detailTextLabel?.text = repository.url
    }
    .addDisposableTo(disposeBag)

Requirements

  • Xcode 8.0 beta 6 (8S201h)
  • Swift 3.0

  • iOS 8.0+
  • Mac OS X 10.10+
  • tvOS 9.0+
  • watchOS 2.0+

Installation

Rx doesn’t contain any external dependencies.

These are currently the supported options:

Manual

Open Rx.xcworkspace, choose RxExample and hit run. This method will build everything and run the sample app

CocoaPods

# Podfile
use_frameworks!

target 'YOUR_TARGET_NAME' do
    pod 'RxSwift',    '~> 3.0.0.alpha.1'
    pod 'RxCocoa',    '~> 3.0.0.alpha.1'
end

# RxTests and RxBlocking make the most sense in the context of unit/integration tests
target 'YOUR_TESTING_TARGET' do
    pod 'RxBlocking', '~> 3.0.0.alpha.1'
    pod 'RxTests',    '~> 3.0.0.alpha.1'
end

Replace YOUR_TARGET_NAME and then, in the Podfile directory, type:

:warning: If you want to use CocoaPods with Xcode 8.0 beta and Swift 3.0, you might need to add the following
lines to your podfile: :warning:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['SWIFT_VERSION'] = '3.0'
      config.build_settings['MACOSX_DEPLOYMENT_TARGET'] = '10.10'
    end
  end
end
$ pod install

Carthage

Add this to Cartfile

github "ReactiveX/RxSwift" ~> 3.0.0.alpha.1
$ carthage update

Manually using git submodules

  • Add RxSwift as a submodule
$ git submodule add [email protected]:ReactiveX/RxSwift.git
  • Drag Rx.xcodeproj into Project Navigator
  • Go to Project > Targets > Build Phases > Link Binary With Libraries, click + and select RxSwift-[Platform] and RxCocoa-[Platform] targets

References

Latest podspec

{
    "name": "RxTests",
    "version": "3.0.0.alpha.1",
    "summary": "RxSwift Testing extensions",
    "description": "Unit testing extensions for RxSwift. This library contains mock schedulers, observables, and observersnthat should make unit testing your operators easy as unit testing RxSwift built-in operators.nnThis library contains everything you needed to write unit tests in the following way:n```swiftnfunc testMap() {n    let scheduler = TestScheduler(initialClock: 0)nn    let xs = scheduler.createHotObservable([n        next(150, 1),n        next(210, 0),n        next(220, 1),n        next(230, 2),n        next(240, 4),n        completed(300)n        ])nn    let res = scheduler.start { xs.map { $0 * 2 } }nn    let correctEvents = [n        next(210, 0 * 2),n        next(220, 1 * 2),n        next(230, 2 * 2),n        next(240, 4 * 2),n        completed(300)n    ]nn    let correctSubscriptions = [n        Subscription(200, 300)n    ]nn    XCTAssertEqual(res.events, correctEvents)n    XCTAssertEqual(xs.subscriptions, correctSubscriptions)n}n```",
    "homepage": "https://github.com/ReactiveX/RxSwift",
    "license": "MIT",
    "authors": {
        "Krunoslav Zaher": "[email protected]"
    },
    "source": {
        "git": "https://github.com/ReactiveX/RxSwift.git",
        "tag": "3.0.0.alpha.1"
    },
    "requires_arc": true,
    "platforms": {
        "ios": "8.0",
        "osx": "10.10",
        "tvos": "9.0"
    },
    "source_files": "RxTests/**/*.swift",
    "frameworks": "XCTest",
    "dependencies": {
        "RxSwift": [
            "~> 3.0.0.alpha.1"
        ]
    },
    "pod_target_xcconfig": {
        "ENABLE_BITCODE": "NO"
    }
}

Pin It on Pinterest

Share This