Skip to content

Commit 98fe613

Browse files
Deployed f5917d5 to v0.12-dev with MkDocs 1.6.1 and mike 2.1.3
1 parent f69b952 commit 98fe613

File tree

19 files changed

+463
-350
lines changed

19 files changed

+463
-350
lines changed
0 Bytes
Binary file not shown.

v0.12-dev/reference/frequenz/repo/config/cli/version/mike/info/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1887,7 +1887,7 @@ <h4 id="frequenz.repo.config.cli.version.mike.info.main" class="doc doc-heading"
18871887
<span class="normal"><a href="#__codelineno-0-54">54</a></span>
18881888
<span class="normal"><a href="#__codelineno-0-55">55</a></span>
18891889
<span class="normal"><a href="#__codelineno-0-56">56</a></span>
1890-
<span class="normal"><a href="#__codelineno-0-57">57</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45"></a><span class="k">def</span> <span class="nf">main</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
1890+
<span class="normal"><a href="#__codelineno-0-57">57</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45"></a><span class="k">def</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
18911891
</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46"></a><span class="w"> </span><span class="sd">&quot;&quot;&quot;Output mike version variables for GitHub Actions.&quot;&quot;&quot;</span>
18921892
</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47"></a> <span class="n">github</span><span class="o">.</span><span class="n">configure_logging</span><span class="p">()</span>
18931893
</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48"></a>

v0.12-dev/reference/frequenz/repo/config/cli/version/mike/sort/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1901,7 +1901,7 @@ <h4 id="frequenz.repo.config.cli.version.mike.sort.main" class="doc doc-heading"
19011901
<span class="normal"><a href="#__codelineno-0-70">70</a></span>
19021902
<span class="normal"><a href="#__codelineno-0-71">71</a></span>
19031903
<span class="normal"><a href="#__codelineno-0-72">72</a></span>
1904-
<span class="normal"><a href="#__codelineno-0-73">73</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38"></a><span class="k">def</span> <span class="nf">main</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
1904+
<span class="normal"><a href="#__codelineno-0-73">73</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38"></a><span class="k">def</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
19051905
</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39"></a><span class="w"> </span><span class="sd">&quot;&quot;&quot;Sort `mike`&#39;s `version.json` file with a custom order.</span>
19061906
</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40"></a>
19071907
</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41"></a><span class="sd"> The versions are sorted using `sort_versions()`.</span>

v0.12-dev/reference/frequenz/repo/config/github/index.html

Lines changed: 9 additions & 9 deletions
Large diffs are not rendered by default.

