🔧 Add blacken-docs

* Fix Python syntax

.pre-commit-config.yaml

@@ -37,6 +37,13 @@ repos:
     rev: 24.8.0
     hooks:
     - id: black
+  - repo: https://github.com/adamchainz/blacken-docs
+    rev: "1.18.0"
+    hooks:
+    - id: blacken-docs
+      args: [--line-length=79]
+      additional_dependencies:
+      - black
   - repo: https://github.com/codespell-project/codespell
     rev: v2.3.0
     hooks:

docs/data-processing/apis/fastapi/example.rst

@@ -103,7 +103,7 @@ zu erhalten:
 
     @app.put("/items/{item_id}")
     def update_item(item_id: int, item: Item):
-    return {"item_name": item.name, "item_id": item_id}
+        return {"item_name": item.name, "item_id": item_id}
 
 Der Server lädt die Datei automatisch neu, da wir den
 `uvicorn <http://www.uvicorn.org/>`_-Aufruf in Schritt 2 mit der Option

docs/data-processing/postgresql/db-api.rst

@@ -27,6 +27,8 @@ Connection
 
     Beispiel:
 
+    .. blacken-docs:off
+
     .. code-block:: python
 
         import driver
@@ -44,6 +46,8 @@ Connection
             conn.commit()
             conn.close()
 
+    .. blacken-docs:on
+
 Cursor
     `Cursorobjekte <https://peps.python.org/pep-0249/#cursor-objects>`_ werden
     zum Verwalten des Kontexts einer ``.fetch*()``-Methode verwendet.

docs/data-processing/postgresql/ipython-sql.rst

@@ -22,29 +22,29 @@ Erste Schritte
 
 #. Zunächst wird ipython-sql in eurem Notebook aktiviert mit
 
-   .. code-block:: python
+   .. code-block:: ipython
 
     In [1]: %load_ext sql
 
 #. Für die Verbindung zur Datenbank wird die `SQLAlchemy URL
    <https://docs.sqlalchemy.org/en/14/core/engines.html#database-urls>`_
    verwendet:
 
-   .. code-block:: python
+   .. code-block:: ipython
 
     In [2]: %sql postgresql://
 
 #. Anschließend könnt ihr eine Tabelle erstellen, :abbr:`z.B. (zum Beispiel)`:
 
-   .. code-block:: python
+   .. code-block:: ipython
 
     In [3]: %%sql postgresql://
        ....: CREATE TABLE accounts (login, name, email)
        ....: INSERT INTO accounts VALUES ('veit', 'Veit Schiele', [email protected]);
 
 #. Die Inhalte der Tabelle ``accounts`` könnt ihr abfragen mit
 
-   .. code-block:: python
+   .. code-block:: ipython
 
     In [4]: result = %sql select * from accounts
 
@@ -62,7 +62,7 @@ Begrenzung, mit ``Autolimit`` lässt sich  jedoch die Ergebnismenge limitieren.
 Mit ``%config SqlMagic`` könnt ihr Euch die aktuelle Konfiguration ausgeben
 lassen:
 
-.. code-block:: python
+.. code-block:: ipython
 
     In [5]: %config SqlMagic
     SqlMagic options
@@ -89,7 +89,7 @@ pandas
 
 Wenn pandas installiert ist, kann die ``DataFrame``-Methode verwendet werden:
 
-.. code-block:: python
+.. code-block:: ipython
 
     In [6]: result = %sql SELECT * FROM accounts
 

docs/data-processing/postgresql/sqlalchemy.rst

@@ -97,10 +97,7 @@ Create Session
     address = Address(street="Birnbaumweg 10", zipcode="79115", country="Germany")
 
     contact = Contact(
-        firstname="Veit",
-        lastname="Schiele",
-        email="[email protected]",
-        address=address
+        firstname="Veit", lastname="Schiele", email="[email protected]", address=address
     )
 
     session.add(contact)

docs/productive/git/advanced/bisect.rst

@@ -144,6 +144,8 @@ komplizierteren Verhaltensänderungen suchen. Für Performance-Tests benötigen
 hierfür ein Testprogramm, das mehrere Durchläufe durchführen und die minimale
 Zeit ermitteln kann, wobei mögliches Rauschen eliminiert werden soll:
 
+.. blacken-docs:off
+
 .. code-block:: python
 
    from subprocess import run
@@ -167,6 +169,8 @@ Zeit ermitteln kann, wobei mögliches Rauschen eliminiert werden soll:
        print("Fast enough")
        raise SystemExit(0)
 
+.. blacken-docs:on
+
 Das Programm führt :samp:`python perftest.py {PARAM}` zehnmal aus und misst bei
 jeder Ausführung die Zeit. Anschließend vergleicht es die minimale
 Ausführungszeit mit einem Grenzwert von ``X`` Sekunden. Liegt die Mindestzeit

docs/productive/qa/code-smells.rst

@@ -61,15 +61,16 @@ Eigenschaft:
 
     class Image(object):
         thumbnail_resolution = 128
+
         def __init__(self, path):
-            ...
+            "..."
 
         def crop(self, width, height):
-            ...
+            "..."
 
         @property
         def thumbnail(self):
-            ...
+            "..."
             return thumb
 
 Objekte, die Funktionen sein sollten

docs/workspace/ipython/extensions.rst

@@ -46,6 +46,8 @@ IPython-Erweiterungen schreiben
 Eine IPython-Erweiterung ist ein importierbares Python-Modul, das über spezielle
 Funktionen zum Laden und Entladen verfügt:
 
+.. blacken-docs:off
+
 .. code-block:: python
 
     def load_ipython_extension(ipython):
@@ -56,5 +58,7 @@ Funktionen zum Laden und Entladen verfügt:
     def unload_ipython_extension(ipython):
         # If you want your extension to be unloadable, put that logic here.
 
+.. blacken-docs:on
+
 .. seealso::
     * :label:`defining_magics`