aboutsummaryrefslogtreecommitdiffstats
path: root/README.rst
diff options
context:
space:
mode:
authorTom Christie2012-10-30 14:32:31 +0000
committerTom Christie2012-10-30 14:32:31 +0000
commit9b30dab4f772f67a626e176dc4fae0a3ef9c2c81 (patch)
treeca138abf4792f58ffa28684f784f201ee1eef6d7 /README.rst
parent7e5b1501b5cede61a9391fb1a751d2ebcdb37031 (diff)
parent4e7805cb24d73e7f706318b5e5a27e3f9ba39d14 (diff)
downloaddjango-rest-framework-2.0.0.tar.bz2
Merge branch 'restframework2' into rest-framework-2-merge2.0.0
Conflicts: .gitignore .travis.yml AUTHORS README.rst djangorestframework/mixins.py djangorestframework/renderers.py djangorestframework/resources.py djangorestframework/serializer.py djangorestframework/templates/djangorestframework/base.html djangorestframework/templates/djangorestframework/login.html djangorestframework/templatetags/add_query_param.py djangorestframework/tests/accept.py djangorestframework/tests/authentication.py djangorestframework/tests/content.py djangorestframework/tests/reverse.py djangorestframework/tests/serializer.py djangorestframework/views.py docs/examples.rst docs/examples/blogpost.rst docs/examples/modelviews.rst docs/examples/objectstore.rst docs/examples/permissions.rst docs/examples/pygments.rst docs/examples/views.rst docs/howto/alternativeframeworks.rst docs/howto/mixin.rst docs/howto/reverse.rst docs/howto/usingurllib2.rst docs/index.rst docs/topics/release-notes.md examples/sandbox/views.py rest_framework/__init__.py rest_framework/compat.py rest_framework/utils/breadcrumbs.py setup.py
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst90
1 files changed, 0 insertions, 90 deletions
diff --git a/README.rst b/README.rst
deleted file mode 100644
index 2c8dabd4..00000000
--- a/README.rst
+++ /dev/null
@@ -1,90 +0,0 @@
-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>`_.
-
-:build status: |build-image|
-
-.. |build-image| image:: https://secure.travis-ci.org/tomchristie/django-rest-framework.png?branch=master
- :target: https://secure.travis-ci.org/tomchristie/django-rest-framework
-
-**Important!** REST framework 2.0 is due to be released to PyPI by the end of October.
-If you are considering building a new API using REST framework you should start working
-with the `restframework2` branch, and refering to the upcoming `REST framework 2 docs <http://tomchristie.github.com/django-rest-framework>`_.
-
-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>`_.
-
-Requirements:
-
-* Python 2.6+
-* Django 1.3+
-
-
-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