json-to-usv 1.0.0

CVS to USV: Convert JavaScript Object Notation (JSON) to Unicode Separated Values (USV) for data markup, including for spreadsheets, databases, text files, and more.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

# json-to-usv

Convert JavaScript Object Notation (JSON) to [Unicode Separated Values (USV)](https://github.com/sixarm/usv).

Syntax:

```sh
stdin | json-to-usv [options] | stdout
```

Example:

```sh
cat example.json | json-to-usv
```

Example with output to a file:

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


## Options

* -d, --delimiter <delimiter> : Set the delimiter character [default: ";"]

* -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:

```sh
cargo install json-to-usv
```

Link: [https://crates.io/crates/json-to-usv](https://crates.io/crates/json-to-usv)


## Example

Suppose file example.json contains:

```json
[
    ["a","b","c"],
    ["d","e","f"],
    ["g","h","i"]
]
```

Run:

```sh
cat example.json | json-to-usv
```

Output:

```usv
a␟b␟c␟␞
d␟e␟f␟␞
g␟h␟i␟␞
```


## FAQ

### When to use this command?

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

A typical use case is when you have JSON data, such as a web request result,
and you want to convert it to USV, such as to make the data easier to view,
or edit, or maintain.

Our real-world use case is converting a bunch of JSON web API RPC results
from a variety of programs, including Excel, to USV so we're better-able to
handle quoting, and multi-line data units, and Unicode characters in a wide
variety of human languages.

### Is there a similar command to convert from USV to JSON?

Yes: [usv-to-json](https://crates.io/crates/usv-to-json).

### Why use USV instead of JSON?

See the documentation for [USV](https://github.com/sixarm/usv).

### Is USV aiming to become a standard?

Yes, USV is submitted to IETF.org as an Internet-Draft work in progress:
[link](https://datatracker.ietf.org/doc/draft-unicode-separated-values/).

## Help wanted

Constructive feedback welcome. Pull requests and feature requests welcome.

## Tracking

* Package: json-to-usv-rust-crate
* Version: 1.2.0
* Created: 2024-03-09-13:33:20Z
* Updated: 2024-03-17T19:24:53Z
* 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)