You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
--gpg-sign, -s sign tag instead of lightweight one
92
95
--changelog-to-stdout
93
96
Output changelog to the stdout
94
97
--git-output-to-stderr
95
98
Redirect git output to stderr
96
99
--retry retry commit if it fails the 1st time
97
100
--major-version-zero keep major version at zero, even for breaking changes
101
+
--template TEMPLATE, -t TEMPLATE
102
+
changelog template file name (relative to the current working directory)
103
+
--extra EXTRA, -e EXTRA
104
+
a changelog extra variable (in the form 'key=value')
105
+
--file-name FILE_NAME
106
+
file name of changelog (default: 'CHANGELOG.md')
98
107
--prerelease-offset PRERELEASE_OFFSET
99
108
start pre-releases with this offset
100
-
--version-scheme {pep440,semver,semver2}
109
+
--version-scheme {pep440,semver2,semver}
101
110
choose version scheme
102
-
--version-type {pep440,semver,semver2}
111
+
--version-type {pep440,semver2,semver}
103
112
Deprecated, use --version-scheme
104
-
--build-metadata {BUILD_METADATA}
105
-
additional metadata in the version string
113
+
--build-metadata BUILD_METADATA
114
+
Add additional build-metadata to the version-number
115
+
--allow-no-commit bump version without eligible commits
106
116
```
107
117
108
118
### `--files-only`
@@ -337,6 +347,18 @@ You should normally not use this functionality, but if you decide to do, keep in
337
347
* Version `1.2.3+a`, and `1.2.3+b` are the same version! Tools should not use the string after `+` for version calculation. This is probably not a guarantee (example in helm) even tho it is in the spec.
338
348
* It might be problematic having the metadata in place when doing upgrades depending on what tool you use.
339
349
350
+
### `--allow-no-commit`
351
+
352
+
Allow the project version to be bumped even when there's no eligible version. This is most useful when used with `--increment {MAJOR,MINOR,PATCH}` or `[MANUL_VERSION]`
353
+
354
+
```sh
355
+
# bump a minor version even when there's only bug fixes, documentation changes or even no commits
356
+
cz bump --incremental MINOR --allow-no-commit
357
+
358
+
# bump version to 2.0.0 even when there's no breaking changes changes or even no commits
359
+
cz bump --allow-no-commit 2.0.0
360
+
```
361
+
340
362
## Avoid raising errors
341
363
342
364
Some situations from commitizen raise an exit code different than 0.
0 commit comments