mohawk-data-platform 0.9.3

Features

• Define structured models, with custom fields and validation.

• Create, edit and update instances defined models using the Django admin interface.

• Group models into applications for bulk access.

• Access models, instances and applications via a simple JSON API.

• Cross-origin API requests via CORS and JSONP.

Installation

1. Checkout the latest mohawk-data-platform release and copy or symlink the data directory into your PYTHONPATH. If using pip, run pip install mohawk-data-platform.

2. Add 'data' to your INSTALLED_APPS setting.

3. Add url(r"^", include("data.urls", namespace="data")), to you urls.py file.

4. Install and active the Django admin site, if not already present.

Admin usage

The bulk of the functionality for mohawk-data-platform is found within the admin UI. The basic workflow is:

1. Create a Model, defining at least one Field.

2. Create an Instance of that model.

3. Optionally, create an Application.

4. Edit the model, and add it to the application you created.

Any data you add to the system will be pubically-available via the API endpoints.

Model field reference

Fields added to a model take a number of optional config parameters, suppled as JSON documents. The available fields, and their configuration options, are listed below.

Fields which take choices expect them to be supplied as a list of [value, label] options:

{
    "choices": [
        ["#ff0000", "Red"],
        ["#0000ff", "Green"],
        ["#00ff00", "Blue"]
    ]
}

{
    "required": true,
    "choices": null
}

{
    "required": true,
    "choices": null
}

{
    "required": true
}

{
    "required": true
}

{
    "required": true
}

{
    "required": true
}

{}

{
    "required": true
}

{
    "required": true
}

{
    "required": true,
    "model_id": "<model_id>"  // The type of instance being referenced.
}

{
    "required": true,
    "model_id": "<model_id>"  // The type of instance being referenced.
}

API endpoints

{
    "status": "OK",
    "message": "Instances of Your Model were successfully loaded.",
    "instances": [
        {
            "_date_created": "<timestamp>",
            "_date_modified": "<timestamp>",
            "_id": "<instance_id>",
            "_model": "<model_id>",
            "<field_name>": "<field_value>",
            ...
        },
        ...
    ]
}

{
    "status": "OK",
    "message": "Instances of <model_name> were successfully loaded.",
    "instance": {
        "_date_created": "<timestamp>",
        "_date_modified": "<timestamp>",
        "_id": "<instance_id>",
        "_model": "<model_id>",
        "<field_name>": "<field_value>",
        ...
    }
}

{
    "status": "OK",
    "message": "Instances within application <application_name> were successfully loaded.",
    "instances": [
        {
            "_date_created": "<timestamp>",
            "_date_modified": "<timestamp>",
            "_id": "<instance_id>",
            "_model": "<model_id>",
            "<field_name>": "<field_value>",
            ...
        },
        ...
    ]
}

More information

The mohawk-data-platform project was developed at Mohawk, and is released as Open Source under the MIT license.

You can get the code from the mohawk-data-platform project site.

Contributors

The following people were involved in the development of this project.

• Dave Hall - Blog | GitHub | Twitter | Google Profile