mirror of
				https://github.com/django/django.git
				synced 2025-10-31 09:41:08 +00:00 
			
		
		
		
	Fixed non-multiple of 4 indentation in docs/ref/request-response.txt.
This commit is contained in:
		| @@ -34,10 +34,10 @@ All attributes should be considered read-only, unless stated otherwise below. | ||||
|  | ||||
| .. attribute:: HttpRequest.scheme | ||||
|  | ||||
|    .. versionadded:: 1.7 | ||||
|     .. versionadded:: 1.7 | ||||
|  | ||||
|    A string representing the scheme of the request (``http`` or ``https`` | ||||
|    usually). | ||||
|     A string representing the scheme of the request (``http`` or ``https`` | ||||
|     usually). | ||||
|  | ||||
| .. attribute:: HttpRequest.body | ||||
|  | ||||
| @@ -251,68 +251,68 @@ Methods | ||||
|  | ||||
| .. method:: HttpRequest.get_full_path() | ||||
|  | ||||
|    Returns the ``path``, plus an appended query string, if applicable. | ||||
|     Returns the ``path``, plus an appended query string, if applicable. | ||||
|  | ||||
|    Example: ``"/music/bands/the_beatles/?print=true"`` | ||||
|     Example: ``"/music/bands/the_beatles/?print=true"`` | ||||
|  | ||||
| .. method:: HttpRequest.build_absolute_uri(location) | ||||
|  | ||||
|    Returns the absolute URI form of ``location``. If no location is provided, | ||||
|    the location will be set to ``request.get_full_path()``. | ||||
|     Returns the absolute URI form of ``location``. If no location is provided, | ||||
|     the location will be set to ``request.get_full_path()``. | ||||
|  | ||||
|    If the location is already an absolute URI, it will not be altered. | ||||
|    Otherwise the absolute URI is built using the server variables available in | ||||
|    this request. | ||||
|     If the location is already an absolute URI, it will not be altered. | ||||
|     Otherwise the absolute URI is built using the server variables available in | ||||
|     this request. | ||||
|  | ||||
|    Example: ``"http://example.com/music/bands/the_beatles/?print=true"`` | ||||
|     Example: ``"http://example.com/music/bands/the_beatles/?print=true"`` | ||||
|  | ||||
| .. method:: HttpRequest.get_signed_cookie(key, default=RAISE_ERROR, salt='', max_age=None) | ||||
|  | ||||
|    Returns a cookie value for a signed cookie, or raises a | ||||
|    ``django.core.signing.BadSignature`` exception if the signature is | ||||
|    no longer valid. If you provide the ``default`` argument the exception | ||||
|    will be suppressed and that default value will be returned instead. | ||||
|     Returns a cookie value for a signed cookie, or raises a | ||||
|     ``django.core.signing.BadSignature`` exception if the signature is | ||||
|     no longer valid. If you provide the ``default`` argument the exception | ||||
|     will be suppressed and that default value will be returned instead. | ||||
|  | ||||
|    The optional ``salt`` argument can be used to provide extra protection | ||||
|    against brute force attacks on your secret key. If supplied, the | ||||
|    ``max_age`` argument will be checked against the signed timestamp | ||||
|    attached to the cookie value to ensure the cookie is not older than | ||||
|    ``max_age`` seconds. | ||||
|     The optional ``salt`` argument can be used to provide extra protection | ||||
|     against brute force attacks on your secret key. If supplied, the | ||||
|     ``max_age`` argument will be checked against the signed timestamp | ||||
|     attached to the cookie value to ensure the cookie is not older than | ||||
|     ``max_age`` seconds. | ||||
|  | ||||
|    For example:: | ||||
|     For example:: | ||||
|  | ||||
|           >>> request.get_signed_cookie('name') | ||||
|           'Tony' | ||||
|           >>> request.get_signed_cookie('name', salt='name-salt') | ||||
|           'Tony' # assuming cookie was set using the same salt | ||||
|           >>> request.get_signed_cookie('non-existing-cookie') | ||||
|           ... | ||||
|           KeyError: 'non-existing-cookie' | ||||
|           >>> request.get_signed_cookie('non-existing-cookie', False) | ||||
|           False | ||||
|           >>> request.get_signed_cookie('cookie-that-was-tampered-with') | ||||
|           ... | ||||
|           BadSignature: ... | ||||
|           >>> request.get_signed_cookie('name', max_age=60) | ||||
|           ... | ||||
|           SignatureExpired: Signature age 1677.3839159 > 60 seconds | ||||
|           >>> request.get_signed_cookie('name', False, max_age=60) | ||||
|           False | ||||
|         >>> request.get_signed_cookie('name') | ||||
|         'Tony' | ||||
|         >>> request.get_signed_cookie('name', salt='name-salt') | ||||
|         'Tony' # assuming cookie was set using the same salt | ||||
|         >>> request.get_signed_cookie('non-existing-cookie') | ||||
|         ... | ||||
|         KeyError: 'non-existing-cookie' | ||||
|         >>> request.get_signed_cookie('non-existing-cookie', False) | ||||
|         False | ||||
|         >>> request.get_signed_cookie('cookie-that-was-tampered-with') | ||||
|         ... | ||||
|         BadSignature: ... | ||||
|         >>> request.get_signed_cookie('name', max_age=60) | ||||
|         ... | ||||
|         SignatureExpired: Signature age 1677.3839159 > 60 seconds | ||||
|         >>> request.get_signed_cookie('name', False, max_age=60) | ||||
|         False | ||||
|  | ||||
|    See :doc:`cryptographic signing </topics/signing>` for more information. | ||||
|     See :doc:`cryptographic signing </topics/signing>` for more information. | ||||
|  | ||||
| .. method:: HttpRequest.is_secure() | ||||
|  | ||||
|    Returns ``True`` if the request is secure; that is, if it was made with | ||||
|    HTTPS. | ||||
|     Returns ``True`` if the request is secure; that is, if it was made with | ||||
|     HTTPS. | ||||
|  | ||||
| .. method:: HttpRequest.is_ajax() | ||||
|  | ||||
|    Returns ``True`` if the request was made via an ``XMLHttpRequest``, by | ||||
|    checking the ``HTTP_X_REQUESTED_WITH`` header for the string | ||||
|    ``'XMLHttpRequest'``. Most modern JavaScript libraries send this header. | ||||
|    If you write your own XMLHttpRequest call (on the browser side), you'll | ||||
|    have to set this header manually if you want ``is_ajax()`` to work. | ||||
|     Returns ``True`` if the request was made via an ``XMLHttpRequest``, by | ||||
|     checking the ``HTTP_X_REQUESTED_WITH`` header for the string | ||||
|     ``'XMLHttpRequest'``. Most modern JavaScript libraries send this header. | ||||
|     If you write your own XMLHttpRequest call (on the browser side), you'll | ||||
|     have to set this header manually if you want ``is_ajax()`` to work. | ||||
|  | ||||
| .. method:: HttpRequest.read(size=None) | ||||
| .. method:: HttpRequest.readline() | ||||
| @@ -357,23 +357,23 @@ a subclass of dictionary. Exceptions are outlined here: | ||||
|  | ||||
| .. method:: QueryDict.__init__(query_string=None, mutable=False, encoding=None) | ||||
|  | ||||
|    Instantiates a ``QueryDict`` object based on ``query_string``. | ||||
|     Instantiates a ``QueryDict`` object based on ``query_string``. | ||||
|  | ||||
|           >>> QueryDict('a=1&a=2&c=3') | ||||
|           <QueryDict: {u'a': [u'1', u'2'], u'b': [u'1']}> | ||||
|     >>> QueryDict('a=1&a=2&c=3') | ||||
|     <QueryDict: {u'a': [u'1', u'2'], u'b': [u'1']}> | ||||
|  | ||||
|    If ``query_string`` is not passed in, the resulting ``QueryDict`` will be | ||||
|    empty (it will have no keys or values). | ||||
|     If ``query_string`` is not passed in, the resulting ``QueryDict`` will be | ||||
|     empty (it will have no keys or values). | ||||
|  | ||||
|    Most ``QueryDict``\ s you encounter, and in particular those at | ||||
|    ``request.POST`` and ``request.GET``, will be immutable. If you are | ||||
|    instantiating one yourself, you can make it mutable by passing | ||||
|    ``mutable=True`` to its ``__init__()``. | ||||
|     Most ``QueryDict``\ s you encounter, and in particular those at | ||||
|     ``request.POST`` and ``request.GET``, will be immutable. If you are | ||||
|     instantiating one yourself, you can make it mutable by passing | ||||
|     ``mutable=True`` to its ``__init__()``. | ||||
|  | ||||
|    Strings for setting both keys and values will be converted from ``encoding`` | ||||
|    to unicode. If encoding is not set, it defaults to :setting:`DEFAULT_CHARSET`. | ||||
|     Strings for setting both keys and values will be converted from ``encoding`` | ||||
|     to unicode. If encoding is not set, it defaults to :setting:`DEFAULT_CHARSET`. | ||||
|  | ||||
|    .. versionchanged:: 1.8 | ||||
|     .. versionchanged:: 1.8 | ||||
|  | ||||
|         In previous versions, ``query_string`` was a required positional argument. | ||||
|  | ||||
| @@ -413,21 +413,21 @@ a subclass of dictionary. Exceptions are outlined here: | ||||
|     dictionary ``update()`` method, except it *appends* to the current | ||||
|     dictionary items rather than replacing them. For example:: | ||||
|  | ||||
|           >>> q = QueryDict('a=1', mutable=True) | ||||
|           >>> q.update({'a': '2'}) | ||||
|           >>> q.getlist('a') | ||||
|           ['1', '2'] | ||||
|           >>> q['a'] # returns the last | ||||
|           ['2'] | ||||
|         >>> q = QueryDict('a=1', mutable=True) | ||||
|         >>> q.update({'a': '2'}) | ||||
|         >>> q.getlist('a') | ||||
|         ['1', '2'] | ||||
|         >>> q['a'] # returns the last | ||||
|         ['2'] | ||||
|  | ||||
| .. method:: QueryDict.items() | ||||
|  | ||||
|     Just like the standard dictionary ``items()`` method, except this uses the | ||||
|     same last-value logic as ``__getitem__()``. For example:: | ||||
|  | ||||
|            >>> q = QueryDict('a=1&a=2&a=3') | ||||
|            >>> q.items() | ||||
|            [('a', '3')] | ||||
|         >>> q = QueryDict('a=1&a=2&a=3') | ||||
|         >>> q.items() | ||||
|         [('a', '3')] | ||||
|  | ||||
| .. method:: QueryDict.iteritems() | ||||
|  | ||||
| @@ -445,9 +445,9 @@ a subclass of dictionary. Exceptions are outlined here: | ||||
|     Just like the standard dictionary ``values()`` method, except this uses the | ||||
|     same last-value logic as ``__getitem__()``. For example:: | ||||
|  | ||||
|            >>> q = QueryDict('a=1&a=2&a=3') | ||||
|            >>> q.values() | ||||
|            ['3'] | ||||
|         >>> q = QueryDict('a=1&a=2&a=3') | ||||
|         >>> q.values() | ||||
|         ['3'] | ||||
|  | ||||
| .. method:: QueryDict.itervalues() | ||||
|  | ||||
|   | ||||
		Reference in New Issue
	
	Block a user