#usv #export #import #import-export #data #asv

bin+lib asv-to-usv

ASV to USV: Convert ASCII Separated Values (ASV) to Unicode Separated Values (USV) such as for data markup, including for spreadsheets, databases, text files, and more

11 stable releases

1.5.2 Apr 11, 2024
1.5.1 Apr 10, 2024
1.3.1 Mar 26, 2024

#1376 in Encoding

MIT OR Apache-2.0 OR GPL-2.0 OR GPL-3.0

24KB
298 lines

asv-to-usv

Convert ASCII Separated Values (ASV) to Unicode Separated Values (USV). Built with the USV Rust crate.

Syntax:

stdin | asv-to-usv | stdout

Example:

cat example.asv | asv-to-usv

More examples below.

Options

Options for USV separators and modifiers:

  • -u, --unit-separator : Set the unit separator (US) string.

  • -r, --record-separator : Set the record separator (RS) string.

  • -g, --group-separator : Set the group separator (GS) string.

  • -f, --file-separator : Set the file separator (FS) string.

  • -e, --escape : Set the escape (ESC) string.

  • -z, --end-of-transmission : Set the end of transmission (EOT) string.

Options for USV style:

  • --style-braces : Set the style to use braces, such as "{US}" for Unit Separator.

  • --style-controls : Set the style to use controls, such as "\u001F" for Unit Separator.

  • --style-symbols : Set the style to use symbols, such as "␟" for Unit Separator.

Options for USV layout:

  • --layout-0: Show each item with no line around it. This is no layout, in other words one long line.

  • --layout-1: Show each item with one line around it. This is like single-space lines for long form text.

  • --layout-2: Show each item with two lines around it. This is like double-space lines for long form text.

  • --layout-units: Show each unit on one line. This can be helpful for line-oriented tools.

  • --layout-records: Show each record on one line. This is like a typical spreadsheet sheet export.

  • --layout-groups: Show each group on one line. This can be helpful for folio-oriented tools.

  • --layout-files: Show one file on one line. This can be helpful for archive-oriented tools.

Options for command line tools:

  • -h, --help : Print help

  • -V, --version : Print version

  • -v, --verbose... : Set the verbosity level: 0=none, 1=error, 2=warn, 3=info, 4=debug, 5=trace. Example: --verbose …

  • --test : Print test output for debugging, verifying, tracing, and the like. Example: --test

Install

Install:

cargo install asv-to-usv

Link: https://crates.io/crates/asv-to-usv

Example

Suppose example.asv contains:

a\u001Fb\u001Ec\u001Fd\u001E

Run:

cat example.asv | asv-to-usv

Output:

a␟b␟␞
c␟d␟␞

If you prefer to render no newlines, which is more like the input:

cat example.csv | asv-to-usv --layout-0

Output:

a␟b␟␞c␟d␟␞

If you prefer to render markers with braces, to see the markers more easily:

cat example.csv | asv-to-usv --style-braces

Output:

a{US}b{US}{RS}
c{US}d{US}{RS}

FAQ

What converters are available?

When to use this command?

Use this command when you want to convert from ASV to USV.

A typical use case is when you have ASV data, such as a collection of units and records, and you want to convert it to USV data, such as for visual editing.

Our real-world use case is converting a bunch of document-oriented data from a variety of programs to a variety of data formats, spreadsheets, and databases.

Why use USV instead of ASV?

See the documentation for USV.

Is USV aiming to become a standard?

Yes, USV is submitted to IETF.org as an Internet-Draft work in progress: link.

Can I build my own USV tools?

Yes, and you may freely use the USV RFC and USV Rust crate.

Help wanted

Constructive feedback welcome. Pull requests and feature requests welcome.

Tracking

  • Package: asv-to-usv-rust-crate
  • Version: 1.5.2
  • Created: 2024-03-09T13:33:20Z
  • Updated: 2024-04-10T20:51:41Z
  • License: MIT or Apache-2.0 or GPL-2.0 or GPL-3.0 or contact us for more
  • Contact: Joel Parker Henderson (joel@sixarm.com)

Dependencies

~1.5MB
~23K SLoC