[心得] 我如何在 GitHub 上拿到四千颗星

楼主: eliang   2016-07-07 18:52:09
两个月前我在 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。
作者: landlord (91)   2016-07-07 18:55:00
great!
作者: Masakiad (Masaki)   2016-07-07 18:59:00
开源推
作者: lensuper (莫三)   2016-07-07 19:07:00
强者
作者: chiwa (我是青蛙,不是王子^_^)   2016-07-07 19:10:00
高手!!
作者: ntddt (灭顶,降公投罢免门槛)   2016-07-07 19:12:00
强者狂推 让世界看到台湾软实力
作者: crossdunk (推嘘自如)   2016-07-07 19:13:00
4000!!!!!!!!!!!!
作者: SMNOONMS   2016-07-07 19:14:00
推开源
作者: SuM0m0 (Part Time Player)   2016-07-07 19:16:00
赞耶 看起来很不错
作者: rodion (r-kan/reminder)   2016-07-07 19:20:00
感谢分享经验谈:>
作者: mmm951 (白天天气好)   2016-07-07 19:24:00
推分享
作者: hSATAC (cAt Ash)   2016-07-07 19:27:00
作者: feeling543 (ifeelings)   2016-07-07 19:28:00
推!
作者: sdf611097 (犹若洗苦)   2016-07-07 19:29:00
作者: max241 (养生之道)   2016-07-07 19:31:00
GOD
作者: cookie1115 (大饼)   2016-07-07 19:32:00
作者: aa06697 (todo se andarà)   2016-07-07 19:36:00
太神啦
作者: y2468101216 (芸)   2016-07-07 19:37:00
作者: minikai (一肚子拐)   2016-07-07 19:41:00
太神了! 已跪!
作者: MoriUmi (森海)   2016-07-07 19:48:00
推 有空来用用看 感觉很实用 手打指令超容易打错的
作者: jlhc (H)   2016-07-07 19:54:00
推一个!!!
作者: fake01 (假面超人)   2016-07-07 20:02:00
太神辣
作者: Zeusken (Rushken)   2016-07-07 20:04:00
好强
作者: sky75217 (瑞比特)   2016-07-07 20:07:00
作者: TKSHADE (雨怎么下不停)   2016-07-07 20:16:00
强者~~!!
作者: longlyeagle (长鹰宝宝实验室)   2016-07-07 20:21:00
push
作者: Aaronter   2016-07-07 20:26:00
感谢支援
作者: Hevak (Arthow Eshes)   2016-07-07 20:29:00
有在trending看到,原来是台湾人@@! cool
作者: chung928 (chung928)   2016-07-07 20:30:00
推强者!
作者: Yshuan (倚絃)   2016-07-07 20:30:00
朝圣!!
作者: bowin (尽其在我)   2016-07-07 20:33:00
推!Good job!! :-)
作者: bab7171   2016-07-07 20:49:00
作者: FLAMEDDD   2016-07-07 20:53:00
请问“fork它”是什么意思阿 谢谢
作者: SmileJoS ( O.o)   2016-07-07 20:56:00
推推推,好强
作者: wuliou (wuliou)   2016-07-07 20:56:00
太强辣
作者: vi000246 (Vi)   2016-07-07 20:58:00
楼主: eliang   2016-07-07 21:00:00
fork意思是拿别人的code改成另一个东西没想到PTT广告效益也很好,又多了好多星星,感谢乡民支持
作者: A4P8T6X9 (残废的名侦探)   2016-07-07 21:06:00
作者: gozule (好冷啊~~)   2016-07-07 21:12:00
open source果然高手如云
作者: javy0521   2016-07-07 21:16:00
推!
作者: Zarmy (扎米)   2016-07-07 21:22:00
强者推!
作者: nfsong (圖書館我來了)   2016-07-07 21:24:00
作者: FLAMEDDD   2016-07-07 21:24:00
感谢 eliang 解释
作者: zerofinal (人生~)   2016-07-07 21:34:00
作者: n080925 (Lonely Journey)   2016-07-07 21:40:00
强者请受我一拜!!
作者: tongzhou (路过的小牛)   2016-07-07 21:43:00
推强者
作者: tnav ((''))   2016-07-07 21:48:00
cool
作者: alibuda174 (阿哩不达)   2016-07-07 21:49:00
作者: bobbyho (BobbyHo)   2016-07-07 21:50:00
推 OpenSource
作者: imindflow (imindflow)   2016-07-07 21:53:00
作者: gerojeng (阿乐 - 反省再出发)   2016-07-07 21:55:00
强者
作者: jily (吉利)   2016-07-07 22:14:00
超屌的!!!!
作者: b510336 (风的细语)   2016-07-07 22:35:00
太神啦~
作者: wowna (wowna)   2016-07-07 22:35:00
作者: x4base (RU~)   2016-07-07 22:42:00
朝圣推~~
作者: ThxThx (洗洗睡)   2016-07-07 22:45:00
路过推,太神了...
作者: lulufufu (lulufufu)   2016-07-07 22:46:00
神人推...
作者: Ekmund (是一只小叔)   2016-07-07 23:02:00
...
作者: yuanyu90221 (菜菜鸟)   2016-07-07 23:03:00
作者: Expsun (无限燃烧)   2016-07-07 23:09:00
作者: descent (“雄辩是银,沉默是金”)   2016-07-07 23:11:00
作者: fantasystar (小光先生)   2016-07-07 23:17:00
这难道是传说中的伊亮
作者: abc0922001 (中士abc)   2016-07-07 23:18:00
超强XDDD 开源推fork就是把别人盘子的牛肉夹道自己盘子上
作者: kakahikari (那不是我)   2016-07-07 23:53:00
作者: dali17dali17   2016-07-07 23:57:00
跪了
作者: johnny4753 (Li)   2016-07-08 00:10:00
实在太强拉 拜一下
作者: srxrrr (干!我是肌董)   2016-07-08 00:14:00
已跪QQ
作者: Ghosso (居关)   2016-07-08 00:31:00
是传说中的lab学长吗!
作者: PHEj (Vino)   2016-07-08 00:32:00
太神了 开源推!
作者: takingblue (takingblue)   2016-07-08 00:36:00
太强了!
作者: qrtt1 (有些事,有时候。。。)   2016-07-08 00:50:00
朝圣
作者: markbex (马克杯)   2016-07-08 00:59:00
作者: hydrogencl (荒费青春)   2016-07-08 01:44:00
github推!
作者: jammy50605 (小刀)   2016-07-08 02:14:00
太神啦
作者: Bright (璀璨的代价)   2016-07-08 02:16:00
神!
作者: retard (Baby baby~~)   2016-07-08 02:57:00
你老婆应该也是搞软件的~~ 好赞~~
作者: Sean64 (Sean)   2016-07-08 05:03:00
朝圣推 <(__)>
作者: timwu (Tim Wu)   2016-07-08 05:51:00
好久没在ptt回文啦.. 已star , parsimonious 是 PEG , 不能再叫它 CFG 了, http://go.shr.lc/29DVncS , PEG很辉煌的一役就是唐凤用parsec干完perl6, then 真希望 prompt-toolkit可以 port 到 GO 啊
作者: mirage7714 (C'est mon soeur.)   2016-07-08 08:09:00
强者推
作者: janice001 (真理)   2016-07-08 08:37:00
纯推
作者: mithuang (阿明)   2016-07-08 09:53:00
还告诉老婆能拿到多少星星XDD,好热血的感觉!!!
楼主: eliang   2016-07-08 09:59:00
@timwu 谢谢指正,大学没修过编译器,只在正规语言学过CFG
作者: abola921 (南港金城武)   2016-07-08 10:04:00
作者: decheng (bodhi)   2016-07-08 10:14:00
推呀~!强大~
作者: eva19452002 (^^)   2016-07-08 10:41:00
我连原po一根脚毛都比不上
作者: Argos (Big doge is watching u)   2016-07-08 10:51:00
推推!
作者: terry01333 (terry)   2016-07-08 11:10:00
推!
作者: jenesis (ゼネシス)   2016-07-08 11:16:00
真的 除了专案本身的品质以外宣传也是很重要的
作者: iamshiao (CircleHsiao)   2016-07-08 11:24:00
作者: jiaming (假命)   2016-07-08 12:26:00
作者: whitglint   2016-07-08 12:31:00
看起来不错,一定要用用看,给推!
作者: Zatarra ( )   2016-07-08 12:43:00
推!!
作者: hijkxyzuw (i,j,k) ×(x,y,z)   2016-07-08 12:45:00
原来是台湾人推!
作者: smallmac (洨麦克)   2016-07-08 13:05:00
作者: frank11118 (想睡觉)   2016-07-08 13:08:00
强者
作者: ian90911 (xopowo)   2016-07-08 13:16:00
太神啦
作者: andreli (小狗跟正妹是我的死穴)   2016-07-08 13:58:00
推!
作者: tomroy (离题辉。)   2016-07-08 15:13:00
作者: doranako (真爱无限)   2016-07-08 15:37:00
作者: TEMPEST (小民)   2016-07-08 17:21:00
真的太厉害了
作者: popxpopxpop (爆爆爆)   2016-07-08 18:19:00
fork推
作者: wadeabc (潜水夫)   2016-07-08 18:52:00
作者: drinks (资深鲁蛇)   2016-07-08 19:24:00
厉害!
作者: promiseone (妄想飞)   2016-07-08 19:32:00
作者: LV999 (封顶)   2016-07-08 19:40:00
好威
作者: tenth ( 哈哈哈)   2016-07-08 21:00:00
推~
作者: netsphere (Ruby&Waku)   2016-07-08 21:26:00
推,厉害
作者: gechenchen92 (诚恳哥)   2016-07-08 22:12:00
推真强者和分享
作者: Sidney0503 (Sidney0503)   2016-07-08 22:13:00
只能推了
作者: kenn7   2016-07-08 22:24:00
前辈
作者: kiki86151 (鲁饭)   2016-07-08 23:04:00
作者: easybaby   2016-07-09 00:16:00
作者: enamor753 (enamor753)   2016-07-09 01:14:00
朝圣
作者: polo8214 (ANDY)   2016-07-09 01:27:00
感谢分享
作者: heihei   2016-07-09 01:41:00
推!
作者: bobju (枯藤老树昏鸦)   2016-07-09 01:48:00
赞~
作者: xdraculax (首席怪叔叔)   2016-07-09 08:31:00
作者: lovdkkkk (dk)   2016-07-09 11:22:00
(y)
作者: O87 (土鬼阝匋阝可!)   2016-07-09 13:01:00
推推
作者: wadeabc (潜水夫)   2016-07-09 16:06:00
这世界就需要你这种人,哪像老屁股领钱不做事
作者: loveisth520   2016-07-09 19:30:00
已跪
作者: shibin (喜饼)   2016-07-10 12:07:00
推分享
作者: aacs0130 (湛靈)   2016-07-10 17:24:00
强者,推推
作者: BlazarArc (Midnight Sun)   2016-07-11 10:21:00
作者: lukedoomer (I want nothing but you)   2016-07-11 13:38:00
这东西的用处应该就只是测试透过HTTP传输的API?我觉得这CLI很棒,但我想知道是不是有我不知道的用处
作者: akito117 (宗益)   2016-07-11 13:52:00
楼主: eliang   2016-07-11 15:19:00
@lukedoomer 主要用途就是测试HTTP API没错另一用途是用curl或httpie指令为例告诉别人如何呼叫API
作者: wanlinlin (wanlinlin)   2016-07-11 16:30:00
推神
作者: andy5564 (笛)   2016-07-12 08:30:00
作者: secondDim ( 祈求备取会上)   2016-07-12 09:13:00
跪着推了
作者: Csy065 (小伟大人)   2016-07-14 00:01:00
有神快拜
作者: supertalker (威哥)   2016-07-14 11:09:00
朝圣推
作者: uly (游历)   2016-07-14 19:13:00
跪了
作者: et282523 (不屈斗志)   2016-07-14 21:22:00
推~
作者: bananayen (Jeff)   2016-07-18 16:26:00
推强者

Links booklink

Contact Us: admin [ a t ] ucptt.com