Web APIs for Django. 🎸
Go to file
2011-12-30 16:30:55 +00:00
djangorestframework Fixes #102 2011-12-30 16:30:55 +00:00
docs Merge remote-tracking branch 'origin/master' 2011-12-30 16:17:12 +01:00
examples Fixup for epio 2011-12-30 15:51:06 +00:00
.gitignore 0.2.4 release. 2011-12-12 12:27:11 +00:00
AUTHORS Added @yandy. Thanks! 2011-12-30 15:34:39 +00:00
LICENSE Fold license text to 80 chars 2011-12-16 10:06:12 +00:00
MANIFEST.in proper manifest. setup groks version from __init__ 2011-06-02 12:17:21 +01:00
README.rst Keep it simple. 2011-12-30 13:06:57 +00:00
RELEASES Version 0.3.0 2011-12-29 13:57:41 +00:00
requirements.txt Use coverage>=3.4, since that's what we've got in tox.ini at the moment. Refs #96 2011-12-15 16:22:10 +00:00
setup.py pull in -dev as 0.2.0 2011-06-02 12:58:10 +01:00
tox.ini Added django 1.4 aplha 1. 2011-12-30 13:42:01 +01:00

Django REST framework
=====================

Django REST framework makes it easy to build well-connected, self-describing RESTful Web APIs.

Features:

* Creates awesome self-describing *web browse-able* APIs.
* Clean, modular design, using Django's class based views.
* Easily extended for custom content types, serialization formats and authentication policies.
* Stable, well tested code-base.
* Active developer community.

Full documentation for the project is available at http://django-rest-framework.org

Issue tracking is on `GitHub <https://github.com/tomchristie/django-rest-framework/issues>`_.
General questions should be taken to the `discussion group <http://groups.google.com/group/django-rest-framework>`_.

We also have a `Jenkins service <http://jenkins.tibold.nl/job/djangorestframework/>`_ which runs our test suite. 

Requirements:

* Python (2.5, 2.6, 2.7 supported)
* Django (1.2, 1.3 supported)


Installation Notes
==================

To clone the project from GitHub using git::

    git clone git@github.com:tomchristie/django-rest-framework.git


To install django-rest-framework in a virtualenv environment::

    cd django-rest-framework
    virtualenv --no-site-packages --distribute env
    source env/bin/activate
    pip install -r requirements.txt # django, coverage


To run the tests::

    export PYTHONPATH=.    # Ensure djangorestframework is on the PYTHONPATH
    python djangorestframework/runtests/runtests.py


To run the test coverage report::

    export PYTHONPATH=.    # Ensure djangorestframework is on the PYTHONPATH
    python djangorestframework/runtests/runcoverage.py


To run the examples::

    pip install -r examples/requirements.txt # pygments, httplib2, markdown
    cd examples
    export PYTHONPATH=..
    python manage.py syncdb
    python manage.py runserver


To build the documentation::

    pip install -r docs/requirements.txt   # sphinx
    sphinx-build -c docs -b html -d docs/build docs html


To run the tests against the full set of supported configurations::

    deactivate  # Ensure we are not currently running in a virtualenv
    tox


To create the sdist packages::

    python setup.py sdist --formats=gztar,zip