📝 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

Author: veit

CHANGELOG.rst

@@ -25,6 +25,19 @@ 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
+  * 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

@@ -24,6 +24,8 @@ Beispiel
     ä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
 ------------------------------------------------------
 
@@ -34,11 +36,26 @@ Alle im Arbeits- oder Bühnenbereich geänderten Dateien
     gibt die dem Bühnenbereich hinzugefügten Dateien aus.
 :samp:`git diff --staged --name-only "*.{SUFFIX}"`
     filtert darüberhinaus noch nach einer bestimmten Dateiendung.
+: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,59 @@ 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.
+
+… 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>`_.

docs/productive/git/advanced/delta-side-by-side-diff.png

@@ -44,8 +44,9 @@ Fortgeschrittenes Git
    notes
    hooks/index
    jupyter-notebooks
-   binary-files
+   shell
    batch
+   binary-files
    lfs
    vs-code/index
    gitlab/index