RxSwiftUtilities

About

Helpful classes and extensions for RxSwift which don't belong in RxSwift core.

Usage

Check out the Documentation, the examples below, or the Example App.

ActivityIndicator

let signingIn = ActivityIndicator()

let signedIn = loginButtonTap.withLatestFrom(usernameAndPassword)
    .flatMapLatest { (username, password) in
        return API.signup(username, password: password)
            .trackActivity(signingIn)
    }
}

signingIn.asDriver()
    .drive(UIApplication.shared.rx.isNetworkActivityIndicatorVisible)
    .disposed(by: disposeBag)

Two-way binding

(textField.rx.text <-> variable)
    .disposed(by: disposeBag)

Example App

This repo contains an Example App with interactive examples.

To use the Example App:

cd ExampleApp
pod install

Open the project located in ExampleApp/ with Xcode and build/run it.

Requirements

• Xcode 11
• Swift 5

Installation

CocoaPods

Tested with pod --version: 1.1.1

In your Podfile:

use_frameworks!

target "YOUR_TARGET_NAME" do
  pod "RxSwiftUtilities"
end

Replace YOUR_TARGET_NAME and then, in the same directory, run:

pod install

Swift Package Manager

Tested with xcode version: 11.5

Add the dependency with xcode via Files>Swift Packages>Add Package Dependency...

Or

Create a Package.swift file.

// swift-tools-version:5.1

import PackageDescription

let package = Package(
  name: "RxSwiftUtiliesTestProject",
  dependencies: [
    .package(url: "https://github.com/RxSwiftCommunity/RxSwiftUtilities", from: "5.0.0")
  ],
  targets: [
    .target(name: "RxSwiftUtiliesTestProject", dependencies: ["RxSwiftUtilities"])
  ]
)

$ swift build

Carthage

Tested with carthage version: 0.18

Add this to Cartfile

github "RxSwiftCommunity/RxSwiftUtilities"

In the same directory, run:

carthage update

Link/Embed frameworks as explained here. Besides linking RxSwiftUtilities, you will also need to link RxSwift and RxCocoa.

Contributing

Help is always appreciated!

git clone [email protected]:RxSwiftCommunity/RxSwiftUtilities.git
cd RxSwiftUtilities

Or use your own forked repo.

carthage bootstrap

This is necessary in order to be able to build the framework on its own and run tests. However, if you prefer, you can instead develop it while it's within another project.

Before submitting a PR, please make sure that the tests pass.