Skip to content

Commit 750e041

Browse files
Deployed 0da3bdb to v0.13-dev with MkDocs 1.6.1 and mike 2.1.3
1 parent aa79975 commit 750e041

3 files changed

Lines changed: 125 additions & 42 deletions

File tree

v0.13-dev/reference/frequenz/repo/config/mkdocs/mike/index.html

Lines changed: 46 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -2755,7 +2755,10 @@ <h4 id="frequenz.repo.config.mkdocs.mike.compare_mike_version" class="doc doc-he
27552755
<span class="normal"><a href="#__codelineno-0-207">207</a></span>
27562756
<span class="normal"><a href="#__codelineno-0-208">208</a></span>
27572757
<span class="normal"><a href="#__codelineno-0-209">209</a></span>
2758-
<span class="normal"><a href="#__codelineno-0-210">210</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-171"><a id="__codelineno-0-171" name="__codelineno-0-171"></a><span class="k">def</span><span class="w"> </span><span class="nf">compare_mike_version</span><span class="p">(</span><span class="n">version1</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">version2</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
2758+
<span class="normal"><a href="#__codelineno-0-210">210</a></span>
2759+
<span class="normal"><a href="#__codelineno-0-211">211</a></span>
2760+
<span class="normal"><a href="#__codelineno-0-212">212</a></span>
2761+
<span class="normal"><a href="#__codelineno-0-213">213</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-171"><a id="__codelineno-0-171" name="__codelineno-0-171"></a><span class="k">def</span><span class="w"> </span><span class="nf">compare_mike_version</span><span class="p">(</span><span class="n">version1</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">version2</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
27592762
</span><span id="__span-0-172"><a id="__codelineno-0-172" name="__codelineno-0-172"></a><span class="w"> </span><span class="sd">&quot;&quot;&quot;Compare two versions.</span>
27602763
</span><span id="__span-0-173"><a id="__codelineno-0-173" name="__codelineno-0-173"></a>
27612764
</span><span id="__span-0-174"><a id="__codelineno-0-174" name="__codelineno-0-174"></a><span class="sd"> The versions are compared as follows:</span>
@@ -2794,7 +2797,10 @@ <h4 id="frequenz.repo.config.mkdocs.mike.compare_mike_version" class="doc doc-he
27942797
</span><span id="__span-0-207"><a id="__codelineno-0-207" name="__codelineno-0-207"></a> <span class="k">if</span> <span class="n">is_version_v2</span><span class="p">:</span> <span class="c1"># version1 is not a version</span>
27952798
</span><span id="__span-0-208"><a id="__codelineno-0-208" name="__codelineno-0-208"></a> <span class="k">return</span> <span class="mi">1</span>
27962799
</span><span id="__span-0-209"><a id="__codelineno-0-209" name="__codelineno-0-209"></a>
2797-
</span><span id="__span-0-210"><a id="__codelineno-0-210" name="__codelineno-0-210"></a> <span class="k">return</span> <span class="o">-</span><span class="mi">1</span> <span class="k">if</span> <span class="n">version1</span> <span class="o">&lt;</span> <span class="n">version2</span> <span class="k">else</span> <span class="mi">1</span>
2800+
</span><span id="__span-0-210"><a id="__codelineno-0-210" name="__codelineno-0-210"></a> <span class="k">if</span> <span class="n">version1</span> <span class="o">==</span> <span class="n">version2</span><span class="p">:</span>
2801+
</span><span id="__span-0-211"><a id="__codelineno-0-211" name="__codelineno-0-211"></a> <span class="k">return</span> <span class="mi">0</span>
2802+
</span><span id="__span-0-212"><a id="__codelineno-0-212" name="__codelineno-0-212"></a>
2803+
</span><span id="__span-0-213"><a id="__codelineno-0-213" name="__codelineno-0-213"></a> <span class="k">return</span> <span class="o">-</span><span class="mi">1</span> <span class="k">if</span> <span class="n">version1</span> <span class="o">&lt;</span> <span class="n">version2</span> <span class="k">else</span> <span class="mi">1</span>
27982804
</span></code></pre></div></td></tr></table></div>
27992805
</details>
28002806
</div>
@@ -2915,10 +2921,7 @@ <h4 id="frequenz.repo.config.mkdocs.mike.sort_mike_versions" class="doc doc-head
29152921

