Fixed #24359 -- Cleaned up docs/ref/exceptions.html

Django Exceptions

=================

Django raises some Django specific exceptions as well as many standard

Python exceptions.

Django raises some of its own exceptions as well as standard Python exceptions.

Django Core Exceptions

======================

.. module:: django.core.exceptions

    :synopsis: Django core exceptions

Django core exception classes are defined in :mod:`django.core.exceptions`.

Django core exception classes are defined in ``django.core.exceptions``.

``ObjectDoesNotExist`` and ``DoesNotExist``

-------------------------------------------

ObjectDoesNotExist and DoesNotExist

-----------------------------------

.. exception:: DoesNotExist

    The ``DoesNotExist`` exception is raised when an object is not found for

    See :meth:`~django.db.models.query.QuerySet.get()` for further information

    on :exc:`ObjectDoesNotExist` and :exc:`DoesNotExist`.

FieldDoesNotExist

-----------------

``FieldDoesNotExist``

---------------------

.. exception:: FieldDoesNotExist

    The ``FieldDoesNotExist`` exception is raised by a model's

        This exception was previously defined only in

        ``django.db.models.fields`` and wasn't part of the public API.

MultipleObjectsReturned

-----------------------

``MultipleObjectsReturned``

---------------------------

.. exception:: MultipleObjectsReturned

    The :exc:`MultipleObjectsReturned` exception is raised by a query if only

    See :meth:`~django.db.models.query.QuerySet.get()` for further information.

SuspiciousOperation

-------------------

``SuspiciousOperation``

-----------------------

.. exception:: SuspiciousOperation

    The :exc:`SuspiciousOperation` exception is raised when a user has

    performed an operation that should be considered suspicious from a security

    perspective, such as tampering with a session cookie. Subclasses of

    SuspiciousOperation include:

    * DisallowedHost

    * DisallowedModelAdminLookup

    * DisallowedModelAdminToField

    * DisallowedRedirect

    * InvalidSessionKey

    * SuspiciousFileOperation

    * SuspiciousMultipartForm

    * SuspiciousSession

    * WizardViewCookieModified

    ``SuspiciousOperation`` include:

    * ``DisallowedHost``

    * ``DisallowedModelAdminLookup``

    * ``DisallowedModelAdminToField``

    * ``DisallowedRedirect``

    * ``InvalidSessionKey``

    * ``SuspiciousFileOperation``

    * ``SuspiciousMultipartForm``

    * ``SuspiciousSession``

    If a ``SuspiciousOperation`` exception reaches the WSGI handler level it is

    logged at the ``Error`` level and results in

    a :class:`~django.http.HttpResponseBadRequest`. See the :doc:`logging

    documentation </topics/logging/>` for more information.

PermissionDenied

----------------

``PermissionDenied``

--------------------

.. exception:: PermissionDenied

    The :exc:`PermissionDenied` exception is raised when a user does not have

    permission to perform the action requested.

ViewDoesNotExist

----------------

``ViewDoesNotExist``

--------------------

.. exception:: ViewDoesNotExist

    The :exc:`ViewDoesNotExist` exception is raised by

    :mod:`django.core.urlresolvers` when a requested view does not exist.

MiddlewareNotUsed

-----------------

``MiddlewareNotUsed``

---------------------

.. exception:: MiddlewareNotUsed

    The :exc:`MiddlewareNotUsed` exception is raised when a middleware is not

    used in the server configuration.

ImproperlyConfigured

--------------------

``ImproperlyConfigured``

------------------------

.. exception:: ImproperlyConfigured

    The :exc:`ImproperlyConfigured` exception is raised when Django is

    somehow improperly configured -- for example, if a value in ``settings.py``

    is incorrect or unparseable.

FieldError

----------

``FieldError``

--------------

.. exception:: FieldError

    The :exc:`FieldError` exception is raised when there is a problem with a

    - A field name is invalid

    - A query contains invalid order_by arguments

ValidationError

---------------

``ValidationError``

-------------------

.. exception:: ValidationError

    The :exc:`ValidationError` exception is raised when data fails form or

    :ref:`Model Field Validation <validating-objects>` and the

    :doc:`Validator Reference </ref/validators>`.

NON_FIELD_ERRORS

~~~~~~~~~~~~~~~~

``NON_FIELD_ERRORS``

~~~~~~~~~~~~~~~~~~~~

.. data:: NON_FIELD_ERRORS

``ValidationError``\s that don't belong to a particular field in a form

URL Resolver exceptions

=======================

URL Resolver exceptions are defined in :mod:`django.core.urlresolvers`.

URL Resolver exceptions are defined in ``django.core.urlresolvers``.

``Resolver404``

---------------

Resolver404

--------------

.. exception:: Resolver404

    The :exc:`Resolver404` exception is raised by

    :func:`django.core.urlresolvers.resolve()` if the path passed to

    ``resolve()`` doesn't map to a view. It's a subclass of

    :class:`django.http.Http404`

    :class:`django.http.Http404`.

``NoReverseMatch``

------------------

NoReverseMatch

--------------

.. exception:: NoReverseMatch

    The :exc:`NoReverseMatch` exception is raised by

Database Exceptions

===================

Database exceptions are provided in :mod:`django.db`.

Database exceptions may be imported from ``django.db``.

Django wraps the standard database exceptions so that your Django code has a

guaranteed common implementation of these classes.

Http Exceptions

===============

Http exceptions are provided in :mod:`django.http`.

Http exceptions may be imported from ``django.http``.

.. exception:: UnreadablePostError

``UnreadablePostError``

-----------------------

    The :exc:`UnreadablePostError` is raised when a user cancels an upload.

.. exception:: UnreadablePostError

.. currentmodule:: django.db.transaction

    :exc:`UnreadablePostError` is raised when a user cancels an upload.

Transaction Exceptions

======================

Transaction exceptions are defined in :mod:`django.db.transaction`.

.. currentmodule:: django.db.transaction

Transaction exceptions are defined in ``django.db.transaction``.

``TransactionManagementError``

------------------------------

.. exception:: TransactionManagementError

    The :exc:`TransactionManagementError` is raised for any and all problems

    :exc:`TransactionManagementError` is raised for any and all problems

    related to database transactions.

.. currentmodule:: django.test

Testing Framework Exceptions

============================

Exceptions provided by the :mod:`django.test` package.

Exceptions provided by the ``django.test`` package.

``RedirectCycleError``

----------------------

.. exception:: client.RedirectCycleError