Requests 是用Python語言編寫,基於 urllib,採用 Apache2 Licensed 開源協議的 HTTP 庫。它比 urllib 更加方便,能夠節約咱們大量的工做,徹底知足 HTTP 測試需求。Requests 的哲學是以 PEP 20 的習語爲中心開發的,因此它比 urllib 更加 Pythoner。更重要的一點是它支持 Python3 哦!python
requests.requests()git
requests.get(‘https://github.com/timeline.json’) #GET請求github
requests.post(「http://httpbin.org/post」) #POST請求json
requests.put(「http://httpbin.org/put」) #PUT請求(提交修改所有的數據)api
requests.delete(「http://httpbin.org/delete」) #DELETE請求服務器
requests.head(「http://httpbin.org/get」) #HEAD請求cookie
requests.patch(「http://httpbin.org/get」) #PATCH請求(提交修改部分數據)網絡
剩下六種方法都是由requests()方法實現的,所以咱們也能夠說requests()方法是最基本的app
在網絡上,對服務器數據進行修改是比較困難的,在實際中get()方法是最爲經常使用的方法post
1.requests()方法:
requests.requests(method, url, **kwargs)
method:請求方式:GET, PUT,POST,HEAD, PATCH, delete, OPTIONS7種方式
url:網絡連接
**kwargs: (13個可選參數)(下面演示這些參數如何使用)
params: 字典或者字節序列,做爲參數增長到url中
>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get("http://httpbin.org/get", params=payload)
經過打印輸出該URL,你能看到URL已被正確編碼:
>>> print r.url
u'http://httpbin.org/get?key2=value2&key1=value1'
json: JSON格式的數據,做爲requests的內容
>>> import requests
>>> r = requests.get('https://github.com/timeline.json')
>>> r.json()
[{u'repository': {u'open_issues': 0, u'url': 'https://github.com/...
headers: 字典,HTTP定製頭
data: 是第二個控制參數,向服務器提交數據
import requests
import json
data = {'some': 'data'}
headers = {'content-type': 'application/json',
'User-Agent': 'Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:22.0) Gecko/20100101 Firefox/22.0'}
r = requests.post('https://api.github.com/some/endpoint', data=data, headers=headers)
print(r.text)
cookies: 字典或CookieJar, Requests中的cookie
若是某個響應中包含一些Cookie,你能夠快速訪問它們:
import requests
r = requests.get('http://www.google.com.hk/')
print(r.cookies['NID'])
print(tuple(r.cookies))
要想發送你的cookies到服務器,可使用 cookies 參數:
import requests
url = 'http://httpbin.org/cookies'
cookies = {'testCookies_1': 'Hello_Python3', 'testCookies_2': 'Hello_Requests'}
# 在Cookie Version 0中規定空格、方括號、圓括號、等於號、逗號、雙引號、斜槓、問號、@,冒號,分號等特殊符號都不能做爲Cookie的內容。
r = requests.get(url, cookies=cookies)
print(r.json())
auth: 元組,支持HTTP認證功能
import requests
from requests.auth import HTTPBasicAuth
r = requests.get('https://httpbin.org/hidden-basic-auth/user/passwd', auth=HTTPBasicAuth('user', 'passwd'))
# r = requests.get('https://httpbin.org/hidden-basic-auth/user/passwd', auth=('user', 'passwd')) # 簡寫
print(r.json())
files: 字典類型,傳輸文件
import requests
url = 'http://127.0.0.1:5000/upload'
files = {'file': open('/home/lyb/sjzl.mpg', 'rb')}
#files = {'file': ('report.jpg', open('/home/lyb/sjzl.mpg', 'rb'))} #顯式的設置文件名
r = requests.post(url, files=files)
print(r.text)
timeout: 設置的超時時間,秒爲單位
>>> requests.get('http://github.com', timeout=0.001)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
requests.exceptions.Timeout: HTTPConnectionPool(host='github.com', port=80): Request timed out. (timeout=0.001)
proxies: 字典類型,設定訪問代理服務器,能夠增長登陸認證
import requests
proxies = {
"http": "http://10.10.1.10:3128",
"https": "http://10.10.1.10:1080",
}
requests.get("http://www.zhidaow.com", proxies=proxies)
若是代理須要帳戶和密碼,則需這樣:
proxies = {
"http": "http://user:pass@10.10.1.10:3128/",
}
allow_redirects: True/False,默認爲True, 重定向開關
stream: True/False,默認爲True,獲取內容當即下載開關
verity: True/False,默認爲True, 認證SSL證書
cert: 本地SSL證書路徑
2.get()方法:
requests.get(url, params=None, **kwargs)
url: 擬獲取頁面的url連接
params: url中的額外參數,字典或字節流,可選擇
**kwargs:12個控制訪問的參數,就是requests中除params參數
3.head()方法
requests.head(url, **kwargs)
url: 擬獲取頁面的url連接
**kwargs:13個控制訪問的參數
4.post()方法
requests.post(url, data=None, json=None, **kwargs)
url: 擬獲取頁面的url連接
data: 字典,字節序列或文件,Requests的內容
json: JSON格式的數據,Requests的內容
**kwargs:11個控制訪問的參數
5.put()方法
requests.put(url, data=None, **kwargs)
url: 擬獲取頁面的url連接
data: 字典,字節序列或文件,Requests的內容
**kwargs:12個控制訪問的參數
6.patch()方法
requests.patch(url, data=None, **kwargs)
url: 擬獲取頁面的url連接
data: 字典,字節序列或文件,Requests的內容
**kwargs:12個控制訪問的參數
7.delete()方法
requests.delete(url, **kwargs)
url: 擬刪除頁面的url連接
**kwargs:13個控制訪問的參數
使用requests方法後,會返回一個response對象,其存儲了服務器響應的內容,
經常使用屬性:
r.status_code #HTTP響應狀態碼,200表示響應成功,404表示失敗
r.content #HTTP響應內容的二進制形式
r.text #字符串方式的響應體,
r.headers #以字典對象存儲服務器響應頭,可是這個字典比較特殊,字典鍵不區分大小寫,若鍵不存在則返回None
(要注意區分r.headers,與前面的headers參數字段,前者只是Response對象的一個屬性,後者是傳遞的參數)
r.encoding#從HTTP頭header中提取響應內容的編碼方式(這個編碼方式不必定存在)
r.apparent_encoding#從內容中分析出響應內容的編碼方式(這個編碼方式是絕對正確的)
r.raw #返回原始響應體,也就是 urllib 的 response 對象,使用 r.raw.read() 讀取
在這裏有一個比較特殊的屬性: r.request.headers能夠查看HTTP請求的頭部,注意區分r.headers
經常使用方法:
r.raise_for_status() #失敗請求(非200響應)拋出requests.HTTPError異常
requests.ConnectionError: 網絡鏈接錯誤異常,如DNS查詢失敗,拒接鏈接等
requests.HTTPError: HTTP錯誤異常
requests.URLRequired: URL缺失異常
requests.TooManyRedirects: 超過最大重定向次數,產生的重定向異常
requests.ConnectTimeout: 遠程鏈接服務器異常超時
requests.Timeout: 請求URL超時,產生的超時異常