duc 1.0

Module for validating and transforming data

Duc (transducer) is a data transformation tool for Python.

>>> d = Duc({'name': {'validator': {'type': 'string'}, 'transform': {'name': 'number_name', 'type': 'integer'}})
>>> v.validate({'name': '518'})
True
>>> v.transform()
True
>>> v.result
{'number_name': 518}

About

Sometimes your application receives data from one place and then (after some transformation) sends it to other place. Often you cannot change the format of data you receive because source dictates its own requirements. But with Duc you can validate input (using Cerberus) and make transformations on it (using similar syntax). Particular example is when you get data from a client and save it to database. You want to validate it or leave it as-is (if you trust client) but select specific fields or transform data to other format is required. Slightly like forms in web-application. It was tested under Python 3.4. Compatibility with other versions is not guaranteed.

Documentation

Complete documentation is missed by you can check examples.py for code snippets and usage illustration

Installation

Duc is on PyPI so all you need is:

$ pip install duc

Also you can install it from Github directly (to use latest version)

$ pip install git+https://github.com/bmwant21/duc.git

Testing

Just run (with Pytest):

$ py.test tests

Copyright

Cerberus is an open source project by Most Wanted.