78 lines
2.9 KiB
Plaintext
78 lines
2.9 KiB
Plaintext
json-rpc-shell
|
|
==============
|
|
:compact-option:
|
|
|
|
'json-rpc-shell' is a shell for running JSON-RPC 2.0 queries.
|
|
|
|
This software was originally created as a replacement for
|
|
http://software.dzhuvinov.com/json-rpc-2.0-shell.html[a different shell] made by
|
|
Vladimir Dzhuvinov, in order to avoid Java, but has evolved since.
|
|
|
|
Features
|
|
--------
|
|
In addition to most of the features provided by its predecessor, you will get
|
|
the following niceties:
|
|
|
|
- configurable JSON syntax highlight, which with prettyprinting turned on
|
|
helps you make sense of the results significantly
|
|
- ability to pipe output through a shell command, so that you can view the
|
|
results in your favourite editor or redirect them to a file
|
|
- ability to edit the input line in your favourite editor as well with Alt+E
|
|
- WebSocket (RFC 6455) can also be used as a transport rather than HTTP
|
|
- even Language Server Protocol servers may be launched as a slave command
|
|
- support for method name tab completion using OpenRPC discovery or file input
|
|
|
|
Documentation
|
|
-------------
|
|
See the link:json-rpc-shell.adoc[man page] for information about usage.
|
|
The rest of this README will concern itself with externalities.
|
|
|
|
Packages
|
|
--------
|
|
Regular releases are sporadic. git master should be stable enough.
|
|
You can get a package with the latest development version using Arch Linux's
|
|
https://aur.archlinux.org/packages/json-rpc-shell-git[AUR],
|
|
or as a https://git.janouch.name/p/nixexprs[Nix derivation].
|
|
|
|
Building
|
|
--------
|
|
Build dependencies: CMake, pkg-config, liberty (included),
|
|
http-parser (included), asciidoctor or asciidoc (recommended but optional) +
|
|
Runtime dependencies:
|
|
libev, Jansson, cURL, openssl, readline or libedit >= 2013-07-12
|
|
|
|
$ git clone --recursive https://git.janouch.name/p/json-rpc-shell.git
|
|
$ mkdir json-rpc-shell/build
|
|
$ cd json-rpc-shell/build
|
|
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
|
|
$ make
|
|
|
|
To install the application, you can do either the usual:
|
|
|
|
# make install
|
|
|
|
Or you can try telling CMake to make a package for you. For Debian it is:
|
|
|
|
$ cpack -G DEB
|
|
# dpkg -i json-rpc-shell-*.deb
|
|
|
|
Test server
|
|
-----------
|
|
If you install development packages for libmagic, an included test server will
|
|
be built but not installed which provides a trivial JSON-RPC 2.0 service with
|
|
FastCGI, SCGI, WebSocket and LSP-like co-process interfaces. It responds to
|
|
`ping` and `date`, supports OpenRPC discovery and it can serve static files.
|
|
|
|
Contributing and Support
|
|
------------------------
|
|
Use https://git.janouch.name/p/json-rpc-shell to report bugs, request features,
|
|
or submit pull requests. `git send-email` is tolerated. If you want to discuss
|
|
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
|
|
|
|
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
|
|
|
|
License
|
|
-------
|
|
This software is released under the terms of the 0BSD license, the text of which
|
|
is included within the package along with the list of authors.
|