Feat add parser opts conventional-changelog#821

README.md

@@ -313,6 +313,26 @@ If you do not want to have any tag prefix you can use the `-t` flag and provide
 
 > Note: simply -t or --tag-prefix without any value will fallback to the default 'v'
 
+### Parser Options
+
+If you need to include custom parser options to read your commits, you can use the `--parser-opts` to indicate the path to a .js file that exports the options.
+
+```sh
+standard-version --parser-options ./parser-opts.js
+```
+
+This can be useful in cases like Azure DevOps that uses custom merge pull request titles. The `parser-opts.js` could look like this:
+
+```js
+/** @type {import("conventional-commits-parser").Options} */
+module.exports = {
+    mergePattern: /^Merged PR (\d+): (\w*)(?:\(([\w\$\.\-\* ]*)\))?\: (.*)$/,
+    mergeCorrespondence: ['id', 'type', 'scope', 'subject']
+}
+```
+
+For more informantion on what parser options are available, reference to [documentation](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-commits-parser).
+
 ### CLI Help
 
 ```sh

command.js

@@ -99,6 +99,10 @@ const yargs = require('yargs')
     default: defaults.preset,
     describe: 'Commit message guideline preset'
   })
+  .option('parser-opts', {
+    type: 'string',
+    describe: 'Path to file with Conventional Commits Parser Options'
+  })
   .option('lerna-package', {
     type: 'string',
     describe: 'Name of the package from which the tags will be extracted'

index.js

@@ -37,6 +37,15 @@ module.exports = async function standardVersion (argv) {
     throw Error(`custom changelog header must not match ${changelog.START_OF_LAST_RELEASE_PATTERN}`)
   }
 
+  if (typeof argv.parserOpts === 'string') {
+    const parserOptsPath = path.resolve(argv.parserOpts)
+    try {
+      argv.parserOpts = require(parserOptsPath)
+    } catch(err) {
+      argv.parserOpts = null
+    }
+  }
+
   const args = Object.assign({}, defaults, argv)
   let pkg
   for (const packageFile of args.packageFiles) {

lib/lifecycles/bump.js

@@ -122,7 +122,7 @@ function bumpVersion (releaseAs, currentVersion, args) {
         path: args.path,
         tagPrefix: args.tagPrefix,
         lernaPackage: args.lernaPackage
-      }, function (err, release) {
+      }, args.parserOpts, function (err, release) {
         if (err) return reject(err)
         else return resolve(release)
       })

lib/lifecycles/changelog.js

@@ -36,7 +36,7 @@ function outputChangelog (args, newVersion) {
       debug: args.verbose && console.info.bind(console, 'conventional-changelog'),
       preset: presetLoader(args),
       tagPrefix: args.tagPrefix
-    }, context, { merges: null, path: args.path })
+    }, context, { merges: null, path: args.path }, args.parserOpts)
       .on('error', function (err) {
         return reject(err)
       })