#string #format-string #format #collection #separator #utf-8 #formatted

nightly bin+lib lineup

读写格式化的 UTF-8 字符串项的集合

5 个版本 (1 个稳定版)

1.0.0 2023 年 3 月 6 日
0.10.1 2022 年 11 月 23 日
0.9.1 2022 年 11 月 22 日
0.2.1 2022 年 12 月 7 日

#475 in 可视化

每月 31 次下载

GPL-3.0-or-later

27KB
471

lineup

读写格式化的 UTF-8 字符串项的集合

关于

lineup 是一个 Rust 库和跨平台命令行工具,用于根据指定的输入和输出格式(分隔符、填充、锚点等)读取和写入 UTF-8 字符串列表。

$ echo -n 'hi,here,hey' | lineup --in-separator=',' --out-span=4 --out-pad='_' --out-anchor=right --out-line-n=1 --out-line-separator='
> '; echo
__hi
here
_hey

更多信息请查看

lineup --help

入门

先决条件

lineup 是跨平台的,使用 Rust 编码;您需要安装有效的 Rust

使用 cargo 获取

cargo install -f lineup

从源代码构建

  1. 克隆此仓库
  2. 使用 cargo 构建
cargo build --release

用法

read/write collection of formatted UTF-8 string items

Usage: lineup [OPTIONS]

Options:
      --in-separator <IN_SEPARATOR>
          IN FORMAT: input item separator, possible values:
            N:   N is fixed number of bytes per item, no explicit item separator; NOTE N must be > 0 and boundary of a UTF-8 code point for each item
            SEP: SEP is a string used to separate items; SEP cannot start with a digit
          
          [default: ,]

      --in-line-n <IN_LINE_N>
          IN format, line: number of items per line; if 0 provided all items are on a single line
          
          [default: 0]

      --in-line-separator <IN_LINE_SEPARATOR>
          IN format, line: separator string between lines
          
          [default: ]

      --out-span <OUT_SPAN>
          OUT format, span: max characters an item would need; shorter representations would be padded with 'pad' and anchored according to 'anchor'; if 0, items will not be padded so 'pad' and 'anchor' are not used
          
          [default: 0]

      --out-pad <OUT_PAD>
          OUT format, span: pad character (see 'span')
          
          [default: " "]

      --out-anchor <OUT_ANCHOR>
          OUT format, span: anchor items to the left or right when padding is needed (see 'span')
          
          [default: left]
          [possible values: right, left]

      --out-separator <OUT_SEPARATOR>
          OUT format: separator string for items within a line
          
          [default: " "]

      --out-line-n <OUT_LINE_N>
          OUT format, line: number of items per line; if 0 provided put all items on a single line
          
          [default: 0]

      --out-line-separator <OUT_LINE_SEPARATOR>
          OUT format, line: separator string between lines
          
          [default: ]

  -h, --help
          Print help information (use `-h` for a summary)

  -V, --version
          Print version information

输入格式参数

这些参数指定输入项如何在输入流中排列

  • 项分隔符:--in-separator
  • 行分隔符
    • 每行项数:--in-line-n,0 禁用行分隔
    • 行分隔符:in-line-separator

输出格式参数

这些参数指定项如何在输出流中排列

  • 跨度
    • 跨度大小:--out-span,0 禁用跨度
    • 填充字符:--out-pad
    • 锚点:--out-anchor
  • 项分隔符:--out-separator
  • 行分隔符
    • 每行项数:--out-line-n,0 禁用行分隔
    • 行分隔符:out-line-separator

许可

本项目采用 GNU 通用公共许可证 v3 许可。

有关更多信息,请参阅 LICENSE

感谢

依赖关系

~3MB
~61K SLoC