python WEB接口自动化测试之requests库详解

前提：

requests库是python的第三方库，需要提前安装哦，可以直接用pip命令：`python –m pip install requests`

 

按照惯例，先将requests库的属性打印出来，看看哪些属性。

>>> import requests

>>> dir(requests) #查看requests库的属性

[‘ConnectionError‘, ‘HTTPError‘, ‘NullHandler‘, ‘PreparedRequest‘, ‘Request‘, ‘RequestException‘, ‘Response‘, ‘Session‘, ‘Timeout‘, ‘TooManyRedirects‘, ‘URLRequired‘, ‘__author__‘, ‘__build__‘, ‘__builtins__‘, ‘__copyright__‘, ‘__doc__‘, ‘__file__‘, ‘__license__‘, ‘__name__‘, ‘__package__‘, ‘__path__‘, ‘__title__‘, ‘__version__‘, ‘adapters‘, ‘api‘, ‘auth‘, ‘certs‘, ‘codes‘, ‘compat‘, ‘cookies‘, ‘delete‘, ‘exceptions‘, ‘get‘, ‘head‘, ‘hooks‘, ‘logging‘, ‘models‘, ‘options‘, ‘packages‘, ‘patch‘, ‘post‘, ‘put‘, ‘request‘, ‘session‘, ‘sessions‘, ‘status_codes‘, ‘structures‘, ‘utils‘]

所以可以看到requests的属性有get，post，delete，put，对应http请求的method方法。

常用的是get和post请求。get请求一般是查询获取资源信息。post一般是更新资源信息。

>>> help(requests.get) #查看requests库的属性get请求函数的使用

Help on function get in module requests.api:

 

get(url, params=None, **kwargs)

Sends a GET request.

:param url: URL for the new :class:`Request` object.

:param params: (optional) Dictionary or bytes to be sent in the query string for the :class:`Request`.

:param \*\*kwargs: Optional arguments that ``request`` takes.

:return: :class:`Response <Response>` object

:rtype: requests.Response

1.2 requests的get函数的入参说明

url：调用接口的URL地址。

params:为可选参数，该参数是一个字典类型。数据会以键/值对的形式置于 URL 中，跟在一个问号的后面。举例说明，若r=requests.get("http://httpbin.org/get",params={‘key1‘:‘value1‘,‘key2‘:‘value2‘}) 那么，最终请求的目标URL为http://bin.org/get?key1=val1& key2=val2。

**kwargs:其他可选参数，例如headers，files，cookies，auth，timeout，json等。

例如：auth=(‘username,’password’)：接口安全测试中用到的用户认证。

例如：headers = {‘user-agent‘: ‘my-app/0.0.1‘}：可定制发送请求头。

1.3 requests函数的返回值（http响应）

返回的是response类对象（requests.models.Response）。来自requests模块 models.py里的Response类

