From 06bff9cb8fb002792d33c9669865ecb5c35816c7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?P=C5=99emysl=20Janouch?= Date: Sun, 27 Sep 2015 01:58:45 +0200 Subject: Convert README to AsciiDoc --- README | 65 ---------------------------------------------------------- README.adoc | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 68 insertions(+), 65 deletions(-) delete mode 100644 README create mode 100644 README.adoc diff --git a/README b/README deleted file mode 100644 index a1cc421..0000000 --- a/README +++ /dev/null @@ -1,65 +0,0 @@ -json-rpc-shell -============== - -`json-rpc-shell' is a simple shell for running JSON-RPC 2.0 queries. - -This software has been created as a replacement for the following shell, which -is written in Java: http://software.dzhuvinov.com/json-rpc-2.0-shell.html - -Supported transports --------------------- - - HTTP - - HTTPS - - WebSocket - - WebSocket over TLS - -WebSockets ----------- -The WebSocket transport is rather experimental. As the JSON-RPC 2.0 spec -doesn't say almost anything about the underlying transports, I'll shortly -describe the way it's implemented: every request is sent as a single text -message. If it has an "id" field, i.e. it's not just a notification, the -client waits for a message from the server in response. - -There's no support so far for any protocol extensions, nor for specifying -the higher-level protocol (the "Sec-Ws-Protocol" HTTP field). - -Building and Running --------------------- -Build dependencies: CMake, pkg-config, help2man, - liberty (included), http-parser (included) -Runtime dependencies: libev, Jansson, cURL, readline, openssl - - $ git clone --recursive https://github.com/pjanouch/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 - -Note that for versions of CMake before 2.8.9, you need to prefix cpack with -`fakeroot' or file ownership will end up wrong. - -Run the program with `--help' to obtain usage information. - -Contributing and Support ------------------------- -Use this project's GitHub to report any bugs, request features, or submit pull -requests. If you want to discuss this project, or maybe just hang out with -the developer, feel free to join me at irc://anathema.irc.so, channel #anathema. - -License -------- -`json-rpc-shell' is written by Přemysl Janouch . - -You may use the software under the terms of the ISC license, the text of which -is included within the package, or, at your option, you may relicense the work -under the MIT or the Modified BSD License, as listed at the following site: - -http://www.gnu.org/licenses/license-list.html diff --git a/README.adoc b/README.adoc new file mode 100644 index 0000000..4856080 --- /dev/null +++ b/README.adoc @@ -0,0 +1,68 @@ +json-rpc-shell +============== +:compact-option: + +'json-rpc-shell' is a simple shell for running JSON-RPC 2.0 queries. + +This software has been created as a replacement for the following shell, which +is written in Java: http://software.dzhuvinov.com/json-rpc-2.0-shell.html + +Supported transports +-------------------- + - HTTP + - HTTPS + - WebSocket + - WebSocket over TLS + +WebSockets +~~~~~~~~~~ +The WebSocket transport is rather experimental. As the JSON-RPC 2.0 spec +doesn't say almost anything about the underlying transports, I'll shortly +describe the way it's implemented: every request is sent as a single text +message. If it has an "id" field, i.e. it's not just a notification, the +client waits for a message from the server in response. + +There's no support so far for any protocol extensions, nor for specifying +the higher-level protocol (the "Sec-Ws-Protocol" HTTP field). + +Building and Running +-------------------- +Build dependencies: CMake, pkg-config, help2man, + liberty (included), http-parser (included) + +Runtime dependencies: libev, Jansson, cURL, readline, openssl + + $ git clone --recursive https://github.com/pjanouch/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 + +Note that for versions of CMake before 2.8.9, you need to prefix `cpack` with +`fakeroot` or file ownership will end up wrong. + +Run the program with `--help` to obtain usage information. + +Contributing and Support +------------------------ +Use this project's GitHub to report any bugs, request features, or submit pull +requests. If you want to discuss this project, or maybe just hang out with +the developer, feel free to join me at irc://anathema.irc.so, channel #anathema. + +License +------- +'json-rpc-shell' is written by Přemysl Janouch . + +You may use the software under the terms of the ISC license, the text of which +is included within the package, or, at your option, you may relicense the work +under the MIT or the Modified BSD License, as listed at the following site: + +http://www.gnu.org/licenses/license-list.html -- cgit v1.2.3