总结了一个 Python 项目启动模板 project_sketch

不啰嗦。尽量不加不需要的东西，比如什么 MANIFEST.in 啊， CHANGES 啊；gitignore 会很简洁，不会像这货里面各种没见过；还有 LICENSE ，说起来我觉得 90% 情况下大家写项目时是不需要带上 LICENSE 的，比如公司内的、自己顺手联系的，如果真的必要，去这里挑一个 ctrl-c 就好。
能看懂。一般一个 Python 项目中最复杂的脚手架文件莫非 setup.py, Makefile 以及作为入口的启动脚本，setup.py, Makefile 已经精简到几乎不需要改就可以用，启动脚本嘛我引入了 manage.py 这个文件，在其中使用了 click 这个我非常喜欢的 CLI 库，随便改几行就可以很方便地创建命令了。

另外，对项目中的每一个文件都有比较详细的描述，也能起到一点 Python Packaging Tutorial 的作用 :)

P.S. 过两天会整理一个 flask 项目的启动模板，会比 fbone 好用一点点 :p

Supplement 1 · Apr 19, 2015

发现一个非常好的 flask project generator，应该很难写得比它更好了…

https://github.com/hustlzp/Flask-Boost

setup.py

makefile

Python

14 replies • 2015-03-29 20:07:53 +08:00

bcxx

Mar 26, 2015

为啥不用类似 paste 的东西来定义一下变量啊，这样就不用每次都改了

reorx

Mar 27, 2015

@bcxx 想尽量保持简洁，不依赖外部库，而且创建新项目这件事情也不是真的频繁到 cp + mv 几下都觉得麻烦嘛。另外 paste 多年没有更新了，不想用这种古老的东西…

tiant167

Mar 27, 2015

已收藏~# 早啊~

felinx

Mar 27, 2015

小蜜蜂，赞！

reorx

Mar 27, 2015

@felinx 嗡嗡嗡，飞龙早！

dddd

Mar 27, 2015

我在别人的 makefile 里发现的，清除 pyc, pyo, ~备份文件的
可以加在 clean 里，怎样？？

find . -name '*.pyc' -exec rm -f {} +
find . -name '*.pyo' -exec rm -f {} +
find . -name '*~' -exec rm -f {} +

netpro

Mar 27, 2015

期待flask的启动模板．．．

reorx

Mar 27, 2015

@dddd clean 一般是用来清除对应的 build 命令所产生的文件，.py[co] 文件并非 build 产生，而是运行产生的，而且它既不会被包含在打出的 package 里，也由于 gitignore 的存在不会被 git 所 track，正常情况下我们对它的存在几乎是无感知的。我只有在怀疑遗留的 pyc 文件影响了我对模块的引用时才会去清除它，所以我的 zsh 里有一句 alias clean_pyc="find . -name '*.pyc' -exec rm {} \;"

至于 vim 的 backup file，正确的处理方式是让他放在固定的文件夹里，在 vim 配置里加上:

set backupdir=~/.vim/backup

就好了。毕竟指不准哪天真的需要，你也不能随便把它清除了不是？

dddd

Mar 27, 2015

@reorx 长知识了，谢谢

wph95

Mar 27, 2015 via iPhone

manage.py………
第一眼以为是django

reorx

Mar 27, 2015

@wph95 自从用了 django，manage.py 这个名字就和入口脚本的概念深深地绑定在我的脑海里，让我再也想不出别的词来… orz

glasslion

Mar 27, 2015

Python, Django, Flask 都有官方推荐的模板，还有那么多人喜欢重复造轮子

https://github.com/pypa/sampleproject
https://github.com/audreyr/cookiecutter

reorx

Mar 27, 2015

@glasslion 所以只是 1. 满足自己需求，2. 多一个选择给不满意已有方案的人

elvis_w

Mar 29, 2015

@wph95 flask-script 也爱用这个文件名