@@ -23473,13 +23473,13 @@ <h6 id="frequenz.client.microgrid.MicrogridApiClient.__aenter__" class="doc doc-
2347323473
2347423474 <details class="quote">
2347523475 <summary>Source code in <code>frequenz/client/base/client.py</code></summary>
23476- <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-237">237 </a></span>
23477- <span class="normal"><a href="#__codelineno-0-238">238 </a></span>
23478- <span class="normal"><a href="#__codelineno-0-239">239 </a></span>
23479- <span class="normal"><a href="#__codelineno-0-240">240 </a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-237 "><a id="__codelineno-0-237 " name="__codelineno-0-237 "></a><span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="fm">__aenter__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">Self</span><span class="p">:</span>
23480- </span><span id="__span-0-238 "><a id="__codelineno-0-238 " name="__codelineno-0-238 "></a><span class="w"> </span><span class="sd">"""Enter a context manager."""</span>
23481- </span><span id="__span-0-239 "><a id="__codelineno-0-239 " name="__codelineno-0-239 "></a> <span class="bp">self</span><span class="o">.</span><span class="n">connect</span><span class="p">()</span>
23482- </span><span id="__span-0-240 "><a id="__codelineno-0-240 " name="__codelineno-0-240 "></a> <span class="k">return</span> <span class="bp">self</span>
23476+ <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-240">240 </a></span>
23477+ <span class="normal"><a href="#__codelineno-0-241">241 </a></span>
23478+ <span class="normal"><a href="#__codelineno-0-242">242 </a></span>
23479+ <span class="normal"><a href="#__codelineno-0-243">243 </a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-240 "><a id="__codelineno-0-240 " name="__codelineno-0-240 "></a><span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="fm">__aenter__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="n">Self</span><span class="p">:</span>
23480+ </span><span id="__span-0-241 "><a id="__codelineno-0-241 " name="__codelineno-0-241 "></a><span class="w"> </span><span class="sd">"""Enter a context manager."""</span>
23481+ </span><span id="__span-0-242 "><a id="__codelineno-0-242 " name="__codelineno-0-242 "></a> <span class="bp">self</span><span class="o">.</span><span class="n">connect</span><span class="p">()</span>
23482+ </span><span id="__span-0-243 "><a id="__codelineno-0-243 " name="__codelineno-0-243 "></a> <span class="k">return</span> <span class="bp">self</span>
2348323483</span></code></pre></div></td></tr></table></div>
2348423484 </details>
2348523485 </div>
@@ -24205,10 +24205,7 @@ <h6 id="frequenz.client.microgrid.MicrogridApiClient.connect" class="doc doc-hea
2420524205
2420624206 <details class="quote">
2420724207 <summary>Source code in <code>frequenz/client/base/client.py</code></summary>
24208- <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-212">212</a></span>
24209- <span class="normal"><a href="#__codelineno-0-213">213</a></span>
24210- <span class="normal"><a href="#__codelineno-0-214">214</a></span>
24211- <span class="normal"><a href="#__codelineno-0-215">215</a></span>
24208+ <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-215">215</a></span>
2421224209<span class="normal"><a href="#__codelineno-0-216">216</a></span>
2421324210<span class="normal"><a href="#__codelineno-0-217">217</a></span>
2421424211<span class="normal"><a href="#__codelineno-0-218">218</a></span>
@@ -24221,23 +24218,26 @@ <h6 id="frequenz.client.microgrid.MicrogridApiClient.connect" class="doc doc-hea
2422124218<span class="normal"><a href="#__codelineno-0-225">225</a></span>
2422224219<span class="normal"><a href="#__codelineno-0-226">226</a></span>
2422324220<span class="normal"><a href="#__codelineno-0-227">227</a></span>
24224- <span class="normal"><a href="#__codelineno-0-228">228</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-212"><a id="__codelineno-0-212" name="__codelineno-0-212"></a><span class="k">def</span><span class="w"> </span><span class="nf">connect</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">server_url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span>
24225- </span><span id="__span-0-213"><a id="__codelineno-0-213" name="__codelineno-0-213"></a><span class="w"> </span><span class="sd">"""Connect to the server, possibly using a new URL.</span>
24226- </span><span id="__span-0-214"><a id="__codelineno-0-214" name="__codelineno-0-214"></a>
24227- </span><span id="__span-0-215"><a id="__codelineno-0-215" name="__codelineno-0-215"></a><span class="sd"> If the client is already connected and the URL is the same as the previous URL,</span>
24228- </span><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216"></a><span class="sd"> this method does nothing. If you want to force a reconnection, you can call</span>
24229- </span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217"></a><span class="sd"> [disconnect()][frequenz.client.base.client.BaseApiClient.disconnect] first.</span>
24230- </span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218"></a>
24231- </span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219"></a><span class="sd"> Args:</span>
24232- </span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220"></a><span class="sd"> server_url: The URL of the server to connect to. If not provided, the</span>
24233- </span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221"></a><span class="sd"> previously used URL is used.</span>
24234- </span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222"></a><span class="sd"> """</span>
24235- </span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223"></a> <span class="k">if</span> <span class="n">server_url</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">server_url</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_server_url</span><span class="p">:</span> <span class="c1"># URL changed</span>
24236- </span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224"></a> <span class="bp">self</span><span class="o">.</span><span class="n">_server_url</span> <span class="o">=</span> <span class="n">server_url</span>
24237- </span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225"></a> <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_connected</span><span class="p">:</span>
24238- </span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226"></a> <span class="k">return</span>
24239- </span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227"></a> <span class="bp">self</span><span class="o">.</span><span class="n">_channel</span> <span class="o">=</span> <span class="n">parse_grpc_uri</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_server_url</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_channel_defaults</span><span class="p">)</span>
24240- </span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228"></a> <span class="bp">self</span><span class="o">.</span><span class="n">_stub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_create_stub</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_channel</span><span class="p">)</span>
24221+ <span class="normal"><a href="#__codelineno-0-228">228</a></span>
24222+ <span class="normal"><a href="#__codelineno-0-229">229</a></span>
24223+ <span class="normal"><a href="#__codelineno-0-230">230</a></span>
24224+ <span class="normal"><a href="#__codelineno-0-231">231</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-215"><a id="__codelineno-0-215" name="__codelineno-0-215"></a><span class="k">def</span><span class="w"> </span><span class="nf">connect</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">server_url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span>
24225+ </span><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216"></a><span class="w"> </span><span class="sd">"""Connect to the server, possibly using a new URL.</span>
24226+ </span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217"></a>
24227+ </span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218"></a><span class="sd"> If the client is already connected and the URL is the same as the previous URL,</span>
24228+ </span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219"></a><span class="sd"> this method does nothing. If you want to force a reconnection, you can call</span>
24229+ </span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220"></a><span class="sd"> [disconnect()][frequenz.client.base.client.BaseApiClient.disconnect] first.</span>
24230+ </span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221"></a>
24231+ </span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222"></a><span class="sd"> Args:</span>
24232+ </span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223"></a><span class="sd"> server_url: The URL of the server to connect to. If not provided, the</span>
24233+ </span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224"></a><span class="sd"> previously used URL is used.</span>
24234+ </span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225"></a><span class="sd"> """</span>
24235+ </span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226"></a> <span class="k">if</span> <span class="n">server_url</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">server_url</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_server_url</span><span class="p">:</span> <span class="c1"># URL changed</span>
24236+ </span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227"></a> <span class="bp">self</span><span class="o">.</span><span class="n">_server_url</span> <span class="o">=</span> <span class="n">server_url</span>
24237+ </span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228"></a> <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_connected</span><span class="p">:</span>
24238+ </span><span id="__span-0-229"><a id="__codelineno-0-229" name="__codelineno-0-229"></a> <span class="k">return</span>
24239+ </span><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230"></a> <span class="bp">self</span><span class="o">.</span><span class="n">_channel</span> <span class="o">=</span> <span class="n">parse_grpc_uri</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_server_url</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_channel_defaults</span><span class="p">)</span>
24240+ </span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231"></a> <span class="bp">self</span><span class="o">.</span><span class="n">_stub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_create_stub</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_channel</span><span class="p">)</span>
2424124241</span></code></pre></div></td></tr></table></div>
2424224242 </details>
2424324243 </div>
@@ -24521,17 +24521,17 @@ <h6 id="frequenz.client.microgrid.MicrogridApiClient.disconnect" class="doc doc-
2452124521
2452224522 <details class="quote">
2452324523 <summary>Source code in <code>frequenz/client/base/client.py</code></summary>
24524- <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-230">230</a></span>
24525- <span class="normal"><a href="#__codelineno-0-231">231</a></span>
24526- <span class="normal"><a href="#__codelineno-0-232">232</a></span>
24527- <span class="normal"><a href="#__codelineno-0-233">233</a></span>
24524+ <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-233">233</a></span>
2452824525<span class="normal"><a href="#__codelineno-0-234">234</a></span>
24529- <span class="normal"><a href="#__codelineno-0-235">235</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230"></a><span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">disconnect</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span>
24530- </span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231"></a><span class="w"> </span><span class="sd">"""Disconnect from the server.</span>
24531- </span><span id="__span-0-232"><a id="__codelineno-0-232" name="__codelineno-0-232"></a>
24532- </span><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233"></a><span class="sd"> If the client is not connected, this method does nothing.</span>
24533- </span><span id="__span-0-234"><a id="__codelineno-0-234" name="__codelineno-0-234"></a><span class="sd"> """</span>
24534- </span><span id="__span-0-235"><a id="__codelineno-0-235" name="__codelineno-0-235"></a> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="fm">__aexit__</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
24526+ <span class="normal"><a href="#__codelineno-0-235">235</a></span>
24527+ <span class="normal"><a href="#__codelineno-0-236">236</a></span>
24528+ <span class="normal"><a href="#__codelineno-0-237">237</a></span>
24529+ <span class="normal"><a href="#__codelineno-0-238">238</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233"></a><span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">disconnect</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span>
24530+ </span><span id="__span-0-234"><a id="__codelineno-0-234" name="__codelineno-0-234"></a><span class="w"> </span><span class="sd">"""Disconnect from the server.</span>
24531+ </span><span id="__span-0-235"><a id="__codelineno-0-235" name="__codelineno-0-235"></a>
24532+ </span><span id="__span-0-236"><a id="__codelineno-0-236" name="__codelineno-0-236"></a><span class="sd"> If the client is not connected, this method does nothing.</span>
24533+ </span><span id="__span-0-237"><a id="__codelineno-0-237" name="__codelineno-0-237"></a><span class="sd"> """</span>
24534+ </span><span id="__span-0-238"><a id="__codelineno-0-238" name="__codelineno-0-238"></a> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="fm">__aexit__</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
2453524535</span></code></pre></div></td></tr></table></div>
2453624536 </details>
2453724537 </div>
0 commit comments