zson 1.0.13

A JSON serializer for Kombu (and therefore also Celery) that supports encoding objects by defining to_json and from_json methods.

Usage
=====

If you want an object to be JSON decodable, you need to define a to_json instance method that returns a dict of json-encodable objects. If you want your object to be encodable, define a from_json class method that takes back that dictionary. You must also use a newstyle class.

An example is below if it would help::

class MyObject(object):

def __init__(self, name):
self._name = name

def to_json(self):
return {'name':self._name}

@classmethod
def from_json(self, obj):
return cls(obj["name"])

Celery Usage
========

ZSON was originally written to allow objects to be passed in Celery. If you want to use zson as your serializer in Celery, you can set this by creating a configuration file and adding::

CELERY_TASK_SERIALIZER = 'zson'
CELERY_RESULT_SERIALIZER = 'zson'
CELERY_ACCEPT_CONTENT = ["zson"]

and then loading this configuration file when you configure your Celery app::

c = celery.Celery('zsearch', backend='amqp', broker='amqp://')
c.config_from_object('celeryconfig')