29 releases (6 stable)
✓ Uses Rust 2018 edition
|1.2.1||Jan 12, 2020|
|1.1.0||Jun 27, 2018|
|1.0.4||Mar 7, 2018|
|1.0.3||Jan 3, 2017|
|0.1.3||Nov 27, 2014|
#16 in Text processing
17,945 downloads per month
Used in 48 crates (42 directly)
tabwriter is a crate that implements
elastic tabstops. It
provides both a library for wrapping Rust
Writers and a small program that
exposes the same functionality at the command line.
Dual-licensed under MIT or the UNLICENSE.
use std::io::Write; use tabwriter::TabWriter; let mut tw = TabWriter::new(vec!); tw.write_all(b" Bruce Springsteen\tBorn to Run Bob Seger\tNight Moves Metallica\tBlack The Boss\tDarkness on the Edge of Town ").unwrap(); tw.flush().unwrap(); let written = String::from_utf8(tw.into_inner().unwrap()).unwrap(); assert_eq!(&written, " Bruce Springsteen Born to Run Bob Seger Night Moves Metallica Black The Boss Darkness on the Edge of Town ");
You can see an example of real use in my CSV toolkit.
[andrew@Liger tabwriter] cat sample | sed 's/ /\\t/g' a\tb\tc abc\tmnopqrstuv\txyz abcmnoxyz\tmore text a\tb\tc [andrew@Liger tabwriter] ./target/tabwriter < sample a b c abc mnopqrstuv xyz abcmnoxyz more text a b c
Notice that once a column block is broken, alignment starts over again.
The API is fully documented with some examples: http://burntsushi.net/rustdoc/tabwriter/.
This crate works with Cargo. Assuming you have Rust and Cargo installed, simply check out the source and run tests:
git clone git://github.com/BurntSushi/tabwriter cd tabwriter cargo test
You can also add
tabwriter as a dependency to your project's
[dependencies] tabwriter = "1"
If you want
tabwriter to be aware of ANSI escape codes, then compile it with
ansi_formatting feature enabled.
This crate's minimum supported
rustc version is
The current policy is that the minimum Rust version required to use this crate
can be increased in minor version updates. For example, if
crate 1.0 requires
Rust 1.20.0, then
crate 1.0.z for all values of
z will also require Rust
1.20.0 or newer. However,
crate 1.y for
y > 0 may require a newer minimum
version of Rust.
In general, this crate will be conservative with respect to the minimum supported version of Rust.