>>> r=requests.get(‘http://httpbin.org/get‘) #查看response的属性

>>> dir(r)

[‘__attrs__‘, ‘__bool__‘, ‘__class__‘, ‘__delattr__‘, ‘__dict__‘, ‘__doc__‘, ‘__format__‘, ‘__getattribute__‘, ‘__getstate__‘, ‘__hash__‘, ‘__init__‘, ‘__iter__‘, ‘__module__‘, ‘__new__‘, ‘__nonzero__‘, ‘__reduce__‘, ‘__reduce_ex__‘, ‘__repr__‘, ‘__setattr__‘, ‘__setstate__‘, ‘__sizeof__‘, ‘__str__‘, ‘__subclasshook__‘, ‘__weakref__‘, ‘_content‘, ‘_content_consumed‘, ‘apparent_encoding‘, ‘close‘, ‘connection‘, ‘content‘, ‘cookies‘, ‘elapsed‘, ‘encoding‘, ‘headers‘, ‘history‘, ‘is_permanent_redirect‘, ‘is_redirect‘, ‘iter_content‘, ‘iter_lines‘, ‘json‘, ‘links‘, ‘ok‘, ‘raise_for_status‘, ‘raw‘, ‘reason‘, ‘request‘, ‘status_code‘, ‘text‘,‘url‘]

对于返回对象常用的属性如下：

 

json():生成json数据对象的方法。如果 JSON 解码失败， r.json 就会抛出一个异常。例如，响应内容是 401 (Unauthorized)，尝试访问 r.json 将会抛出 ValueError: No JSON object could be decoded 异常。

status_code：响应状态码。

encoding：编码，如utf-8。

url：目标url。

headers：响应头。类型为字典类型，若键不存在则返回None。

text：响应内容。字符串方式，会自动根据响应头部的字符编码进行解码。如果你改变了编码r.encoding，每当你访问 r.text ，Request 都将会使用 r.encoding 的新值。

content：二进制响应内容。字节方式，会自动为你解码gzip和deflate压缩。

raw：原始响应内容，也就是 urllib 的 response 对象，请求中要加stream=True，再使用 r.raw.read() 读取。

r.raise_for_status:失败请求（非200响应）抛出异常。

 1.4 举例说明

>>> r=requests.get("http://httpbin.org/get",params=payload)

>>> r.status_code

200

>>> r.json()

{u‘origin‘: u‘113.98.252.236‘, u‘headers‘: {u‘Host‘: u‘httpbin.org‘, u‘Accept-Encoding‘: u‘gzip, deflate‘, u‘Accept‘: u‘*/*‘, u‘User-Agent‘: u‘python-requests/2.7.0 CPython/2.7.11 Windows/7‘}, u‘args‘: {u‘key2‘: u‘value2‘, u‘key1‘: u‘value1‘}, u‘url‘: u‘http://httpbin.org/get?key2=value2&key1=value1‘}

>>> r.url #url：params数据会以键/值对的形式置于 URL 中，跟在一个问号的后面。

u‘http://httpbin.org/get?key2=value2&key1=value1‘

>>> r.headers

{‘content-length‘: ‘334‘, ‘server‘: ‘nginx‘, ‘connection‘: ‘keep-alive‘, ‘access-control-allow-credentials‘: ‘true‘, ‘date‘: ‘Fri, 09 Dec 2016 09:04:40 GMT‘, ‘access-control-allow-origin‘: ‘*‘, ‘content-type‘: ‘application/json‘}

>>> r.headers[‘content-type‘]

‘application/json‘

>>> r.raw

<requests.packages.urllib3.response.HTTPResponse object at 0x0000000002E64E10>

>>> r.cookies

<RequestsCookieJar[]>

>>> r.text

u‘{\n "args": {\n "key1": "value1", \n "key2": "value2"\n }, \n "headers": {\n "Accept": "*/*", \n "Accept-Encoding": "gzip, deflate", \n "Host": "httpbin.org", \n "User-Agent": "python-requests/2.7.0 CPython/2.7.11 Windows/7"\n }, \n "origin": "113.98.252.236", \n "url": "http://httpbin.org/get?key2=value2&key1=value1"\n}\n‘

>>> r.content

‘{\n "args": {\n "key1": "value1", \n "key2": "value2"\n }, \n "headers": {\n "Accept": "*/*", \n "Accept-Encoding": "gzip, deflate", \n "Host": "httpbin.org", \n "User-Agent": "python-requests/2.7.0 CPython/2.7.11 Windows/7"\n }, \n "origin": "113.98.252.236", \n "url": "http://httpbin.org/get?key2=value2&key1=value1"\n}\n‘

>>> payload = {‘key1‘: ‘value1‘, ‘key2‘: ‘value2‘}

>>> r = requests.get("http://httpbin.org/get", params=payload,stream=True)

>>> r.raw

<requests.packages.urllib3.response.HTTPResponse object at 0x0000000003105940>

>>> r.raw.read()

‘{\n "args": {\n "key1": "value1", \n "key2": "value2"\n }, \n "headers": {\n "Accept": "*/*", \n "Accept-Encoding": "gzip, deflate", \n "Host": "httpbin.org", \n "User-Agent": "python-requests/2.7.0 CPython/2.7.11 Windows/7"\n }, \n "origin": "113.98.252.236", \n "url": "http://httpbin.org/get?key2=value2&key1=value1"\n}\n‘

综上所述，通过requests.get("某url",params={字典类型参数键值对})模拟浏览器发送一个http的请求（其中请求的方法是get，请求的url地址如下形式http://httpbin.org/get？key2=value2&key1=value1），服务器处理数据后，会返回一个response对象，通过读取response对象的属性值，如json数据，可以做一系列的断言，从而验证该接口返回的数据是否正确。

## 2.1 查看post函数的使用

>>> help(requests.post) #查看requests库的属性post请求函数的使用

post(url, data=None, json=None, **kwargs)

Sends a POST request.

:param url: URL for the new :class:`Request` object.

:param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`.

:param json: (optional) json data to send in the body of the :class:`Request`.

:param \*\*kwargs: Optional arguments that ``request`` takes.

:return: :class:`Response <Response>` object

:rtype: requests.Response

url：调用接口的URL地址。

data:为可选参数，该参数是一个字典类型。

json：为可选参数，该参数是一个json类型。

**kwargs:其他可选参数，例如headers等。

同1.3

 

json():生成json数据对象的方法。如果 JSON 解码失败， r.json 就会抛出一个异常。例如，响应内容是 401 (Unauthorized)，尝试访问 r.json 将会抛出 ValueError: No JSON object could be decoded 异常。

>>> payload = {‘key1‘: ‘value1‘, ‘key2‘: ‘value2‘}

>>> r = requests.post("http://httpbin.org/post", data=payload)

3.1 定制请求头

>>> headers = {‘user-agent‘: ‘my-app/0.0.1‘}

>>> r = requests.post("http://httpbin.org/post", data=payload,headers=headers)

>>> cookies = dict(cookies_are=‘working‘)

>>> r = requests.get(url, cookies=cookies)

>>> r.text

u‘{\n "cookies": {\n "cookies_are": "working"\n }\n}\n‘

请求的headers中的client项中的Accept-Encoding的，例如Accept-Encoding: gzip, deflate。浏览器申明自己接收的编码方法，通常指定压缩方法，是否支持压缩，支持什么压缩方法（gzip，deflate）（注意：这不是只字符编码）。

Text：用于标准化地表示的文本信息，文本消息可以是多种字符集和或者多种格式的；