prettytable-rs

为 Rust 开发的格式化和对齐的表格打印库。

版权所有 © 2022 Pierre-Henri Symoneaux

本软件分发时不附带任何保证
有关更多信息，请参阅 LICENSE.txt 文件。

如何使用

• 包括
• 基本使用
• 使用宏
• 以风格化方式使用
  • 样式指定符列表
  • 颜色指定符列表
• 切片
• 自定义表格的外观和感觉
• CSV 导入/导出
  • 导入
  • 导出
• 关于行结束符的说明
• Evcxr 集成

包括

通过将以下行添加到您的 Cargo.toml 文件中，将库作为依赖项包含到您的项目中

[dependencies]
prettytable-rs = "^0.10"

该库需要至少 rust v1.56。

对 MSRV 的任何更改都将通过小版本号升级来完成。

SemVer 策略

• 1.0.0 之前的预版本 breaking changes 将遵循小版本号升级
• 1.0.0 之后 本库的所有默认功能都受 SemVer 保护
• 如上所述，MSRV 被视为 SemVer 之外

基本使用

开始使用它

#[macro_use] extern crate prettytable;
use prettytable::{Table, Row, Cell};

fn main() {
    // Create the table
    let mut table = Table::new();

    // Add a row per time
    table.add_row(row!["ABC", "DEFG", "HIJKLMN"]);
    table.add_row(row!["foobar", "bar", "foo"]);
    // A more complicated way to add a row:
    table.add_row(Row::new(vec![
        Cell::new("foobar2"),
        Cell::new("bar2"),
        Cell::new("foo2")]));

    // Print the table to stdout
    table.printstd();
}

上面的代码将输出

+---------+------+---------+
| ABC     | DEFG | HIJKLMN |
+---------+------+---------+
| foobar  | bar  | foo     |
+---------+------+---------+
| foobar2 | bar2 | foo2    |
+---------+------+---------+

使用宏

对于日常使用，请考虑使用 table! 宏。此代码将产生与上面相同的输出

#[macro_use] extern crate prettytable;

fn main() {
    let table = table!(["ABC", "DEFG", "HIJKLMN"],
                       ["foobar", "bar", "foo"],
                       ["foobar2", "bar2", "foo2"]);

    table.printstd();
}

ptable! 宏结合了创建和打印表格的功能

#[macro_use] extern crate prettytable;

fn main() {
    let table = ptable!(["ABC", "DEFG", "HIJKLMN"],
                        ["foobar", "bar", "foo"],
                        ["foobar2", "bar2", "foo2"]);
}

表格还支持多行单元格内容。因此，您可以打印一个表格到另一个表格中（yo dawg ;）。例如

let table1 = table!(["ABC", "DEFG", "HIJKLMN"],
                    ["foobar", "bar", "foo"],
                    ["foobar2", "bar2", "foo2"]);

let table2 = table!(["Title 1", "Title 2"],
                    ["This is\na multiline\ncell", "foo"],
                    ["Yo dawg ;) You can even\nprint tables\ninto tables", table1]);

table2.printstd();

将打印

+-------------------------+------------------------------+
| Title 1                 | Title 2                      |
+-------------------------+------------------------------+
| This is                 | foo                          |
| a multiline             |                              |
| cell                    |                              |
+-------------------------+------------------------------+
| Yo dawg ;) You can even | +---------+------+---------+ |
| print tables            | | ABC     | DEFG | HIJKLMN | |
| into tables             | +---------+------+---------+ |
|                         | | foobar  | bar  | foo     | |
|                         | +---------+------+---------+ |
|                         | | foobar2 | bar2 | foo2    | |
|                         | +---------+------+---------+ |
+-------------------------+------------------------------+

行可能有不同数量的单元格。表格将自动适应最大行，通过在较小的行中打印额外的空单元格。

以风格化方式使用！

表格可以具有带背景和前景颜色、粗体和斜体的样式化输出，这要归功于 term crate。还可以设置单元格的对齐方式（左、右、居中），并且单元格可以跨越多列。

term 样式属性被重新导出

