Metadata-Version: 2.0
Name: py-kim
Version: 1.0.2
Summary: Kim: A JSON Serialization and Marshaling framework
Home-page: https://github.com/mikeywaites/kim
Author: Mikey Waites, Jack Saunders
Author-email: mike@oldstlabs.com
License: MIT License
Download-URL: https://github.com/mikeywaites/kim/releases/tag/1.0.2
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Dist: iso8601 (>=0.1.10)
Requires-Dist: six (>=1.9.0)
Provides-Extra: develop
Requires-Dist: Sphinx (==1.3.1); extra == 'develop'
Requires-Dist: ipdb; extra == 'develop'
Requires-Dist: mock (==1.3.0); extra == 'develop'
Requires-Dist: pytest (==2.8); extra == 'develop'
Requires-Dist: pytest-cov (==1.8.1); extra == 'develop'
Requires-Dist: pytest-spec (==0.2.24); extra == 'develop'
Requires-Dist: sphinx-bootstrap-theme (==0.4.5); extra == 'develop'
Requires-Dist: sqlalchemy (==1.0.4); extra == 'develop'

Kim: A JSON Serialization and Marshaling framework
===================================================

.. image:: https://img.shields.io/pypi/v/py-kim.svg
    :target: https://pypi.python.org/pypi/py-kim

.. image:: https://img.shields.io/pypi/l/py-kim.svg
    :target: https://pypi.python.org/pypi/py-kim

.. image:: https://circleci.com/gh/mikeywaites/kim.svg?style=shield&circle-token=d46954b5e66c2cc885f35c745baaea9a70e961af
    :target: https://pypi.python.org/pypi/py-kim

**Introducing Kim**::

.. code-block:: python

    >>> mapper = UserMapper(data=response.json())
    >>> mapper.marshal()
    User(id='one', name='Bruce Wayne', 'title'='CEO/Super Hero')
    >>> user_two = User.query.get('two')
    >>> mapper = UserMapper(obj=user_two)
    >>> mapper.serialize()
    {u'id': 'two', u'name': 'Martha Wayne', 'title': 'Mother of Batman'}

Kim Features
------------

Kim is a feature packed framework for handling even the most complex
marshaling and serialization requirements.

- Web framework agnostic - Flask, Django, Framework-XXX supported!
- Highly customisable field processing system
- Security focused
- Control included fields with powerful roles system
- Handle mixed data types with polymorphic mappers
- Marshal and Serialize nested objects

Kim officially supports Python 2.7 & 3.3–3.5


Installation
------------

Install Kim using pip::

.. code-block:: bash

    $ pip install py-kim


Documentation
-------------

Learn all of Kim's features with these simple step-by-step instructions or check out the
quickstart guide for a rapid overview to get going quickly.

http://kim.readthedocs.io/en/latest/


