https://github.com/fluidgroup/rxfuture

🛸A library to provide Future/Promise pattern API that is backed by RxSwift.
https://github.com/fluidgroup/rxfuture

future promise rxswift

Last synced: 2 months ago
JSON representation

🛸A library to provide Future/Promise pattern API that is backed by RxSwift.

• Host: GitHub
• URL: https://github.com/fluidgroup/rxfuture
• Owner: FluidGroup
• License: mit
• Created: 2018-12-23T17:37:22.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2022-04-04T10:59:58.000Z (almost 3 years ago)
• Last Synced: 2024-10-31T16:20:57.456Z (3 months ago)
• Topics: future, promise, rxswift
• Language: Swift
• Homepage:
• Size: 40 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# RxFuture

A temporary solution

## What's this?

A library to provide Future/Promise pattern API that is backed by RxSwift.

## Why do we need this against using Single?

Firstly, Future/Promise pattern fits to return a single result of an asynchronous task.

```swift

func doSomething() -> Future

```

Future/Promise pattern can also do with API of RxSwift only.

With using Observable or some PrimitiveSequence.

The problems in this case,

First, Observable does not know how many it will be subscribed.

So, Observable always should be shared sequence.

If it isn't, a task wrapped by Observable will run by each of subscribe.

Second, a task wrapped by Observable does not know when starts. It depends on subscribe.

The second case depends on RxSwift.

Almost of Observables in RxSwift are cold-observable.

```swift

func doSomething() -> Observable

```

the name of this function says "do something", but actually, "something" will not be done until subscribed.

A below name may be better than above.

```swift

func taskToDoSomething() -> Observable

```

Basically, Future will run a wrapped task immediately.

So, I created an object like as Future with RxSwift.

## What's the differences with `Single`?

RxFuture is different with Single. We can say `RxFuture` runs similar with `Combine.Future`.  

`RxFuture` and `Combine.Future` runs their tasks immediately and they caches result until they are deallocated.