Skip to main content

Data modeling and validation Python library

Project description

Latest version Docs License Number of PyPI downloads Build status

Booby is a standalone data modeling and validation library written in Python. Booby is under active development (visit this blog post for more info and the roadmap) and licensed under the Apache2 license, so feel free to contribute and report errors and suggestions.


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

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(
        'key': 'vs7dfxxx',
        'secret': 'ds5ds4xxx'
        {'line_1': 'Main Street'},
        {'line_1': 'Main St'}

if jack.is_valid:
    print jack.to_json(indent=2)
    print json.dumps(dict(jack.validation_errors))
  "email": "",
  "login": "jack",
  "token": {
    "secret": "ds5ds4xxx",
    "key": "vs7dfxxx"
  "name": "Jack",
  "addresses": [
      "line_1": "Main St",
      "line_2": null
      "line_1": "Main Street",
      "line_2": null


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

$ pip install booby

Also you can install the latest sources from Github.

$ pip install -e git+git://


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

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


See Changes.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
booby-0.7.0.tar.gz (10.1 kB) Copy SHA256 hash SHA256 Source None Dec 3, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page