Requests 库帮助文档（小甲鱼版）

小甲鱼

为什么小甲鱼要重新翻译该文档？

呃……你们如果看过非转基因的、纯天然植物饲养的官方中文文档应该就知道为什么了：



不是我闲得蛋疼，是我觉得这样的官方文档，你们也看不下去……

再说了，我们还有大家所喜闻乐见的鱼式冷幽默，哇咔咔

好了，以下是正文：

Requests 是唯一一个比 Python 亲儿子还好用的 HTTP 库，无毒无副作用，聪明的程序员必备家居良品！

注意：

我们更提倡你使用 Python3 而不是 Python2。如果你此时还在用 Python2，那么你可能需要考虑升级你的应用程序了，因为 Python2 已经 OUT 了；如果你使用的是 Python3，恭喜，你是一枚与时俱进的程序员！

—— Kenneth Reitz

下面，先让你们见识一下 Requests 的强大：

1. >>> import requests
   
2. >>> r = requests.get('https://api.github.com/user', auth=('user', 'pass'))
   
3. >>> r.status_code
   
4. 200
   
5. >>> r.headers['content-type']
   
6. 'application/json; charset=utf8'
   
7. >>> r.encoding
   
8. 'utf-8'
   
9. >>> r.text
   
10. u'{"type":"User"...'
    
11. >>> r.json()
    
12. {u'private_gists': 419, u'total_private_repos': 77, ...}

复制代码

实现类似功能，Python 的亲儿子要麻烦许多（注意，上面 requests 是一句代码而已）：

1. #!/usr/bin/env python
   
2. # -*- coding: utf-8 -*-
   
3. 
   
4. import urllib2
   
5. 
   
6. gh_url = 'https://api.github.com'
   
7. 
   
8. req = urllib2.Request(gh_url)
   
9. 
   
10. password_manager = urllib2.HTTPPasswordMgrWithDefaultRealm()
    
11. password_manager.add_password(None, gh_url, 'user', 'pass')
    
12. 
    
13. auth_manager = urllib2.HTTPBasicAuthHandler(password_manager)
    
14. opener = urllib2.build_opener(auth_manager)
    
15. 
    
16. urllib2.install_opener(opener)
    
17. 
    
18. handler = urllib2.urlopen(req)
    
19. 
    
20. print handler.getcode()
    
21. print handler.headers.getheader('content-type')
    
22. 
    
23. # ------
    
24. # 200
    
25. # 'application/json'

复制代码

Requests 允许你发送纯粹的 HTTP/1.1 请求，无需额外的操作。也就是说不需要在 ULR 中添加额外的查询语句，或者对 POST 提交的数据进行编码。另外，Keep-alive 和 HTTP 连接池都是 100% 自动进行的。Requests 能这么牛逼，都是多亏了 urllib3 的助攻！


功能特性

Requests 完全满足当今 web 的需求：

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

Requests 正式支持 Python 2.6-2.7 和 Python 3.4-3.7，并且在 PyPy 上可以很好的运行哦~


下面这些牛逼的团队正在使用我们的产品：

Twitter、Spotify、Microsoft、Amazon、Lyft、BuzzFeed、Reddit、NSA、英国皇室、Amazon、Google、Twilio、Mozilla、Heroku、PayPal、NPR、奥巴马政府、Transifex、Native Instruments、Washington Post、Twitter、SoundCloud、Kippt、Readability、以及若干不愿意公开身份的联邦政府机构都在内部偷偷地使用我们的产品。

Armin Ronacher ——
Requests 诠释了什么才是完美的 API。

Matt DeBoard ——
我要想办法把 Kenneth Reitz 的 requests 一字不漏的做成纹身。

Daniel Greenfeld ——
感谢 Kenneth Reitz 的 Requests 库，刚刚用 10 行代码就完爆了原来 1200 行意大利面代码，今天真是爽呆了！

Kenny Meyers ——
Python HTTP：疑惑与否，都去用 Requests 吧。简单、优美，并符合 Python 风格。

Requests 是 Python 所有库中最受欢迎的一个，不是我吹，每个月有 13,000,000 下载量，全世界优秀的人都在使用它，你还等什么？！

哦，对了，你可能早就听人们这么描述程序员 ——“话少钱多死得早，毫无情趣女友跑”……

但伟大的 Kenneth Reitz（Requests 的作者）却扛起厚厚的一块板砖，用实际行动生疼的砸了所有人的脸。

告诉世界：程序员才是最牛逼的潜力股！

（TIPS：点击页面上方的目录可以跳转到其他章节哦^_^）

不二如是

理解Web程序之间“通信的基本协议”相当重要

因为它让我们理解了Web应用程序的内部工作.

#鱼C出品，又要造福一方百姓了

alltolove

使用这个太简单好用了

旋转风

甲鱼出品，必属精品

walter1981

好东西呀，看一下

walter1981

小甲鱼，有没有专门讲request的课，哪怕一节也可以。期待中

小甲鱼

walter1981 发表于 2017-9-12 16:25
小甲鱼，有没有专门讲request的课，哪怕一节也可以。期待中

你看我都在做文档了，肯定是有的啦~~~

llxdgchk

支持了。顶一下。。。

qwc3000

好希望我能有50鱼币啊 ……

一叶知秋非本意

好想学习啊 但是没鱼币 刚看了 怎么弄豆瓣爬取TOP250 但是request 模块不会弄 哎伤心

一颗青豆

请赐我一只雄性程序猿, 会解忧会卖萌的那种///>..<///

hostmi

一颗青豆 发表于 2017-10-18 12:08
请赐我一只雄性程序猿, 会解忧会卖萌的那种///>..

会好多好多。。。你自己慢慢发现

MiraiKuna

开心，正在学习爬虫。使用新模块大概能节省不少繁琐的功夫？

黑白色的枫

30鱼币

Beavan

下载来了学习学习

古尔丹

怎么下载啊

zhouzhouanker

晕了,我是新手,哪里是终端啊,,,,,,能不能截个屏...

瞬秒爆加速

刚学会一些BeautifulSoup,requests,就看见教程更新了

流月飞星

eXps

小甲鱼太棒啦