@@ -1990,7 +1990,7 @@ <h3 id="version-schemes">Version Schemes<a class="headerlink" href="#version-sch
19901990</ li >
19911991< li >
19921992< p > Configuration file:
1993- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
1993+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
19941994< span class ="n "> version_scheme</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="s2 "> "semver"</ span >
19951995</ code > </ pre > </ div > </ p >
19961996</ li >
@@ -2051,7 +2051,7 @@ <h3 id="-prerelease"><code>--prerelease</code><a class="headerlink" href="#-prer
20512051< p > For example, the following versions (using the < a href ="https://peps.python.org/pep-0440/ "> PEP 440</ a > scheme) are ordered
20522052by their precedence and showcase how a release might flow through a development cycle:</ p >
20532053< ul >
2054- < li > < code > 1.0.0</ code > is the current published version</ li >
2054+ < li > < code > 1.0.0</ code > is the currently published version</ li >
20552055< li > < code > 1.0.1a0</ code > after committing a < code > fix:</ code > for pre-release</ li >
20562056< li > < code > 1.1.0a1</ code > after committing an additional < code > feat:</ code > for pre-release</ li >
20572057< li > < code > 1.1.0b0</ code > after bumping a beta release</ li >
@@ -2128,18 +2128,18 @@ <h3 id="-check-consistency"><code>--check-consistency</code><a class="headerlink
21282128< div class ="highlight "> < pre > < span > </ span > < code > cz< span class ="w "> </ span > bump< span class ="w "> </ span > --check-consistency
21292129</ code > </ pre > </ div >
21302130< p > For example, if we have < code > pyproject.toml</ code > </ p >
2131- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2131+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
21322132< span class ="n "> version</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="s2 "> "1.21.0"</ span >
21332133< span class ="n "> version_files</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="p "> [</ span >
21342134< span class ="w "> </ span > < span class ="s2 "> "src/__version__.py"</ span > < span class ="p "> ,</ span >
21352135< span class ="w "> </ span > < span class ="s2 "> "setup.py"</ span > < span class ="p "> ,</ span >
21362136< span class ="p "> ]</ span >
21372137</ code > </ pre > </ div >
2138- < p > < code > src/__version__.py</ code > , </ p >
2139- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="n "> __version__</ span > < span class ="o "> =</ span > < span class ="s2 "> "1.21.0"</ span >
2138+ < p > < code > src/__version__.py</ code > </ p >
2139+ < div class ="highlight "> < span class =" filename " > src/__version__.py </ span > < pre > < span > </ span > < code > < span class ="n "> __version__</ span > < span class ="o "> =</ span > < span class ="s2 "> "1.21.0"</ span >
21402140</ code > </ pre > </ div >
2141- < p > and < code > setup.py</ code > . </ p >
2142- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="kn "> from</ span > < span class ="w "> </ span > < span class ="nn "> setuptools</ span > < span class ="w "> </ span > < span class ="kn "> import</ span > < span class ="n "> setup</ span >
2141+ < p > and < code > setup.py</ code > </ p >
2142+ < div class ="highlight "> < span class =" filename " > setup.py </ span > < pre > < span > </ span > < code > < span class ="kn "> from</ span > < span class ="w "> </ span > < span class ="nn "> setuptools</ span > < span class ="w "> </ span > < span class ="kn "> import</ span > < span class ="n "> setup</ span >
21432143
21442144< span class ="n "> setup</ span > < span class ="p "> (</ span > < span class ="o "> ...</ span > < span class ="p "> ,</ span > < span class ="n "> version</ span > < span class ="o "> =</ span > < span class ="s2 "> "1.0.5"</ span > < span class ="p "> ,</ span > < span class ="o "> ...</ span > < span class ="p "> )</ span >
21452145</ code > </ pre > </ div >
@@ -2153,7 +2153,7 @@ <h3 id="-local-version"><code>--local-version</code><a class="headerlink" href="
21532153< div class ="highlight "> < pre > < span > </ span > < code > cz< span class ="w "> </ span > bump< span class ="w "> </ span > --local-version
21542154</ code > </ pre > </ div >
21552155< p > For example, if we have < code > pyproject.toml</ code > </ p >
2156- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2156+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
21572157< span class ="n "> version</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="s2 "> "5.3.5+0.1.0"</ span >
21582158</ code > </ pre > </ div >
21592159< p > If < code > --local-version</ code > is used, it will bump only the local version < code > 0.1.0</ code > and keep the public version < code > 5.3.5</ code > intact, bumping to the version < code > 5.3.5+0.2.0</ code > .</ p >
@@ -2345,7 +2345,7 @@ <h3 id="tag_format"><code>tag_format</code><a class="headerlink" href="#tag_form
23452345< div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
23462346< span class ="n "> tag_format</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="s2 "> "v$major.$minor.$patch$prerelease"</ span >
23472347</ code > </ pre > </ div >
2348- < p > The variables must be preceded by a < code > $</ code > sign and optionally can be wrapped in < code > {}</ code > . Default is < code > $version</ code > .</ p >
2348+ < p > The variables must be preceded by a < code > $</ code > sign and optionally can be wrapped in < code > {}</ code > . The default is < code > $version</ code > .</ p >
23492349< p > Supported variables:</ p >
23502350< table >
23512351< thead >
@@ -2390,7 +2390,7 @@ <h3 id="version_files"><code>version_files</code> *<a class="headerlink" href="#
23902390< p > * Renamed from < code > files</ code > to < code > version_files</ code > .</ p >
23912391< p > Some examples</ p >
23922392< p > < code > pyproject.toml</ code > , < code > .cz.toml</ code > or < code > cz.toml</ code > </ p >
2393- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2393+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
23942394< span class ="n "> version_files</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="p "> [</ span >
23952395< span class ="w "> </ span > < span class ="s2 "> "src/__version__.py"</ span > < span class ="p "> ,</ span >
23962396< span class ="w "> </ span > < span class ="s2 "> "setup.py:version"</ span >
@@ -2401,8 +2401,7 @@ <h3 id="version_files"><code>version_files</code> *<a class="headerlink" href="#
24012401in a line containing the < code > version</ code > substring.</ p >
24022402< div class ="admonition note ">
24032403< p class ="admonition-title "> Note</ p >
2404- < p > Files can be specified using relative (to the execution) paths, absolute paths
2405- or glob patterns.</ p >
2404+ < p > Files can be specified using relative (to the execution) paths, absolute paths, or glob patterns.</ p >
24062405</ div >
24072406< hr />
24082407< h3 id ="bump_message "> < code > bump_message</ code > < a class ="headerlink " href ="#bump_message " title ="Permanent link "> ¶</ a > </ h3 >
@@ -2428,34 +2427,34 @@ <h3 id="bump_message"><code>bump_message</code><a class="headerlink" href="#bump
24282427</ table >
24292428< p > Some examples</ p >
24302429< p > < code > pyproject.toml</ code > , < code > .cz.toml</ code > or < code > cz.toml</ code > </ p >
2431- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2430+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
24322431< span class ="n "> bump_message</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="s2 "> "release $current_version → $new_version [skip-ci]"</ span >
24332432</ code > </ pre > </ div >
24342433< hr />
24352434< h3 id ="update_changelog_on_bump "> < code > update_changelog_on_bump</ code > < a class ="headerlink " href ="#update_changelog_on_bump " title ="Permanent link "> ¶</ a > </ h3 >
24362435< p > When set to < code > true</ code > the changelog is always updated incrementally when running < code > cz bump</ code > , so the user does not have to provide the < code > --changelog</ code > flag every time.</ p >
24372436< p > Defaults to: < code > false</ code > </ p >
2438- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2437+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
24392438< span class ="n "> update_changelog_on_bump</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="kc "> true</ span >
24402439</ code > </ pre > </ div >
24412440< hr />
24422441< h3 id ="annotated_tag "> < code > annotated_tag</ code > < a class ="headerlink " href ="#annotated_tag " title ="Permanent link "> ¶</ a > </ h3 >
24432442< p > When set to < code > true</ code > , Commitizen will create annotated tags.</ p >
2444- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2443+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
24452444< span class ="n "> annotated_tag</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="kc "> true</ span >
24462445</ code > </ pre > </ div >
24472446< hr />
24482447< h3 id ="gpg_sign "> < code > gpg_sign</ code > < a class ="headerlink " href ="#gpg_sign " title ="Permanent link "> ¶</ a > </ h3 >
24492448< p > When set to < code > true</ code > , Commitizen will create gpg signed tags.</ p >
2450- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2449+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
24512450< span class ="n "> gpg_sign</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="kc "> true</ span >
24522451</ code > </ pre > </ div >
24532452< hr />
24542453< h3 id ="major_version_zero "> < code > major_version_zero</ code > < a class ="headerlink " href ="#major_version_zero " title ="Permanent link "> ¶</ a > </ h3 >
24552454< p > When set to < code > true</ code > , Commitizen will keep the major version at zero.
24562455Useful during the initial development stage of your project.</ p >
24572456< p > Defaults to: < code > false</ code > </ p >
2458- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2457+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
24592458< span class ="n "> major_version_zero</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="kc "> true</ span >
24602459</ code > </ pre > </ div >
24612460< hr />
@@ -2506,7 +2505,7 @@ <h3 id="pre_bump_hooks"><code>pre_bump_hooks</code><a class="headerlink" href="#
25062505</ tr >
25072506</ tbody >
25082507</ table >
2509- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2508+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
25102509< span class ="n "> pre_bump_hooks</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="p "> [</ span >
25112510< span class ="w "> </ span > < span class ="s2 "> "scripts/generate_documentation.sh"</ span >
25122511< span class ="p "> ]</ span >
@@ -2558,15 +2557,15 @@ <h3 id="post_bump_hooks"><code>post_bump_hooks</code><a class="headerlink" href=
25582557</ tr >
25592558</ tbody >
25602559</ table >
2561- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2560+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
25622561< span class ="n "> post_bump_hooks</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="p "> [</ span >
25632562< span class ="w "> </ span > < span class ="s2 "> "scripts/slack_notification.sh"</ span >
25642563< span class ="p "> ]</ span >
25652564</ code > </ pre > </ div >
25662565< h3 id ="prerelease_offset "> < code > prerelease_offset</ code > < a class ="headerlink " href ="#prerelease_offset " title ="Permanent link "> ¶</ a > </ h3 >
25672566< p > Offset with which to start counting prereleases.</ p >
25682567< p > Defaults to: < code > 0</ code > </ p >
2569- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2568+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
25702569< span class ="n "> prerelease_offset</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="mi "> 1</ span >
25712570</ code > </ pre > </ div >
25722571< h3 id ="version_scheme "> < code > version_scheme</ code > < a class ="headerlink " href ="#version_scheme " title ="Permanent link "> ¶</ a > </ h3 >
@@ -2609,7 +2608,7 @@ <h3 id="version_scheme"><code>version_scheme</code><a class="headerlink" href="#
26092608</ table >
26102609< p > Options: < code > pep440</ code > , < code > semver</ code > , < code > semver2</ code > </ p >
26112610< p > Defaults to: < code > pep440</ code > </ p >
2612- < div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
2611+ < div class ="highlight "> < span class =" filename " > pyproject.toml </ span > < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
26132612< span class ="n "> version_scheme</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="s2 "> "semver"</ span >
26142613</ code > </ pre > </ div >
26152614< h2 id ="custom-bump "> Custom bump< a class ="headerlink " href ="#custom-bump " title ="Permanent link "> ¶</ a > </ h2 >
0 commit comments