encode/django-rest-framework
1
1
Fork 0
mirror of https://github.com/encode/django-rest-framework.git synced 2024-11-24 02:24:03 +03:00
Code Issues Packages Projects Releases Wiki Activity
Web APIs for Django. 🎸
704 Commits 18 Branches 132 Tags 105 MiB
Python 83.5%
JavaScript 9.6%
HTML 4.7%
CSS 2.2%
0e3a2e6fdd
Go to file
Ralph Broenink 0e3a2e6fdd Modify mixins.py to make sure that the 415 (Unsupported Media Type) returns its error in the 'detail' key instead of in the 'error' key (for consistency with all other errors).
2012-07-06 15:43:02 +03:00
djangorestframework Modify mixins.py to make sure that the 415 (Unsupported Media Type) returns its error in the 'detail' key instead of in the 'error' key (for consistency with all other errors). 2012-07-06 15:43:02 +03:00
docs Fix typo. 2012-04-12 01:06:35 +03:00
examples Fix broken pygments test. 2012-03-27 23:40:33 +02:00
.gitignore 0.2.4 release. 2011-12-12 12:27:11 +00:00
AUTHORS Added Adam Ness. Thanks! 2012-07-03 12:44:13 +02:00
CHANGELOG.rst Use seuptools to be explicit about optional version-dependency of markdown. 2012-04-11 23:51:00 +02:00
LICENSE Fold license text to 80 chars 2011-12-16 10:06:12 +00:00
MANIFEST.in Fix up packaging and staticfiles changes. Fixes #155. Fixes #153. Fixes #150. 2012-02-07 08:58:15 +00:00
README.rst 1.4 Ain't alpha. 2012-05-11 09:46:00 +02:00
requirements.txt Preserve existing query params in PaginatorMixin 2012-01-05 14:07:31 +00:00
setup.py Use seuptools to be explicit about optional version-dependency of markdown. 2012-04-11 23:51:00 +02:00
tox.ini django-staticfiles for Django 1.2 compatability 2012-01-31 09:05:52 +00:00

README.rst 

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

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

**Author:** Tom Christie.  `Follow me on Twitter <https://twitter.com/_tomchristie>`_.

Overview
========

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/djangorestframework1/>`_ which runs our test suite. 

Requirements:

* Python (2.5, 2.6, 2.7 supported)
* Django (1.2, 1.3, 1.4 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