This is a Gradle plugin for Git Changelog Lib.
Published to plugins.gradle.org.
There is a complete running example here and also with Kotlin DSL here.
There are some more examples in the build.gradle.
More documentation can be found in the Git Changelog Lib.
It will use master
branch by default, you can change that with something like toRef = "main"
.
These tasks are configured when plugin is applied, no further configuration needed to use them.
gitChangelogSemanticVersion
- Will set version ingradle.properties
from conventional commits.gitChangelog
- Will updateCHANGELOG.md
using conventional commits.
plugin {
id 'se.bjurr.gitchangelog.git-changelog-gradle-plugin' version 'X'
}
// Optional config if you want to configure the changelog
task gitChangelogTask(type: se.bjurr.gitchangelog.plugin.gradle.GitChangelogTask) {
templateContent = """
// Template here!
""";
}
// Optional config if you want to configure versioning
task gitChangelogVersionTask(type: se.bjurr.gitchangelog.plugin.gradle.GitChangelogSemanticVersionTask) {
suffixSnapshot = true;
majorVersionPattern = "^[Bb]reaking"
minorVersionPattern = "[Ff]eature"
patchVersionPattern = "[Ff]ix"
}
If you are using conventional commits:
<type>[optional scope]: <description>
[optional body]
[optional footer(s)]
A changelog can be rendered (using Helpers) like this:
You can add your own helpers and use them in the template. There are also built in Helpers.
apply plugin: "se.bjurr.gitchangelog.git-changelog-gradle-plugin"
import se.bjurr.gitchangelog.plugin.gradle.HelperParam;
import com.github.jknack.handlebars.Helper;
import com.github.jknack.handlebars.Options;
task gitChangelogTask(type: se.bjurr.gitchangelog.plugin.gradle.GitChangelogTask) {
file = new File("CHANGELOG.md");
handlebarsHelpers = [
new HelperParam("startsWith", new Helper<String>() {
public Object apply(String from, Options options) throws IOException {
def s = options.hash['s']
if (from.matches("^" + s + ".*")) {
return options.fn(this);
} else {
return options.inverse(this);
}
}
}),
new HelperParam("firstLetters", new Helper<String>() {
public Object apply(String from, Options options) throws IOException {
def number = new Integer(options.hash['number'])
return from.substring(0,number);
}
})
]
templateContent = """
{{#commits}}
{{#startsWith messageTitle s='feat'}}
Starts with feat: "{{messageTitle}}"
first 10 letters of hash is: {{firstLetters hash number='10'}}
{{/startsWith}}
{{/commits}}
""";
}
It can also be used to get the next semantic version based on commits.
classpath 'se.bjurr.gitchangelog:git-changelog-lib:1.+'
...
buildscript {
repositories {
mavenCentral()
mavenLocal()
}
dependencies {
...
classpath 'se.bjurr.gitchangelog:git-changelog-lib:1.+'
}
}
def nextVersion = se.bjurr.gitchangelog.api.GitChangelogApi.gitChangelogApiBuilder()
.withSemanticMajorVersionPattern("^[Bb]reaking")
.withSemanticMinorVersionPattern("[Ff]eature")
.getNextSemanticVersion();
println "Next version:" + nextVersion.toString();
println " Major:" + nextVersion.getMajor();
println " Minor:" + nextVersion.getMinor();
println " Patch:" + nextVersion.getPatch();