30 releases

0.12.3 Sep 21, 2023
0.12.1 Apr 19, 2023
0.12.0 Mar 30, 2023
0.11.3 Apr 21, 2022
0.0.1 Nov 21, 2014

#25 in Command-line interface

Download history 55270/week @ 2023-12-12 46736/week @ 2023-12-19 19214/week @ 2023-12-26 35829/week @ 2024-01-02 36964/week @ 2024-01-09 39458/week @ 2024-01-16 42007/week @ 2024-01-23 40671/week @ 2024-01-30 46275/week @ 2024-02-06 45228/week @ 2024-02-13 40078/week @ 2024-02-20 45475/week @ 2024-02-27 42961/week @ 2024-03-05 39572/week @ 2024-03-12 38689/week @ 2024-03-19 42158/week @ 2024-03-26

170,683 downloads per month
Used in 370 crates (41 directly)

MIT license

89KB
2K SLoC

pretty.rs

build 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

Dependencies

~160–365KB