MessagePack CLI

This is a simple CLI for converting between MessagePack and JSON. Jump to Installing for installation instructions.

```sh $ # Basic usage: convert a file either direction $ mpk in.json -o out.msgpack $ mpk out.msgpack {"name":"messagepack","age":20,"source":"github"}

$ # Pretty formatting $ mpk out.msgpack --pretty { "name": "messagepack", "age": 20, "source": "github" }

$ # Use stdin input and stdout output. You need to specify the destination type with $ # --to-msgpack or --to-json (-m or -j) $ cat in.json | mpk --to-msgpack | xxd 00000000: 83a4 6e61 6d65 ab6d 6573 7361 6765 7061 ..name.messagepa 00000010: 636b a361 6765 14a6 736f 7572 6365 a667 ck.age..source.g 00000020: 6974 6875 62 ithub

$ # Use a hex string as input or output $ mpk --hex -i "82 a7 63 6f 6d 70 61 63 74 c3 a6 73 63 68 65 6d 61 00" --to-json {"compact":true,"schema":0} $ mpk --hex -i '{"compact":true,"schema":0}' --to-msgpack 82a7636f6d70616374c3a6736368656d6100

$ # And with pretty print: $ mpk in.json --hex --pretty 83a4 6e61 6d65 ab6d 6573 7361 6765 7061 636b a361 6765 14a6 736f 7572 6365 a667 6974 6875 62 ```

Installing

The easiest way to install is to go the [releases] page and download a version. If you use Debian or Ubuntu, using the prebuilt .deb package is easiest; just download and install with with dpkg -i mpk-download-path.deb. dpkg -r mpk will uninstall if needed.

For other systems download the correct target and extract the archive. You can then either use the binary directly, or use make install to put it in your system path (along with manual pages and autocomplete scripts). make uninstall can reverse this.

Alternatively, you can install with Cargo via cargo install msgpack-cli, or build the source yourself with cargo build --release.

Usage

See above for usage examples. The command line options are as follows:

``` Usage: mpk [OPTIONS] [INPUT_FILE]

Arguments: [INPUT_FILE] Specify the input file to read from. If not given, stdin will be used

Options: -o, --output Specify the output file to write. If not specified, stdout will be used -i, --input Specify input via text. (can't use with 'INPUT_FILE') -j, --to-json Convert from MessagePack to JSON. (can't use with '--to-json') -m, --to-msgpack Convert from JSON to MessagePack. (can't use with '--to-msgpack') --hex Use messagepack with hexadecimal strings instead of binary -p, --pretty Enable pretty output (formatted JSON, spacing for MessagePack when used with --hex) -v, --verbose Turn verbose mode on -h, --help Print help information (use --help for more detail) -V, --version Print version information ```