tabwriter is a crate that implements
elastic tabstops. It
provides both a library for wrapping Rust Writer
s and a small program that
exposes the same functionality at the command line.
Dual-licensed under MIT or the UNLICENSE.
Simple example of library
use Write;
use TabWriter;
let mut tw = new;
tw.write_all.unwrap;
tw.flush.unwrap;
let written = String from_utf8.unwrap;
assert_eq!;
You can see an example of real use in my CSV toolkit.
Simple example of command line utility
|
Notice that once a column block is broken, alignment starts over again.
Documentation
The API is fully documented with some examples: http://burntsushi.net/rustdoc/tabwriter/.
Installation
This crate works with Cargo. Assuming you have Rust and Cargo installed, simply check out the source and run tests:
You can also add tabwriter
as a dependency to your project's Cargo.toml
:
[]
= "1"
Dealing with ANSI escape codes
If you want tabwriter
to be aware of ANSI escape codes, then compile it with
the ansi_formatting
feature enabled.
Minimum Rust version policy
This crate's minimum supported rustc
version is 1.34.0
.
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.