Skip to main content

Kylie provides mappings between JSON data structures and Python objects.

Project description

Kylie

https://img.shields.io/travis/judy2k/kylie.svg https://coveralls.io/repos/judy2k/kylie/badge.svg?branch=master Code Health https://img.shields.io/pypi/v/kylie.svg

Kylie provides mappings between JSON data structures and Python objects. It provides a reasonable amount of power with only a tiny bit of magic, and it has 100% code coverage.

Features

Example

class SpanishInquisitionModel(Model):
    inquisition_id = Attribute('id')
    expected = Attribute(python_type=bool, serialized_type=int)

Then:

>>> surprise = SpanishInquisitionModel(inquisition_id=1234, expected=False)
>>> surprise.inquisition_id
1234
>>> surprise.serialize()
{'id': 1234, expected=0}

Note that the attribute inquisition_id becomes the dict key "id", and expected is mapped to 0 instead of False.

We can now take this dict, dumps it to JSON, and somewhere else call the following on the json_data (which is a dict returned from loads):

>>> my_surprise = SpanishInquisitionModel.deserialize(json_data)
>>> my_surprise.inquisition_id
1234
>>> my_surprise.expected
False

Kylie supports nested models, so you can embed other Model instances inside the data, and Kylie will manage serialization and deserialization of them for you.

Non-Features

So what doesn’t Kylie do yet? Well, there are a few things, because it’s very new:

  • Doesn’t have any mechanism for validation. I plan to add this once I decide the best way to do it. Ideas welcome!

  • No post-deserialize option, unless you do it yourself. This would allow wiring up of objects that are referred to by id and provided elsewhere in the serialized data-structure, for example.

So, still some important things to do, but I think Kylie is already useful.

Why is it called Kylie?

Back in the late 80’s (I’m old!) Kylie and Jason were today’s Kim and Kanye. This Kylie works well with JSON. Geddit?

http://upload.wikimedia.org/wikipedia/en/1/1a/KylieEspeciallyForYouCover.png

History

0.3.0 (2015-06-05)

  • MappedModelChoice & BaseModelChoice for determining Model to deserialize at runtime.

  • Change to internal Attribute interface (will lead to minor version bump)

    _apply_model has been replaced with a direct set of attr_name.

  • Minor code quality improvements.

  • Documentation improvements.

0.2.0 (2015-04-22)

  • Added list support to Relation with sequence=True parameter.

0.1.1 (2015-04-12)

  • Removed print statement inside class constructor.

0.1.0 (2015-04-12)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kylie-0.3.1.tar.gz (19.0 kB view details)

Uploaded Source

Built Distribution

kylie-0.3.1-py2.py3-none-any.whl (9.1 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file kylie-0.3.1.tar.gz.

File metadata

  • Download URL: kylie-0.3.1.tar.gz
  • Upload date:
  • Size: 19.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for kylie-0.3.1.tar.gz
Algorithm Hash digest
SHA256 c5df453509ca82c6b4fc450248c38cac928a11be1fdce901bbebae40425a4789
MD5 154110611c528366679fc5b505582fb8
BLAKE2b-256 a7fb2c4ef9d741f6ffcfebd2c415888a32c9b75b386bade37eb3dc89b8f2ead3

See more details on using hashes here.

File details

Details for the file kylie-0.3.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for kylie-0.3.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 c34a21545145bc0ec7e9a311ac3e5cc2b34eb39ff72402b1c736f77bf2f9a2eb
MD5 e3049a7850922e8ca10549f4378aa87b
BLAKE2b-256 2a3f5cd9a83d0fe9dbc88ad2f38bb4fcadcfa54fbd6c6af6b3290f74120c6a80

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page