usv-to-json

Crates.iousv-to-json
lib.rsusv-to-json
version1.2.1
sourcesrc
created_at2024-03-17 20:04:47.673824
updated_at2024-04-11 19:54:58.225596
descriptionUSV to JSON: Convert Unicode Separated Values (USV) to JavaScript Object Notation (JSON) for data markup, including for spreadsheets, databases, text files, and more.
homepage
repositoryhttps://github.com/sixarm/usv-to-json-rust-crate/
max_upload_size
id1176768
size38,673
Joel Parker Henderson (joelparkerhenderson)

documentation

README

usv-to-json

Convert Unicode Separated Values (USV) to JavaScript Object Notation (JSON). Built with the USV Rust crate.

Syntax:

stdin | usv-to-json | stdout

Example:

cat example.usv | usv-to-json

More examples below.

Options

  • -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 usv-to-json

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

Example

Suppose example.usv contains:

a␟b␟␞
c␟d␟␞

Run:

cat example.usv | usv-to-json

Output:

[
    ["a","b"],
    ["c","d"],
]

Example with output to a file:

cat example.usv | usv-to-json > example.json

FAQ

What converters are available?

When to use this command?

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

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

Our real-world use case is converting a bunch of USV document-oriented data from a variety of programs, including a CMS, to USV so we're better-able to import the data into Excel.

Why use USV instead of JSON?

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: usv-to-json-rust-crate
  • Version: 1.2.1
  • Created: 2024-03-09T13:33:20Z
  • Updated: 2024-04-11T19:54:23Z
  • 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)
Commit count: 11

cargo fmt