开发

获得源码签出

我们的 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 看到。一些值得注意的具体任务:

  • testintegration:分别运行主测试和集成测试套件。(大多数情况下,你可以忽略 integration – 它主要用于 CI 系统或本地偶尔的理智检查。)

  • wwwdocs (以及它们的子任务,如 docs.browse):分别建立 WWW 站点和 API 文档。

另一个好的资源是略过我们的 .travis.yml 文件,看看它执行的命令 – 如果提交的文件在某种程度上没有通过所有这些命令,它们也不会通过 Travis 的 CI 构建!