feat: Add subjectPatternError option to set custom sub validation error

README.md

@@ -51,6 +51,16 @@ jobs:
           # Configure additional validation for the subject based on a regex.
           # This example ensures the subject doesn't start with an uppercase character.
           subjectPattern: ^(?![A-Z]).+$
+          # Configure custom error message that should be passed to the logs to better describe the error thrown by subject pattern validation.
+          # You can pass template values to the error test
+          # - ${subject} will be replaced with the subject of the PR title
+          # - ${title} will be replaced with the PR title
+          # This example will return the following error of PR title "fix(core): Test": 
+          #     The subject "Test" found in the pull request title "fix(core): Test" didn't match the configured pattern.
+          #     Please ensure that the subject doesn't start with an uppercase character.
+          subjectPatternError: |
+            The subject "${subject}" found in the pull request title "${title}" didn't match the configured pattern.
+            Please ensure that the subject doesn't start with an uppercase character.
           # For work-in-progress PRs you can typically use draft pull requests 
           # from Github. However, private repositories on the free plan don't have 
           # this option and therefore this action allows you to opt-in to using the 

action.yml

@@ -20,6 +20,9 @@ inputs:
   subjectPattern:
     description: "Configure additional validation for the subject based on a regex. E.g. '^(?![A-Z]).+$' ensures the subject doesn't start with an uppercase character."
     required: false
+  subjectPatternError:
+    description: "Configure custom error message that should be passed to the logs to better describe the error thrown by subject pattern validation."
+    required: false
   wip:
     description: "For work-in-progress PRs you can typically use draft pull requests from Github. However, private repositories on the free plan don't have this option and therefore this action allows you to opt-in to using the special '[WIP]' prefix to indicate this state. This will avoid the validation of the PR title and the pull request checks remain pending. Note that a second check will be reported if this is enabled."
     required: false

src/SubjectPatternErrorParser.js

@@ -0,0 +1,2 @@
+module.exports = (subjectPatternError, subject, title) =>
+  subjectPatternError.replace('${subject}', subject).replace('${title}', title);

src/SubjectPatternErrorParser.test.js

@@ -0,0 +1,24 @@
+const subjectPatternErrorParser = require('./SubjectPatternErrorParser');
+
+describe('parse pattern error', () => {
+  it('parse string without changes if template values not provided', () => {
+    const customError = 'this is test';
+    expect(subjectPatternErrorParser(customError)).toEqual(customError);
+  });
+
+  it('parses string properly by replacing one template value', () => {
+    expect(
+      subjectPatternErrorParser('this is ${subject} test', 'my subject')
+    ).toEqual('this is my subject test');
+  });
+
+  it('parses string properly by replacing both template values', () => {
+    expect(
+      subjectPatternErrorParser(
+        'this ${title} is ${subject} test',
+        'my subject',
+        'my title'
+      )
+    ).toEqual('this my title is my subject test');
+  });
+});

src/index.js

@@ -6,7 +6,14 @@ const validatePrTitle = require('./validatePrTitle');
 module.exports = async function run() {
   try {
     const client = github.getOctokit(process.env.GITHUB_TOKEN);
-    const {types, scopes, requireScope, wip, subjectPattern} = parseConfig();
+    const {
+      types,
+      scopes,
+      requireScope,
+      wip,
+      subjectPattern,
+      subjectPatternError
+    } = parseConfig();
 
     const contextPullRequest = github.context.payload.pull_request;
     if (!contextPullRequest) {
@@ -38,7 +45,8 @@ module.exports = async function run() {
           types,
           scopes,
           requireScope,
-          subjectPattern
+          subjectPattern,
+          subjectPatternError
         });
       } catch (error) {
         validationError = error;

src/parseConfig.js

@@ -21,10 +21,24 @@ module.exports = function parseConfig() {
     subjectPattern = ConfigParser.parseString(process.env.INPUT_SUBJECTPATTERN);
   }
 
+  let subjectPatternError;
+  if (process.env.INPUT_SUBJECTPATTERNERROR) {
+    subjectPatternError = ConfigParser.parseString(
+      process.env.INPUT_SUBJECTPATTERNERROR
+    );
+  }
+
   let wip;
   if (process.env.INPUT_WIP) {
     wip = ConfigParser.parseBoolean(process.env.INPUT_WIP);
   }
 
-  return {types, scopes, requireScope, wip, subjectPattern};
+  return {
+    types,
+    scopes,
+    requireScope,
+    wip,
+    subjectPattern,
+    subjectPatternError
+  };
 };

src/validatePrTitle.js

@@ -1,12 +1,13 @@
 const conventionalCommitsConfig = require('conventional-changelog-conventionalcommits');
 const conventionalCommitTypes = require('conventional-commit-types');
 const parser = require('conventional-commits-parser').sync;
+const subjectPatternErrorParser = require('./SubjectPatternErrorParser');
 
 const defaultTypes = Object.keys(conventionalCommitTypes.types);
 
 module.exports = async function validatePrTitle(
   prTitle,
-  {types, scopes, requireScope, subjectPattern} = {}
+  {types, scopes, requireScope, subjectPattern, subjectPatternError} = {}
 ) {
   if (!types) types = defaultTypes;
 
@@ -66,6 +67,12 @@ module.exports = async function validatePrTitle(
   if (subjectPattern) {
     const match = result.subject.match(new RegExp(subjectPattern));
 
+    if (subjectPatternError) {
+      throw new Error(
+        subjectPatternErrorParser(subjectPatternError, result.subject, prTitle)
+      );
+    }
+
     if (!match) {
       throw new Error(
         `The subject "${result.subject}" found in pull request title "${prTitle}" doesn't match the configured pattern "${subjectPattern}".`

src/validatePrTitle.test.js

@@ -107,6 +107,28 @@ describe('description validation', () => {
   it('does not validate the description by default', async () => {
     await validatePrTitle('fix: sK!"§4123');
   });
+  it('throws custom error', async () => {
+    const customError =
+      'The subject found in the pull request title cannot start with an uppercase character.';
+    await expect(
+      validatePrTitle('fix: Foobar', {
+        subjectPattern: '^(?![A-Z]).+$',
+        subjectPatternError: customError
+      })
+    ).rejects.toThrow(customError);
+  });
+
+  it('throws custom error enriched with template values', async () => {
+    await expect(
+      validatePrTitle('fix: Foobar', {
+        subjectPattern: '^(?![A-Z]).+$',
+        subjectPatternError:
+          'The subject "${subject}" found in the pull request title "${title}" cannot start with an uppercase character.'
+      })
+    ).rejects.toThrow(
+      'The subject "Foobar" found in the pull request title "fix: Foobar" cannot start with an uppercase character.'
+    );
+  });
 
   it('throws for invalid subjects', async () => {
     await expect(