• 直接

  use prettytable::{Attr, color};
  
  /* ... */
  
  table.add_row(Row::new(vec![
      Cell::new("foobar")
          .with_style(Attr::Bold)
          .with_style(Attr::ForegroundColor(color::GREEN)),
      Cell::new("bar")
          .with_style(Attr::BackgroundColor(color::RED))
          .with_style(Attr::Italic(true))
          .with_hspan(2),
      Cell::new("foo")
      ]));
  

• 通过样式字符串

  table.add_row(Row::new(vec![
      Cell::new("foobar").style_spec("bFg"),
      Cell::new("bar").style_spec("BriH2"),
      Cell::new("foo")]));
  

• 使用 row! 宏

  table.add_row(row![bFg->"foobar", BriH2->"bar", "foo"]);
  

• 使用 table! 宏（此宏创建一个新表，与之前的示例不同）

  table!([bFg->"foobar", BriH2->"bar", "foo"]);
  

这里

• bFg 表示 加粗，前景：绿色，
• BriH2 表示 背景：红色，斜体，水平跨距：2。

另一个例子： FrBybc 表示 前景：红色，背景：黄色，加粗，居中。

宏中所有单元格样式的示例

• 使用 row!，为每个单元格单独设置

  row![FrByb->"ABC", FrByb->"DEFG", "HIJKLMN"];
  

• 使用 row!，为整行设置

  row![FY => "styled", "bar", "foo"];
  

• 使用 table!，为每个单元格单独设置

  table!([FrBybl->"A", FrBybc->"B", FrBybr->"C"], [123, 234, 345, 456]);
  

• 使用 table!，为整行设置

  table!([Frb => "A", "B", "C"], [Frb => 1, 2, 3, 4], [1, 2, 3]);
  

• 使用 table!，混合样式

  table!([Frb => "A", "B", "C"], [Frb->1, Fgi->2, 3, 4], [1, 2, 3]);
  

样式指定符列表

• F : 前景（必须后跟颜色指定符）
• B : 背景（必须后跟颜色指定符）
• H : 水平跨距（必须后跟一个数字）
• b : 加粗
• i : 斜体
• u : 下划线
• c : 居中对齐
• l : 左对齐
• r : 右对齐
• d : 默认样式

颜色指定符列表

小写字母代表 普通 颜色

• r : 红色
• b : 蓝色
• g : 绿色
• y : 黄色
• c : 青色
• m : 品红色
• w : 白色
• d : 黑色

大写字母代表上述颜色的 亮色 对应色

• R : 亮红色
• B : 亮蓝色
• ...等等...

切片

表可以被分割成不可变的借用子表。切片的类型是 prettytable::TableSlice<'a>.

use prettytable::Slice;
/* ... */
let slice = table.slice(2..5);
table.printstd();

table.slice(..); // Returns a borrowed immutable table with all rows
table.slice(2..); // Returns a table with rows starting at index 2
table.slice(..3); // Returns a table with rows until the one at index 3

let mut table = Table::new();
let format = format::FormatBuilder::new()
    .column_separator('|')
    .borders('|')
    .separators(&[format::LinePosition::Top,
                  format::LinePosition::Bottom],
                format::LineSeparator::new('-', '+', '+', '+'))
    .padding(1, 1)
    .build();
table.set_format(format);

table.set_titles(row!["Title 1", "Title 2"]);
table.add_row(row!["Value 1", "Value 2"]);
table.add_row(row!["Value three", "Value four"]);

+-------------+------------+
| Title 1     | Title 2    |
| Value 1     | Value 2    |
| Value three | Value four |
+-------------+------------+

let table = Table::from_csv_string("ABC,DEFG,HIJKLMN\n\
                                    foobar,bar,foo\n\
                                    foobar2,bar2,foo2")?;

let table = Table::from_csv_file("input_csv.txt")?;

let reader = /* create a reader */;
/* do something with the reader */
let table = Table::from_csv(reader);

let out = File::create("output_csv.txt")?;
table.to_csv(out)?;

let writer = /* create a writer */;
/* do something with the writer */
table.to_csv_writer(writer)?;

:dep prettytable = { git = "https://github.com/phsym/prettytable-rs", package = "prettytable-rs", features = ["evcxr"] }