有了它，我们似乎可以告别 Stack Overflow 了？
“
阅读本文大概需要 5 分钟。
”先问大家一个问题，如果你撸代码的过程中遇到了一个问题不知道怎么解决，你一般会怎么办？
那当然是搜了，去哪里搜呢？
比如这里我就想知道 Python 里面怎么使用 requests 怎么上传文件，我可能就直接 Google 一下，结果有很多，比如官方文档，Stack Overflow 等等，然后一个个去查。
比如我可能就会输入关键词 python requests upload file ，查到的结果类似如下：
这里给我的第一个结果是 Stack Overflow，结果链接为 https://stackoverflow.com/questions/22567306/python-requests-file-upload，我把它点开，然后找到最高票的答案。
这里最高票的答案如图琐事，然后把它的代码 copy 下来试试看看，然后就跑通了。
不过似乎还是有一点麻烦的？开浏览器，开 Google 或 Stack Overflow，找最高票答案试试。
介绍
今天给大家介绍一个神器，叫做 howdoi，有了它，似乎我们就可以告别 Stack Overflow 了。
下面我们就先来看看 howdoi 能做点什么，安装了之后，我们就能直接输入这样的命令，比如：
howdoi python requests upload file
它给我的返回结果就是这样：
files = {'upload_file': open('file.txt','rb')}
values = {'DB': 'photcat', 'OUT': 'csv', 'SHORT': 'short'}
r = requests.post(url, files=files, data=values)
比如我想搜 python 怎么发送 POST 请求，输入这样的命令：
howdoi python requests post
返回结果就是这样：
>>> import requests
>>> r = requests.post('http://httpbin.org/post', json={"key": "value"})
>>> r.status_code
200
>>> r.json()
{'args': {},
'data': '{"key": "value"}',
'files': {},
'form': {},
'headers': {'Accept': '*/*',
'Accept-Encoding': 'gzip, deflate',
'Connection': 'close',
'Content-Length': '16',
'Content-Type': 'application/json',
'Host': 'httpbin.org',
'User-Agent': 'python-requests/2.4.3 CPython/3.4.0',
'X-Request-Id': 'xx-xx-xx'},
'json': {'key': 'value'},
'origin': 'x.x.x.x',
'url': 'http://httpbin.org/post'}
看起来还不错对不对。
比如我想搜 Python 里面怎么把 timestamp 转 datetime，输入这样的命令：
howdoi python timestamp to datetime
返回结果就是这样：
from datetime import datetime
ts = int("1284101485")
# if you encounter a "year is out of range" error the timestamp
# may be in milliseconds, try `ts /= 1000` in that case
print(datetime.utcfromtimestamp(ts).strftime('%Y-%m-%d %H:%M:%S'))
那 Java 它会吗？试试看：
howdoi java timestamp to datetime
返回结果就是这样：
Timestamp stamp = new Timestamp(System.currentTimeMillis());
Date date = new Date(stamp.getTime());
System.out.println(date);
有点牛逼啊，搜啥答案都有，准确率还蛮高。
以上是怎么实现的？没错，就是借助于 howdoi 这个项目。
howdoi
那么这个 howdoi 究竟是个什么？我们 GitHub 上就能找到，链接地址为：https://github.com/gleitz/howdoi。
看下简介：
Are you a hack programmer? Do you find yourself constantly Googling for how to do basic programming tasks?
Suppose you want to know how to format a date in bash. Why open your browser and read through blogs (risking major distraction) when you can simply stay in the console and ask howdoi.
意思就是说，如果你想搜一些编程相关的解决方案，我们可以不用再去开浏览器，然后再去读文档或者博客，你可以通过 howdoi 就能直接得到答案。
操作就是上面我们讲的。
howdoi 是一个 Python 项目，我们可以 pip 命令安装：
pip3 install howdoi
如果是 Mac 的话，推荐使用 brew 来安装：
brew install howdoi
安装完了就能使用 howdoi 命令了。
完整用法如下：
usage: howdoi.py [-h] [-p POS] [-a] [-l] [-c] [-j] [-n NUM_ANSWERS] [-C] [-v] [-e ENGINE] QUERY [QUERY ...]
instant coding answers via the command line
positional arguments:
QUERY the question to answer
optional arguments:
-h, --help show this help message and exit
-p POS, --pos POS select answer in specified position (default: 1)
-a, --all display the full text of the answer
-l, --link display only the answer link
-c, --color enable colorized output
-j, --json-output return answers in raw json format, to pretty print try 'howdoi pretty print json command line'
-n NUM_ANSWERS, --num-answers NUM_ANSWERS
number of answers to return
-C, --clear-cache clear the cache
-v, --version displays the current version of howdoi
-e ENGINE, --engine ENGINE change search engine for this query only. Currently supported engines: google (default), bing, duckduckgo.
但一般来说就按照前文所演示的直接输入问题就行了。
比如看看怎样在 Python 中打印 traceback，这么搜：
howdoi print stack trace python
结果如下：
import traceback
try:
raise TypeError("Oups!")
except Exception, err:
try:
raise TypeError("Again !?!")
except:
pass
traceback.print_exc()
不错不错。
原理
这时候大家可能就有疑问了，这到底是怎么实现的？为什么还能这么精准。
其实看下源码就知道了，我们稍微扒下看看，其实源码就都在这里了：https://github.com/gleitz/howdoi/blob/master/howdoi/howdoi.py。
先看看一上来定义了这么多：
SUPPORTED_SEARCH_ENGINES = ('google', 'bing', 'duckduckgo')
URL = os.getenv('HOWDOI_URL') or 'stackoverflow.com'
USER_AGENTS = ('Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:11.0) Gecko/20100101 Firefox/11.0',
'Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:22.0) Gecko/20100 101 Firefox/22.0',
'Mozilla/5.0 (Windows NT 6.1; rv:11.0) Gecko/20100101 Firefox/11.0',
('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_4) AppleWebKit/536.5 (KHTML, like Gecko) '
'Chrome/19.0.1084.46 Safari/536.5'),
('Mozilla/5.0 (Windows; Windows NT 6.1) AppleWebKit/536.5 (KHTML, like Gecko) Chrome/19.0.1084.46'
'Safari/536.5'), )
SEARCH_URLS = {
'bing': SCHEME + 'www.bing.com/search?q=site:{0}%20{1}&hl=en',
'google': SCHEME + 'www.google.com/search?q=site:{0}%20{1}&hl=en',
'duckduckgo': SCHEME + 'duckduckgo.com/?q=site:{0}%20{1}&t=hj&ia=web'
}
貌似我们就懂了什么，这些答案是从搜索引擎得来的。
然后我们再扒一扒，又看到一个关键的 _get_result 方法，定义如下：
def _get_result(url):
try:
return howdoi_session.get(url, headers={'User-Agent': _random_choice(USER_AGENTS)},
proxies=get_proxies(),
verify=VERIFY_SSL_CERTIFICATE).text
except requests.exceptions.SSLError as e:
_print_err('Encountered an SSL Error. Try using HTTP instead of '
'HTTPS by setting the environment variable "HOWDOI_DISABLE_SSL".\n')
raise e
看到了吧，这里就是一次 requests 发起了 get 请求，那么这个 url 究竟是怎么来的呢？我们再顺着找下调用 _get_result 方法的地方：
def _get_links(query):
search_engine = os.getenv('HOWDOI_SEARCH_ENGINE', 'google')
search_url = _get_search_url(search_engine)
result = _get_result(search_url.format(URL, url_quote(query)))
if _is_blocked(result):
_print_err('Unable to find an answer because the search engine temporarily blocked the request. Please wait a few minutes or select a different search engine.')
raise BlockError("Temporary block by search engine")
html = pq(result)
return _extract_links(html, search_engine)
这里就是 _get_links 方法调用了 _get_result 方法，就是 search_url 的格式化结果，传入了 URL 还有 query，其中 search_url 是 _get_search_url 方法传入了 search_engine，search_engine 是通过环境变量 HOWDOI_SEARCH_ENGINE 获取的，默认是 google。
好，那顺着再看看 _get_search_url 的实现，定义如下：
def _get_search_url(search_engine):
return SEARCH_URLS.get(search_engine, SEARCH_URLS['google'])
很明显了，就是 SEARCH_URLS 里面定义的，所以最后，我们就可以得到如下的搜索 URL：
www.google.com/search?q=site:stackoverflow.com%20{query}&hl=en
这里 query 就是我们搜索的内容，比如搜索 print stack trace python，构造的 URL 就是：
https://www.google.com/search?q=site:stackoverflow.com%20print%20stack%20trace%20python&hl=en
我们访问一下就是这样的结果：
其实这就是借助 Google 搜索了 Stack Overflow 的内容，搜索了 python 关键字的内容。
然后 howdoi 就是提取了其中的 TOP 答案，然后解析一下返回即可。
彩蛋
既然 howdoi 这么吊，我们来问它一个困扰大家多年的问题吧：
howdoi how to find girlfriend
回答：
Sorry, couldn't find any help with that topic
什么？这都不会！摔！
崔庆才丨静觅
隐形字
同名公众号「崔庆才丨静觅」
在这里分享自己的一些经验、想法和见解。
长按识别二维码关注
作者：崔庆才
排版：崔庆才
好文和朋友一起看~