jsonrpc-cli
========

A jsonrpc command line utility for devlopment and testing.

Usage
--------

    jsonrpc-cli --endpoint <endpoint> [options] <method> [<params>]

Params can be the following formats:

1. JSON string, e.g. `{"a": 1, "b": 2}`
2. JSON file, e.g. `@/path/to/file.json`
3. Key-value pair
    Examples
    - `a=int(1) b=null()` generates `{"a": 1, "b": null}`
    - `--a=1 --b=2` generates `{"a": "1", "b": "2"}`
    - `-a 1 -b 2` generates `{"a": "1", "b": "2"}`
4. Array separated by comma, e.g. `1,2,3` generates `[1, 2, 3]`

Examples
--------

    # call `add` method with params `{"a": 1, "b": 2}`
    JSONRPC_ENDPOINT=http://localhost:3000 jsonrpc add 1 2
    # alternatively
    JSONRPC_ENDPOINT=http://localhost:3000 jsonrpc add 1,2

    # call `vector_product` method with params `{"a": [1, 2, 3], "b": [4, 5, 6]}`
    JSONRPC_ENDPOINT=http://localhost:3000 jsonrpc vector_product {"a": [1, 2, 3], "b": [4, 5, 6]}

Options
--------

    -h, --help                  output usage information
    -V, --version               output the version number
    -v, --rpc-version <version> jsonrpc version, default: 2.0
    -e, --endpoint <endpoint>   jsonrpc server endpoint
    -i, --id <id>               jsonrpc id, e.g. "test", "int(1)", "null()"
    -d, --verbose               verbose output for debugging

NOTE: `--endpoint` can be set by environment variable `JSONRPC_ENDPOINT`.

Build and Install
--------

Released binaries are available at <https://github.com/pluveto/jsonrpc-cli/releases>. Or you can build it from source code:

    git clone https://github.com/pluveto/jsonrpc-cli
    cd jsonrpc-cli

Default PREFIX is `/usr/local`, you can change it by `make PREFIX=/path/to/prefix install`.

    make
    make install

License
--------

This program is licensed under the MIT license.