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
--dry-run show output to stdout, no commit, no modified files
65
65
--files-only bump version in the files from the config
66
66
--changelog, -ch generate the changelog for the newest version
67
-
--no-verify this option bypasses the pre-commit and commit-msg
68
-
hooks
67
+
--no-verify this option bypasses the pre-commit and commit-msg hooks
69
68
--yes accept automatically questions done
70
69
--local-version bump the local portion of the version
71
70
--tag-format TAG_FORMAT
72
-
the format used to tag the commit and read it, use it
73
-
in existing projects, wrap around simple quotes
71
+
the format used to tag the commit and read it, use itin existing projects, wrap
72
+
around simple quotes
74
73
--bump-message BUMP_MESSAGE
75
-
template used to create the release commit, useful
76
-
when working with CI
74
+
template used to create the release commit, useful when working with CI
77
75
--prerelease {alpha,beta,rc}, -pr {alpha,beta,rc}
78
76
choose type of prerelease
79
77
--increment {MAJOR,MINOR,PATCH}
80
78
manually specify the desired increment
81
79
--check-consistency, -cc
82
-
check consistency among versions defined in commitizen
83
-
configuration and version_files
80
+
check consistency among versions defined in commitizen configuration and
81
+
version_files
82
+
--annotated-tag, -at create annotated tag instead of lightweight one
84
83
```
85
84
86
85
### `--files-only`
@@ -158,6 +157,10 @@ version = "5.3.5+0.1.0"
158
157
159
158
If `--local-version` is used, it will bump only the local version `0.1.0` and keep the public version `5.3.5` intact, bumping to the version `5.3.5+0.2.0`.
160
159
160
+
### `--annotated-tag`
161
+
162
+
If `--annotated-tag` is used, commitizen will create annotated tags. Also available via configuration, in `pyproject.toml` or `.cz.toml`.
163
+
161
164
## Configuration
162
165
163
166
### `tag_format`
@@ -256,6 +259,17 @@ defaults to: `false`
256
259
update_changelog_on_bump = true
257
260
```
258
261
262
+
---
263
+
264
+
### `annotated_tag`
265
+
266
+
When set to `true` commitizen will create annotated tags.
267
+
268
+
```toml
269
+
[tool.commitizen]
270
+
annotated_tag = true
271
+
```
272
+
259
273
## Custom bump
260
274
261
275
Read the [customizing section](./customization.md).
0 commit comments