feat(parser): support using regex group values (#145)

README.md

@@ -622,6 +622,8 @@ Examples:
   - Group the commit as "Features" if the commit message (description) starts with "feat".
 - `{ body = ".*security", group = "Security"}`
   - Group the commit as "Security" if the commit body contains "security".
+- `{ message = '^fix\((.*)\)', group = 'Fix (${1})' }`
+  - Use the matched scope value from the commit message in the group name.
 - `{ message = ".*deprecated", body = ".*deprecated", group = "Deprecation"}`
   - Group the commit as "Deprecation" if the commit body and message contains "deprecated".
 - `{ message = "^revert", skip = true}`

git-cliff-core/src/commit.rs

@@ -277,7 +277,15 @@ impl Commit<'_> {
 							"Skipping commit",
 						)));
 					} else {
-						self.group = parser.group.as_ref().cloned();
+						self.group =
+							parser.group.as_ref().cloned().map(|mut group| {
+								for mat in regex.find_iter(&text) {
+									group = regex
+										.replace(mat.as_str(), group)
+										.to_string();
+								}
+								group
+							});
 						self.scope = parser.scope.as_ref().cloned();
 						self.default_scope = parser.default_scope.as_ref().cloned();
 						return Ok(self);

git-cliff/src/changelog.rs

@@ -248,6 +248,14 @@ mod test {
 						scope:         Some(String::from("documentation")),
 						skip:          None,
 					},
+					CommitParser {
+						message:       Regex::new(r#"match\((.*)\):.*"#).ok(),
+						body:          None,
+						group:         Some(String::from("Matched ($1)")),
+						default_scope: None,
+						scope:         None,
+						skip:          None,
+					},
 					CommitParser {
 						message:       Regex::new(".*").ok(),
 						body:          None,
@@ -307,6 +315,10 @@ mod test {
 					String::from("qwertz"),
 					String::from("feat!: support breaking commits"),
 				),
+				Commit::new(
+					String::from("qwert0"),
+					String::from("match(group): support regex-replace for groups"),
+				),
 			],
 			commit_id: Some(String::from("0bc123")),
 			timestamp: 50000000,
@@ -392,6 +404,10 @@ mod test {
 			#### documentation
 			- update docs
 
+			### Matched (group)
+			#### group
+			- support regex-replace for groups
+
 			### New features
 			#### app
 			- add cool features
@@ -497,6 +513,10 @@ chore(deps): fix broken deps
 			#### documentation
 			- update docs
 
+			### Matched (group)
+			#### group
+			- support regex-replace for groups
+
 			### New features
 			#### app
 			- add cool features