Graphviz::DOT::Grammar

Raku package with a parser and interpreters of Graphviz DOT language.

Languages and formats DOT is translated to:

• DONE DOT layout formats

  • SVG, EPS, JSON, plain, etc.

• DONE PlantUML

  • PlantUML uses DOT language, so it was very short and easy format implementation.

• DONE Mermaid-JS

• [-] TODO Mathematica

  • DONE Basic vertexes and edges

  • TODO Vertex styles

  • TODO Edge styles

• TODO Raku

  • Translation to Raku graphs, [AAp1]

  • Based on the Mathematica actions

Usage examples

Here is a graph (see [AAp1]):

use Graph::HexagonalGrid;

my $g = Graph::HexagonalGrid.new(1, 1);

# Graph(vertexes => 6, edges => 6, directed => False)

Translate to Mermaid-JS:

use Graphviz::DOT::Grammar;
$g.dot ==> dot-interpret(a=>'mermaid')

Translate to Mathematica:

$g.dot ==> dot-interpret(a=>'Mathematica')

Graph[{}, {UndirectedEdge["3", "5"], UndirectedEdge["4", "5"], UndirectedEdge["0", "2"], UndirectedEdge["2", "4"], UndirectedEdge["1", "3"], UndirectedEdge["0", "1"]}]

CLI

The package provides the Command Line Interface (CLI) script from-dot. Here is its usage message:

from-dot --help

# Usage:
#   from-dot <text> [-t|--to=<Str>] [-o|--output=<Str>] -- Converts Graphviz DOT language texts or files into Mermaid-JS, Mathematica, Markdown, JSON, Raku, or SVG files.
#   
#     <text>               Input file or DOT spec.
#     -t|--to=<Str>        Format to convert to. (One of 'json', 'mathematica', 'mermaid', 'raku', 'svg', or 'Whatever'.) [default: 'Whatever']
#     -o|--output=<Str>    Output file; if an empty string then the result is printed to stdout. [default: '']

References

[AAp1] Anton Antonov, Graph Raku package, (2024), GitHub/antononcube.