v0.12-dev/reference/frequenz/repo/config/index.html

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1988,7 +1988,7 @@ <h5 id="frequenz.repo.config--writing-the-noxfilepy">Writing the <code>noxfile.p
19881988
which will configure all nox sessions.</p>
19891989
<p>To use the default options, you should call <code>configure()</code> using one of the <a class="autorefs autorefs-internal" href="#frequenz.repo.config.RepositoryType">repository
19901990
types</a>. For example:</p>
1991-
<div class="language-python highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="kn">from</span> <span class="nn">frequenz.repo.config</span> <span class="kn">import</span> <span class="n">RepositoryType</span><span class="p">,</span> <span class="n">nox</span>
1991+
<div class="language-python highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">frequenz.repo.config</span><span class="w"> </span><span class="kn">import</span> <span class="n">RepositoryType</span><span class="p">,</span> <span class="n">nox</span>
19921992
</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>
19931993
</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="n">nox</span><span class="o">.</span><span class="n">configure</span><span class="p">(</span><span class="n">RepositoryType</span><span class="o">.</span><span class="n">LIB</span><span class="p">)</span>
19941994
</span></code></pre></div>
@@ -1998,8 +1998,8 @@ <h5 id="frequenz.repo.config--writing-the-noxfilepy">Writing the <code>noxfile.p
19981998
the <a class="autorefs autorefs-internal" href="nox/default/#frequenz.repo.config.nox.default"><code>frequenz.repo.config.nox.default</code></a> module,
19991999
<a class="autorefs autorefs-internal" href="nox/config/#frequenz.repo.config.nox.config.Config.copy">copying</a> it and changing whatever you
20002000
need to customize. For example:</p>
2001-
<div class="language-python highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="kn">from</span> <span class="nn">frequenz.repo.config</span> <span class="kn">import</span> <span class="n">nox</span>
2002-
</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="kn">from</span> <span class="nn">frequenz.repo.config.nox</span> <span class="kn">import</span> <span class="n">default</span>
2001+
<div class="language-python highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">frequenz.repo.config</span><span class="w"> </span><span class="kn">import</span> <span class="n">nox</span>
2002+
</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="kn">from</span><span class="w"> </span><span class="nn">frequenz.repo.config.nox</span><span class="w"> </span><span class="kn">import</span> <span class="n">default</span>
20032003
</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>
20042004
</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="n">config</span> <span class="o">=</span> <span class="n">default</span><span class="o">.</span><span class="n">lib_config</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
20052005
</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="n">config</span><span class="o">.</span><span class="n">opts</span><span class="o">.</span><span class="n">black</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot;--diff&quot;</span><span class="p">)</span>
@@ -2176,7 +2176,7 @@ <h5 id="frequenz.repo.config--api-reference-generation">API reference generation
21762176
(<code>site</code> by defaul).</p>
21772177
<p>If you need to customize the above paths, you can create a new script to use with the
21782178
<code>mkdocs-gen-files</code> plugin as follows:</p>
2179-
<div class="language-python highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="kn">from</span> <span class="nn">frequenz.repo.config.mkdocs</span> <span class="kn">import</span> <span class="n">api_pages</span>
2179+
<div class="language-python highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">frequenz.repo.config.mkdocs</span><span class="w"> </span><span class="kn">import</span> <span class="n">api_pages</span>
21802180
</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>
21812181
</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="n">api_pages</span><span class="o">.</span><span class="n">generate_python_api_pages</span><span class="p">(</span><span class="s2">&quot;my_sources&quot;</span><span class="p">,</span> <span class="s2">&quot;API&quot;</span><span class="p">)</span>
21822182
</span></code></pre></div>
@@ -2200,8 +2200,8 @@ <h5 id="frequenz.repo.config--linting-examples-in-the-source-codes-docstrings">L
22002200
<li>
22012201
<p>Add a <code>conftest.py</code> file to the root directory containing your source code with the
22022202
following contents:</p>
2203-
<div class="language-python highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="kn">from</span> <span class="nn">frequenz.repo.config.pytest</span> <span class="kn">import</span> <span class="n">examples</span>
2204-
</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="kn">from</span> <span class="nn">sybil</span> <span class="kn">import</span> <span class="n">Sybil</span>
2203+
<div class="language-python highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">frequenz.repo.config.pytest</span><span class="w"> </span><span class="kn">import</span> <span class="n">examples</span>
2204+
</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="kn">from</span><span class="w"> </span><span class="nn">sybil</span><span class="w"> </span><span class="kn">import</span> <span class="n">Sybil</span>
22052205
</span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>
22062206
</span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="n">pytest_collect_file</span> <span class="o">=</span> <span class="n">Sybil</span><span class="p">(</span><span class="o">**</span><span class="n">examples</span><span class="o">.</span><span class="n">get_sybil_arguments</span><span class="p">())</span><span class="o">.</span><span class="n">pytest</span><span class="p">()</span>
22072207
</span></code></pre></div>
@@ -2280,7 +2280,7 @@ <h5 id="frequenz.repo.config--mkdocs-api-reference-generation"><code>mkdocs</cod
22802280
<p>If your project provides <em>protobuf</em> files, you can also generate the API
22812281
documentation for them adding one more line to the script provided in the common
22822282
section:</p>
2283-
<div class="language-python highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="kn">from</span> <span class="nn">frequenz.repo.config.mkdocs</span> <span class="kn">import</span> <span class="n">api_pages</span>
2283+
<div class="language-python highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">frequenz.repo.config.mkdocs</span><span class="w"> </span><span class="kn">import</span> <span class="n">api_pages</span>
22842284
</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>
22852285
</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="n">api_pages</span><span class="o">.</span><span class="n">generate_python_api_pages</span><span class="p">(</span><span class="s2">&quot;my_sources&quot;</span><span class="p">,</span> <span class="s2">&quot;API-py&quot;</span><span class="p">)</span>
22862286
</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="n">api_pages</span><span class="o">.</span><span class="n">generate_protobuf_api_pages</span><span class="p">()</span>
@@ -2401,7 +2401,7 @@ <h4 id="frequenz.repo.config.RepositoryType" class="doc doc-heading">
24012401
<span class="normal"><a href="#__codelineno-0-22">22</a></span>
24022402
<span class="normal"><a href="#__codelineno-0-23">23</a></span>
24032403
<span class="normal"><a href="#__codelineno-0-24">24</a></span>
2404-
<span class="normal"><a href="#__codelineno-0-25">25</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9"></a><span class="k">class</span> <span class="nc">RepositoryType</span><span class="p">(</span><span class="n">_enum</span><span class="o">.</span><span class="n">Enum</span><span class="p">):</span>
2404+
<span class="normal"><a href="#__codelineno-0-25">25</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9"></a><span class="k">class</span><span class="w"> </span><span class="nc">RepositoryType</span><span class="p">(</span><span class="n">_enum</span><span class="o">.</span><span class="n">Enum</span><span class="p">):</span>
24052405
</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10"></a><span class="w"> </span><span class="sd">&quot;&quot;&quot;Supported types of repository.&quot;&quot;&quot;</span>
24062406
</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11"></a>
24072407
</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12"></a> <span class="n">ACTOR</span> <span class="o">=</span> <span class="s2">&quot;actor&quot;</span>

