The Promise class designed as a Monad for Swift.
Swift Objective-C
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
PromiseK.xcodeproj
Sources/PromiseK
Tests
.gitignore
LICENSE
Package.swift
README.md

README.md

PromiseK

PromiseK provides a simple monadic Promise type for Swift.

// `flatMap` is equivalent to `then` of JavaScript's `Promise`
let a: Promise<Int> = asyncGet(2)
let b: Promise<Int> = asyncGet(3).map { $0 * $0 } // Promise(9)
let sum: Promise<Int> = a.flatMap { a in b.map { b in a + b } }

Promise can collaborate with throws for failable asynchronous operations.

// Collaborates with `throws` for error handling
let a: Promise<() throws -> Int> = asyncFailable(2)
let b: Promise<() throws -> Int> = asyncFailable(3).map { try $0() * $0() }
let sum: Promise<() throws -> Int> = a.flatMap { a in b.map { b in try a() * b() } }

It is also possible to recover from errors.

// Recovery from errors
let recovered: Promise<Int> = asyncFailable(42).map { value in
    do {
        return try value()
    } catch _ {
        return -1
    }
}

Installation

Swift Package Manager

.package(
    url: "https://github.com/koher/PromiseK.git",
    from: "3.0.0"
)

Carthage

github "koher/PromiseK" ~> 3.0.0

License

The MIT License

References

  1. Promise - JavaScript | MDN
  2. JavaScript Promises: There and back again - HTML5 Rocks
  3. A Fistful of Monads - Learn You a Haskell for Great Good!