@@ -1,18 +1,48 @@

 A JSON-RPC 2.0 implementation for Python (Python 3 not supported yet)

-You can get started with:

+## Getting Started

-Python 2.7: `python -m jsonrpc <host name>`

+- Start the Server:

-Python 2.6: `python -m jsonrpc.__main__ <host name>`

+    % python -m jsonrpc.example_server

+    Listening on port 8007...

+

+- Start the Client:

+  - Python 2.7: `python -m jsonrpc <host name>`

+  - Python 2.6: `python -m jsonrpc.__main__ <host name>`

      >>> server.add(1, 2)

      3

+

      >>> server.subtract(3,2)

      1

+     # Exceptions

+     >>> server.add(1, '2')

+     Traceback (most recent call last):

+       File "<stdin>", line 1, in <module>

+       File "jsonrpc/proxy.py", line 182, in __call__

+         raise JSONRPCException(resp['error'])

+     jsonrpc.proxy.JSONRPCException: unsupported operand type(s) for +: 'int' and 'unicode'

+

+

+     >>> server.batch_call( dict(add=( (1,2), {} ), subtract=( (3,2), {} )) )

+     [(3, None), (1, None)] # the pattern is (result, error)

+

+     # batch calls can also be done with an iterable, if you want

+     # to have more than one call to the same method

+     >>> server.batch_call( [('add', ((1, 2), {})), ('subtract', ((3, 2), {}))] )

+     [(3, None), (1, None)]

+

+     # Exceptions in batch calls

+     >>> server.batch_call( dict(add=( (1,2), {} ), subtract=( (3,'2'), {} )) )

+     [(3, None), (None, {u'message': u"unsupported operand type(s) for -: 'int' 

+     and 'unicode'", u'code': 0, u'data': [u"unsupported operand type(s) for -: 

+     'int' and 'unicode'"]})]

+

+

 Made for:

     http://ncmi.bcm.edu

\ No newline at end of file