summaryrefslogtreecommitdiff
path: root/README.md
blob: a8327b9362c2f07884eede5ee5dddd3f98bc6818 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
# Dotavious

[![crates.io](https://meritbadge.herokuapp.com/dotavious)](https://crates.io/crates/dotavious)
[![Released API docs](https://docs.rs/dotavious/badge.svg)](https://docs.rs/dotavious)
[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
[![CI](https://github.com/doctavious/dotavious/workflows/CI/badge.svg)](https://github.com/doctavious/dotavious/actions?query=workflow%3ACI)

A library for generating [Graphviz](https://graphviz.org/) [DOT](https://graphviz.org/doc/info/lang.html) language files 
for visualizing graphs.

## Constraints / Limitations

- Not every Attribute is fully documented/described. 
  However, all those which have specific allowed values should be covered. 
- Deprecated Attributes are not defined.


## Quickstart

```rust
use dotavious::{Dot, Edge, Graph, GraphBuilder, Node};
use std::io;
use std::io::Read;

// can also start building a undirected graph via `GraphBuilder::new_undirected`
let graph = GraphBuilder::new_directed(Some("example".to_string()))
        .add_node(Node::new("N0".to_string()))
        .add_node(Node::new("N1".to_string()))
        .add_edge(Edge::new("N0".to_string(), "N1".to_string()))
        .build()
        .unwrap();

let dot = Dot { graph };
println!("{}", dot);
```
which produces
```
digraph example {
    N0;
    N1;
    N0 -> N1;
}
```
and when rendered will look like
![README example rendered](readme-example.png?raw=true)