Introduction

Achilles provides a framework to create Django applications using AJAX. Trough the use of some primitives it allows you to build asynchronous without the need of writting javascript to manage client side.

The name of the project comes from ancient Greek mythology, Achilles and Ajax where soldiers who fough together in Trojan War.

Ajax and Achilles amphora painted by Exekias (Greece, 540 BCE)

Features

This is a basic list of features provided by Achilles:

• Integration with JQuery and Django (>=1.4)
• Asynchronous server side action calling (with return values)
• Dynamically loaded (HTML) blocks
• Error management

Installation

1. Run pip install django-achilles
2. Add achilles to INSTALLED_APPS in Django settings:

INSTALLED_APPS = (
    'django.contrib.auth',
    ...
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'myapp',
    'achilles',
)

3. Create achilles endpoint adding achilles.urls to your urls.py file:

from django.conf.urls import patterns, url, include
from myapp.views import SomeView

urlpatterns = patterns('',
    url(r'^$', SomeView.as_view(), name='home'),
    url(r'^achilles$', include('achilles.urls')),
)

You are ready to start using Achilles! Now you can follow with the Tutorial