fastjsonrpc 0.3.0

A library for writing asynchronous JSON-RPC servers and clients in Python, using Twisted.

Introduction

A library for writing asynchronous JSON-RPC servers and clients in Python, using Twisted. It aims to be as simple and easy to understand (and hack) as possible.

Read more about JSON-RPC at http://www.jsonrpc.org/

Features

• Support for HTTP and HTTPS as protocol (via twisted.web) and for more lightweight netstring (see http://cr.yp.to/proto/netstrings.txt )

• Support for HTTP authentization - only basic, not digest; use SSL for encrypted credentials.

• Support for HTTP persistent connections and Factory to create proxies to different URLs

• Support for HTTP compression

• Full standards compliance.

• Support both JSON-RPC standards at once - great if you don’t control your clients.

• ‘Just work’ with various clients (i.e. PHP, C++, JavaScript…).

• Detailed examples :-) .

TODO

• More tests, better (functionality) coverage. This applies to every project, always :-) .

• Refactoring, mostly tests.

  • test_server and test_jsonrpc

  • test_client and test_netstringclient

Notes

• JSON is well readable for a human. It’s easy to use Wireshark (www.wireshark.org) or similar for debugging.

• JSON-RPC version 1 doesn’t talk about batch requests. In order to support both standards at once, fastjsonrpc supports it just like in version 2. It ties JSON-RPC version to the method call, not the request as a whole.

• I didn’t test the JSON Class hinting, as mentioned in the version 1 spec. I leave this to the JSON parsing capabilities of respective libraries.

• SSL client test raises an error after shutDown. Looks like a bug in Trial and we can ignore it.