Promis：Swift中最简单的Future和Promises框架

Promis：Swift中最简单的Future和Promises框架

PromisThe easiest Future and Promises framework in Swift. No magic. No boilerplate.项目地址:https://gitcode.com/gh_mirrors/pr/Promis

项目介绍

Promis 是一个在Swift中实现Future和Promises的框架，它源自Objective-C版本的JustPromises，并进行了现代化改造。Promis旨在提供一个简洁、无样板代码的解决方案，帮助开发者更高效地处理异步编程。

项目技术分析

Promis通过使用泛型和现代Swift特性，如类型推断，解决了Objective-C版本中的一些限制。它移除了不必要的概念，如Progress，从而避免了不良的编程模式。Promis的核心优势在于其简洁的接口、支持链式调用、取消操作以及基于队列的块执行，这些都是通过泛型参数化的结果类型实现的。

项目及技术应用场景

Promis适用于需要处理复杂异步操作的场景，特别是在需要避免“回调地狱”（pyramid of doom）的情况下。它可以用于网络请求、数据解析、文件操作等多种异步任务，通过链式调用简化代码结构，提高可读性和维护性。

项目特点

• 简洁高效：Promis的设计理念是“无魔法、无样板代码”，保持代码的简洁和可读性。
• 类型安全：利用Swift的泛型特性，确保类型在编译时的安全。
• 链式调用：支持链式调用，简化异步代码路径，避免回调地狱。
• 取消操作：支持任务的取消，增加了灵活性。
• 队列支持：允许基于队列的块执行，更好地管理线程和并发。
• 全面测试：Promis经过了全面的单元测试，确保稳定性和可靠性。

使用示例

以下是一个简单的使用示例，展示了如何通过链式调用处理异步任务：

let request = URLRequest(url: URL(string: "http://example.com")!)

getData(request: request).thenWithResult { data in
    parse(data: data)
}.thenWithResult { parsedData in
    map(data: parsedData)
}.onError { error in
    print("error: " + String(describing: error))
}.finally(queue: .main) { future in
    switch future.state {
    case .result(let value):
        print(String(describing: value))
    case .error(let err):
        print(String(describing: err))
    case .cancelled:
        print("future is in a cancelled state")
    case .unresolved:
        print("this really cannot be if any chaining block is executed")
    }
}

安装指南

CocoaPods

在Podfile中添加Promis：

use_frameworks!
target 'MyTarget' do
    pod 'Promis', '~> x.y.z'
end

然后运行：

$ pod install

Carthage

在Cartfile中添加：

github "albertodebortoli/Promis" ~> "x.y.z"

然后在应用目标的Build Phases设置中，添加一个新的Run Script Phase，内容如下：

/usr/local/bin/carthage copy-frameworks

并添加以下路径到“Input Files”：

$(SRCROOT)/Carthage/Build/iOS/Promis.framework

作者

Alberto De Bortoli

• Email: albertodebortoli.website@gmail.com
• Twitter: @albertodebo
• GitHub: albertodebortoli
• 网站: albertodebortoli.com

许可证

Promis遵循Apache 2许可证。详细信息请参阅LICENSE文件。

---

Promis是一个强大且易用的Future和Promises框架，适用于Swift开发者，特别是那些希望简化异步编程流程的开发者。通过其简洁的接口和强大的功能，Promis无疑将成为你工具箱中的宝贵资产。

PromisThe easiest Future and Promises framework in Swift. No magic. No boilerplate.项目地址:https://gitcode.com/gh_mirrors/pr/Promis