开发¶
获得源码签出¶
我们的 Git 资源库在 Github 上维护,地址是 pyinvoke/invoke。请按照他们的指示来克隆(或者先分叉,再克隆,如果你想回馈的话,最好是这样)那里的仓库。
下载后,通过运行 pip install -r dev-requirements.txt
来安装 repo 本身和它的开发依赖项。
提交错误报告或补丁¶
所有的开发都遵循 contribution-guide.org – 请去那里了解提交补丁的细节,哪个分支的工作,等等。我们的问题跟踪器在 our GitHub page。
更新日志的位置¶
Invoke 的更新日志在 sites/www/changelog.rst
中,并使用 Releases Sphinx 插件进行格式化。
运行管理任务¶
Invoke 将自己用于项目管理,有许多任务,你可以用 inv --list
看到。一些值得注意的具体任务:
test
和integration
:分别运行主测试和集成测试套件。(大多数情况下,你可以忽略integration
– 它主要用于 CI 系统或本地偶尔的理智检查。)
www
和docs
(以及它们的子任务,如docs.browse
):分别建立 WWW 站点和 API 文档。
另一个好的资源是略过我们的 .travis.yml
文件,看看它执行的命令 – 如果提交的文件在某种程度上没有通过所有这些命令,它们也不会通过 Travis 的 CI 构建!