#tree #formatting #pretty-print #derive #charset

display_tree

Simple, automatic, and customizable tree pretty-printing

4 stable releases

1.1.2 Dec 20, 2022
1.1.0 Dec 19, 2022
1.0.3 Dec 19, 2022

#143 in Value formatting

Download history 5/week @ 2024-02-15 21/week @ 2024-02-22 13/week @ 2024-02-29 15/week @ 2024-03-07 19/week @ 2024-03-14 8/week @ 2024-03-21 13/week @ 2024-03-28

55 downloads per month

MIT/Apache

41KB
510 lines

display_tree

Simple, automatic, and customizable tree pretty-printing in Rust.

Example

This crate provides tools to easily pretty-print data as a tree, including a trait that represents the ability to be printed as a tree, and a derive macro to automatically implement it for your types

See the crate-level documentation to get started.

Examples

use display_tree::{AsTree, CharSet, DisplayTree, StyleBuilder};

// A tree representing a numerical expression.
#[derive(DisplayTree)]
enum Expr {
    Int(i32),
    BinOp {
        #[node_label]
        op: char,
        #[tree]
        left: Box<Self>,
        #[tree]
        right: Box<Self>,
    },
    UnaryOp {
        #[node_label]
        op: char,
        #[tree]
        arg: Box<Self>,
    },
}

let expr: Expr = Expr::BinOp {
    op: '+',
    left: Box::new(Expr::UnaryOp {
        op: '-',
        arg: Box::new(Expr::Int(2)),
    }),
    right: Box::new(Expr::Int(7)),
};

assert_eq!(
    format!(
        "{}",
        AsTree::new(&expr)
            .indentation(1)
            .char_set(CharSet::DOUBLE_LINE)
    ),
    concat!(
        "+\n",
        "╠═ -\n",
        "║  ╚═ Int\n",
        "║     ╚═ 2\n",
        "╚═ Int\n",
        "   ╚═ 7",
    ),
);

Dependencies

~1.5MB
~34K SLoC