summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorHasan Ramezani <hasan.r67@gmail.com>2019-10-29 21:15:18 +0100
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2019-10-30 13:13:15 +0100
commit6315a272c5cfcc70b745f87b25148a158663a222 (patch)
treecb910d6184f19527ab66823dd3a0ab9b89ffc010 /docs
parent4c762588ff6748a9a9bad111894fd418c43b74a9 (diff)
Refs #28428 -- Made filepath_to_uri() support pathlib.Path.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/utils.txt7
-rw-r--r--docs/releases/3.1.txt6
2 files changed, 12 insertions, 1 deletions
diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt
index 4f174c5efe..09b174c1ce 100644
--- a/docs/ref/utils.txt
+++ b/docs/ref/utils.txt
@@ -280,7 +280,8 @@ The functions defined in this module share the following properties:
.. function:: filepath_to_uri(path)
Convert a file system path to a URI portion that is suitable for inclusion
- in a URL. The path is assumed to be either UTF-8 bytes or string.
+ in a URL. The path is assumed to be either UTF-8 bytes, string, or a
+ :class:`~pathlib.Path`.
This method will encode certain characters that would normally be
recognized as special characters for URIs. Note that this method does not
@@ -289,6 +290,10 @@ The functions defined in this module share the following properties:
Returns an ASCII string containing the encoded result.
+ .. versionchanged:: 3.1
+
+ Support for :class:`pathlib.Path` ``path`` was added.
+
.. function:: escape_uri_path(path)
Escapes the unsafe characters from the path portion of a Uniform Resource
diff --git a/docs/releases/3.1.txt b/docs/releases/3.1.txt
index 0a08ce3cdf..d928abd205 100644
--- a/docs/releases/3.1.txt
+++ b/docs/releases/3.1.txt
@@ -214,6 +214,12 @@ URLs
* ...
+Utilities
+~~~~~~~~~
+
+* :func:`~django.utils.encoding.filepath_to_uri` now supports
+ :class:`pathlib.Path`.
+
Validators
~~~~~~~~~~