Struct dot_writer::DotWriter

pub struct DotWriter<'w> { /* fields omitted */ }

The entry point struct for writing a DOT graph. See the examples on the index for how to use it. This struct must live for the livetime of writing the graph, and also outlive the Write struct it points to, because it’s Drop trait will finish writing graph.

Implementations

impl<'w> DotWriter<'w>

pub fn set_pretty_print(&mut self, pretty_print: bool)

If set to true, then output will have additional whitespace including newlines and indentation to make the output more human friendly. If false then this will be left out and the output will be more compact. Defaults to true. For example disabled:

use dot_writer::DotWriter;

let mut bytes = Vec::new();
let mut writer = DotWriter::from(&mut bytes);
writer.set_pretty_print(false);
writer.graph().subgraph().cluster().subgraph();
println!("{}", std::str::from_utf8(&bytes).unwrap());

Gives you:

graph {subgraph {subgraph cluster_0 {subgraph {}}}}

While enabled:

use dot_writer::DotWriter;

let mut bytes = Vec::new();
let mut writer = DotWriter::from(&mut bytes);
// writer.set_pretty_print(false); defaults to true anyway
writer.graph().subgraph().cluster().subgraph();
println!("{}", std::str::from_utf8(&bytes).unwrap());

Gives you:

graph {
  subgraph {
    subgraph cluster_0 {
      subgraph {}
    }
  }
}

pub fn graph(&mut self) -> Scope<'_, 'w>

Start a new undirection graph. This uses the edge operator -- automatically, which means edges should be rendered without any arrowheads by default.

use dot_writer::DotWriter;

let mut bytes = Vec::new();
let mut writer = DotWriter::from(&mut bytes);
writer.set_pretty_print(false);
writer.graph().edge("a", "b");
assert_eq!(
    std::str::from_utf8(&bytes).unwrap(),
    "graph {a--b;}"
);

pub fn digraph(&mut self) -> Scope<'_, 'w>

Start a new directed graph. This uses the edge operator -> automatically, which means edges should be redered with an arrow head pointing to the head (end) node.

use dot_writer::DotWriter;

let mut bytes = Vec::new();
let mut writer = DotWriter::from(&mut bytes);
writer.set_pretty_print(false);
writer.digraph().edge("a", "b");
assert_eq!(
    std::str::from_utf8(&bytes).unwrap(),
    "digraph {a->b;}"
);

Trait Implementations

impl<'w, W: Write> From<&'w mut W> for DotWriter<'w>

This is the only constructor, which requires a Write to borrow and write the DOT output to. Defaults to pretty printing the output (see DotWriter::set_pretty_print).

fn from(writer: &'w mut W) -> Self

Performs the conversion.