29162922
<details class="quote">
29172923
<summary>Source code in <code>frequenz/repo/config/mkdocs/mike.py</code></summary>
2918-
<div class="language-python highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-213">213</a></span>
2919-
<span class="normal"><a href="#__codelineno-0-214">214</a></span>
2920-
<span class="normal"><a href="#__codelineno-0-215">215</a></span>
2921-
<span class="normal"><a href="#__codelineno-0-216">216</a></span>
2924+
<div class="language-python highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-216">216</a></span>
29222925
<span class="normal"><a href="#__codelineno-0-217">217</a></span>
29232926
<span class="normal"><a href="#__codelineno-0-218">218</a></span>
29242927
<span class="normal"><a href="#__codelineno-0-219">219</a></span>
@@ -2950,42 +2953,45 @@ <h4 id="frequenz.repo.config.mkdocs.mike.sort_mike_versions" class="doc doc-head
29502953
<span class="normal"><a href="#__codelineno-0-245">245</a></span>
29512954
<span class="normal"><a href="#__codelineno-0-246">246</a></span>
29522955
<span class="normal"><a href="#__codelineno-0-247">247</a></span>
2953-
<span class="normal"><a href="#__codelineno-0-248">248</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-213"><a id="__codelineno-0-213" name="__codelineno-0-213"></a><span class="k">def</span><span class="w"> </span><span class="nf">sort_mike_versions</span><span class="p">(</span><span class="n">versions</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">*</span><span class="p">,</span> <span class="n">reverse</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
2954-
</span><span id="__span-0-214"><a id="__codelineno-0-214" name="__codelineno-0-214"></a><span class="w"> </span><span class="sd">&quot;&quot;&quot;Sort `mike`&#39;s `version.json` file with a custom order.</span>
2955-
</span><span id="__span-0-215"><a id="__codelineno-0-215" name="__codelineno-0-215"></a>
2956-
</span><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216"></a><span class="sd"> The `version` keys are expected as follows:</span>
2957-
</span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217"></a>
2958-
</span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218"></a><span class="sd"> - `vX.Y` for stable release versions</span>
2959-
</span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219"></a><span class="sd"> - `vX.Y-pre` for pre-release versions</span>
2960-
</span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220"></a><span class="sd"> - `vX.Y-dev` for development versions</span>
2961-
</span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221"></a><span class="sd"> - Any other arbitrary string for other versions</span>
2962-
</span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222"></a>
2963-
</span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223"></a><span class="sd"> The sorting order is as follows:</span>
2964-
</span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224"></a>
2965-
</span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225"></a><span class="sd"> - Versions are first sorted by major version (`X`).</span>
2966-
</span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226"></a><span class="sd"> - Inside a major version group, versions are sorted by minor version (`Y`).</span>
2967-
</span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227"></a><span class="sd"> - For the same major and minor version, development versions (`-dev`) considered</span>
2968-
</span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228"></a><span class="sd"> the latest for that major version group, then stable versions, and finally</span>
2969-
</span><span id="__span-0-229"><a id="__codelineno-0-229" name="__codelineno-0-229"></a><span class="sd"> pre-release versions (`-pre`).</span>
2970-
</span><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230"></a><span class="sd"> - Other versions appear first and are sorted alphabetically.</span>
2971-
</span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231"></a>
2972-
</span><span id="__span-0-232"><a id="__codelineno-0-232" name="__codelineno-0-232"></a><span class="sd"> The versions are sorted in-place using</span>
2973-
</span><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233"></a><span class="sd"> [`compare_mike_version()`][frequenz.repo.config.mkdocs.mike.compare_mike_version].</span>
2956+
<span class="normal"><a href="#__codelineno-0-248">248</a></span>
2957+
<span class="normal"><a href="#__codelineno-0-249">249</a></span>
2958+
<span class="normal"><a href="#__codelineno-0-250">250</a></span>
2959+
<span class="normal"><a href="#__codelineno-0-251">251</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216"></a><span class="k">def</span><span class="w"> </span><span class="nf">sort_mike_versions</span><span class="p">(</span><span class="n">versions</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="o">*</span><span class="p">,</span> <span class="n">reverse</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
2960+
</span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217"></a><span class="w"> </span><span class="sd">&quot;&quot;&quot;Sort `mike`&#39;s `version.json` file with a custom order.</span>
2961+
</span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218"></a>
2962+
</span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219"></a><span class="sd"> The `version` keys are expected as follows:</span>
2963+
</span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220"></a>
2964+
</span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221"></a><span class="sd"> - `vX.Y` for stable release versions</span>
2965+
</span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222"></a><span class="sd"> - `vX.Y-pre` for pre-release versions</span>
2966+
</span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223"></a><span class="sd"> - `vX.Y-dev` for development versions</span>
2967+
</span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224"></a><span class="sd"> - Any other arbitrary string for other versions</span>
2968+
</span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225"></a>
2969+
</span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226"></a><span class="sd"> The sorting order is as follows:</span>
2970+
</span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227"></a>
2971+
</span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228"></a><span class="sd"> - Versions are first sorted by major version (`X`).</span>
2972+
</span><span id="__span-0-229"><a id="__codelineno-0-229" name="__codelineno-0-229"></a><span class="sd"> - Inside a major version group, versions are sorted by minor version (`Y`).</span>
2973+
</span><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230"></a><span class="sd"> - For the same major and minor version, development versions (`-dev`) considered</span>
2974+
</span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231"></a><span class="sd"> the latest for that major version group, then stable versions, and finally</span>
2975+
</span><span id="__span-0-232"><a id="__codelineno-0-232" name="__codelineno-0-232"></a><span class="sd"> pre-release versions (`-pre`).</span>
2976+
</span><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233"></a><span class="sd"> - Other versions appear first and are sorted alphabetically.</span>
29742977
</span><span id="__span-0-234"><a id="__codelineno-0-234" name="__codelineno-0-234"></a>
2975-
</span><span id="__span-0-235"><a id="__codelineno-0-235" name="__codelineno-0-235"></a><span class="sd"> Example:</span>
2976-
</span><span id="__span-0-236"><a id="__codelineno-0-236" name="__codelineno-0-236"></a>
2977-
</span><span id="__span-0-237"><a id="__codelineno-0-237" name="__codelineno-0-237"></a><span class="sd"> `z`, `whatever`, `v2.1-dev`, `v2.1`, `v2.1-pre`, `v2.0`, `v1.1-dev`, `v1.0-dev`,</span>
2978-
</span><span id="__span-0-238"><a id="__codelineno-0-238" name="__codelineno-0-238"></a><span class="sd"> `v1.0`</span>
2978+
</span><span id="__span-0-235"><a id="__codelineno-0-235" name="__codelineno-0-235"></a><span class="sd"> The versions are sorted in-place using</span>
2979+
</span><span id="__span-0-236"><a id="__codelineno-0-236" name="__codelineno-0-236"></a><span class="sd"> [`compare_mike_version()`][frequenz.repo.config.mkdocs.mike.compare_mike_version].</span>
2980+
</span><span id="__span-0-237"><a id="__codelineno-0-237" name="__codelineno-0-237"></a>
2981+
</span><span id="__span-0-238"><a id="__codelineno-0-238" name="__codelineno-0-238"></a><span class="sd"> Example:</span>
29792982
</span><span id="__span-0-239"><a id="__codelineno-0-239" name="__codelineno-0-239"></a>
2980-
</span><span id="__span-0-240"><a id="__codelineno-0-240" name="__codelineno-0-240"></a><span class="sd"> Args:</span>
2981-
</span><span id="__span-0-241"><a id="__codelineno-0-241" name="__codelineno-0-241"></a><span class="sd"> versions: The list of versions to sort.</span>
2982-
</span><span id="__span-0-242"><a id="__codelineno-0-242" name="__codelineno-0-242"></a><span class="sd"> reverse: Whether to sort in reverse order.</span>
2983-
</span><span id="__span-0-243"><a id="__codelineno-0-243" name="__codelineno-0-243"></a>
2984-
</span><span id="__span-0-244"><a id="__codelineno-0-244" name="__codelineno-0-244"></a><span class="sd"> Returns:</span>
2985-
</span><span id="__span-0-245"><a id="__codelineno-0-245" name="__codelineno-0-245"></a><span class="sd"> The sorted list of versions.</span>
2986-
</span><span id="__span-0-246"><a id="__codelineno-0-246" name="__codelineno-0-246"></a><span class="sd"> &quot;&quot;&quot;</span>
2987-
</span><span id="__span-0-247"><a id="__codelineno-0-247" name="__codelineno-0-247"></a> <span class="n">versions</span><span class="o">.</span><span class="n">sort</span><span class="p">(</span><span class="n">key</span><span class="o">=</span><span class="n">functools</span><span class="o">.</span><span class="n">cmp_to_key</span><span class="p">(</span><span class="n">compare_mike_version</span><span class="p">),</span> <span class="n">reverse</span><span class="o">=</span><span class="n">reverse</span><span class="p">)</span>
2988-
</span><span id="__span-0-248"><a id="__codelineno-0-248" name="__codelineno-0-248"></a> <span class="k">return</span> <span class="n">versions</span>
2983+
</span><span id="__span-0-240"><a id="__codelineno-0-240" name="__codelineno-0-240"></a><span class="sd"> `z`, `whatever`, `v2.1-dev`, `v2.1`, `v2.1-pre`, `v2.0`, `v1.1-dev`, `v1.0-dev`,</span>
2984+
</span><span id="__span-0-241"><a id="__codelineno-0-241" name="__codelineno-0-241"></a><span class="sd"> `v1.0`</span>
2985+
</span><span id="__span-0-242"><a id="__codelineno-0-242" name="__codelineno-0-242"></a>
2986+
</span><span id="__span-0-243"><a id="__codelineno-0-243" name="__codelineno-0-243"></a><span class="sd"> Args:</span>
2987+
</span><span id="__span-0-244"><a id="__codelineno-0-244" name="__codelineno-0-244"></a><span class="sd"> versions: The list of versions to sort.</span>
2988+
</span><span id="__span-0-245"><a id="__codelineno-0-245" name="__codelineno-0-245"></a><span class="sd"> reverse: Whether to sort in reverse order.</span>
2989+
</span><span id="__span-0-246"><a id="__codelineno-0-246" name="__codelineno-0-246"></a>
2990+
</span><span id="__span-0-247"><a id="__codelineno-0-247" name="__codelineno-0-247"></a><span class="sd"> Returns:</span>
2991+
</span><span id="__span-0-248"><a id="__codelineno-0-248" name="__codelineno-0-248"></a><span class="sd"> The sorted list of versions.</span>
2992+
</span><span id="__span-0-249"><a id="__codelineno-0-249" name="__codelineno-0-249"></a><span class="sd"> &quot;&quot;&quot;</span>
2993+
</span><span id="__span-0-250"><a id="__codelineno-0-250" name="__codelineno-0-250"></a> <span class="n">versions</span><span class="o">.</span><span class="n">sort</span><span class="p">(</span><span class="n">key</span><span class="o">=</span><span class="n">functools</span><span class="o">.</span><span class="n">cmp_to_key</span><span class="p">(</span><span class="n">compare_mike_version</span><span class="p">),</span> <span class="n">reverse</span><span class="o">=</span><span class="n">reverse</span><span class="p">)</span>
2994+
</span><span id="__span-0-251"><a id="__codelineno-0-251" name="__codelineno-0-251"></a> <span class="k">return</span> <span class="n">versions</span>
29892995
</span></code></pre></div></td></tr></table></div>
29902996
</details>
29912997
</div>

