Forbind
Functional chaining and promises in Swift
Note: still in an experimental state. Everything could change. I would love some feedback on this. Write to @ulrikdamm on Twitter.
What is it
Bind local or async expressions together functionally, all error handling taken care of for you:
func getUser(id : String) -> Promise<Result<User>> {
let data = NSURL(string: id)
=> { NSURLRequest(URL: $0) }
=> NSURLConnection.sendRequest(.mainQueue())
=> { response, data in data }
return data
=> NSJSONSerialization.toJSON(options: nil)
=> { $0.dictionaryValue }
=> User.fromJSON
}
• Bind operations together with =>
• No error handling inside your logic
• Transparent async calls
• No if-lets
• Combine inputs with ++
For more details, read my Blog post.
New in 1.1
• ResultPromise and OptionalPromise has been replaced with Promise<Result> and Promise<T?>. Still works the same.
• You can use the bind operator to map over lists of promises!
let user = User(name: "Ulrik")
let names = user.loadFriends() => { $0.name } // [Promise<String>]
• And you can also filter and reduce with filterp and reducep:
let someNames = filterp(names) { $0 != "Peter" } // Promise<[String]>
• The NSJSONSerialization extension now returns a JSONResult, which is either a Dictionary or Array.
Get started
You can add Forbind to your project using CocoaPods. Just add it to your Podfile:
use_frameworks!
pod 'Forbind', '~> 1.1'
pod 'ForbindExtensions', :git => 'https://github.com/ulrikdamm/Forbind'
(You need the use_frameworks! since that feature of CocoaPods is still in beta. ForbindExtensions are optional)
Or you can add it using Carthage by adding this to your cartfile:
github "ulrikdamm/Forbind" ~> 1.0
This will add both Forbind.framework and ForbindExtensions.framework, which you can drag into your Xcode project.
Then in your files just import Forbind and optionally ForbindExtensions
import Forbind
import ForbindExtensions
The Forbind library is the bind operator (=>) and the combine operator (++), along with the Result enum and Promise classes.
ForbindExtensions are extensions to Foundation and UIKit for working better with Forbind, by, for example, returning a promise instead of using a completion block. The ForbindExtensions are still a work in progress, so you might want to make your own extensions instead. In this case, just only include the Forbind framework.
What is the state of the project?
It’s still very experimental, so I would love some feedback on it. I wouldn’t recommend relying on this for product code yet. If you have a good idea, or just questions, submit a pull request or contact me at @ulrikdamm on Twitter.
Things that still needs to be considered:
• General direction of the project (are there some fundamental flaws?)
• Promise cancellation (support for cancelling an async operation if a promise is deallocated)
• Handling of dispatch queues (currently promise callbacks are run on the same queue as the operation finished on)
• More extensions for common UIKit/AppKit/Foundation methods to use Promise and Result instead of NSErrorPointer and completion blocks.
• "Expression was too complex to be solved in reasonable time" for big expressions.
825 Dec 7, 2022
133 Oct 9, 2022
31 Nov 3, 2022
0 Jan 23, 2022
6.2k Dec 29, 2022
132 Jan 6, 2023
1.9k Dec 20, 2022
759 Dec 2, 2022
111 Dec 27, 2022
3.7k Dec 24, 2022
60 Aug 11, 2022
17 Apr 5, 2019
2k Dec 24, 2022
40 Sep 23, 2022
115 Nov 23, 2022
259 Dec 29, 2022
14k Jan 5, 2023
219 Aug 30, 2022
619 Aug 5, 2022
11 Aug 10, 2019
405 Jun 29, 2022
3.5k Jan 7, 2023
613 Dec 20, 2022
3.4k Dec 27, 2022
183 Dec 15, 2022