Skip to content

Commit

Permalink
Improve documentation for BaseRequest.path and BaseRequest.raw_path (#…
Browse files Browse the repository at this point in the history
  • Loading branch information
Harmon758 authored and asvetlov committed May 22, 2019
1 parent 506c244 commit 6b0a651
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 3 deletions.
1 change: 1 addition & 0 deletions CHANGES/3791.doc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Improve documentation for ``web.BaseRequest.path`` and ``web.BaseRequest.raw_path``.
6 changes: 3 additions & 3 deletions docs/web_reference.rst
Original file line number Diff line number Diff line change
Expand Up @@ -161,19 +161,19 @@ and :ref:`aiohttp-web-signals` handlers.
.. attribute:: path

The URL including *PATH INFO* without the host or scheme. e.g.,
``/app/blog``. The path is URL-unquoted. For raw path info see
``/app/blog``. The path is URL-decoded. For raw path info see
:attr:`raw_path`.

Read-only :class:`str` property.

.. attribute:: raw_path

The URL including raw *PATH INFO* without the host or scheme.
Warning, the path may be quoted and may contains non valid URL
Warning, the path may be URL-encoded and may contain invalid URL
characters, e.g.
``/my%2Fpath%7Cwith%21some%25strange%24characters``.

For unquoted version please take a look on :attr:`path`.
For URL-decoded version please take a look on :attr:`path`.

Read-only :class:`str` property.

Expand Down

0 comments on commit 6b0a651

Please sign in to comment.