作者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。
--
※ 发信站: 批踢踢实业坊(ptt.cc), 来自: 1.162.127.191
※ 文章网址: https://webptt.com/cn.aspx?n=bbs/Soft_Job/M.1467888742.A.259.html
1F:推 landlord: great! 07/07 18:55
2F:推 Masakiad: 开源推 07/07 18:59
3F:推 lensuper: 强者 07/07 19:07
4F:推 chiwa: 高手!! 07/07 19:10
5F:推 ntddt: 强者狂推 让世界看到台湾软实力 07/07 19:12
6F:推 crossdunk: 4000!!!!!!!!!!!! 07/07 19:13
7F:推 SMNOONMS: 推开源 07/07 19:14
8F:推 SuM0m0: 赞耶 看起来很不错 07/07 19:16
9F:推 rodion: 感谢分享经验谈:> 07/07 19:20
10F:推 mmm951: 推分享 07/07 19:24
11F:推 hSATAC: 强 07/07 19:27
12F:推 feeling543: 推! 07/07 19:28
13F:推 sdf611097: 推 07/07 19:29
14F:推 max241: GOD 07/07 19:31
15F:推 cookie1115: 强 07/07 19:32
16F:推 aa06697: 太神啦 07/07 19:36
17F:推 y2468101216: 推 07/07 19:37
18F:推 minikai: 太神了! 已跪! 07/07 19:41
19F:推 MoriUmi: 推 有空来用用看 感觉很实用 手打指令超容易打错的 07/07 19:48
20F:推 dreamnook: 07/07 19:53
21F:推 jlhc: 推一个!!! 07/07 19:54
22F:推 fake01: 太神辣 07/07 20:02
23F:推 Zeusken: 好强 07/07 20:04
24F:推 sky75217: 推 07/07 20:07
25F:推 TKSHADE: 强者~~!! 07/07 20:16
26F:推 longlyeagle: push 07/07 20:21
27F:推 Aaronter: 感谢支援 07/07 20:26
28F:推 Hevak: 有在trending看到,原来是台湾人@@! cool 07/07 20:29
29F:推 chung928: 推强者! 07/07 20:30
30F:推 Yshuan: 朝圣!! 07/07 20:30
31F:推 bowin: 推!Good job!! :-) 07/07 20:33
32F:推 bab7171: 推 07/07 20:49
33F:推 FLAMEDDD: 请问「fork它」是甚麽意思阿 谢谢 07/07 20:53
34F:推 SmileJoS: 推推推,好强 07/07 20:56
35F:推 wuliou: 太强辣 07/07 20:56
36F:推 vi000246: 推 07/07 20:58
37F:→ eliang: fork意思是拿别人的code改成另一个东西 07/07 21:00
38F:→ eliang: 没想到PTT广告效益也很好,又多了好多星星,感谢乡民支持 07/07 21:02
39F:推 A4P8T6X9: 推 07/07 21:06
40F:推 gozule: open source果然高手如云 07/07 21:12
41F:推 javy0521: 推! 07/07 21:16
42F:推 Zarmy: 强者推! 07/07 21:22
43F:推 nfsong: 推 07/07 21:24
44F:推 FLAMEDDD: 感谢 eliang 解释 07/07 21:24
45F:推 zerofinal: 推 07/07 21:34
46F:推 n080925: 强者请受我一拜!! 07/07 21:40
47F:推 tongzhou: 推强者 07/07 21:43
48F:推 tnav: cool 07/07 21:48
49F:推 alibuda174: 推 07/07 21:49
50F:推 bobbyho: 推 OpenSource 07/07 21:50
51F:推 imindflow: 强 07/07 21:53
52F:推 gerojeng: 强者 07/07 21:55
53F:推 jily: 超屌的!!!! 07/07 22:14
54F:推 b510336: 太神啦~ 07/07 22:35
55F:推 wowna: 推 07/07 22:35
56F:推 x4base: 朝圣推~~ 07/07 22:42
57F:推 ThxThx: 路过推,太神了... 07/07 22:45
58F:推 lulufufu: 神人推... 07/07 22:46
59F:推 Ekmund: ... 07/07 23:02
60F:推 yuanyu90221: 推 07/07 23:03
61F:推 Expsun: 推 07/07 23:09
62F:推 descent: 推 07/07 23:11
63F:→ fantasystar: 这难道是传说中的伊亮 07/07 23:17
64F:推 abc0922001: 超强XDDD 开源推 07/07 23:18
65F:推 abc0922001: fork就是把别人盘子的牛肉夹道自己盘子上 07/07 23:24
66F:推 kakahikari: 猛 07/07 23:53
67F:推 dali17dali17: 跪了 07/07 23:57
68F:推 johnny4753: 实在太强拉 拜一下 07/08 00:10
69F:推 srxrrr: 已跪QQ 07/08 00:14
70F:推 Ghosso: 是传说中的lab学长吗! 07/08 00:31
71F:推 PHEj: 太神了 开源推! 07/08 00:32
72F:推 takingblue: 太强了! 07/08 00:36
73F:推 qrtt1: 朝圣 07/08 00:50
74F:推 markbex: 推 07/08 00:59
75F:推 hydrogencl: github推! 07/08 01:44
76F:推 jammy50605: 太神啦 07/08 02:14
77F:推 Bright: 神! 07/08 02:16
78F:推 retard: 你老婆应该也是搞软体的~~ 好赞~~ 07/08 02:57
79F:推 Sean64: 朝圣推 <(__)> 07/08 05:03
80F:推 timwu: 好久没在ptt回文啦.. 已star , parsimonious 是 PEG , 不能 07/08 05:51
82F:→ timwu: 役就是唐凤用parsec干完perl6, then 真希望 prompt-toolkit 07/08 06:01
83F:→ timwu: 可以 port 到 GO 啊 07/08 06:01
84F:推 mirage7714: 强者推 07/08 08:09
85F:推 janice001: 纯推 07/08 08:37
86F:推 mithuang: 还告诉老婆能拿到多少星星XDD,好热血的感觉!!! 07/08 09:53
87F:→ eliang: @timwu 谢谢指正,大学没修过编译器,只在正规语言学过CFG 07/08 09:59
88F:推 abola921: 推 07/08 10:04
89F:推 decheng: 推呀~!强大~ 07/08 10:14
90F:→ eva19452002: 我连原po一根脚毛都比不上 07/08 10:41
91F:推 Argos: 推推! 07/08 10:51
92F:推 terry01333: 推! 07/08 11:10
93F:推 jenesis: 真的 除了专案本身的品质以外宣传也是很重要的 07/08 11:16
94F:推 iamshiao: 推 07/08 11:24
95F:推 jiaming: 推 07/08 12:26
96F:推 whitglint: 看起来不错,一定要用用看,给推! 07/08 12:31
97F:推 Zatarra: 推!! 07/08 12:43
98F:推 hijkxyzuw: 原来是台湾人推! 07/08 12:45
99F:推 smallmac: 推 07/08 13:05
100F:推 frank11118: 强者 07/08 13:08
101F:推 ian90911: 太神啦 07/08 13:16
102F:推 andreli: 推! 07/08 13:58
103F:推 tomroy: 猛 07/08 15:13
104F:推 doranako: 推 07/08 15:37
105F:推 TEMPEST: 真的太厉害了 07/08 17:21
106F:推 popxpopxpop: fork推 07/08 18:19
107F:推 wadeabc: 推 07/08 18:52
108F:推 drinks: 厉害! 07/08 19:24
109F:推 promiseone: 推 07/08 19:32
110F:推 LV999: 好威 07/08 19:40
111F:推 tenth: 推~ 07/08 21:00
112F:推 netsphere: 推,厉害 07/08 21:26
113F:推 gechenchen92: 推真强者和分享 07/08 22:12
114F:推 Sidney0503: 只能推了 07/08 22:13
115F:推 kenn7: 前辈 07/08 22:24
116F:推 kiki86151: 推 07/08 23:04
117F:推 easybaby: 推 07/09 00:16
118F:推 enamor753: 朝圣 07/09 01:14
119F:推 polo8214: 感谢分享 07/09 01:27
120F:推 heihei: 推! 07/09 01:41
121F:推 bobju: 赞~ 07/09 01:48
122F:推 xdraculax: 推 07/09 08:31
123F:推 lovdkkkk: (y) 07/09 11:22
124F:推 O87: 推推 07/09 13:01
125F:推 wadeabc: 这世界就需要你这种人,哪像老屁股领钱不做事 07/09 16:06
126F:推 loveisth520: 已跪 07/09 19:30
127F:推 shibin: 推分享 07/10 12:07
128F:推 aacs0130: 强者,推推 07/10 17:24
129F:推 BlazarArc: 推 07/11 10:21
130F:推 lukedoomer: 这东西的用处应该就只是测试透过HTTP传输的API? 07/11 13:38
131F:→ lukedoomer: 我觉得这CLI很棒,但我想知道是不是有我不知道的用处 07/11 13:39
132F:推 akito117: 推 07/11 13:52
133F:→ eliang: @lukedoomer 主要用途就是测试HTTP API没错 07/11 15:19
134F:→ eliang: 另一用途是用curl或httpie指令为例告诉别人如何呼叫API 07/11 15:22
135F:推 wanlinlin: 推神 07/11 16:30
136F:推 andy5564: 推 07/12 08:30
137F:推 secondDim: 跪着推了 07/12 09:13
138F:推 Csy065: 有神快拜 07/14 00:01
139F:推 supertalker: 朝圣推 07/14 11:09
140F:推 uly: 跪了 07/14 19:13
141F:推 et282523: 推~ 07/14 21:22
142F:推 bananayen: 推强者 07/18 16:26
143F:推 demo1945: 来朝圣 07/27 01:31
144F:推 tim5104: 超强的给推!感谢原po的贡献!! 11/30 22:26
145F:推 p90085: 高手推推 11/30 23:16
146F:推 zxc455233: 朝圣跪 12/01 21:23
147F:推 iamten: 推推 03/01 16:46
148F:推 Jason81000: 推 03/03 14:50
149F:推 vvind: 推 05/20 23:19