v0.12-dev/reference/frequenz/repo/config/mkdocs/api_pages/index.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2006,7 +2006,7 @@ <h4 id="frequenz.repo.config.mkdocs.api_pages.generate_protobuf_api_pages" class
20062006
<span class="normal"><a href="#__codelineno-0-146">146</a></span>
20072007
<span class="normal"><a href="#__codelineno-0-147">147</a></span>
20082008
<span class="normal"><a href="#__codelineno-0-148">148</a></span>
2009-
<span class="normal"><a href="#__codelineno-0-149">149</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87"></a><span class="k">def</span> <span class="nf">generate_protobuf_api_pages</span><span class="p">(</span>
2009+
<span class="normal"><a href="#__codelineno-0-149">149</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87"></a><span class="k">def</span><span class="w"> </span><span class="nf">generate_protobuf_api_pages</span><span class="p">(</span>
20102010
</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88"></a> <span class="n">src_path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;proto&quot;</span><span class="p">,</span> <span class="n">dst_path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;protobuf-reference&quot;</span>
20112011
</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
20122012
</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90"></a><span class="w"> </span><span class="sd">&quot;&quot;&quot;Generate API documentation pages for the code.</span>
@@ -2193,7 +2193,7 @@ <h4 id="frequenz.repo.config.mkdocs.api_pages.generate_python_api_pages" class="
21932193
<span class="normal"><a href="#__codelineno-0-81">81</a></span>
21942194
<span class="normal"><a href="#__codelineno-0-82">82</a></span>
21952195
<span class="normal"><a href="#__codelineno-0-83">83</a></span>
2196-
<span class="normal"><a href="#__codelineno-0-84">84</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43"></a><span class="k">def</span> <span class="nf">generate_python_api_pages</span><span class="p">(</span>
2196+
<span class="normal"><a href="#__codelineno-0-84">84</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43"></a><span class="k">def</span><span class="w"> </span><span class="nf">generate_python_api_pages</span><span class="p">(</span>
21972197
</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44"></a> <span class="n">src_path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;src&quot;</span><span class="p">,</span> <span class="n">dst_path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;python-reference&quot;</span>
21982198
</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
21992199
</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46"></a><span class="w"> </span><span class="sd">&quot;&quot;&quot;Generate API documentation pages for the code.</span>

0 commit comments

Comments
 (0)