Metadata-Version: 1.1
Name: lambdaJSON
Version: 0.2.14
Summary: Serialize python standard types (function, tuple, memoryview, set, frozenset, exceptions, complex, range, bytes,
                   bytearray, dict with number keys, byte keys or tuple keys, and etc) with json. 
                   No dependencies, just needs json lib (or other json libraries). --Changes: 
                   Added support for Builtin Exceptions.
Home-page: https://github.com/pooya-eghbali/lambdaJSON
Author: Pooya Eghbali
Author-email: persian.writer@gmail.com
License: LGPLv3
Description: ===========
        lambdaJSON
        ===========
        Serialize python standard types (function, tuple, complex, memoryview, exceptions, set, frozenset, range, bytearray, bytes, dict with number keys, byte keys or tuple keys, and etc) with json.
        lambdaJSON lets you serialize python standard library objects with json.
        Typical usage::
        
            #!/usr/bin/env python
            
            >>> import lambdaJSON
            >>> myComplexData = {True: (3-5j), (3+5j): b'json', (1, 2, 3): {b'lambda': [1, 2, 3, (3, 4, 5)]}}
            >>> mySerializedData = lambdaJSON.serialize(myComplexData)
            >>> myComplexData  == lambdaJSON.deserialize(mySerializedData)
            True
            
            >>> 
        
        To pass args and kwargs to the encoder/decoder simply pass them to the serialize/deserialize function, example for json::
        
            >>> mySerializedData = lambdaJSON.serialize(myComplexData, sort_keys = True)
            >>> myComplexData  == lambdaJSON.deserialize(mySerializedData, object_hook = my_hook)
        
        It can be done for ujson too. You can also serialize python functions::
        
            >>> import lambdaJSON
            >>> def f(): print('lambdaJSON Rocks!')
            
            >>> mySerializedFunction = lambdaJSON.serialize(f)
            >>> myNewFunction  = lambdaJSON.deserialize(mySerializedFunction)
            >>> myNewFunction()
            'lambdaJSON Rocks!'
            >>>
        
        Changed int 0.2.4, for function deserialization you must pass a function which returns the list of globals for the function::
        
            >>> import lambdaJSON
            >>> y = 10
            >>> def f(x): return x*y
            
            >>> mySerializedFunction = lambdaJSON.serialize(f)
            >>> myNewFunction  = lambdaJSON.deserialize(mySerializedFunction, globs = (lambda: globals()))
            >>> myNewFunction(5)
            50
            >>> y = 3
            >>> myNewFunction(5)
            15
            >>>
        
        If no globs passed to function, the globs will be just the __builtins__ module. Note that passing globals will pass the lambdaJSONs globals and it will not work, if you want to include all the globals from where the deserialization function is called, just use globs = (lambda: globals()), else implement your own function. You can do some nice hacks too::
        
            >>> z = 10
            >>> def g():
                    global z
                    z += 1
                    return {'z':z}
            
            >>> def f(x,y): return x*y+z
            
            >>> mySerializedFunction = lambdaJSON.serialize(f)
            >>> myNewFunction  = lambdaJSON.deserialize(mySerializedFunction, globs = g)
            >>> myNewFunction(2,3)
            17
            >>> myNewFunction(2,3)
            18
            >>>
        
        isn't it cool?? 
        
        You can serialize Builtin Exceptions like this:
        
            >>> a = serialize(OSError('FILE NOT FOUND'))
            >>> b = deserialize(a)
            >>> raise b
            Traceback (most recent call last):
              File "<pyshell#3>", line 1, in <module>
                raise b
            OSError: FILE NOT FOUND
            >>>
        
        To check version, simply use lambdaJSON.__version__, or if you want to know which json lib is in use, try lambdaJSON.__json__
        
        After the support for all types are added, I'm planning to release a query friendly version of this library, that will be in version 0.3.0.
        
        The json lib
        ============
        
        LambdaJSON first tries to import ujson, if it fails it will import simplejson, and if that fails too, the json lib will be imported. you can check which json lib is in use with lambdaJSON.__json__ variable.
        
        Currently Supported Types
        =========================
        
        This types are covered in this version:
        
        1. Functions
        2. Bytes and Bytearrays
        3. Builtin Exceptions
        4. Tuples
        5. Complex
        6. Range
        7. Set and Frozenset
        8. Memoryview
        9. Dicts (With Number, Tuple, String, Bool and Byte keys)
        10. other json supported types
        
        Changes from previous
        =====================
        
        Added support for Builtin Exceptions.
        
        Project Info
        ============
        
        Github project page: https://github.com/pooya-eghbali/lambdaJSON
        Mail me at: persian.writer [at] Gmail.com
        
        Contact me if there were any issues or you had a feature request. you can also post issues on github.
Keywords: json,serialization,serialize,pickle,marshal
Platform: Any
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
