Python requests介绍

引用官网介绍

Requests 唯一的一个非转基因的 Python HTTP 库，人类可以安全享用。

Requests 允许你发送纯天然，植物饲养的 HTTP/1.1 请求，无需手工劳动。你不需要手动为 URL 添加查询字串，也不需要对 POST 数据进行表单编码。Keep-alive 和 HTTP 连接池的功能是 100% 自动化的，一切动力都来自于根植在 Requests 内部的 。

功能特性

Requests 完全满足今日 web 的需求。

• Keep-Alive & 连接池
• 国际化域名和 URL
• 带持久 Cookie 的会话
• 浏览器式的 SSL 认证
• 自动内容解码
• 基本/摘要式的身份认证
• 优雅的 key/value Cookie
• 自动解压
• Unicode 响应体
• HTTP(S) 代理支持
• 文件分块上传
• 流下载
• 连接超时
• 分块请求
• 支持 .netrc

Requests 支持 Python 2.6—2.7以及3.3—3.7，而且能在 PyPy 下完美运行。

''' requests 接口介绍  '''

#-*-coding:utf-8-*-# Time:2017/10/12 22:54# Author:YangYangJun#开始 requests学习之旅，这里直接在代码编写文字了。#requests 是python的第三方库，所以这里需要安装# 直接在命令行窗口执行 pip install requests  即可#如果提示安装失败，可以参看提示，安装必备软件然后重新安装即可#安装成功后 即可直接导入import  requests#如上不报错即可#参考资料#访问网址 http://cn.python-requests.org/zh_CN/latest/  即可查看官方中文文档#或是查看源代码  https://github.com/requests/requests#也可到 自己的安装目录下查找 D:/SProgram/Python/Lib/site-packages/requests/api.py 等文件查看介绍''' requests 接口介绍  '''# 这部分文档包含了 Requests 所有的接口。对于 Requests 依赖的外部库部分，我们在这里介绍最重要的部分，并提供了规范文档的链接。# # 主要接口# Requests 所有的功能都可以通过以下 7 个方法访问。它们全部都会返回一个 Response 对象的实例。# 1、request()方法# requests.request(method, url, **kwargs)   Constructs and sends a Request. 构造和发送请求。# 这里的参数 method 、 url 是必选参数，**kwargs 是可选参数，是 可变关键字参数，Dictionary 类型'''参数:    method -- method for the new Request object.  新请求对象的方法url -- URL for the new Request object.  新的请求对象的URLparams -- (optional) Dictionary or bytes to be sent in the query string for the Request.  (可选)在查询字符串中为请求发送的字典或字节。data -- (optional) Dictionary or list of tuples [(key, value)] (will be form-encoded), bytes, or file-like object to send in the body of the Request.(可选)字典或元组列表[(键，值)](将以表单编码)、字节或类似文件的对象发送到请求体中。json -- (optional) json data to send in the body of the Request.(可选)json数据发送到请求体中。headers -- (optional) Dictionary of HTTP Headers to send with the Request.(可选)HTTP报头字典，以发送请求。cookies -- (optional) Dict or CookieJar object to send with the Request.(可选)命令或CookieJar对象发送请求。files -- (optional) Dictionary of 'name': file-like-objects (or {'name': file-tuple}) for multipart encoding upload. file-tuple can be a 2-tuple ('filename', fileobj), 3-tuple ('filename', fileobj, 'content_type') or a 4-tuple ('filename', fileobj, 'content_type', custom_headers), where 'content-type' is a string defining the content type of the given file and custom_headers a dict-like object containing additional headers to add for the file.438/5000  (可选)“名称”的字典:文件- like- object(或{' name ':file - tuple})，用于多部分编码上传。文件- tuple可以是一个2元组(文件名，fileobj)，3元组(文件名，fileobj，' content_type ')或一个4元组(' filename '，fileobj，' content_type '，custom_headers)，其中' content-type '是一个字符串，它定义了给定文件的内容类型和custom_headers，其中包含了一个类似于dict的对象，其中包含了添加文件的附加头文件。auth -- (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.(可选)Auth tuple来启用Basic /Digest /自定义HTTP Auth。timeout (float or tuple) -- (optional) How many seconds to wait for the server to send data before giving up, as a float, or a (connect timeout, read timeout) tuple.(可选)在放弃之前，等待服务器发送数据的时间是多少秒，作为一个浮点数，或者是一个(连接超时，读超时)元组。allow_redirects (bool) -- (optional) Boolean. Enable/disable GET/OPTIONS/POST/PUT/PATCH/DELETE/HEAD redirection. Defaults to True.(可选)布尔。启用/禁用GET /选项/ POST / PUT /补丁/删除/头重定向。默认值为True。proxies -- (optional) Dictionary mapping protocol to the URL of the proxy.(可选)字典映射协议到代理的URL。verify -- (optional) Either a boolean, in which case it controls whether we verify the server's TLS certificate, or a string, in which case it must be a path to a CA bundle to use. Defaults to True.(可选)一个布尔值，在这种情况下，它控制我们是否验证服务器的TLS证书，或者是一个字符串，在这种情况下，它必须是一个到CA包使用的路径。默认值为True。stream -- (optional) if False, the response content will be immediately downloaded.(可选)如果错误，将立即下载响应内容。cert -- (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair.(可选)如果字符串，路径到ssl客户机cert文件(. pem)。如果是Tuple(' cert '，' key ')对。'''# request()方法实例req = requests.request('GET', 'http://httpbin.org/get')print req# 得到 
     
      # 2、head()方法# requests.head(url, **kwargs)# Sends a HEAD request.  发送一个HEAD 请求。# Optional arguments that ``request`` takes.  请求获取的可选参数。r"""Sends a HEAD request.   :param url: URL for the new :class:`Request` object.   :param \*\*kwargs: Optional arguments that ``request`` takes.     :return: :class:`Response 
      
       ` object     :rtype: requests.Response   """# head()方法实例req = requests.head('http://httpbin.org/get')print req# 得到 
       
        # 3、get()方法# requests.get(url, params=None, **kwargs)[源代码]# Sends a GET request.## 参数:# url -- URL for the new Request object.# params -- (optional) Dictionary or bytes to be sent in the query string for the Request.# **kwargs -- Optional arguments that request takes.# 返回:# Response object## 返回类型:# requests.Response# get()方法实例req = requests.get('http://httpbin.org/get')print req# 得到 
        
         # 4、post()方法# requests.post(url, data=None, json=None, **kwargs)[源代码]# Sends a POST request.## 参数:# url -- URL for the new Request object.# data -- (optional) Dictionary (will be form-encoded), bytes, or file-like object to send in the body of the Request.# json -- (optional) json data to send in the body of the Request.# **kwargs -- Optional arguments that request takes.# 返回:# Response object## 返回类型:# requests.Response# post()方法实例req = requests.post('http://httpbin.org/get')print req# 得到 
         
          # 5、put()方法# requests.put(url, data=None, **kwargs)[源代码]# Sends a PUT request.## 参数:# url -- URL for the new Request object.# data -- (optional) Dictionary (will be form-encoded), bytes, or file-like object to send in the body of the Request.# json -- (optional) json data to send in the body of the Request.# **kwargs -- Optional arguments that request takes.# 返回:# Response object## 返回类型:# requests.Response# 6、patch()方法# requests.patch(url, data=None, **kwargs)[源代码]# Sends a PATCH request.## 参数:# url -- URL for the new Request object.# data -- (optional) Dictionary (will be form-encoded), bytes, or file-like object to send in the body of the Request.# json -- (optional) json data to send in the body of the Request.# **kwargs -- Optional arguments that request takes.# 返回:# Response object## 返回类型:# requests.Response# 7、delete()方法# requests.delete(url, **kwargs)[源代码]# Sends a DELETE request.## 参数:# url -- URL for the new Request object.# **kwargs -- Optional arguments that request takes.# 返回:# Response object## 返回类型:# requests.Response#