Update Python logging examples in documentation. (#2206)[deploy site]

* Update Python logging examples in documentation.

This adds information to the logging docs in
`documentation/webdriver/troubleshooting/`` for setting up
log handlers in Python. This is necessary to get log output.

* Add file logging to Python logging examples

---------

Co-authored-by: Sri Harsha <12621691+harsha509@users.noreply.github.com> e4f3470

Author: selenium-ci

documentation/_print/index.html

@@ -8765,7 +8765,12 @@
 to look at the important Selenium logs,
 take a look at the <a href=https://github.com/titusfortner/selenium-logger#selenium-logger>Selenium Logger project</a></p></div><div class="tab-body tab-pane fade" id=tabs-00-01 role=tabpanel aria-labelled-by=tabs-00-01-tab tabindex=0><p>Python logs are typically created per module. You can match all submodules by referencing the top
 level module. So to work with all loggers in selenium module, you can do this:</p><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-py data-lang=py><span style=display:flex><span>    <span style=color:#000>logger</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#000>logging</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#000>getLogger</span><span style=color:#000;font-weight:700>(</span><span style=color:#4e9a06>&#39;selenium&#39;</span><span style=color:#000;font-weight:700>)</span></span></span></code></pre></div><div class="text-end pb-2"><a href=https://github.com/SeleniumHQ/seleniumhq.github.io/blob/trunk//examples/python/tests/troubleshooting/test_logging.py#L5 target=_blank><i class="fas fa-external-link-alt pl-2"></i>
-<strong>View full example on GitHub</strong></a></div></div><div class="tab-body tab-pane fade" id=tabs-00-02 role=tabpanel aria-labelled-by=tabs-00-02-tab tabindex=0><p>.NET logger is managed with a static class, so all access to logging is managed simply by referencing <code>Log</code> from the <code>OpenQA.Selenium.Internal.Logging</code> namespace.</p></div><div class="tab-body tab-pane fade" id=tabs-00-03 role=tabpanel aria-labelled-by=tabs-00-03-tab tabindex=0><p>If you want to see as much debugging as possible in all the classes,
+<strong>View full example on GitHub</strong></a></div><p>You must also create and add a log handler (<code>StreamHandler</code>, <code>FileHandler</code>, etc).</p><p>To save logs to a file, you can do this:</p><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-py data-lang=py><span style=display:flex><span><span style=color:#000>log_path</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#4e9a06>&#39;/path/to/log&#39;</span>
+</span></span><span style=display:flex><span><span style=color:#000>handler</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#000>logging</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#000>FileHandler</span><span style=color:#000;font-weight:700>(</span><span style=color:#000>log_path</span><span style=color:#000;font-weight:700>)</span>
+</span></span><span style=display:flex><span><span style=color:#000>logger</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#000>addHandler</span><span style=color:#000;font-weight:700>(</span><span style=color:#000>handler</span><span style=color:#000;font-weight:700>)</span>
+</span></span></code></pre></div><p>To display logs in the console, you can do this:</p><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-py data-lang=py><span style=display:flex><span><span style=color:#000>handler</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#000>logging</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#000>StreamHandler</span><span style=color:#000;font-weight:700>()</span>
+</span></span><span style=display:flex><span><span style=color:#000>logger</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#000>addHandler</span><span style=color:#000;font-weight:700>(</span><span style=color:#000>handler</span><span style=color:#000;font-weight:700>)</span>
+</span></span></code></pre></div></div><div class="tab-body tab-pane fade" id=tabs-00-02 role=tabpanel aria-labelled-by=tabs-00-02-tab tabindex=0><p>.NET logger is managed with a static class, so all access to logging is managed simply by referencing <code>Log</code> from the <code>OpenQA.Selenium.Internal.Logging</code> namespace.</p></div><div class="tab-body tab-pane fade" id=tabs-00-03 role=tabpanel aria-labelled-by=tabs-00-03-tab tabindex=0><p>If you want to see as much debugging as possible in all the classes,
 you can turn on debugging globally in Ruby by setting <code>$DEBUG = true</code>.</p><p>For more fine-tuned control, Ruby Selenium created its own Logger class to wrap the default <code>Logger</code> class.
 This implementation provides some interesting additional features.
 Obtain the logger directly from the <code>#logger</code>class method on the <code>Selenium::WebDriver</code> module:</p><p><a href=https://github.com/SeleniumHQ/selenium/releases/tag/selenium-4.10.0><span class=selenium-badge-version data-bs-toggle=tooltip data-bs-placement=right title="This code requires Selenium v4.10 or greater">Selenium v4.10</span></a></p><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-rb data-lang=rb><span style=display:flex><span>    <span style=color:#000>logger</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#000>Selenium</span><span style=color:#ce5c00;font-weight:700>::</span><span style=color:#000>WebDriver</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#000>logger</span></span></span></code></pre></div><div class="text-end pb-2"><a href=https://github.com/SeleniumHQ/seleniumhq.github.io/blob/trunk//examples/ruby/spec/troubleshooting/logging_spec.rb#L11 target=_blank><i class="fas fa-external-link-alt pl-2"></i>
@@ -13962,7 +13967,7 @@
 No patent liability is assumed with respect
 to the use of the information contained herein.</p><h2 id=attributions>Attributions</h2><h4 id=selenium-main-repositorygithubcomseleniumhqselenium><a href=//github.com/SeleniumHQ/selenium/>Selenium Main Repository</a></h4><style type=text/css>.ghContributors{display:flex;flex-flow:wrap;align-content:flex-start}.ghContributors>div{width:50%;display:inline-flex;margin-bottom:5px}.ghContributors>div label{padding-left:4px}.ghContributors>div span{font-size:x-small;padding-left:4px}</style><div class=ghContributors><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/28229?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/shs96c>@shs96c</a></label>
-<span class=contributions>5338 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/617090?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<span class=contributions>5339 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/617090?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/barancev>@barancev</a></label>
 <span class=contributions>3352 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/352840?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/jimevans>@jimevans</a></label>
@@ -14006,11 +14011,11 @@
 <label><a href=https://github.com/symonk>@symonk</a></label>
 <span class=contributions>203 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/122800?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/davehunt>@davehunt</a></label>
-<span class=contributions>200 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/455056?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
-<label><a href=https://github.com/hbchai>@hbchai</a></label>
-<span class=contributions>191 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/22616990?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<span class=contributions>200 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/22616990?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/nvborisenko>@nvborisenko</a></label>
-<span class=contributions>190 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/4405962?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<span class=contributions>193 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/455056?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<label><a href=https://github.com/hbchai>@hbchai</a></label>
+<span class=contributions>191 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/4405962?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/lmtierney>@lmtierney</a></label>
 <span class=contributions>179 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/696749?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/freynaud>@freynaud</a></label>
@@ -14020,14 +14025,14 @@
 <label><a href=https://github.com/nirvdrum>@nirvdrum</a></label>
 <span class=contributions>133 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/3331063?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/selenium-ci>@selenium-ci</a></label>
-<span class=contributions>131 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/1168195?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<span class=contributions>132 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/1168195?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/sevaseva>@sevaseva</a></label>
 <span class=contributions>115 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/140960?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/gigix>@gigix</a></label>
+<span class=contributions>109 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/12619902?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<label><a href=https://github.com/RenderMichael>@RenderMichael</a></label>
 <span class=contributions>109 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/10137971?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/juangj>@juangj</a></label>
-<span class=contributions>108 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/12619902?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
-<label><a href=https://github.com/RenderMichael>@RenderMichael</a></label>
 <span class=contributions>108 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/1000?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/aslakhellesoy>@aslakhellesoy</a></label>
 <span class=contributions>94 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/in/2740?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>

documentation/about/_print/index.html

@@ -41,7 +41,7 @@
 No patent liability is assumed with respect
 to the use of the information contained herein.</p><h2 id=attributions>Attributions</h2><h4 id=selenium-main-repositorygithubcomseleniumhqselenium><a href=//github.com/SeleniumHQ/selenium/>Selenium Main Repository</a></h4><style type=text/css>.ghContributors{display:flex;flex-flow:wrap;align-content:flex-start}.ghContributors>div{width:50%;display:inline-flex;margin-bottom:5px}.ghContributors>div label{padding-left:4px}.ghContributors>div span{font-size:x-small;padding-left:4px}</style><div class=ghContributors><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/28229?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/shs96c>@shs96c</a></label>
-<span class=contributions>5338 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/617090?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<span class=contributions>5339 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/617090?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/barancev>@barancev</a></label>
 <span class=contributions>3352 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/352840?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/jimevans>@jimevans</a></label>
@@ -85,11 +85,11 @@
 <label><a href=https://github.com/symonk>@symonk</a></label>
 <span class=contributions>203 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/122800?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/davehunt>@davehunt</a></label>
-<span class=contributions>200 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/455056?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
-<label><a href=https://github.com/hbchai>@hbchai</a></label>
-<span class=contributions>191 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/22616990?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<span class=contributions>200 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/22616990?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/nvborisenko>@nvborisenko</a></label>
-<span class=contributions>190 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/4405962?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<span class=contributions>193 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/455056?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<label><a href=https://github.com/hbchai>@hbchai</a></label>
+<span class=contributions>191 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/4405962?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/lmtierney>@lmtierney</a></label>
 <span class=contributions>179 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/696749?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/freynaud>@freynaud</a></label>
@@ -99,14 +99,14 @@
 <label><a href=https://github.com/nirvdrum>@nirvdrum</a></label>
 <span class=contributions>133 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/3331063?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/selenium-ci>@selenium-ci</a></label>
-<span class=contributions>131 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/1168195?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<span class=contributions>132 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/1168195?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/sevaseva>@sevaseva</a></label>
 <span class=contributions>115 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/140960?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/gigix>@gigix</a></label>
+<span class=contributions>109 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/12619902?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
+<label><a href=https://github.com/RenderMichael>@RenderMichael</a></label>
 <span class=contributions>109 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/10137971?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/juangj>@juangj</a></label>
-<span class=contributions>108 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/12619902?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
-<label><a href=https://github.com/RenderMichael>@RenderMichael</a></label>
 <span class=contributions>108 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/1000?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
 <label><a href=https://github.com/aslakhellesoy>@aslakhellesoy</a></label>
 <span class=contributions>94 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/in/2740?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>