django-tastypie-swagger

An adapter to use swagger-ui with django-tastypie.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

132

Maintenance

Last Commit

6yrs ago

Contributors

25

Package

Dependencies

0

License

BSD

Categories

Readme

Concentric Sky

Django Tastypie Swagger

django-tastypie-swagger is a small adapter library to construct Swagger documentation from Tastypie resources.

This package provides two things:

  1. An embedded instance of Swagger UI to point a URL to.
  2. Automatic Resource Listing and API Declaration generation that is consumed by #1

Table of Contents

Version History

  • v0.1.3 Various bug fixes and documentation updates
  • v0.1.2 Fixes for Django 1.5 compatibility
  • v0.1.1 Public codebase was released

Documentation

Detailed documentation is available on Read The Docs.

Installation

Install package::

pip install django-tastypie-swagger

Add to INSTALLED_APPS::

INSTALLED_APPS = [
    ...

    'tastypie_swagger',

    ...
]

Getting Started

Enable documentation for an api endpoint by adding a URL to your urlpatterns.

eg::

urlpatterns = patterns('',
    ...

    url(r'api/myapi/doc/',
      include('tastypie_swagger.urls', namespace='myapi_tastypie_swagger'),
      kwargs={"tastypie_api_module":"myapp.registration.my_api", "namespace":"myapi_tastypie_swagger"}
    ),

    ...
)

To declare more than one endpoint, repeat the above URL definition and change the namespace.

Swagger documentation will be served up at the URL(s) you configured.

Contributors

Contributors to this project are listed in the CONTRIBUTORS.md file. If you contribute to this project, please add your name to the file.

License

This project is licensed under the Apache License, Version 2.0. Details can be found in the LICENSE.md file. License for third-party code is available in 3RDPARTYLICENSES.md.

About Concentric Sky

For nearly a decade, Concentric Sky has been building technology solutions that impact people everywhere. We work in the mobile, enterprise and web application spaces. Our team, based in Eugene Oregon, loves to solve complex problems. Concentric Sky believes in contributing back to our community and one of the ways we do that is by open sourcing our code on GitHub. Contact Concentric Sky at hello@concentricsky.com.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100