bast / gitink

ASCII to SVG Git log graph visualizer.

gitink

ASCII to SVG Git log graph visualizer. Useful for teaching Git. Under the hood it uses https://github.com/bast/ascii2graph.

Example

$ cat example.txt

                     [feature]
                      |
                      v
               x1-----x2
              /
c1----c2----m1----c3----c4
  \        /            ^
   b1----b2----b3       |
   ^           ^       [main,HEAD]
   |           |
  [_branch]   [branch]

$ gitink --in-file=example.txt | display

This produces (display command requires imagemagick):

Available options

$ gitink --help

Usage: gitink [OPTIONS]

Options:
  --scale FLOAT             Scale sizes by this factor.
  --in-file TEXT            ASCII file to convert.
  --time-direction INTEGER  Direction of the time arrow (0, 90, 180, or 270).
                            Default: 90 (right).
  --help                    Show this message and exit.

Installation

$ pip install gitink

How do the colors work?

Coloring is done according to the first character of the commit hash. Other suggestions welcome.

Other projects that are interesting

• Asciio: this project has a Git mode and can be scripted using the API to generate graphs.