Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/STDevTM/STDevRxExt
STDevRxExt contains some extension functions for RxSwift and RxCocoa which makes our live easy.
https://github.com/STDevTM/STDevRxExt
cast-extensions extensions filter-extensions reactivex rxcocoa rxswift swift4
Last synced: 3 months ago
JSON representation
STDevRxExt contains some extension functions for RxSwift and RxCocoa which makes our live easy.
- Host: GitHub
- URL: https://github.com/STDevTM/STDevRxExt
- Owner: STDevTM
- License: mit
- Created: 2018-03-31T10:14:36.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-03-26T10:18:21.000Z (over 3 years ago)
- Last Synced: 2024-07-30T06:03:45.968Z (3 months ago)
- Topics: cast-extensions, extensions, filter-extensions, reactivex, rxcocoa, rxswift, swift4
- Language: Swift
- Homepage:
- Size: 71.3 KB
- Stars: 7
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-ios - STDevRxExt - STDevRxExt contains some extension functions for RxSwift and RxCocoa which makes our live easy. (Reactive Programming / Other Parsing)
README
# STDevRxExt
[](https://github.com/STDevTM/STDevRxExt/actions)
[](http://cocoapods.org/pods/STDevRxExt)
[](http://cocoapods.org/pods/STDevRxExt)
[](https://swift.org/package-manager/)
[](https://codecov.io/gh/STDevTM/STDevRxExt)
[](http://cocoapods.org/pods/STDevRxExt)
## Example
To run the [Example.playground](Example/Example.playground), clone the repo, and run `pod install` from the Example directory first.
## Requirements
* iOS 9.0+
* tvOS 9.0+
* macOS 10.10+
* watchOS 3.0+
* Swift 5.0+
* Xcode 11+
## Installation
CocoaPods
STDevRxExt is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'STDevRxExt'
Swift Package Manager
You can use The Swift Package Manager to install STDevRxExt by adding the proper description to your Package.swift file:
import PackageDescription
let package = Package(
name: "YOUR_PROJECT_NAME",
targets: [],
dependencies: [
.package(url: "https://github.com/STDevTM/STDevRxExt.git", from: "1.0.0")
]
)
Next, add STDevRxExt to your targets dependencies like so:
.target(
name: "YOUR_TARGET_NAME",
dependencies: [
"STDevRxExt",
]
),
Then run swift package update.
## List of All Extensions
* [Filter Extensions](#filter-extensions)
* [Map Extensions](#map-extensions)
* [Cast Extensions](#cast_extensions)
* [Other Extensions](#other_extensions)
* _more coming soon_
### Filter Extensions
Allow only `true` elements from `Observable`:
```swift
let disposeBag = DisposeBag()
Observable.of(true, false, false, true, true)
.allowTrue()
.subscribe(onNext: { print($0) })
.disposed(by: disposeBag)
```
Output will be:
```text
true
true
true
```
You can use `allowTrue` on `Bool?` as well. In this case `nil` elements will be ignored:
```swift
let disposeBag = DisposeBag()
Observable.of(true, false, nil, true, nil, true)
.allowTrue()
.subscribe(onNext: { print($0) })
.disposed(by: disposeBag)
```
Output will be:
```text
true
true
true
```
If you prefer to allow `nil` elements as well then you can use `allowTrueOrNil` like this:
```swift
let disposeBag = DisposeBag()
Observable.of(true, false, nil, true, nil, true, false)
.allowTrueOrNil()
.subscribe(onNext: { print($0) })
.disposed(by: disposeBag)
```
Output will be:
```text
true
true
true
true
true
```
### Map Extensions
You can map every element in sequence with provided value.
```swift
let disposeBag = DisposeBag()
Observable.of(1, 5, 7, 8)
.map(to: "ping")
.subscribe(onNext: { print($0) })
.disposed(by: disposeBag)
```
Output will be:
```text
ping
ping
ping
ping
```
You can map every element in sequence by procided Key Path.
```swift
let disposeBag = DisposeBag()
let observable = Observable.of(
Book(title: "Twenty Thousand Leagues Under the Sea", author: Author("Jules", "Verne")),
Book(title: "Hamlet", author: Author("William", "Shakespeare")),
Book(title: "Hearts of Three", author: Author("Jack", "London"))
)
observable
.map(at: \.title)
.subscribe(onNext: { print($0) })
.disposed(by: disposeBag)
observable
.map(at: \.author.firstName)
.subscribe(onNext: { print($0) })
.disposed(by: disposeBag)
```
Output will be:
```text
Twenty Thousand Leagues Under the Sea
Hamlet
Hearts of Three
Jules
William
Jack
```
### Cast Extensions
You can do downcast elements in sequence using `cast(to:)`.
```swift
let disposeBag = DisposeBag()
Observable.of("1", "5", "7", "8")
.cast(to: String.self)
.subscribe(onNext: { print($0) })
.disposed(by: disposeBag)
```
Output will be:
```text
Optional("1")
Optional("5")
Optional("7")
Optional("8")
```
In order to do force downcast use `forceCast(to:)` liek this:
```swift
let disposeBag = DisposeBag()
Observable.of("1", "5", "7", "8")
.forceCast(to: String.self)
.subscribe(onNext: { print($0) })
.disposed(by: disposeBag)
```
Output will be:
```text
1
5
7
8
```
In case of downcast exception it will return `Observable.error(RxCastError.castFailed)`.
Allow extension functions can be used on `Driver` as well, except `forceCast(to:)`.
### Other Extensions
Sometimes we need to update some subject or observer on each `next` event of `Observable` or `Driver`. For example:
```swift
request
.do(onNext: { [weak self] _ in
self?.inProgress.onNext(true)
})
.flatMap {
service.doRequest($0)
}
.do(onNext: { [weak self] _ in
self?.inProgress.onNext(false)
})
.subscribe(onNext: { response in
dump(response)
})
.disposed(by: disposeBag)
```
You can use `update(_:with:)` method for shorting code like this:
```swift
request
.update(inProgress, with: true)
.flatMap {
service.doRequest($0)
}
.update(inProgress, with: false)
.subscribe(onNext: { response in
dump(response)
})
.disposed(by: disposeBag)
```
## Author
Tigran Hambardzumyan, [email protected]
## Support
Feel free to [open issues](https://github.com/STDevTM/STDevRxExt/issues/new) with any suggestions, bug reports, feature requests, questions.
## Let us know!
We’d be really happy if you sent us links to your projects where you use our component. Just send an email to [email protected] And do let us know if you have any questions or suggestion.
## License
STDevRxExt is available under the MIT license. See the LICENSE file for more info.