📝 Update git section

* Add diff source and destination prefix
* Add diff with exiftool
* Add git list-changed
* Add default branch config for init
* Add git-symbolic-ref
* Add Git Credential Store for Linux
* Update shallow clones
* Add shell configs and command line tools
* Extend git stash section

Author: veit

CHANGELOG.rst

@@ -25,6 +25,18 @@ Added
 * 📝 Add csv.Sniffer methods
 * 📝 Add the removal of git lfs
 
+Changed
+~~~~~~~
+
+* 📝 Update git section
+
+  * Add diff source and destination prefix
+  * Add default branch config for init
+  * Add git-symbolic-ref
+  * Add Git Credential Store for Linux
+  * Update shallow clones
+  * Add shell config and command line tools
+
 `24.3.0 <https://github.com/cusyio/Python4DataScience-de/compare/24.2.0...24.3.0>`_: 2024-11-19
 -----------------------------------------------------------------------------------------------
 

docs/productive/git/advanced/batch.rst

@@ -20,10 +20,20 @@ die Kombination von `git ls-files <https://git-scm.com/docs/git-ls-files>`_ und
 Beispiel
 ~~~~~~~~
 
-:samp:`$ git ls-files -z -- "*.py" | xargs -0 git update-index --chmod=+x`
+To execute commands for the changed file list, you can use the shell `Command
+Substitution
+<https://www.gnu.org/software/bash/manual/html_node/Command-Substitution.html>`_:
+
+:samp:`$ uv run codespell $(git list-changed '*.py')`
+    Die Shell führt das ``git list-changed`` in Klammern aus und fügt dessen
+    Ausgabe in den äußeren Befehl ein. ``codespell`` erhält also die Liste der
+    geänderten Textdateien als Argument.
+:samp:`uv run pytest $(git diff --staged --name-only "tests/*test_*.py")`
     ändert für alle Dateien mit dem Suffix ``.py`` ggf. die Berechtigungen von
     ``100644`` zu ``100755``, sodass sie ausführbar werden.
 
+.. _git-name-only:
+
 Alle im Arbeits- oder Bühnenbereich geänderten Dateien
 ------------------------------------------------------
 
@@ -35,10 +45,28 @@ Alle im Arbeits- oder Bühnenbereich geänderten Dateien
 :samp:`git diff --staged --name-only "*.{SUFFIX}"`
     filtert darüberhinaus noch nach einer bestimmten Dateiendung.
 
+.. _list-changed:
+
+:samp:`git diff --name-only --diff-filter d`
+    schließt gelöschte Dateien aus.
+
+    Dies ist bei mir der häufigste Fall, weswegen ich mir hierfür einen Alias
+    ``list-changed`` angelegt habe: ``git config --global alias.list-changed
+    'diff --name-only --diff-filter d'``.
+
 Beispiel
 ~~~~~~~~
 
-:samp:`pytest $(git diff --staged --name-only "tests/test_*.py")`
+Um Befehle für die geänderte Dateiliste auszuführen, könnt ihr die
+Shell-`Command Substitution
+<https://www.gnu.org/software/bash/manual/html_node/Command-Substitution.html>`_
+verwenden:
+
+:samp:`$ uv run codespell $(git list-changed '*.py')`
+    Die Shell führt das in Klammern gesetzte ``git list-changed`` aus und fügt
+    dessen Ausgabe in den äußeren Befehl ein. ``codespell`` erhält also die
+    Liste der geänderten Textdateien als Argument.
+:samp:`uv run pytest $(git diff --staged --name-only "tests/*test_*.py")`
     ruft :doc:`python-basics:test/pytest/index` auf, um anschließend nur
     diejenigen Testmodule auszuführen, die im Arbeitsverzeichnis geändert
     wurden.

docs/productive/git/advanced/binary-files.rst

@@ -1,4 +1,3 @@
-
 Git für Binärdateien
 ====================
 
@@ -25,16 +24,16 @@ Excel-Dateien verwenden:
    :language: python
    :lines: 5-
 
-Nun fügt ihr noch in der globalen Git-Konfiguration in der Datei :file:`~/.gitconfig`
-den folgenden Abschnitt hinzu:
+Nun fügt ihr noch in der globalen Git-Konfiguration in der Datei
+:file:`~/.config/git/config` den folgenden Abschnitt hinzu:
 
 .. code-block:: ini
 
     [diff "excel"]
         textconv=python3 /PATH/TO/exceltocsv.py
         binary=true
 
-Schließlich wird in der globalen :file:`~/.gitattributes`-Datei unser
+Schließlich wird in der globalen :file:`~/.config/git/attributes`-Datei unser
 ``excel``-Konverter mit :file:`*.xlsx`-Dateien verknüpft:
 
 .. code-block:: ini
@@ -58,15 +57,15 @@ Hierfür wird zusätzlich ``pdftohtml`` benötigt. Ihr installiert es mit
 
       $ brew install pdftohtml
 
-Anschließend fügt ihr den folgenden Abschnitt der globalen Git-Konfiguration in der
-Datei :file:`~/.gitconfig` hinzu:
+Anschließend fügt ihr den folgenden Abschnitt der globalen Git-Konfiguration in
+der Datei :file:`~/.config/git/config` hinzu:
 
 .. code-block:: ini
 
     [diff "pdf"]
         textconv=pdftohtml -stdout
 
