1
1
mirror of https://github.com/orhun/git-cliff.git synced 2024-12-15 16:42:12 +03:00
A highly customizable Changelog Generator that follows Conventional Commit specifications ⛰️
Go to file
2021-06-30 02:09:11 +03:00
.github fix(ci): update lychee arguments to exclude invalid links 2021-06-29 02:11:30 +03:00
git-cliff chore(release): prepare for v0.1.0-rc.16 2021-06-30 01:35:28 +03:00
git-cliff-core chore(release): prepare for v0.1.0-rc.16 2021-06-30 01:35:28 +03:00
.dockerignore chore(docker): add Dockerfile 2021-06-11 21:41:03 +03:00
.editorconfig chore(project): update .editorconfig about shell scripts 2021-06-21 23:41:57 +03:00
.gitignore chore(project): rename 2021-05-30 01:45:03 +03:00
Cargo.lock chore(release): prepare for v0.1.0-rc.16 2021-06-30 01:35:28 +03:00
Cargo.toml chore(project): rename 2021-05-30 01:45:03 +03:00
CHANGELOG.md chore(release): prepare for v0.1.0-rc.16 2021-06-30 01:35:28 +03:00
cliff.toml style(config): update the order of entries in config 2021-06-20 21:55:47 +03:00
CODE_OF_CONDUCT.md chore(project): rename 2021-05-30 01:45:03 +03:00
codecov.yml chore(project): add codecov.yml 2021-06-07 03:14:06 +03:00
CONTRIBUTING.md docs(contributing): add CONTRIBUTING.md 2021-06-28 18:06:37 +03:00
Dockerfile chore(docker): remove user directive from Dockerfile 2021-06-18 02:20:08 +03:00
LICENSE Initial commit 2021-05-11 01:54:45 +03:00
README.md feat(changelog): support setting the body template via args 2021-06-20 16:57:26 +03:00
RELEASE.md chore(release): set the new version in release script 2021-06-30 01:26:32 +03:00
release.sh chore(release): verify the created tag after creation 2021-06-30 02:09:11 +03:00
rustfmt.toml chore(fmt): remove normalize_comments from rustfmt.toml 2021-06-04 03:11:15 +03:00


Installation

Usage

git-cliff [FLAGS] [OPTIONS] [RANGE]

Flags:

-v, --verbose       Increases the logging verbosity
-l, --latest        Processes the commits starting from the latest tag
-u, --unreleased    Processes the commits that do not belong to a tag
-h, --help          Prints help information
-V, --version       Prints version information

Options:

-c, --config <PATH>        Sets the configuration file [env: CONFIG=]  [default: cliff.toml]
-w, --workdir <PATH>       Sets the working directory [env: WORKDIR=]
-r, --repository <PATH>    Sets the repository to parse commits from [env: REPOSITORY=]
-p, --changelog <PATH>     Prepends entries to the given changelog file [env: CHANGELOG=]
-o, --output <PATH>        Writes output to the given file [env: OUTPUT=]
-t, --tag <TAG>            Sets the tag for the latest version [env: TAG=]
-b, --body <TEMPLATE>      Sets the template for the changelog body [env: TEMPLATE=]
-s, --strip <PART>         Strips the given parts from the changelog [possible values: header, footer, all]

Args:

<RANGE>    Sets the commit range to process

Docker

The easiest way of running git-cliff (in the git root directory) is to use the available tags from Docker Hub:

docker run -t -v "$(pwd)":/app/ orhunp/git-cliff:latest

Or you can use the image from the GitHub Package Registry:

docker run -t -v "$(pwd)":/app/ docker.pkg.github.com/orhun/git-cliff/git-cliff:latest

Also, you can build the image yourself using docker build -t git-cliff . command.

Examples

License

GNU General Public License (v3.0)

Copyright © 2021, git-cliff contributors