Metadata-Version: 2.1
Name: metabooby
Version: 0.8.0
Summary: Data modeling and validation Python library
Home-page: https://github.com/jaimegildesagredo/booby
Author: Jaime Gil de Sagredo Luna
Author-email: jaimegildesagredo@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Software Development :: Libraries :: Python Modules

Booby: data modeling and validation
===================================

.. image:: https://img.shields.io/pypi/v/metabooby.svg
    :target: https://pypi.python.org/pypi/metabooby
    :alt: Latest version

.. image:: https://img.shields.io/badge/Licence-Apache2-brightgreen.svg
    :target: https://www.tldrlegal.com/l/apache2
    :alt: License

.. image:: https://img.shields.io/circleci/build/github/metabolize-forks/booby/master
    :target: https://app.circleci.com/pipelines/github/metabolize-forks/booby
    :alt: Build status

Booby is a standalone data `modeling` and `validation` library written in Python. Booby is under active development (visit `this blog post <http://jaimegildesagredo.github.io/2014/01/04/booby-05-introducing-inspection-api.html>`_ for more info and the roadmap) and licensed under the `Apache2 license <http://www.apache.org/licenses/LICENSE-2.0.html>`_, so feel free to `contribute <https://github.com/jaimegildesagredo/booby/pulls>`_ and `report errors and suggestions <https://github.com/jaimegildesagredo/booby/issues>`_.

This is an active fork.

Usage
-----

See the sample code below to get an idea of the main features.

.. code-block:: python

    from booby import Model, fields


    class Token(Model):
        key = fields.String()
        secret = fields.String()


    class Address(Model):
        line_1 = fields.String()
        line_2 = fields.String()


    class User(Model):
        login = fields.String(required=True)
        name = fields.String()
        email = fields.Email()
        token = fields.Embedded(Token, required=True)
        addresses = fields.Collection(Address)

    jack = User(
        login='jack',
        name='Jack',
        email='jack@example.com',
        token={
            'key': 'vs7dfxxx',
            'secret': 'ds5ds4xxx'
        },
        addresses=[
            {'line_1': 'Main Street'},
            {'line_1': 'Main St'}
        ]
    )

    if jack.is_valid:
        print jack.to_json(indent=2)
    else:
        print json.dumps(dict(jack.validation_errors))

.. code-block:: json

    {
      "email": "jack@example.com",
      "login": "jack",
      "token": {
        "secret": "ds5ds4xxx",
        "key": "vs7dfxxx"
      },
      "name": "Jack",
      "addresses": [
        {
          "line_1": "Main St",
          "line_2": null
        },
        {
          "line_1": "Main Street",
          "line_2": null
        }
      ]
    }

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

You can install the last stable release of Booby from PyPI using pip or easy_install.

.. code-block:: bash

    $ pip install booby

Also you can install the latest sources from Github.

.. code-block:: bash

    $ pip install -e git+git://github.com/jaimegildesagredo/booby.git#egg=booby

Tests
-----

To run the Booby test suite you should install the development requirements and then run nosetests.

.. code-block:: bash

    $ pip install -r test-requirements.txt
    $ nosetests tests/unit
    $ nosetests tests/integration

Changes
-------

See `Changes <https://booby.readthedocs.org/en/latest/changes.html>`_.


