roc/vendor/pretty
2020-04-04 02:08:08 +02:00
..
src disable clippy in pretty.rs 2020-04-04 02:08:08 +02:00
Cargo.toml don't run pretty.rs tests 2020-04-04 01:50:19 +02:00
LICENSE add pretty.rs to vendor 2020-04-04 01:40:17 +02:00
README.md add pretty.rs to vendor 2020-04-04 01:40:17 +02:00

pretty.rs

Build Status Docs

Pretty printing combinators for Rust

Synopsis

This crate provides functionality for defining pretty printers. It is particularly useful for printing structured recursive data like trees.

The implementation was originally based on Larsen's SML translation (https://github.com/kfl/wpp) of Wadler's Haskell pretty printer (https://homepages.inf.ed.ac.uk/wadler/papers/prettier/prettier.pdf). It has since been modified in various ways to better fit Rust's programming model. In particular, it uses iteration rather than recursion and provides streaming output.

Documentation

See the generated API documentation here.

Requirements

  1. Rust
  2. Cargo

You can install both with the following:

$ curl -s https://static.rust-lang.org/rustup.sh | sudo sh

See Installation for further details.

Usage

$ cargo build                                          ## build library and binary
$ cargo run --example trees                            ## run the example (pretty trees)
$ cargo run --example colored --features termcolor     ## run the example (pretty colored output)
$ cargo bench                                          ## run benchmarks
$ cargo test                                           ## run tests