Skip to content

Latest commit

 

History

History
106 lines (74 loc) · 4.3 KB

README.md

File metadata and controls

106 lines (74 loc) · 4.3 KB
Raw

properties-maven-extension

License

A Maven extension to introduce properties before the build is started. This allows the usage of dynamic project versions like 1.2.3.${sha1}.

Example

For a simple example, consider the following POM file:

<?xml version="1.0" encoding="UTF-8"?>
<project>
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>example-artifact</artifactId>
    <version>1.2.3.${sha1}</version>

    <properties>
        <sha1>${git.commit.id.abbrev}</sha1>
    </properties>
</project>

For a useful project version, the build would have to be invoked like mvn clean install -Dsha1=abcd123.

Using the Properties Maven Extension, this configuration can be set in the project directory itself, by adding the following .mvn/extensions.xml file to the project:

<?xml version="1.0" encoding="UTF-8"?>
<extensions>
    <extension>
        <groupId>com.github.pascalgn</groupId>
        <artifactId>properties-maven-extension</artifactId>
        <version>0.7.0</version>
    </extension>
</extensions>

A build is now as easy as mvn clean install and the commit hash will be available as a property, so that the final project version will be 1.2.3.abcd123 (depending on the current commit hash).

Requirements

You will need at least Maven 3.5.0 for this to work. See the release notes for more information. You also need to run your Maven build with at least Java 11 (due to the JGit dependency).

Properties

The following properties are currently provided by the extension:

  • git.branch, the current branch name (master, feature/some-feature, etc.)
  • git.build.datetime.simple, build time in simple datetime format (yyyyMMdd_HHmmss)
  • git.commit.id, the full SHA of the HEAD commit (cbf1b9a1be984a9f61b79a05f23b19f66d533537)
  • git.commit.id.abbrev, the abbreviated SHA of the HEAD commit (cbf1b9a)
  • git.count, the current number of commits reachable from HEAD
  • git.commit.color, always the first six characters of the commit SHA (cbf1b9)
  • git.dir.git, the absolute path of the repository (/home/user/workspace/myproject/.git)
  • git.dir.worktree, the absolute path of the working tree (/home/user/workspace/myproject)
  • git.tag.last, last tag from sorted tag list (v1.2.3)
  • git.describe.long, combination of tag name and commit SHA (v1.2.3-27-gcbf1b9a)
  • git.describe.tag, the latest tag reachable from the current branch (v1.2.3)

If you need more properties, feel free to create an issue or a pull request.

Notes

Changelog

Version 0.7.0

  • Added new property git.describe.long
  • Added new property git.describe.tag (see #64)

Version 0.6.0

  • Removed unused color properties

Version 0.5.1

  • Updated maven-core dependency to fix security warnings

Version 0.5.0

  • Changed required Java version from 1.8 to 11

Related projects

  • There are already plugins providing properties, like maven-git-commit-id-plugin. However, the POM structure, including versions, is built by Maven before any plugins are executed, hence this extension.
  • The maven-git-versioning-extension is very similar, but it directly sets the project version, based on existing branches and tags, which makes it less flexible.

License

Apache License, Version 2.0