Python培训
400-996-5531
Uplink让你用少的代码,构建一个HTTP服务的客户端。
如果你用其他库来做这件事情,比如requests,通常来说你都需要写一个样本代码,然后用一个抽象层来抽象化这个样本代码。但是使用Uplink则不用这样,你只需要使用一些装饰器和注释,就能够构建一个HTTP服务的客户端。
方法注释:静态请求处理
从本质上说,Uplink是使用方法注释来描述这个API请求所需要的特征。
下面是一个例子
使用timeout注释这个类方法,这样get_repos构建的API请求就会在60s没有返回时报超时错误。
使用多个方法注释
你不仅仅可以加一个装饰器,事实上你可以加一系列装饰器
给类中所有方法增加同样的注释
为了给类中所有方法增加一个同样的注释,那么你就把装饰器直接加在类上就好了,就不用在每个方法上单独添加了。
上面这个例子,和下面这个略微麻烦一点的写法作用是一样的。
参数注释:动态请求处理
编程中,一个函数的参数驱动了这个函数的动态行为;一个函数的输出往往依赖于其输入。使用Uplink,你可以通过函数参数来驱动请求中的动态部分,你可以通过正确地进行注释来说明请求中的动态部分。
为了介绍这个特性,在下面的get_user方法中,我们注释说明了函数参数username是一个URL参数。
然后,在客户端你就可以这样调用这个方法了:
这样这个方法发出的请求,其请求地址就是以"users/prkumar"结尾了。
默认使用函数参数名称
像上面的例子中,如果使用Path时不提供名称参数,Uplink会默认使用函数的参数名称作为URL参数的名称。
下面这个例子和上面讲的例子作用是等价的:
使用装饰器注释参数
我们可以使用函数装饰器注释参数。这时,装饰器是从下向上匹配参数的。
例如,在下面这个例子中,注释Url对应参数commits_url,注释Path对应参数sha。
使用uplink.args
还有一个办法就是使用装饰器uplink.args,uplink.args中的注释是按照顺序对应函数参数的。
函数参数注释(只支持Python3)
如果你使用Python3,你还可以直接在函数参数处注释。
英文原文:#/en/latest/introduction.html
译者:诗书塞外
本文内容转载自网络,本着分享与传播的原则,版权归原作者所有,如有侵权请联系我们进行删除!
填写下面表单即可预约申请免费试听! 怕学不会?助教全程陪读,随时解惑!担心就业?一地学习,可全国推荐就业!
Copyright © 京ICP备08000853号-56 京公网安备 11010802029508号 达内时代科技集团有限公司 版权所有
Tedu.cn All Rights Reserved