git-big-picture

git-big-picture visualisiert Git-Repositories als DAGs. Das Tool kommt mit einigen Filtern um sich nur die interessanten Bereiche anzeigen zu lassen, z.B. nur die Hierarchie von Tags und Branches.

Beispiele

git big-picture -o git-big-picture.svg

$ git big-picture -ao git-big-picture_all.svg

Installation

Ihr könnt git-big-picture einfach installieren mit:

$ uv add git-big-picture
Installing git-big-picture…
Adding git-big-picture to Pipfile's [packages]…
✔ Installation Succeeded
…

Git-Integration

Ihr könnt das Tool einfach in Git integrieren indem ihr das Skript git-big-picture einfach $PATH hinzufügt. Anschließend könnt ihr es verwenden z.B. mit:

$ git big-picture -h
Usage: git-big-picture OPTIONS [<repo-directory>]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  --pstats=FILE         run cProfile profiler writing pstats output to FILE
  -d, --debug           activate debug output

  Output Options:
    Options to control output and format

    -f FMT, --format=FMT
                        set output format [svg, png, ps, pdf, ...]
    -g, --graphviz      output lines suitable as input for dot/graphviz
    -G, --no-graphviz   disable dot/graphviz output
    -p, --processed     output the dot processed, binary data
    -P, --no-processed  disable binary output
    -v CMD, --viewer=CMD
                        write image to tempfile and start specified viewer
    -V, --no-viewer     disable starting viewer
    -o FILE, --outfile=FILE
                        write image to specified file
    -O, --no-outfile    disable writing image to file

  Filter Options:
    Options to control commit/ref selection

    -a, --all           include all commits
    -b, --branches      show commits pointed to by branches
    -B, --no-branches   do not show commits pointed to by branches
    -t, --tags          show commits pointed to by tags
    -T, --no-tags       do not show commits pointed to by tags
    -r, --roots         show root commits
    -R, --no-roots      do not show root commits
    -m, --merges        include merge commits
    -M, --no-merges     do not include merge commits
    -i, --bifurcations  include bifurcation commits
    -I, --no-bifurcations
                        do not include bifurcation commits

Konfiguration

Die Standard-git config-Infrastruktur kann verwendet werden um auch git-big-picture zu konfigurieren. Die meisten Kommandozeilen-Argumente können konfiguriert werden im [big-picture]-Abschnitt, z.B. um Firefox als Viewer zu konfigurieren

$ git config --global big-picture.viewer firefox

erstellt den folgenden Abschnitt in eurer ~/.gitconfig-Datei:

[big-picture]
    viewer = firefox

Bemerkung

Beachtet, dass ihr dann keine anderen Optionen mehr auswählen könnt. So könnt ihr nun den Graph nicht mehr als Graphviz ausgeben lassen:

$ git-big-picture -g
fatal: Options '-g | --graphviz' and '-p | --processed' are incompatible with other output options.

In diesem Fall müsst ihr dann die -V oder --no-viewer-Option wählen:

$ git-big-picture -g -V
digraph {
    "c509669a01b156900eed9f1c9f927b6d2f7bb95b"[label="origin/pyup-scheduled-update-2020-11-16", color="/pastel13/2", style=filled];
…