286286
287287
288288
289-
290-
291- < li class ="md-nav__item ">
292- < a href ="../../getting_started/ " class ="md-nav__link ">
293-
294-
295- < span class ="md-ellipsis ">
296- Getting Started
297- </ span >
298-
299-
300- </ a >
301- </ li >
302-
303-
304-
305-
306-
307-
308-
309289
310290
311291
318298
319299
320300
321- < input class ="md-nav__toggle md-toggle " type ="checkbox " id ="__nav_3 " checked >
301+ < input class ="md-nav__toggle md-toggle " type ="checkbox " id ="__nav_2 " checked >
322302
323303
324- < label class ="md-nav__link " for ="__nav_3 " id ="__nav_3_label " tabindex ="0 ">
304+ < label class ="md-nav__link " for ="__nav_2 " id ="__nav_2_label " tabindex ="0 ">
325305
326306
327307 < span class ="md-ellipsis ">
332312 < span class ="md-nav__icon md-icon "> </ span >
333313 </ label >
334314
335- < nav class ="md-nav " data-md-level ="1 " aria-labelledby ="__nav_3_label " aria-expanded ="true ">
336- < label class ="md-nav__title " for ="__nav_3 ">
315+ < nav class ="md-nav " data-md-level ="1 " aria-labelledby ="__nav_2_label " aria-expanded ="true ">
316+ < label class ="md-nav__title " for ="__nav_2 ">
337317 < span class ="md-nav__icon md-icon "> </ span >
338318 Commands
339319 </ label >
997977
998978
999979
1000- < input class ="md-nav__toggle md-toggle " type ="checkbox " id ="__nav_6 " >
980+ < input class ="md-nav__toggle md-toggle " type ="checkbox " id ="__nav_5 " >
1001981
1002982
1003- < label class ="md-nav__link " for ="__nav_6 " id ="__nav_6_label " tabindex ="0 ">
983+ < label class ="md-nav__link " for ="__nav_5 " id ="__nav_5_label " tabindex ="0 ">
1004984
1005985
1006986 < span class ="md-ellipsis ">
1011991 < span class ="md-nav__icon md-icon "> </ span >
1012992 </ label >
1013993
1014- < nav class ="md-nav " data-md-level ="1 " aria-labelledby ="__nav_6_label " aria-expanded ="false ">
1015- < label class ="md-nav__title " for ="__nav_6 ">
994+ < nav class ="md-nav " data-md-level ="1 " aria-labelledby ="__nav_5_label " aria-expanded ="false ">
995+ < label class ="md-nav__title " for ="__nav_5 ">
1016996 < span class ="md-nav__icon md-icon "> </ span >
1017997 Tutorials
1018998 </ label >
@@ -1774,7 +1754,7 @@ <h3 id="-changelog"><code>--changelog</code><a class="headerlink" href="#-change
17741754< h3 id ="-prerelease "> < code > --prerelease</ code > < a class ="headerlink " href ="#-prerelease " title ="Permanent link "> ¶</ a > </ h3 >
17751755< p > The bump is a pre-release bump, meaning that in addition to a possible version bump the new version receives a
17761756pre-release segment compatible with the bump’s version scheme, where the segment consist of a < em > phase</ em > and a
1777- non-negative number. Supported options for < code > --prerelease</ code > are the following phase names < code > alpha</ code > , < code > beta</ code > , or
1757+ non-negative number. Supported options for < code > --prerelease</ code > are the following phase names < code > alpha</ code > , < code > beta</ code > , or
17781758< code > rc</ code > (release candidate). For more details, refer to the
17791759< a href ="https://packaging.python.org/en/latest/specifications/version-specifiers/#pre-releases "> Python Packaging User Guide</ a > .</ p >
17801760< p > Note that as per < a href ="https://semver.org/#spec-item-9 "> semantic versioning spec</ a > </ p >
@@ -1858,7 +1838,7 @@ <h3 id="-increment-mode"><code>--increment-mode</code><a class="headerlink" href
18581838</ tbody >
18591839</ table >
18601840< h3 id ="-check-consistency "> < code > --check-consistency</ code > < a class ="headerlink " href ="#-check-consistency " title ="Permanent link "> ¶</ a > </ h3 >
1861- < p > Check whether the versions defined in < code > version_files</ code > and the version in commitizen
1841+ < p > Check whether the versions defined in < code > version_files</ code > and the version in Commitizen
18621842configuration are consistent before bumping version.</ p >
18631843< div class ="highlight "> < pre > < span > </ span > < code > cz< span class ="w "> </ span > bump< span class ="w "> </ span > --check-consistency
18641844</ code > </ pre > </ div >
@@ -1878,7 +1858,7 @@ <h3 id="-check-consistency"><code>--check-consistency</code><a class="headerlink
18781858
18791859< 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 >
18801860</ code > </ pre > </ div >
1881- < p > If < code > --check-consistency</ code > is used, commitizen will check whether the current version in < code > pyproject.toml</ code >
1861+ < p > If < code > --check-consistency</ code > is used, Commitizen will check whether the current version in < code > pyproject.toml</ code >
18821862exists in all version_files and find out it does not exist in < code > setup.py</ code > and fails.
18831863However, it will still update < code > pyproject.toml</ code > and < code > src/__version__.py</ code > .</ p >
18841864< p > To fix it, you'll first < code > git checkout .</ code > to reset to the status before trying to bump and update
@@ -1893,9 +1873,9 @@ <h3 id="-local-version"><code>--local-version</code><a class="headerlink" href="
18931873</ code > </ pre > </ div >
18941874< 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 >
18951875< h3 id ="-annotated-tag "> < code > --annotated-tag</ code > < a class ="headerlink " href ="#-annotated-tag " title ="Permanent link "> ¶</ a > </ h3 >
1896- < p > If < code > --annotated-tag</ code > is used, commitizen will create annotated tags. Also available via configuration, in < code > pyproject.toml</ code > or < code > .cz.toml</ code > .</ p >
1876+ < p > If < code > --annotated-tag</ code > is used, Commitizen will create annotated tags. It is also available via configuration, in < code > pyproject.toml</ code > or < code > .cz.toml</ code > .</ p >
18971877< h3 id ="-annotated-tag-message "> < code > --annotated-tag-message</ code > < a class ="headerlink " href ="#-annotated-tag-message " title ="Permanent link "> ¶</ a > </ h3 >
1898- < p > If < code > --annotated-tag-message</ code > is used, commitizen will create annotated tags with the given message.</ p >
1878+ < p > If < code > --annotated-tag-message</ code > is used, Commitizen will create annotated tags with the given message.</ p >
18991879< h3 id ="-changelog-to-stdout "> < code > --changelog-to-stdout</ code > < a class ="headerlink " href ="#-changelog-to-stdout " title ="Permanent link "> ¶</ a > </ h3 >
19001880< p > If < code > --changelog-to-stdout</ code > is used, the incremental changelog generated by the bump
19011881will be sent to the stdout, and any other message generated by the bump will be
@@ -2013,10 +1993,10 @@ <h3 id="-allow-no-commit"><code>--allow-no-commit</code><a class="headerlink" hr
20131993cz< span class ="w "> </ span > bump< span class ="w "> </ span > --allow-no-commit< span class ="w "> </ span > < span class ="m "> 2</ span > .0.0
20141994</ code > </ pre > </ div >
20151995< h2 id ="avoid-raising-errors "> Avoid raising errors< a class ="headerlink " href ="#avoid-raising-errors " title ="Permanent link "> ¶</ a > </ h2 >
2016- < p > Some situations from commitizen raise an exit code different than 0.
2017- If the error code is different than 0, any CI or script running commitizen might be interrupted.</ p >
1996+ < p > Some situations from Commitizen raise an exit code different from 0.
1997+ If the error code is different from 0, any CI or script running Commitizen might be interrupted.</ p >
20181998< p > If you have a special use case, where you don't want to raise one of this error codes, you can
2019- tell commitizen to not raise them.</ p >
1999+ tell Commitizen to not raise them.</ p >
20202000< h3 id ="recommended-use-case "> Recommended use case< a class ="headerlink " href ="#recommended-use-case " title ="Permanent link "> ¶</ a > </ h3 >
20212001< p > At the moment, we've identified that the most common error code to skip is</ p >
20222002< table >
@@ -2038,24 +2018,24 @@ <h3 id="recommended-use-case">Recommended use case<a class="headerlink" href="#r
20382018< div class ="highlight "> < pre > < span > </ span > < code > cz< span class ="w "> </ span > -nr< span class ="w "> </ span > < span class ="m "> 21</ span > < span class ="w "> </ span > bump
20392019</ code > </ pre > </ div >
20402020< h3 id ="easy-way "> Easy way< a class ="headerlink " href ="#easy-way " title ="Permanent link "> ¶</ a > </ h3 >
2041- < p > Check which error code was raised by commitizen by running in the terminal</ p >
2021+ < p > Check which error code was raised by Commitizen by running in the terminal</ p >
20422022< div class ="highlight "> < pre > < span > </ span > < code > < span class ="nb "> echo</ span > < span class ="w "> </ span > < span class ="nv "> $?</ span >
20432023</ code > </ pre > </ div >
20442024< p > The output should be an integer like this</ p >
20452025< div class ="highlight "> < pre > < span > </ span > < code > < span class ="m "> 3</ span >
20462026</ code > </ pre > </ div >
2047- < p > And then you can tell commitizen to ignore it:</ p >
2027+ < p > And then you can tell Commitizen to ignore it:</ p >
20482028< div class ="highlight "> < pre > < span > </ span > < code > cz< span class ="w "> </ span > --no-raise< span class ="w "> </ span > < span class ="m "> 3</ span >
20492029</ code > </ pre > </ div >
2050- < p > You can tell commitizen to skip more than one if needed:</ p >
2030+ < p > You can tell Commitizen to skip more than one if needed:</ p >
20512031< div class ="highlight "> < pre > < span > </ span > < code > cz< span class ="w "> </ span > --no-raise< span class ="w "> </ span > < span class ="m "> 3</ span > ,4,5
20522032</ code > </ pre > </ div >
20532033< h3 id ="longer-way "> Longer way< a class ="headerlink " href ="#longer-way " title ="Permanent link "> ¶</ a > </ h3 >
20542034< p > Check the list of < a href ="../../exit_codes/ "> exit_codes</ a > and understand which one you have
20552035to skip and why.</ p >
20562036< p > Remember to document somewhere this, because you'll forget.</ p >
20572037< p > For example if the system raises a < code > NoneIncrementExit</ code > error, you look it up
2058- on the list and then you can use the exit code:</ p >
2038+ on the list, and then you can use the exit code:</ p >
20592039< div class ="highlight "> < pre > < span > </ span > < code > cz< span class ="w "> </ span > -nr< span class ="w "> </ span > < span class ="m "> 21</ span > < span class ="w "> </ span > bump
20602040</ code > </ pre > </ div >
20612041< h2 id ="configuration "> Configuration< a class ="headerlink " href ="#configuration " title ="Permanent link "> ¶</ a > </ h2 >
@@ -2065,7 +2045,7 @@ <h3 id="tag_format"><code>tag_format</code><a class="headerlink" href="#tag_form
20652045< ul >
20662046< li > < code > cz bump</ code > : Find previous release tag (exact match) and generate new tag.</ li >
20672047< li > Find previous release tags in < code > cz changelog</ code > .</ li >
2068- < li > If < code > --incremental</ code > : Using latest version found in the changelog, scan existing Git tags with 89\% similarity match.</ li >
2048+ < li > If < code > --incremental</ code > : Using the latest version found in the changelog, scan existing Git tags with 89\% similarity match.</ li >
20692049< li > < code > --rev-range</ code > is converted to Git tag names with < code > tag_format</ code > before searching Git history.</ li >
20702050< li > If the < code > scm</ code > < code > version_provider</ code > is used, it uses different regexes to find the previous version tags:</ li >
20712051< li > If < code > tag_format</ code > is set to < code > $version</ code > (default): < code > VersionProtocol.parser</ code > (allows < code > v</ code > prefix)</ li >
@@ -2142,7 +2122,7 @@ <h3 id="version_files"><code>version_files</code> *<a class="headerlink" href="#
21422122< hr />
21432123< h3 id ="bump_message "> < code > bump_message</ code > < a class ="headerlink " href ="#bump_message " title ="Permanent link "> ¶</ a > </ h3 >
21442124< p > Template used to specify the commit message generated when bumping.</ p >
2145- < p > defaults to: < code > bump: version $current_version → $new_version</ code > </ p >
2125+ < p > Defaults to: < code > bump: version $current_version → $new_version</ code > </ p >
21462126< table >
21472127< thead >
21482128< tr >
@@ -2169,25 +2149,25 @@ <h3 id="bump_message"><code>bump_message</code><a class="headerlink" href="#bump
21692149< hr />
21702150< 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 >
21712151< 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 >
2172- < p > defaults to: < code > false</ code > </ p >
2152+ < p > Defaults to: < code > false</ code > </ p >
21732153< div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
21742154< 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 >
21752155</ code > </ pre > </ div >
21762156< hr />
21772157< h3 id ="annotated_tag "> < code > annotated_tag</ code > < a class ="headerlink " href ="#annotated_tag " title ="Permanent link "> ¶</ a > </ h3 >
2178- < p > When set to < code > true</ code > commitizen will create annotated tags.</ p >
2158+ < p > When set to < code > true</ code > , Commitizen will create annotated tags.</ p >
21792159< div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
21802160< span class ="n "> annotated_tag</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="kc "> true</ span >
21812161</ code > </ pre > </ div >
21822162< hr />
21832163< h3 id ="gpg_sign "> < code > gpg_sign</ code > < a class ="headerlink " href ="#gpg_sign " title ="Permanent link "> ¶</ a > </ h3 >
2184- < p > When set to < code > true</ code > commitizen will create gpg signed tags.</ p >
2164+ < p > When set to < code > true</ code > , Commitizen will create gpg signed tags.</ p >
21852165< div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
21862166< span class ="n "> gpg_sign</ span > < span class ="w "> </ span > < span class ="o "> =</ span > < span class ="w "> </ span > < span class ="kc "> true</ span >
21872167</ code > </ pre > </ div >
21882168< hr />
21892169< h3 id ="major_version_zero "> < code > major_version_zero</ code > < a class ="headerlink " href ="#major_version_zero " title ="Permanent link "> ¶</ a > </ h3 >
2190- < p > When set to < code > true</ code > commitizen will keep the major version at zero.
2170+ < p > When set to < code > true</ code > , Commitizen will keep the major version at zero.
21912171Useful during the initial development stage of your project.</ p >
21922172< p > Defaults to: < code > false</ code > </ p >
21932173< div class ="highlight "> < pre > < span > </ span > < code > < span class ="k "> [tool.commitizen]</ span >
0 commit comments