📝 Add logging section from Python4DataScience

Author: veit

.github/workflows/ci.yml

@@ -22,6 +22,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
+    - uses: pandoc/actions/setup@v1
     - uses: actions/setup-python@v5
       with:
         # Keep in sync with .readthedocs.yaml

.github/workflows/pages.yml

@@ -32,6 +32,8 @@ jobs:
         uses: actions/checkout@v4
       - name: Install packages
         run: sudo apt install plantuml
+      - name: Setup pandoc
+        uses: pandoc/actions/setup@v1
       - name: Setup python
         uses: actions/setup-python@v5
         with:

docs/conf.py

@@ -39,6 +39,7 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named "sphinx.ext.*") or your custom ones.
 extensions = [
+    "nbsphinx",
     "pygments_pytest",
     "sphinx.ext.autodoc",
     "sphinx.ext.viewcode",

docs/index.rst

@@ -119,6 +119,7 @@ Follow us on…
    packs/index
    oop/index
    save-data/index
+   logging/index
    test/index
    document/index
    appendix/index

docs/logging/development.ini

@@ -0,0 +1,25 @@
+; SPDX-FileCopyrightText: 2021 Veit Schiele
+;
+; SPDX-License-Identifier: BSD-3-Clause
+
+[loggers]
+keys=root
+
+[handlers]
+keys=stream_handler
+
+[formatters]
+keys=formatter
+
+[logger_root]
+level=DEBUG
+handlers=stream_handler
+
+[handler_stream_handler]
+class=StreamHandler
+level=DEBUG
+formatter=formatter
+args=(sys.stderr,)
+
+[formatter_formatter]
+format=%(asctime)s %(name)-12s %(levelname)-8s %(message)s