Migration Graph Visualization

The export command allows you to visualize the directed acyclic graph (DAG) of your migrations. This is useful for understanding the dependency structure between migrations and sharing migration architecture with your team.

Usage

kat export [OPTIONS]

The default export format is DOT, which can be visualized using tools like Graphviz:

# Export to DOT format and save to a file
kat export --file migrations.dot

# Generate an image using Graphviz (if installed)
dot -Tpng migrations.dot -o migrations.png

Options

Option	Description
`--config`, `-c`	Path to the configuration file (default: `kat.conf.yaml`)
`--file`, `-f`	File to save graph to: `dot` or `json` (default: `stdout`)

Visualizing the Graph

The DOT format output can be visualized using various tools:

Graphviz: Install Graphviz and use the dot command line tool
Online Visualizers: Use online tools like GraphvizOnline

Example

A typical migration graph might look like this in DOT format:

strict digraph {
    "1747578830" [  weight=0 ];
    "1747578830" -> "1747578839" [  weight=0 ];
    "1747578839" [  weight=0 ];
    "1747578808" [  weight=0 ];
    "1747578808" -> "1747578830" [  weight=0 ];
    "1747578819" [  weight=0 ];
    "1747578819" -> "1747578830" [  weight=0 ];
}

When visualized, this would show the dependency structure between these migrations.