对蟒蛇的承诺
pypromise的Python项目详细描述
承诺
这是python中promises的实现。这是一套很好的 promises/a+设计为具有可读性、可执行的代码并提供 只是在中使用承诺绝对必要的扩展 Python。
它完全兼容Promises/A+ spec
安装
$ pip install pypromise
使用量
下面的示例演示如何加载Promise库。那么 演示如何从头开始创建承诺。你只要打电话 Promise(fn)。对于返回的内容有一个完整的规范 用这种方法 Promises/A+。
frompromiseimportPromisepromise=Promise(lambdaresolve,reject:resolve('RESOLVED!'))
api
在所有示例之前,您需要:
frompromiseimportPromise
承诺(分解器)
这创造并回报了一个新的承诺。resolver必须是函数。 resolver函数传递了两个参数:
- resolve应该用一个参数调用。如果它被称为 有了非承诺价值,承诺就实现了 价值。如果它是用承诺(a)调用的,那么返回的承诺 承担新承诺的状态。
- reject应该用一个参数调用。返回的 这个论据会否定诺言的。
静态函数
这些方法通过调用Promise.methodName来调用。
承诺。决心(价值)
将价值观和国外承诺转换为承诺/a+承诺。如果你 传递一个值,然后返回该值的承诺。如果你通过了 接近承诺的东西(例如 promise)返回一个承诺,其状态为value (拒绝或满足)。
承诺。拒绝(价值)
返回具有给定值的拒绝承诺。
承诺。全部(列表)
返回列表的承诺。如果用一个参数调用它 然后返回一个带有任何承诺的列表副本的承诺 取而代之的是他们实现的价值观。例如
p=Promise.all([Promise.resolve('a'),'b',Promise.resolve('c')]) \ .then(lambdares:res==['a','b','c'])assertp.valueisTrue
实例方法
通过调用promise实例调用这些方法 myPromise.methodName
承诺。然后(在你履行承诺时,在你拒绝承诺时)
此方法遵循Promises/A+ spec。它解释了 事情很清楚,所以我建议你读一下。
将调用on_fulfilled或on_rejected,它们将 不能被多次呼叫。他们将通过一个单一的论点 将始终异步调用(在事件的下一轮中 循环)。
如果实现了承诺,则调用on_fulfilled。如果 承诺被拒绝,然后调用on_rejected。
对.then的调用也返回一个promise。如果 called返回一个promise,由.then返回的promise接受 承诺的状态。如果调用的处理程序返回 不是promise的值,由.then返回的promise将是 实现了这个价值。如果被调用的处理程序抛出 异常,则.then返回的承诺将被拒绝 例外。
承诺。捕获(在被拒绝的情况下)
糖,promise.then(None, on_rejected),镜像catch在 同步代码。
承诺。完成(完成时,拒绝时)
与.then的语义相同,只是它不返回承诺 任何异常都会被重新抛出,以便记录下来(崩溃 非浏览器环境中的应用程序)
其他套餐功能
是否可以(obj)
此函数检查obj是Promise还是 promisifyed.
预测(obj)
如果可能,此函数将obj包装为Promise。Python Futures受支持,当 断然的。