v0.13-dev/search/search_index.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

versions.json

Lines changed: 78 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,78 @@
1-
[{"version":"v0.14-dev","title":"v0.14-dev (9406b99)","aliases":["latest-dev","v0-dev"]},{"version":"v0.13-dev","title":"v0.13-dev (f93e20f)","aliases":[]},{"version":"v0.13","title":"v0.13.4","aliases":["v0","latest"]},{"version":"v0.12-dev","title":"v0.12-dev (07780ea)","aliases":[]},{"version":"v0.12","title":"v0.12.3","aliases":[]},{"version":"v0.11","title":"v0.11.0","aliases":[]},{"version":"v0.10","title":"v0.10.0","aliases":[]},{"version":"v0.9","title":"v0.9.2","aliases":[]},{"version":"v0.8","title":"v0.8.0","aliases":[]},{"version":"v0.7","title":"v0.7.5","aliases":[]},{"version":"v0.6","title":"v0.6.2","aliases":[]},{"version":"v0.5","title":"v0.5.2","aliases":[]},{"version":"v0.4","title":"v0.4.0","aliases":[]},{"version":"v0.3","title":"v0.3.0","aliases":[]}]
1+
[
2+
{
3+
"version": "v0.14-dev",
4+
"title": "v0.14-dev (9406b99)",
5+
"aliases": [
6+
"v0-dev",
7+
"latest-dev"
8+
]
9+
},
10+
{
11+
"version": "v0.13",
12+
"title": "v0.13.4",
13+
"aliases": [
14+
"latest",
15+
"v0"
16+
]
17+
},
18+
{
19+
"version": "v0.13-dev",
20+
"title": "v0.13-dev (0da3bdb)",
21+
"aliases": []
22+
},
23+
{
24+
"version": "v0.12",
25+
"title": "v0.12.3",
26+
"aliases": []
27+
},
28+
{
29+
"version": "v0.12-dev",
30+
"title": "v0.12-dev (07780ea)",
31+
"aliases": []
32+
},
33+
{
34+
"version": "v0.11",
35+
"title": "v0.11.0",
36+
"aliases": []
37+
},
38+
{
39+
"version": "v0.10",
40+
"title": "v0.10.0",
41+
"aliases": []
42+
},
43+
{
44+
"version": "v0.9",
45+
"title": "v0.9.2",
46+
"aliases": []
47+
},
48+
{
49+
"version": "v0.8",
50+
"title": "v0.8.0",
51+
"aliases": []
52+
},
53+
{
54+
"version": "v0.7",
55+
"title": "v0.7.5",
56+
"aliases": []
57+
},
58+
{
59+
"version": "v0.6",
60+
"title": "v0.6.2",
61+
"aliases": []
62+
},
63+
{
64+
"version": "v0.5",
65+
"title": "v0.5.2",
66+
"aliases": []
67+
},
68+
{
69+
"version": "v0.4",
70+
"title": "v0.4.0",
71+
"aliases": []
72+
},
73+
{
74+
"version": "v0.3",
75+
"title": "v0.3.0",
76+
"aliases": []
77+
}
78+
]

0 commit comments

Comments
 (0)