RxSwift extensions for Swift optionals and "Occupiable" types.
All operators are also available on Driver
, unless otherwise noted.
Observable<String?>
.of("One", nil, "Three")
.filterNil()
// Type is now Observable<String>
.subscribe { print($0) }
Next(One)
Next(Three)
Completed
Observable<String?>
.of("One", nil, "Three")
.replaceNilWith("Two")
// Type is now Observable<String>
.subscribe { print($0) }
Next(One)
Next(Two)
Next(Three)
Completed
Unavailable on Driver
, because Driver
s cannot error out.
By default errors with RxOptionalError.FoundNilWhileUnwrappingOptional
.
Observable<String?>
.of("One", nil, "Three")
.errorOnNil()
// Type is now Observable<String>
.subscribe { print($0) }
Next(One)
Error(Found nil while trying to unwrap type <Optional<String>>)
Observable<String?>
.of("One", nil, "Three")
.catchOnNil {
return Observable<String>.just("A String from a new Observable")
}
// Type is now Observable<String>
.subscribe { print($0) }
Next(One)
Next(A String from a new Observable)
Next(Three)
Completed
Occupiables are:
String
Array
Dictionary
Set
Currently in Swift protocols cannot be extended to conform to other protocols.
For now the types listed above conform to Occupiable
. You can also conform
custom types to Occupiable
.
Observable<[String]>
.of(["Single Element"], [], ["Two", "Elements"])
.filterEmpty()
.subscribe { print($0) }
Next(["Single Element"])
Next(["Two", "Elements"])
Completed
Unavailable on Driver
, because Driver
s cannot error out.
By default errors with RxOptionalError.EmptyOccupiable
.
Observable<[String]>
.of(["Single Element"], [], ["Two", "Elements"])
.errorOnEmpty()
.subscribe { print($0) }
Next(["Single Element"])
Error(Empty occupiable of type <Array<String>>)
Observable<[String]>
.of(["Single Element"], [], ["Two", "Elements"])
.catchOnEmpty {
return Observable<[String]>.just(["Not Empty"])
}
.subscribe { print($0) }
Next(["Single Element"])
Next(["Not Empty"])
Next(["Two", "Elements"])
Completed
- Run
pod install
in Example directory - Select RxOptional Examples target
- Build
- Show Debug Area (cmd+shift+Y)
- Click blue play button in Debug Area
RxOptional is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'RxOptional'
Thane Gill, [email protected]
RxOptional is available under the MIT license. See the LICENSE file for more info.