Skip to content
프로젝트

tomasbjerre/git-changelog-gradle-plugin

GitHub에서 보기

tomasbjerre/git-changelog-gradle-plugin has 88 GitHub stars and 18 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-20 17:41 UTC. Last push 2026-11-11.

이 수치를 측정하는 방법

측정된 스타 증가

in 24h
0
in 7 days
0
in 15 days
기록 수집 중
in 1 month
기록 수집 중

서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.

소개

Automate changelog and versioning with conventional commits and Git.

개발 도구

README.md

Original

Git Changelog Gradle Plugin

Maven Central Gradle Plugin Portal

This is a Gradle plugin for Git Changelog Lib.

Version Java Version
version < 2.0.0 8
2.0.0 <= version < 2.2.0 11
2.2.0 <= version 17

Usage

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 HEAD branch by default, you can change that with something like toRevision = "main".

Default tasks

These tasks are configured when plugin is applied, no further configuration needed to use them.

You can also set the property setVersionConventional=true that will trigger the project.version to be updated. The gitChangelogSemanticVersion will update the version to late if you are also publishing in the same invocation. Triggering the versioning with the property will set the version earlier so that it is correct in the publications. The properties that can be set are:

# Needs to be set
setVersionConventional=true

# These can also be set, but they have defaults
suffixSnapshot=...
suffixSnapshotIfNotTagged=...
majorVersionPattern=...
minorVersionPattern=...
patchVersionPattern=...
ignoreTagsIfNameMatches=...

build.gradle

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.set("""
  // Template here!
 """);
}

// Optional config if you want to configure versioning
task gitChangelogVersionTask(type: se.bjurr.gitchangelog.plugin.gradle.GitChangelogSemanticVersionTask) {
 suffixSnapshot.set(true);
 majorVersionPattern.set("^[Bb]reaking")
 minorVersionPattern.set("[Ff]eature")
 patchVersionPattern.set("[Ff]ix")
}

Template - Simple

Changelog of ${projectDisplayName}.

{{#tags}}
## {{name}}
 {{#issues}}
  {{#hasIssue}}
   {{#hasLink}}
### {{name}} [{{issue}}]({{link}}) {{title}} {{#hasIssueType}} *{{issueType}}* {{/hasIssueType}} {{#hasLabels}} {{#labels}} *{{.}}* {{/labels}} {{/hasLabels}}
   {{/hasLink}}
   {{^hasLink}}
### {{name}} {{issue}} {{title}} {{#hasIssueType}} *{{issueType}}* {{/hasIssueType}} {{#hasLabels}} {{#labels}} *{{.}}* {{/labels}} {{/hasLabels}}
   {{/hasLink}}
  {{/hasIssue}}
  {{^hasIssue}}
### {{name}}
  {{/hasIssue}}

  {{#commits}}
**{{{messageTitle}}}**

{{#messageBodyItems}}
 * {{.}}
{{/messageBodyItems}}

[{{hash}}](https://github.com/{{ownerName}}/{{repoName}}/commit/{{hash}}) {{authorName}} *{{commitTime}}*

  {{/commits}}

 {{/issues}}
{{/tags}}

Template - Semantic versioning from conventional commits

If you are using conventional commits:

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

A changelog can be rendered (using Helpers) like this:

# Changelog

{{#tags}}
{{#ifReleaseTag .}}
## [{{name}}](https://gitlab.com/html-validate/html-validate/compare/{{name}}) ({{tagDate .}})

  {{#ifContainsType commits type='feat'}}
### Features

    {{#commits}}
      {{#ifCommitType . type='feat'}}
 - {{#eachCommitScope .}} **{{.}}** {{/eachCommitScope}} {{{commitDescription .}}} ([{{hash}}](https://gitlab.com/html-validate/html-validate/commit/{{hashFull}}))
      {{/ifCommitType}}
    {{/commits}}
  {{/ifContainsType}}

  {{#ifContainsType commits type='fix'}}
### Bug Fixes

    {{#commits}}
      {{#ifCommitType . type='fix'}}
 - {{#eachCommitScope .}} **{{.}}** {{/eachCommitScope}} {{{commitDescription .}}} ([{{hash}}](https://gitlab.com/html-validate/html-validate/commit/{{hashFull}}))
      {{/ifCommitType}}
    {{/commits}}
  {{/ifContainsType}}

{{/ifReleaseTag}}
{{/tags}}

Example - custom helpers

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.set(new File("CHANGELOG.md"));
  handlebarsHelpers.set([
    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.set("""
  {{#commits}}
    {{#startsWith messageTitle s='feat'}}
      Starts with feat: "{{messageTitle}}"
      first 10 letters of hash is: {{firstLetters hash number='10'}}
    {{/startsWith}}
  {{/commits}}
  """);
}

Example - custom helpers from a file

Instead of registering Java helpers inline, JavaScript helpers can be kept in their own file with handlebarsHelperFile, the same way a templateFile is kept separate from the build script. This requires a JS engine like Nashorn on the classpath.

task gitChangelogTask(type: se.bjurr.gitchangelog.plugin.gradle.GitChangelogTask) {
  file.set(new File("CHANGELOG.md"));
  handlebarsHelperFile.set("helpers.js");
  templateFile.set("changelog.mustache");
}

helpers.js:

Handlebars.registerHelper("startsWith", function(options) {
  var s = options.hash.s;
  if (this.messageTitle && this.messageTitle.match("^" + s + ".*")) {
    return options.fn(this);
  } else {
    return options.inverse(this);
  }
});

Get next release

It can also be used to get the next semantic version based on commits.

buildscript {
 repositories {
  mavenCentral()
  mavenLocal()
 }
 dependencies {
  classpath 'se.bjurr.gitchangelog:git-changelog-lib:3.+'
 }
}

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();