-Schließlich wird in der globalen :file:`~/.gitattributes`-Datei unser
+Schließlich wird in der globalen :file:`~/.config/git/attributes`-Datei unser
 ``pdf``-Konverter mit :file:`*.pdf`-Dateien verknüpft:
 
 .. code-block:: ini
@@ -76,10 +75,10 @@ Schließlich wird in der globalen :file:`~/.gitattributes`-Datei unser
 Nun wird beim Aufruf von ``git diff`` die PDF-Datei zunächst konvertiert und
 dann ein Diff über den Ausgaben des Konverters durchgeführt.
 
-… für Word-Dokumente
---------------------
+… für Dokumente
+---------------
 
-Auch Unterschiede in Word-Dokumenten lassen sich anzeigen. Hierfür kann `Pandoc
+Auch Unterschiede in Dokumenten lassen sich anzeigen. Hierfür kann `Pandoc
 <https://pandoc.org/>`_ verwendet werden, das einfach installiert werden kann
 mit
 
@@ -100,22 +99,34 @@ mit
    Herunterladen und Installieren der aktuellen :file:`.msi`-Datei von `GitHub
    <https://github.com/jgm/pandoc/releases/>`_.
 
-Anschließend wird der globalen Git-Konfiguration :file:`~/.gitconfig` folgender
-Abschnitt hinzugefügt:
+Anschließend wird der globalen Git-Konfiguration :file:`~/.config/git/config`
+folgender Abschnitt hinzugefügt:
 
 .. code-block:: ini
 
-   [diff "word"]
-           textconv=pandoc --to=markdown
-           binary=true
-           prompt=false
+   [diff "pandoc-to-markdown"]
+       textconv = pandoc --to markdown
+       cachetextconv = true
 
-Schließlich wird in der globalen :file:`~/.gitattributes`-Datei unser
-``word``-Konverter mit :file:`*.docx`-Dateien verknüpft:
+Schließlich wird in der globalen :file:`~/.config/git/attributes`-Datei unser
+``pandoc-to-markdown``-Konverter mit :file:`*.docx`, :file:`*.odt` und
+:file:`*.rtf`-Dateien verknüpft:
 
 .. code-block:: ini
 
-   *.docx diff=word
+   *.docx diff=pandoc-to-markdown
+   *.odt diff=pandoc-to-markdown
+   *.rtf diff=pandoc-to-markdown
+
+.. tip::
+   :doc:`Jupyter Notebooks <jupyter-tutorial:notebook/index>` schreiben in eine
+   JSON-Datei :ref:`*.ipynb <jupyter-tutorial:was-ist-eine-ipynb-datei>`, die
+   ziemlich dicht und insbesondere bei Diffs schwer zu lesen ist. Die
+   Markdown-Darstellung von Pandoc vereinfact dies:
+
+   .. code-block:: ini
+
+      *.ipynb diff=pandoc-to-markdown
 
 Die gleiche Vorgehensweise kann auch angewandt werden, um nützliche Diffs von
 anderen Binärdateien zu erhalten, :abbr:`z.B. (zum Beispiel)` ``*.zip``,
@@ -124,3 +135,61 @@ Metainformationen von Bildern mit ``exiv2``. Zudem gibt es
 Konvertierungswerkzeuge für die Umwandlung von :file:`*.odt`, :file:`*.doc` und
 anderen Dokumentenformaten in einfachen Text. Für Binärdateien, für die es
 keinen Konverter gibt, reichen oft auch Strings aus.
+
+.. _exiftool:
+
+… für Medien-Dateien
+--------------------
+
+`ExifTool <https://exiftool.org>`_ kann verwendet werden um die Metadaten der
+Medien-Dateien in Text zu konvertieren.
+
+.. tab:: Debian/Ubuntu
+
+   .. code-block:: console
+
+      $ sudo apt install libimage-exiftool-perl
+
+.. tab:: macOS
+
+   .. code-block:: console
+
+      $ brew install exiftool
+
+.. tab:: Windows
+
+   .. code-block:: ps1
+
+      > choco install exiftool
+
+.. seealso::
+   * `Installing ExifTool <https://exiftool.org/install.html>`_
+
+Anschließend könnt ihr in der globalen Git-Konfigurationsdatei
+:file:`~/.config/git/config` folgenden Abschnitt hinzufügen:
+
+.. code-block:: ini
+
+   [diff "exiftool"]
+   textconv = exiftool --composite -x 'Exiftool:*'
+   cachetextconv = true
+   xfuncname =
+   "^-.*$"
+
+Schließlich wird in der :file:`~/.config/git/attributes` der
+``exiftool``-Konverter mit Datei-Endungen von Medien-Dateien verknüpft:
+
+.. code-block:: ini
+
+   *.avif diff=exiftool
+   *.bmp diff=exiftool
+   *.gif diff=exiftool
+   *.jpeg diff=exiftool
+   *.jpg diff=exiftool
+   *.png diff=exiftool
+   *.webp diff=exiftool
+
+.. seealso::
+   ``exiftool`` kann noch viele weitere Medien-Dateien verarbeiten. Eine
+   vollständige Liste erhaltet ihr in `Supported File Types
+   <https://exiftool.org/#supported>`_.