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，你还可以直接在函数参数处注释。
英文原文：http://uplink.readthedocs.io/en/latest/introduction.html
译者：诗书塞外
