9f7a37b4e9
Previously commit message types were provided as part of the ng-dev config in the repository using the ng-dev toolset. This change removes this configuration expectation and instead predefines the valid types for commit messages. Additionally, with this new unified set of types requirements around providing a scope have been put in place. Scopes are either required, optional or forbidden for a given commit type. PR Close #38430
75 lines
1.7 KiB
TypeScript
75 lines
1.7 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright Google LLC All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.io/license
|
|
*/
|
|
|
|
import {assertNoErrors, getConfig, NgDevConfig} from '../utils/config';
|
|
|
|
export interface CommitMessageConfig {
|
|
maxLineLength: number;
|
|
minBodyLength: number;
|
|
minBodyLengthTypeExcludes?: string[];
|
|
scopes: string[];
|
|
}
|
|
|
|
/** Retrieve and validate the config as `CommitMessageConfig`. */
|
|
export function getCommitMessageConfig() {
|
|
// List of errors encountered validating the config.
|
|
const errors: string[] = [];
|
|
// The non-validated config object.
|
|
const config: Partial<NgDevConfig<{commitMessage: CommitMessageConfig}>> = getConfig();
|
|
|
|
if (config.commitMessage === undefined) {
|
|
errors.push(`No configuration defined for "commitMessage"`);
|
|
}
|
|
|
|
assertNoErrors(errors);
|
|
return config as Required<typeof config>;
|
|
}
|
|
|
|
/** Scope requirement level to be set for each commit type. */
|
|
export enum ScopeRequirement {
|
|
Required,
|
|
Optional,
|
|
Forbidden,
|
|
}
|
|
|
|
/** A commit type */
|
|
export interface CommitType {
|
|
scope: ScopeRequirement;
|
|
}
|
|
|
|
/** The valid commit types for Angular commit messages. */
|
|
export const COMMIT_TYPES: {[key: string]: CommitType} = {
|
|
build: {
|
|
scope: ScopeRequirement.Forbidden,
|
|
},
|
|
ci: {
|
|
scope: ScopeRequirement.Forbidden,
|
|
},
|
|
docs: {
|
|
scope: ScopeRequirement.Optional,
|
|
},
|
|
feat: {
|
|
scope: ScopeRequirement.Required,
|
|
},
|
|
fix: {
|
|
scope: ScopeRequirement.Required,
|
|
},
|
|
perf: {
|
|
scope: ScopeRequirement.Required,
|
|
},
|
|
refactor: {
|
|
scope: ScopeRequirement.Required,
|
|
},
|
|
release: {
|
|
scope: ScopeRequirement.Forbidden,
|
|
},
|
|
test: {
|
|
scope: ScopeRequirement.Required,
|
|
},
|
|
};
|