Skip to main content

A factory for createing Django Rest Framework APIs

Project description

Rest Framework Factory (DRFF)

https://img.shields.io/pypi/v/rest_framework_factory.svg https://img.shields.io/travis/MiddleFork/rest_framework_factory.svg Documentation Status Updates

A factory for creating Django Rest Framework APIs

Features

  • Create a DRF API painlessly, without needing to repeat boilerplate code

Installation

  • pip install rest_framework_factory

Requirements

  • A Django project with at least one app’ from which you wish to build an DRF API included in INSTALLED_APPS, and with at least one model defined in models.py

How it Works

  • The Factory works because a model itself contains all the information required in order to generate an API for it, including a Serializer, a Viewset, URL(s) and other optional (e.g. Forms, Filters) content

  • Template files contain variable placeholders referencing the name and attributes of a model

TODOs

  • WEB UI interface to generate factory apis interactively

  • Configuration files (YML?) to allow fine-grained control of the factory API, e.g. by including/excluding individual models and/or fields, setting allowed methods, etc.

  • Swagger

  • Sphinx

Usage

Basic Usage - Manual Creation

  • It is not necessary to add rest_framework_factory to INSTALLED_APPS

  • One common use case is to build a factory using all the models defined in an app:

    from rest_framework_factory import factory
    drff = factory.Factory()
    drff.build_from_app('my_app')
    content = drff.apis['app']['my_app']
    with open('/tmp/drff_api.py')), 'w') as f:
        f.write(data)
  • Once the factory file is built, it should be placed into the apps’ folder, added to INSTALLED_APPS, and have its urls wired into the project:

    mkdir my_app/drff; touch my_app/drff/__init__.py; cp /tmp/drff_api.py ./my_app/drff/api.py
    • settings.py:

      INSTALLED_APPS += 'my_app.drff'
    • urls.py:

      from my_app.drff.api import urlpatterns as drff_urls
      urlpatterns += drff_urls

Using the Factory UI

  • TODO

    • Scan all the apps, the models therein, and their fields

    • Build forms for each model/app

    • Toggle desired models/fields on-off

    • Select serializer type (ie ModelSerializer vs ReadOnlyModelSerializer

    • Select allowed API endpoint methos (ie GET, POST)

Configuring the factory via YML

  • TODO

    • Initiallize: Scan all apps, the models therein, and their fields; write structure to file

      • Manually edit file, comment out undesired fields and models, change permissions, etc

    • Implement: Read yml file, generate factory

Credits

Django

Package created with Cookiecutter.

History

0.1.0 (2019-01-22)

  • 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

rest_framework_factory-0.2.1.tar.gz (16.4 kB view hashes)

Uploaded Source

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