git-revision-webpack-plugin


Simple webpack plugin that generates VERSION and COMMITHASH files during build based on a local git repository.

Usage

Given a webpack 5 project (check below for old webpack versions), install it as a local development dependency:

``bash
npm install --save-dev git-revision-webpack-plugin
`

Then, simply configure it as a plugin in the webpack config:

`javascript
const { GitRevisionPlugin } = require('git-revision-webpack-plugin')

module.exports = {
plugins: [new GitRevisionPlugin()],
}
`

It outputs a VERSION based on git-describe such as:

`
v0.0.0-34-g7c16d8b
`

A COMMITHASH such as:

`
7c16d8b1abeced419c14eb9908baeb4229ac0542
`

And (optionally when branch is enabled) a BRANCH such as:

`
master
`

Path Substitutions

It is also possible to use path substitutions on build to get the revision, version or branch as part of output paths.

- [git-revision-version]
- [git-revision-hash]
- [git-revision-branch] (only when branch is enabled)
- [git-revision-last-commit-datetime]

Example:

`javascript
module.exports = {
output: {
publicPath: 'http://my-fancy-cdn.com/[git-revision-version]/',
filename: '[name]-[git-revision-hash].js',
},
}
`

Plugin API

The VERSION, COMMITHASH, LASTCOMMITDATETIME and BRANCH are also exposed through a public API.

Example using the DefinePlugin:

`javascript
const webpack = require('webpack')
const { GitRevisionPlugin } = require('git-revision-webpack-plugin')
const gitRevisionPlugin = new GitRevisionPlugin()

module.exports = {
plugins: [
gitRevisionPlugin,
new webpack.DefinePlugin({
VERSION: JSON.stringify(gitRevisionPlugin.version()),
COMMITHASH: JSON.stringify(gitRevisionPlugin.commithash()),
BRANCH: JSON.stringify(gitRevisionPlugin.branch()),
LASTCOMMITDATETIME: JSON.stringify(gitRevisionPlugin.lastcommitdatetime()),
}),
],
}
`

Configuration

The plugin requires no configuration by default, but it is possible to configure it to support custom git workflows.

$3

If you need lightweight tags support, you may turn on lightweightTags option in this way:

`javascript
const { GitRevisionPlugin } = require('git-revision-webpack-plugin')

module.exports = {
plugins: [
new GitRevisionPlugin({
lightweightTags: true,
}),
],
}
`

$3

If you need branch name support, you may turn on branch option in this way:

`javascript
const { GitRevisionPlugin } = require('git-revision-webpack-plugin')

module.exports = {
plugins: [
new GitRevisionPlugin({
branch: true,
}),
],
}
`

$3

To change the default git command used to read the value of COMMITHASH.

This configuration is not not meant to accept arbitrary user input and it is executed by the plugin without any sanitization.

`javascript
const { GitRevisionPlugin } = require('git-revision-webpack-plugin')

module.exports = {
plugins: [
new GitRevisionPlugin({
commithashCommand: 'rev-list --max-count=1 --no-merges HEAD',
}),
],
}
`

$3

To change the default git command used to read the value of VERSION.

This configuration is not not meant to accept arbitrary user input and it is executed by the plugin without any sanitization.

`javascript
const { GitRevisionPlugin } = require('git-revision-webpack-plugin')

module.exports = {
plugins: [
new GitRevisionPlugin({
versionCommand: 'describe --always --tags --dirty',
}),
],
}
`

$3

To change the default git command used to read the value of BRANCH.

This configuration is not not meant to accept arbitrary user input and it is executed by the plugin without any sanitization.

`javascript
const { GitRevisionPlugin } = require('git-revision-webpack-plugin')

module.exports = {
plugins: [
new GitRevisionPlugin({
branchCommand: 'rev-parse --symbolic-full-name HEAD',
}),
],
}
`

$3

To change the default git command used to read the value of LASTCOMMITDATETIME.

This configuration is not not meant to accept arbitrary user input and it is executed by the plugin without any sanitization.

`javascript
const { GitRevisionPlugin } = require('git-revision-webpack-plugin')

module.exports = {
plugins: [
new GitRevisionPlugin({
branchCommand: 'log -1 --format=%ci',
}),
],
}
`

Outdated webpack

If your project is not running on Webpack 5, you will need older versions of this package.

$3

`
npm install git-revision-webpack-plugin@3.0.6
`

$3

`
npm install git-revision-webpack-plugin@2.5.1
``

Check issue 29 for more information.