txJSON-RPC

If you are on a lookout for async Python JSON-RPC servers and clients either over HTTP or directly on TCP with the Netstring protocol, txJSON-RPC might just be your solution. This software is written in Twisted, which makes it excellent for those who prefer that framework.

For installation, there are a few ways to obtain this software. If you wish to develop for txJSON-RPC or use the latest code, you can install from the sources using `bzr branch lp:txjsonrpc`, `cd txjsonrpc`, and `sudo python setup.py install`. The easiest way, however, is to use the setuptools easy_install script with `sudo easy_install txJSON-RPC`. You can also manually download the source tarball from the Python Package Index.

Testing the source code is also relatively easy. Once installed, you can run `trial txjsonrpc` from the top-level source directory. This will run the test suite and report on the success and failure of any unit tests.

For usage, there are many examples in the top-level source directory that you can examine. This includes client and server examples for twiste.web-based and twiste.web2-based JSON-RPC, as well as Netstring TCP JSON-RPC. There is even a code showing how to use subhandlers for the TCP code, which is different from the XML-RPC/JSON-RPC HTTP-based subhandlers. Examining each of the Python files in the example directories is the best way to get a sense of how to use txJSON-RPC.