Skip to main content

A re-useable Django helper app for integrating rest-scaffold.js.

Project description

Django REST Scaffold

TravisCI PyPI Coveralls Code Style

Source: https://github.com/gregschmit/django-rest-scaffold

REST Scaffold is a Django app that provides a template tag helper for using the rest-scaffold.js library.

The Problem: AJAX is nice because if you have an API, then you don’t need separate pages/views for listing, creating, and updating model instances. But writing custom AJAX tables on the frontend can be time-consuming.

The Solution: This app provides a template tag that uses rest-scaffold.js to quickly render “scaffolds”, which are tables that have controls which interact with your API.

How to Use

$ pip install django-rest-scaffold

Include rest_scaffold in your INSTALLED_APPS.

Build your API or create one using AutoREST.

Then, insert a scaffold using the rest_scaffold template tag. At the top you’ll need to load the template tag:

{% load rest_scaffold %}

And then wherever you want in the HTML page, inject the scaffold:

{% rest_scaffold 'user' api_root='api' %}

In the above example, you would see a scaffold for the User model.

Contributing

Open a pull request fixing a bug or implementing a feature if you want to contribute. You must only contribute code that you have authored or otherwise hold the copyright to, and you must make any contributions to this project available under the MIT license.

To collaborators: don’t push using the --force option.

Dev Quickstart

REST Scaffold comes with a settings.py file, technically making it a Django project as well as a Django app. First clone, the repository into a location of your choosing:

$ git clone https://github.com/gregschmit/django-rest-scaffold

Then you can go into the django-rest-scaffold directory, install the test environment requirements, and then migrate and run the local development server:

$ cd django-rest-scaffold
$ pip install -r requirements-test.txt
$ python manage.py migrate
$ python manage.py createsuperuser
...
$ python manage.py runserver

Then you can see the api at http://127.0.0.1:8000/api/, and you can see the example scaffold page at http://127.0.0.1:8000/example/.

Project details


Download files

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

Files for django-rest-scaffold, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size django_rest_scaffold-0.1.0-py3-none-any.whl (9.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size django-rest-scaffold-0.1.0.tar.gz (7.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page