danger

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

危险 :no_entry_sign:

规范你的拉取请求礼仪。

什么是 Danger？ • 愿景 • 帮忙 • 插件开发

危险是什么？

在你的 CI 过程中，Danger 会运行，并给团队机会自动化常见的代码审查工作。

这为你的流程提供了另一个逻辑步骤，通过它 Danger 可以帮助在日常代码审查中检查你重复性的任务。

你可以使用 Danger 来规范团队的行为准则，让人类去思考更困难的问题。

举个例子？

你可以：

• 强制执行 CHANGELOG
• 在 PR/MR 正文中强制链接到 Trello/JIRA
• 强制使用描述性标签
• 注意常见的反模式
• 突出显示有趣的构建产物
• 对特定文件给予额外关注

Danger 提供了粘合剂，使_你_能够构建符合你团队文化的规则，提供有用的元数据和一个全面的插件系统来共享常见问题。

入门

好吧。其实，你可能来错地方了。从现在起，这个自述文件将面向那些对开发和改进 Danger 感兴趣的人。

我们将所有终端用户文档保存在 https://danger.systems。

一些快速链接：指南索引、DSL 参考、入门 和 Danger 做什么？。

我来帮忙！

太棒了。那么，让我们来帮你设置一下。

git clone https://github.com/danger/danger.git
cd danger
bundle install
bundle exec rake spec

这样就能设置好一切并运行所有测试。

理论

Danger 有一个 VISION.md 文件，汇总了关于 Danger 的理念。它是 Danger 意义的下限。Orta 也曾在 Artsy 博客 上写过关于处理和创建 Danger 的内容。

文献资料

你写的代码可能会出现在网站的公开部分——最简单的判断方式是它文档过于繁多。如果你所在的领域看起来文档过于繁杂，请特别注意添加文档。我们期望文档的使用者不是红宝石学者，因此应避免使用具体行话，尽量提供重复且重叠的示例。

测试

到目前为止，我们还没真正找到正确的方法来做CLI命令的测试。即使我们做了测试，它们都变得脆弱。所以，理想情况下，尝试把任何会放入命令的逻辑转移到不同的类中，并对它们进行测试。我们可以接受命令没有覆盖，但理想情况下，构成它的类会覆盖。

我强烈建议在工作时使用 bundle exec guard 来运行你的测试。你在 lib 或规格中所做的任何更改都会立即执行相应的测试。

调试

Ruby 非常动态。调试 Ruby 代码的最佳方法之一是使用 pry。我们为开发者包含了 pry：当你遇到问题时，只需在问题发生前复制这两行代码，并按照 “我想成为一个危险向导” 中的说明操作。

require 'pry'
binding.pry