From 98ace4b8565ffb932fbdae3da30ba8087538c489 Mon Sep 17 00:00:00 2001 From: Matt Belisle Date: Tue, 30 Oct 2018 13:22:39 -0500 Subject: [PATCH 1/3] Adding Doc/library entries for max_num_fields --- Doc/library/urllib.parse.rst | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst index 2d3488bb5eef54..eec6896ddf412f 100644 --- a/Doc/library/urllib.parse.rst +++ b/Doc/library/urllib.parse.rst @@ -137,7 +137,7 @@ or on combining URL components into a URL string. returning :const:`None`. -.. function:: parse_qs(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace') +.. function:: parse_qs(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace', max_num_fields=None) Parse a query string given as a string argument (data of type :mimetype:`application/x-www-form-urlencoded`). Data are returned as a @@ -158,6 +158,10 @@ or on combining URL components into a URL string. percent-encoded sequences into Unicode characters, as accepted by the :meth:`bytes.decode` method. + The optional argument *max_num_fields* is a flag for the maximum number of + fields to read. If set, then throws a :exc:`ValueError` if there are more + than *max_num_fields* fields read. Default is *None*. + Use the :func:`urllib.parse.urlencode` function (with the ``doseq`` parameter set to ``True``) to convert such dictionaries into query strings. @@ -166,8 +170,11 @@ or on combining URL components into a URL string. .. versionchanged:: 3.2 Add *encoding* and *errors* parameters. + .. versionchanged:: 3.8 + Added *max_num_fields* param. + -.. function:: parse_qsl(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace') +.. function:: parse_qsl(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace', max_num_fields=None) Parse a query string given as a string argument (data of type :mimetype:`application/x-www-form-urlencoded`). Data are returned as a list of @@ -187,12 +194,19 @@ or on combining URL components into a URL string. percent-encoded sequences into Unicode characters, as accepted by the :meth:`bytes.decode` method. + The optional argument *max_num_fields* is a flag for the maximum number of + fields to read. If set, then throws a :exc:`ValueError` if there are more + than *max_num_fields* fields read. Default is *None*. + Use the :func:`urllib.parse.urlencode` function to convert such lists of pairs into query strings. .. versionchanged:: 3.2 Add *encoding* and *errors* parameters. + .. versionchanged:: 3.8 + Added *max_num_fields* param. + .. function:: urlunparse(parts) From 1c3f2f095742fa8fc390d27b6977397c693762e8 Mon Sep 17 00:00:00 2001 From: Matt Belisle Date: Tue, 30 Oct 2018 14:54:50 -0500 Subject: [PATCH 2/3] param -> parameter --- Doc/library/urllib.parse.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst index eec6896ddf412f..d8c82479743549 100644 --- a/Doc/library/urllib.parse.rst +++ b/Doc/library/urllib.parse.rst @@ -171,7 +171,7 @@ or on combining URL components into a URL string. Add *encoding* and *errors* parameters. .. versionchanged:: 3.8 - Added *max_num_fields* param. + Added *max_num_fields* parameter. .. function:: parse_qsl(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace', max_num_fields=None) @@ -205,7 +205,7 @@ or on combining URL components into a URL string. Add *encoding* and *errors* parameters. .. versionchanged:: 3.8 - Added *max_num_fields* param. + Added *max_num_fields* parameter. .. function:: urlunparse(parts) From 51d6fb37bf5b60952fbd598fa6d9279aaa582da7 Mon Sep 17 00:00:00 2001 From: Matt Belisle Date: Tue, 30 Oct 2018 15:17:36 -0500 Subject: [PATCH 3/3] Changing max_num_fields wording --- Doc/library/urllib.parse.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst index d8c82479743549..913e933d657cfe 100644 --- a/Doc/library/urllib.parse.rst +++ b/Doc/library/urllib.parse.rst @@ -158,9 +158,9 @@ or on combining URL components into a URL string. percent-encoded sequences into Unicode characters, as accepted by the :meth:`bytes.decode` method. - The optional argument *max_num_fields* is a flag for the maximum number of - fields to read. If set, then throws a :exc:`ValueError` if there are more - than *max_num_fields* fields read. Default is *None*. + The optional argument *max_num_fields* is the maximum number of fields to + read. If set, then throws a :exc:`ValueError` if there are more than + *max_num_fields* fields read. Use the :func:`urllib.parse.urlencode` function (with the ``doseq`` parameter set to ``True``) to convert such dictionaries into query @@ -194,9 +194,9 @@ or on combining URL components into a URL string. percent-encoded sequences into Unicode characters, as accepted by the :meth:`bytes.decode` method. - The optional argument *max_num_fields* is a flag for the maximum number of - fields to read. If set, then throws a :exc:`ValueError` if there are more - than *max_num_fields* fields read. Default is *None*. + The optional argument *max_num_fields* is the maximum number of fields to + read. If set, then throws a :exc:`ValueError` if there are more than + *max_num_fields* fields read. Use the :func:`urllib.parse.urlencode` function to convert such lists of pairs into query strings.