概述
为代码库中的特定文件夹应用自定义代码审查设置。非常适合不同区域有不同标准或所有权的单体代码库。 Kody 为每个 PR 选择单个配置:目录 → 代码库 → 全局了解设置如何在级别之间流动,请参阅配置继承与覆盖。
工作原理
- 在任何深度配置任何文件夹(例如
api/src/services) - 根据需要配置任意多个文件夹
- 不重叠:如果配置
api/src/services,则不能同时配置api/src/services/users
选择规则
- 触及一个已配置目录:使用该目录的配置
- 未触及已配置目录:使用代码库配置(如果没有代码库配置则使用全局配置)
- 触及两个或更多已配置目录:升级到代码库配置(如果没有代码库配置则使用全局配置)
Kody 对每个 PR 使用一个配置以保持审查可预测。混合配置会导致冲突。
示例
- 单个已配置目录
- 无已配置目录
- 多个已配置目录
您配置了
src/microservice-alpha。PR 更改了 src/microservice-alpha 和未配置文件夹中的文件。使用 microservice-alpha 配置。设置
- 在侧边栏中,打开 Code review 分组顶部的作用域选择器,然后选择 Add repository configuration
- 在 Create repository settings 中,Select the target repository,然后 Select the target directories(一个或多个文件夹),并点击 Create settings
- 选择新的目录作用域 —— 它会缩进显示在作用域选择器中所属代码库的下方 —— 然后在任意页面(General、What to review、Kody Rules、What Kody writes)中更改设置;设置页面通过 Save settings 保存
kodus-config.yml,它会覆盖网页设置(请参阅通用设置中的配置优先级)。