Install & Setup

Install

Serrano's source code is hosted on GitHub. Releases follow the SemVer spec. All tagged versions are uploaded to PyPi, but tagged versions can be downloaded directly.

pip install serrano --use-mirrors

Setup

Include serrano.urls in your ROOT_URLCONF module:

urlpatterns = patterns('',
    url(r'^api/', include('serrano.urls')),
    ...
)

In this example, /api/ is the root endpoint for Serrano. Hitting this endpoint will expose the available URLs for the API.

Add django.contrib.sessions to your project's INSTALLED_APPS:

INSTALLED_APPS = (
    'django.contrib.sessions',
    ...
)

Add the serrano.middleware.SessionMiddleware to the MIDDLEWARE_CLASSES setting after Django's session and authentication middleware (if installed):

MIDDLEWARE_CLASSES = (
    ...
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'serrano.middleware.SessionMiddleware',
    ...
)

Next: Settings