jsonrpc 0.0.1
JSON-RPC protocol library.
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
JSON-RPC Server and Client Library
This is a library to create JSON-RPC servers and clients quickly and use them simply.
interface MyAPI {
bool one(int y);
void two(bool b, int c, string d);
int three();
}
// These are the callable functions.
// Inheritance isn't necessary.
class APIImpl : MyAPI {
bool one(int y) { return (y > 5); }
void two(bool b, int c, string d) { return; }
int three() { return 100; };
}
// We'll run this in a new thread for this example.
void startServer(string host, string port) {
auto server = new RPCServer!APIImpl(host, port);
server.listen();
}
void main() {
import core.thread : Thread;
import core.time : dur;
import std.parallelism : task;
task!startServer("127.0.0.1", 54321).executeInNewThread;
Thread.sleep(dur!"seconds"(3)); // Give it time to start up before connecting.
// Now create a client.
auto client = new RPCClient!MyAPI("127.0.0.1", 54321);
// These are calls that return the function's response.
client.two(true, 2, "somestring");
assert(client.one(3) == false);
assert(client.three() == 100);
// `call` returns the Response from the server.
auto resp = client.call("one", 3);
assert(resp.result == JSONValue(false));
// `notify` executes a function, but doesn't get a response from the server.
client.notify("one", 3);
// Send a batch.
import std.typecons : Yes;
import std.json : parseJSON;
auto responses = client.batch(
batchReq("one", JSONValue(3)),
batchReq("one", JSONValue(3), Yes.notify),
batchReq("two", JSONValue(`{"b": false, "c": -50, "d": "fifty"}`.parseJSON)),
batchReq("three", JSONValue()),
batchReq("three", JSONValue(), Yes.notify)
);
assert(responses.length == 3); // Notifications don't return a response.
assert(responses[2].result == JSONValue(100));
}
This is currently usable but may not be stable/reliable (so, usable-ish).
Documentation is currently in the docs/ folder and is not rebuilt often; I'll host them properly it once the project is ready.
Testing
The tested library is an optional
dependency for unit testing; to use it, add the following dub.selections.json
to your project root:
{
"fileVersion": 1,
"versions": {
"tested": "0.9.4"
}
}
- Registered by Ryan Frame
- 0.0.1 released 6 years ago
- rjframe/json-rpc
- MIT
- Copyright © 2017 Ryan Frame
- Authors:
- Dependencies:
- tested
- Versions:
-
0.0.2 2018-Oct-29 0.0.1 2018-Oct-29 ~master 2021-Mar-29 - Download Stats:
-
-
0 downloads today
-
0 downloads this week
-
0 downloads this month
-
28 downloads total
-
- Score:
- 0.0
- Short URL:
- jsonrpc.dub.pm