in ng-dev/pullapprove/verify.ts [16:117]
export function verify() {
const git = GitClient.get();
/** Full path to PullApprove config file */
const PULL_APPROVE_YAML_PATH = resolve(git.baseDir, '.pullapprove.yml');
/** All tracked files in the repository. */
const REPO_FILES = git.allFiles();
/** The pull approve config file. */
const pullApproveYamlRaw = readFileSync(PULL_APPROVE_YAML_PATH, 'utf8');
/** All of the groups defined in the pullapprove yaml. */
const groups = getGroupsFromYaml(pullApproveYamlRaw);
/**
* PullApprove groups without conditions. These are skipped in the verification
* as those would always be active and cause zero unmatched files.
*/
const groupsSkipped = groups.filter((group) => !group.conditions.length);
/** PullApprove groups with conditions. */
const groupsWithConditions = groups.filter((group) => !!group.conditions.length);
/** Files which are matched by at least one group. */
const matchedFiles: string[] = [];
/** Files which are not matched by at least one group. */
const unmatchedFiles: string[] = [];
// Test each file in the repo against each group for being matched.
REPO_FILES.forEach((file: string) => {
if (groupsWithConditions.filter((group) => group.testFile(file)).length) {
matchedFiles.push(file);
} else {
unmatchedFiles.push(file);
}
});
/** Results for each group */
const resultsByGroup = groupsWithConditions.map((group) => group.getResults());
/**
* Whether all group condition lines match at least one file and all files
* are matched by at least one group.
*/
const allGroupConditionsValid =
resultsByGroup.every((r) => !r.unmatchedCount) && !unmatchedFiles.length;
/** Whether all groups have at least one reviewer user or team defined. */
const groupsWithoutReviewers = groups.filter(
(group) => Object.keys(group.reviewers).length === 0,
);
/** The overall result of the verifcation. */
const overallResult = allGroupConditionsValid && groupsWithoutReviewers.length === 0;
/**
* Overall result
*/
logHeader('Overall Result');
if (overallResult) {
info('PullApprove verification succeeded!');
} else {
info(`PullApprove verification failed.`);
info();
info(`Please update '.pullapprove.yml' to ensure that all necessary`);
info(`files/directories have owners and all patterns that appear in`);
info(`the file correspond to actual files/directories in the repo.`);
}
/** Reviewers check */
logHeader(`Group Reviewers Check`);
if (groupsWithoutReviewers.length === 0) {
info('All group contain at least one reviewer user or team.');
} else {
info.group(`Discovered ${groupsWithoutReviewers.length} group(s) without a reviewer defined`);
groupsWithoutReviewers.forEach((g) => info(g.groupName));
info.groupEnd();
}
/**
* File by file Summary
*/
logHeader('PullApprove results by file');
info.group(`Matched Files (${matchedFiles.length} files)`);
matchedFiles.forEach((file) => debug(file));
info.groupEnd();
info.group(`Unmatched Files (${unmatchedFiles.length} files)`);
unmatchedFiles.forEach((file) => info(file));
info.groupEnd();
/**
* Group by group Summary
*/
logHeader('PullApprove results by group');
info.group(`Groups skipped (${groupsSkipped.length} groups)`);
groupsSkipped.forEach((group) => debug(`${group.groupName}`));
info.groupEnd();
const matchedGroups = resultsByGroup.filter((group) => !group.unmatchedCount);
info.group(`Matched conditions by Group (${matchedGroups.length} groups)`);
matchedGroups.forEach((group) => logGroup(group, 'matchedConditions', debug));
info.groupEnd();
const unmatchedGroups = resultsByGroup.filter((group) => group.unmatchedCount);
info.group(`Unmatched conditions by Group (${unmatchedGroups.length} groups)`);
unmatchedGroups.forEach((group) => logGroup(group, 'unmatchedConditions'));
info.groupEnd();
const unverifiableConditionsInGroups = resultsByGroup.filter(
(group) => group.unverifiableConditions.length > 0,
);
info.group(`Unverifiable conditions by Group (${unverifiableConditionsInGroups.length} groups)`);
unverifiableConditionsInGroups.forEach((group) => logGroup(group, 'unverifiableConditions'));
info.groupEnd();
// Provide correct exit code based on verification success.
process.exit(overallResult ? 0 : 1);
}