Skip to content

Commit a3cd7c1

Browse files
deploy: bb1539d
1 parent 61713b8 commit a3cd7c1

File tree

32 files changed

+1285
-2475
lines changed

32 files changed

+1285
-2475
lines changed

404.html

Lines changed: 8 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -279,26 +279,6 @@
279279

280280

281281

282-
<li class="md-nav__item">
283-
<a href="/getting_started/" class="md-nav__link">
284-
285-
286-
<span class="md-ellipsis">
287-
Getting Started
288-
</span>
289-
290-
291-
</a>
292-
</li>
293-
294-
295-
296-
297-
298-
299-
300-
301-
302282

303283

304284

@@ -307,10 +287,10 @@
307287

308288

309289

310-
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
290+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
311291

312292

313-
<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
293+
<label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
314294

315295

316296
<span class="md-ellipsis">
@@ -321,8 +301,8 @@
321301
<span class="md-nav__icon md-icon"></span>
322302
</label>
323303

324-
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
325-
<label class="md-nav__title" for="__nav_3">
304+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
305+
<label class="md-nav__title" for="__nav_2">
326306
<span class="md-nav__icon md-icon"></span>
327307
Commands
328308
</label>
@@ -599,10 +579,10 @@
599579

600580

601581

602-
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
582+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
603583

604584

605-
<label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
585+
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
606586

607587

608588
<span class="md-ellipsis">
@@ -613,8 +593,8 @@
613593
<span class="md-nav__icon md-icon"></span>
614594
</label>
615595

616-
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
617-
<label class="md-nav__title" for="__nav_6">
596+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
597+
<label class="md-nav__title" for="__nav_5">
618598
<span class="md-nav__icon md-icon"></span>
619599
Tutorials
620600
</label>

commands/bump/index.html

Lines changed: 26 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -286,26 +286,6 @@
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

@@ -318,10 +298,10 @@
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">
@@ -332,8 +312,8 @@
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>
@@ -997,10 +977,10 @@
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">
@@ -1011,8 +991,8 @@
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">&para;</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
17761756
pre-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">&para;</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
18621842
configuration 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">&quot;1.0.5&quot;</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>
18821862
exists in all version_files and find out it does not exist in <code>setup.py</code> and fails.
18831863
However, 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">&para;</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">&para;</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">&para;</a></h3>
19001880
<p>If <code>--changelog-to-stdout</code> is used, the incremental changelog generated by the bump
19011881
will 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
20131993
cz<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">&para;</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">&para;</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">&para;</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">&para;</a></h3>
20542034
<p>Check the list of <a href="../../exit_codes/">exit_codes</a> and understand which one you have
20552035
to 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">&para;</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">&para;</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">&para;</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">&para;</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">&para;</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">&para;</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.
21912171
Useful 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

Comments
 (0)