Metadata-Version: 1.1
Name: adrest
Version: 3.0.0
Summary: Adrest - Another Django REST. Simple application for quick build REST API.

Home-page:  http://github.com/klen/adrest
Author: Kirill Klenov
Author-email: horneds@gmail.com
License: GNU LGPL
Description: |logo| ADREST
        #############
        
        Adrest is Another Django REST. Django application for simple make HTTP REST API.
        
        Documentation in `construction <http://adrest.readthedocs.org>`_.
        
        .. _badges:
        
        .. image:: https://secure.travis-ci.org/klen/adrest.png?branch=develop
            :target: http://travis-ci.org/klen/adrest
            :alt: Build Status
        
        .. image:: https://coveralls.io/repos/klen/adrest/badge.png?branch=develop
            :target: https://coveralls.io/r/klen/adrest
            :alt: Coverals
        
        .. image:: https://pypip.in/v/adrest/badge.png
            :target: https://crate.io/packages/adrest
            :alt: Version
        
        .. image:: https://pypip.in/d/adrest/badge.png
            :target: https://crate.io/packages/adrest
            :alt: Downloads
        
        .. image:: https://dl.dropboxusercontent.com/u/487440/reformal/donate.png
            :target: https://www.gittip.com/klen/
            :alt: Donate
        
        .. _requirements:
            
        Requirements
        =============
        
        - Python (2.6, 2.7)
        - Django (1.3, 1.4, 1.5, 1.6)
        
        .. _installation:
        
        Installation
        =============
        
        **ADRest** should be installed using pip: ::
        
            pip install adrest
        
        .. _quickstart:
        
        Quick start
        ===========
        ::
        
            from adrest.api import Api
            from adrest.views import ResourceView
        
            api = Api('1.0.0')
        
            @api.register
            class BookResource(ResourceView):
                class Meta:
                    allowed_methods = 'get', 'post'
                    model = 'app.book'
        
            urlpatterns = api.urls
        
        
        .. _setup:
        
        Setup
        =====
        
        Adrest settings (default values): ::
        
            # Enable logs
            ADREST_ACCESS_LOG = False
        
            # Auto create adrest access key for User
            ADREST_AUTO_CREATE_ACCESSKEY = False
        
            # Max resources per page in list views
            ADREST_LIMIT_PER_PAGE = 50
        
            # Display django standart technical 500 page
            ADREST_DEBUG = False
        
            # Limit request number per second from same identifier, null is not limited
            ADREST_THROTTLE_AT = 120
            ADREST_THROTTLE_TIMEFRAME = 60
        
            # We do not restrict access for OPTIONS request
            ADREST_AUTHENTICATE_OPTIONS_REQUEST = False
        
        .. note::
            Add 'adrest' to INSTALLED_APPS
        
        
        Use adrest
        ==========
        
        See test/examples in ADREST sources.
        
        
        .. _bagtracker:
        
        Bug tracker
        ===========
        
        If you have any suggestions, bug reports or
        annoyances please report them to the issue tracker
        at https://github.com/klen/adrest/issues
        
        
        .. _contributing:
        
        Contributing
        ============
        
        Development of adrest happens at github: https://github.com/klen/adrest
        
        
        .. _contributors:
        
        Contributors
        =============
        
        * klen_ (Kirill Klenov)
        
        
        .. _license:
        
        License
        =======
        
        Licensed under a `GNU lesser general public license`_.
        
        
        .. _links:
        
        .. _GNU lesser general public license: http://www.gnu.org/copyleft/lesser.html
        .. _klen: http://klen.github.com/
        .. _REST: http://en.wikipedia.org/wiki/Representational_state_transfer
        .. _RPC: http://en.wikipedia.org/wiki/JSON-RPC
        .. |logo| image:: https://raw.github.com/klen/adrest/develop/docs/_static/logo.png
                          :width: 100
        
Keywords: rest,rpc,api,django
Platform: Any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Utilities
