※ [本文转录自 Soft_Job 看板 #1NVZHc9P ]
作者: eliang () 看板: Soft_Job
标题: [心得] 我如何在 GitHub 上拿到四千颗星
时间: Thu Jul 7 18:52:09 2016
两个月前我在 GitHub 发表了一个开源专案，发表后一夕爆红，在一开始的 24 小时内就
得到 1200+ 颗星，目前已累积 4000+ 颗星。这个专案名叫 HTTP Prompt，网址是：
https://github.com/eliangcs/http-prompt
我想在这里分享一下它的开发故事。
这一切要先从 Vertica 讲起。没多久前我的工作几乎每天都会使用 Vertica，Vertica
是一个强大的数据库，但它官方的客户端程式（vsql）一点都不强大。另一个 GUI 的选择
DbVisualizer 也是难用到爆。
我就想起 PostgreSQL 那边有一个叫 pgcli 的好物，我想如果 fork 它，应该不需要太大
功夫就能把它改成 Vertica 版本。最后也如我所想，没花几天就写出了 vcli：
https://github.com/dbcli/vcli
我还联络了 pgcli 的原作者，告诉他“我用你的东西写了另一个专案”，他很高兴的帮我
在他网站上宣传。但 Vertica 实在是小众，所以 vcli 并没有得到很多注意。但至少有了
vcli，我终于能每天快快乐乐的使用 Vertica 了。
vcli、pgcli、mycli（for MySQL）其实都是建于一个叫 prompt-toolkit 的 Python 套件
之上。有了 prompt-toolkit 的加持，任何命令列程式因为有了自动完成和语法高亮，都
会变得超酷炫，去它的首页看看有多少专案使用它就知道了：
https://github.com/jonathanslenders/python-prompt-toolkit
当时有一阵子工作常会需要连接 HTTP/REST API，这应该也是很多人工作的一部分，我相
信大部分人应该都是用 Postman 这类 GUI 工具，但身为一个什么都要尽量用命令列接口
的 hacker，用 GUI 实在有点 low，而且跟 terminal 切换起来也不方便。所以我就选择
使用类似 curl 的 HTTPie。使用 HTTPie 的缺点是常需要打很多重复的字，不像 Postman
会帮你记住之前的状态，我想如果 HTTPie 或 curl 有互动模式就好了。我调查了一下，
原来早在一年前就有人这么想了：
https://github.com/jkbrzt/httpie/issues/343
甚至在五年前就有人写出我心目中理想的工具了：
https://github.com/chrislongo/HttpShell
但 HTTPie 实在设计得太完美让我不想放弃它，而且 HttpShell 似乎也没在更新，所以我
也就不考虑使用 HttpShell。
“任何命令列程式受了 prompt-toolkit 加持，都会变得超酷炫”，那我何不站在巨人肩
膀上，结合 HTTPie 和 prompt-toolkit，写出一个有自动完成和语法高亮的 HTTP client
，不要求使用者放弃完美的 HTTPie，肯定有卖点。
于是我开始着手开发 HTTP Prompt，我还告诉我老婆，我这写完至少会在 GitHub 拿一千
颗星星。我当时不是随便推算的。因为 pgcli 都有四千多颗星了，用 HTTP 的人一定多过
PostgreSQL，所以如果我执行得好，吸引一千颗星星应该不是问题。
一开始卡最久是我想找出一个完美的写法，使得自动完成、语法高亮、指令解析三大模组
能用一个统一的 context-free grammar（CFG）解决，但 prompt-toolkit 的作者告诉我
这个想法不切实际：
https://github.com/jonathanslenders/python-prompt-toolkit/issues/276
所以最终只有指令解析是以 CFG 实做，另两个模组则分别土法炼钢。CFG parser 一开始
也让我有点头痛，幸亏有人写了一个现成的 parser：
https://github.com/erikrose/parsimonious
读过 parsimonious 的程式码，我只能说这套件的作者功力深厚，没有编译器或正规语言
的基础还真写不出这样的东西。
prompt-toolkit 已解决大部分的难题，所以除了 CFG 之外就没什么特别困难的地方了。
我前后大概花了三个礼拜完成基本功能，即发布到 Reddit/programming，没多久就登上热
门第一名：
https://www.reddit.com/r/programming/comments/4k1l2o
Reddit 广告效益真的很强，HTTP Prompt 初期的流量都是靠 Reddit 吸引进来的。之后星
星数愈增愈快，几乎是每一分钟都就多一颗星，也成功登上 GitHub Trending 第一名，老
婆还帮我拍了一张照片做纪念：
http://imgur.com/4zKkv98
Issue 和 pull request 也跟着星星一起来，其中有不少不错的功能建议，我也陆续加入
，在后面几个版本释出。
开发开源专案是很好玩的，当你知道很多人正在使用你写的软件、给你回馈，你会觉得你
在做一件有意义的事。希望这篇文章能鼓励更多人使用 HTTP Prompt，也能帮助到一些想
参与开源专案的人，当然最好是可以贡献到 HTTP Prompt :P。