Commit Graph

9086 Commits

Author SHA1 Message Date
Miss Islington (bot) 56410810d3
Doc: add missing capture_output arg to subprocess.run() signature (GH-8374)
(cherry picked from commit 22d131a7f9)

Co-authored-by: Andriy Maletsky <9919211+and800@users.noreply.github.com>
2018-08-09 15:03:52 -07:00
Miss Islington (bot) fac49762c5
bpo-34335: Use async/await syntax in documentation examples (GH-8674)
(cherry picked from commit d2ac400267)

Co-authored-by: Mikhail Terekhov <termim@gmail.com>
2018-08-07 13:33:31 -07:00
Miss Islington (bot) 1c6df83e93
bpo-34319: Clarify file handler closure in pathlib.read_text (GH-8645)
Patch by Terry Jan Reedy.
(cherry picked from commit 5b2657fb8c)

Co-authored-by: Xtreak <tirkarthi@users.noreply.github.com>
2018-08-06 12:59:43 -07:00
Miss Islington (bot) e39fb207f2
bpo-34273: Change 'Fixed point' to 'Fixed-point notation'. (GH-8673)
* bpo-34273: Change 'Fixed point' to 'Fixed-point notation'.
The change in the mini language floating point and decimal table
is consistent with 'Exponential notation' and clarifies that we
are referring to the output notation, not an object type.

* Update string.rst

* Update string.rst

* Update string.rst

* Update string.rst
(cherry picked from commit 28c7f8c8ce)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-08-06 05:47:36 -07:00
Miss Islington (bot) e610c4f998
bpo-34336: Don't promote possibility to leave out typing.Optional (GH-8677)
(cherry picked from commit 336c945858)

Co-authored-by: Ville Skyttä <ville.skytta@iki.fi>
2018-08-05 10:36:04 -07:00
Miss Islington (bot) 2a2a3f56f5 Fix reST markup in unittest documentation (GH-8665)
(cherry picked from commit 2e5566d9e7)

Co-authored-by: Berker Peksag <berker.peksag@gmail.com>
2018-08-04 01:13:52 +03:00
Miss Islington (bot) 39fcd99498 bpo-34329: Doc'd how to remove suffix of pathlib.Path() (GH-8655)
(cherry picked from commit 46dc4e34ed)

Co-authored-by: Stefan Otte <stefan.otte@gmail.com>
2018-08-04 00:45:46 +03:00
Miss Islington (bot) b4d71c9149
Improve the grammar in `range` documentation. (GH-8628)
Remove unnecessary "that" in the sentence.
(cherry picked from commit b6efc2cf97)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-08-02 23:16:07 -07:00
Miss Islington (bot) 0f9df886d6 bpo-27910: Update documentation of traceback module (GH-6116)
In the documentation for the traceback module, the definitions of functions
extract_tb(), format_list() and classmethod StackSummary.from_list()
mention the old style 4-tuples that these functions used to return or accept.

Since Python 3.5, however, they return or accept a FrameSummary object
instead of a 4-tuple, or a StackSummary object instead of a list of 4-tuples.

Co-authored-by: torsava <torsava@redhat.com>
Co-Authored-By: Berker Peksag <berker.peksag@gmail.com>

(cherry picked from commit f394ee5eaf)
2018-08-02 19:51:48 +03:00
Serhiy Storchaka 47957dab94
[3.7] bpo-33729: Fix issues with arguments parsing in hashlib. (GH-8346) (GH-8581)
* help(hashlib) didn't work because of incorrect module name in blake2b and
  blake2s classes.
* Constructors blake2*(), sha3_*(), shake_*() and keccak_*() incorrectly
  accepted keyword argument "string" for binary data, but documented as
  accepting the "data" keyword argument. Now this parameter is positional-only.
* Keyword-only parameters in blake2b() and blake2s() were not documented as
  keyword-only.
* Default value for some parameters of blake2b() and blake2s() was None,
  which is not acceptable value.
* The length argument for shake_*.digest() was wrapped out to 32 bits.
* The argument for shake_128.digest() and shake_128.hexdigest() was not
  positional-only as intended.
* TypeError messages for incorrect arguments in all constructors sha3_*(),
  shake_*() and keccak_*() incorrectly referred to sha3_224.

Also made the following enhancements:

* More accurately specified input and result types for strings, bytes and
  bytes-like objects.
* Unified positional parameter names for update() and constructors.
* Improved formatting.
(cherry picked from commit f1d36d8efa)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2018-07-31 10:22:44 +03:00
Steve Dower 3dc8cdf56d
bpo-8145: Improve isolation_level documentation (GH-8499)
Initial patch by R. David Murray.
2018-07-29 12:06:35 +01:00
Miss Islington (bot) 8764a6ffda
bpo-29710: Clarify documentation for Bitwise binary operation (GH-1691)
Mathematically, bitwise operations on integers behave as if there were an
infinite number of sign bits. Pragmatically, that gives the same answer as
using one extra sign bit for the bitwise logical operations.
(cherry picked from commit b4bc5cab82)

Co-authored-by: Sanyam Khurana <8039608+CuriousLearner@users.noreply.github.com>
2018-07-28 09:52:14 -07:00
Steve Dower 83b449d754
bpo-24356: Specify which Python binary will be used with venv (GH-6589) 2018-07-28 17:48:29 +01:00
Miss Islington (bot) 2335544562
bpo-33921: Clarify how to bind to all interfaces using socket (GH-7877)
Clarify how to bind to all interfaces using socket
(cherry picked from commit 95dfb9c3ae)

Co-authored-by: johnthagen <johnthagen@users.noreply.github.com>
2018-07-28 05:27:15 -07:00
Miss Islington (bot) c6801b48a1
bpo-5978: Document that profiling needs cmd/function to return (GH-7938)
<!-- issue-number: bpo-5978 -->
https://bugs.python.org/issue5978
<!-- /issue-number -->
(cherry picked from commit 937fb55d35)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-28 05:23:42 -07:00
Miss Islington (bot) 6f7fd963a0 Fix site module documentation. (GH-8441)
The script will exit with the number 0 (zero), instead of the letter O.
(cherry picked from commit 95d34c2a37)

Co-authored-by: Mariatta <Mariatta@users.noreply.github.com>
2018-07-24 10:30:33 -07:00
Miss Islington (bot) 4e166ffd29 bpo-33468: Add try-finally contextlib.contextmanager example (GH-7816) (GH-8425)
(cherry picked from commit bde782bb59)

Co-authored-by: Matthias Bussonnier <bussonniermatthias@gmail.com>
2018-07-24 00:38:18 +03:00
Miss Islington (bot) 05a72f15f7 bpo-21446: Update reload fixer to use importlib (GH-8391)
(cherry picked from commit 7a3056fa7d)

Co-authored-by: Berker Peksag <berker.peksag@gmail.com>
2018-07-23 11:11:22 +03:00
Miss Islington (bot) 7cf7541aa4 Fix versionchanged indentation in popitem documentation (GH-8387)
(cherry picked from commit cb9c299a55)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-21 16:04:54 -07:00
Miss Islington (bot) 68833dcbd4 Clarify ValueError's broad applicability (GH-8313) (GH-8315)
(cherry picked from commit feabae9617)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2018-07-17 13:22:50 -07:00
Miss Islington (bot) bfa8a358e2 bpo-34123: Fix missed documentation update for dict.popitem(). (GH-8292) (GH#8307) 2018-07-16 19:08:13 -07:00
Miss Islington (bot) 43c2fabb2f bpo-34124: Fix markup of message_from_binary_file() signature (GH-8297)
(cherry picked from commit c9265c1534)

Co-authored-by: Jon Ribbens <jribbens@gmail.com>
2018-07-16 21:43:41 +03:00
Miss Islington (bot) 08c1da7103
bpo-4260: Document that ctypes.xFUNCTYPE are decorators (GH-7924)
(cherry picked from commit 379e9d639a)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-13 06:35:31 -07:00
Miss Islington (bot) 6b1b6e4385
Doc: Point to Simple statements section instead of PEP (GH-8238)
(cherry picked from commit 33aefad342)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-11 03:32:31 -07:00
Miss Islington (bot) bcea15a611 Dataclasses: Fix example on 30.6.8, add method should receive a list rather than an integer. (GH-8038) (GH-8237)
Change example function to append rather than add lists.
(cherry picked from commit da5e9476bb)

Co-authored-by: Tom Faulkner <tomfaulkner@gmail.com>
2018-07-11 06:11:11 -04:00
Miss Islington (bot) 1b6e217304
bpo-34067: Include a more easily understood example for nullcontext (GH-8158)
Include a more easily understood example for nullcontext
(cherry picked from commit c287545d62)

Co-authored-by: Daniel Porteous <danielporteous1@gmail.com>
2018-07-09 07:11:42 -07:00
Serhiy Storchaka 7c43b80150
[3.7] bpo-26544: Fixed implementation of platform.libc_ver(). (GH-7684). (GH-8193)
(cherry picked from commit 2a9b8babf0)
2018-07-09 12:55:35 +03:00
Miss Islington (bot) 79c6b35b35
Fix margin in sentinel and mock_open (GH-8188)
(cherry picked from commit f85af035c5)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-08 17:48:02 -07:00
Marcin Niemira 0b63759651 bpo-34061: Document sqlite3.NotSupportedError (GH-8172)
(cherry picked from commit bc9aa813a3)

Co-authored-by: Marcin Niemira <marcin@niemira.net>
2018-07-08 16:59:48 +03:00
Miss Islington (bot) a912305512
closes bpo-34050: Fix link in SSL docs (GH-8173)
(cherry picked from commit 9c5ba09748)

Co-authored-by: Marcin Niemira <marcin@niemira.net>
2018-07-07 15:47:35 -07:00
Miss Islington (bot) e5b47ea585
bpo-33804: Document that the argument for io.TextIOBase.read() is optional (GH-7510)
(cherry picked from commit b6bb77c2b8)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-07 13:39:03 -07:00
Miss Islington (bot) c5e4c76eaa
Fix moduleauthor/sectionauthor directives in Enum (GH-8117)
(cherry picked from commit 2d748389dc)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-07 12:32:08 -07:00
Miss Islington (bot) c8b18d3192
Add missing closing parentheses (GH-8144)
(cherry picked from commit 03dd0e794e)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-07 12:19:55 -07:00
Dong-hee Na 75f2eb5eca [3.7] bpo-34065: Improve the markup of logging.basicConfig() arguments (GH-8153). (GH-8156)
(cherry picked from commit 2800dcf656)

Co-authored-by: Dong-hee Na <donghee.na92@gmail.com>
2018-07-07 19:12:11 +03:00
Miss Islington (bot) e217d23886
Doc: Remove superfluous markup. (GH-8112)
The line is speaking of a list of commands, not the list command.
(cherry picked from commit 7943c5e8b5)

Co-authored-by: Julien Palard <julien@palard.fr>
2018-07-06 02:34:24 -07:00
Miss Islington (bot) a8bb18bbb9 bpo-30516: Fix documentation issue with -timedelta in datetime (GH-7348) (GH-8093)
This commit fixes the -timedelta overfllow issue not documented properly.

Signed-off-by: Farhaan Bukhsh <farhaan.bukhsh@gmail.com>
(cherry picked from commit 5b6e49a139)

Co-authored-by: Farhaan Bukhsh <farhaan.bukhsh@gmail.com>
2018-07-05 00:04:24 +01:00
Miss Islington (bot) 6699386231 bpo-34018: Doc'd that type names of SQLite converters are case-insensitive. (GH-8042) (GH-8065)
(cherry picked from commit 831c29721d)

Co-authored-by: Sergey Fedoseev <fedoseev.sergey@gmail.com>
2018-07-03 15:37:16 +03:00
Chris Cogdon 24d74bd837 bpo-33961: Adjusted dataclasses docs to correct exceptions raised. (GH-7917) 2018-07-02 06:21:50 -04:00
Miss Islington (bot) f9ae07441c Doc: Remove unused image file (GH-8027)
(cherry picked from commit fe524df37c)
2018-07-01 03:30:43 +09:00
Miss Islington (bot) fd1c092bb9 bpo-32568: make select.epoll() and its docs consistent (GH-7840) (GH-8024)
* `flags` is indeed deprecated, but there is a validation on its value for
  backwards compatibility reasons.  This adds mention of this in the docs.
* The docs say that `sizehint` is deprecated and ignored, but it is still
  used when `epoll_create1()` is unavailable. This adds mention of this in
  the docs.
* `sizehint=-1` is acceptable again, and is replaced with `FD_SETSIZE-1`.
  This is needed to have a default value available at the Python level,
  since `FD_SETSIZE` is not exposed to Python. (see: bpo-31938)
* Reject `sizehint=0` since it is invalid to pass on to `epoll_create()`.

The relevant tests have also been updated.

(cherry picked from commit 0cdf5f4289)

Co-authored-by: Tal Einat <taleinat+github@gmail.com>
2018-06-30 16:03:19 +03:00
Miss Islington (bot) d0b442803a
Fix the indentation in the documentation of bin() and hash() (GH-7998)
(cherry picked from commit bda9c3eae3)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-29 03:16:26 -07:00
Miss Islington (bot) 4c20d2bf5d
bpo-33985: Implement ContextVar.name attribute. (GH-7980)
(cherry picked from commit 41cb0baea9)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-06-28 10:39:54 -07:00
Miss Islington (bot) 150cd3cb27 [3.7] bpo-33573: docs to suggest median() alternatives for non-numeric data (GH-7587) (GH-7906)
(cherry picked from commit fdd6e0bf18)
2018-06-25 14:18:54 +03:00
Miss Islington (bot) 80f1a908a8 bpo-33952: Fix typo in str.upper() documentation (GH-7898) (GH-7903)
(cherry picked from commit 4a6e746079)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-25 13:42:20 +03:00
Miss Islington (bot) 66d77d8af8 bpo-33943: Add references in the docs for logging.basicConfig (GH-7858) (GH-7900)
Adds references to info about file modes, `time.strftime()`, string formatting
syntaxes, and logging levels.

(cherry picked from commit a8ddf85a84)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-25 09:25:58 +03:00
Miss Islington (bot) e4db73058b
bpo-33885: Replace "hook function" with "callable" (GH-7765)
(cherry picked from commit c45cb47907)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-22 14:30:45 -07:00
Miss Islington (bot) fee52e34ce Clarified the tempfile.tempdir documentation (GH-7829) (GH-7841)
(cherry picked from commit 940ae60856)

Co-authored-by: Srinivas Reddy Thatiparthy (శ్రీనివాస్ రెడ్డి తాటిపర్తి) <srinivasreddy@users.noreply.github.com>
2018-06-21 04:03:29 -04:00
Miss Islington (bot) 5f165851b9
bpo-33892: Doc: Use gender neutral words (GH-7770)
(cherry picked from commit 5092439c2c)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-17 21:49:43 -07:00
Miss Islington (bot) 416e488415
bpo-33859: Fix spelling mistakes in docs. (GH-7691)
(cherry picked from commit c151f7846d)

Co-authored-by: Xtreak <tirkarthi@users.noreply.github.com>
2018-06-15 22:26:34 -07:00
Miss Islington (bot) ce1bda774e bpo-33854: Add PEP 461 title to 'See also' note (GH-7688) (#7719)
(cherry picked from commit a9d0b34a5c)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 16:14:32 -04:00
Miss Islington (bot) eea4f14971
bpo-31378: Document sqlite3.OperationalError exception (GH-7677)
(cherry picked from commit 71ede00f14)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2018-06-13 02:28:48 -07:00
Miss Islington (bot) 29fdea5ec2
bpo-33828: Add missing versionchanged note for string.Formatter. (GH-7668)
string.Formatter auto-numbering feature was added in 3.4 and there
is no versionchanged note in its documentation, making the documentation
ambiguous about which version the feature is available.
(cherry picked from commit b9d8ad5130)

Co-authored-by: Xiang Zhang <angwerzx@126.com>
2018-06-12 19:10:51 -07:00
Miss Islington (bot) 7b82281c80 bpo-27397: Make email module properly handle invalid-length base64 strings (GH-7583) (GH-7664)
When attempting to base64-decode a payload of invalid length (1 mod 4),
properly recognize and handle it.  The given data will be returned as-is,
i.e. not decoded, along with a new defect, InvalidBase64LengthDefect.
(cherry picked from commit c3f55be7dd)

Co-authored-by: Tal Einat <taleinat+github@gmail.com>
2018-06-12 16:46:11 +03:00
Miss Islington (bot) a5db479ac4 bpo-31432: Clarify ssl CERT_NONE/OPTIONAL/REQUIRED docs. (GH-3530) (GH-7649)
The documentation for CERT_NONE, CERT_OPTIONAL, and CERT_REQUIRED were
misleading and partly wrong. It fails to explain that OpenSSL behaves
differently in client and server mode. Also OpenSSL does validate the
cert chain everytime. With SSL_VERIFY_NONE a validation error is not
fatal in client mode and does not request a client cert in server mode.
Also discourage people from using CERT_OPTIONAL in client mode.
(cherry picked from commit ef24b6c54d)

Co-authored-by: Christian Heimes <christian@python.org>
2018-06-11 19:20:24 -04:00
Miss Islington (bot) b06fc2d244 bpo-30820: Remove incorrect docs for email.contentmanager.raw_data_manager (GH-7631) (#7633)
The docs claimed that a list of EmailMessage objects could be
passed to set_content(), but this was never implemented.
(cherry picked from commit 2c071cebe6)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2018-06-11 12:11:22 -04:00
Miss Islington (bot) 037e912552 bpo-33812: Corrected astimezone for naive datetimes. (GH-7578) (GH-7600)
A datetime object d is aware if d.tzinfo is not None and
d.tzinfo.utcoffset(d) does  not return None. If d.tzinfo is None,
or if d.tzinfo is not None but d.tzinfo.utcoffset(d) returns None,
 d is naive.

This commit ensures that instances with non-None d.tzinfo, but
d.tzinfo.utcoffset(d) returning None are treated as naive.

In addition, C acceleration code will raise TypeError if
d.tzinfo.utcoffset(d) returns an object with the type other than
timedelta.

* Updated the documentation.

Assume that the term "naive" is defined elsewhere and remove the
not entirely correct clarification.  Thanks, Tim.
(cherry picked from commit 877b23202b)

Co-authored-by: Alexander Belopolsky <abalkin@users.noreply.github.com>
2018-06-10 18:02:24 -04:00
Miss Islington (bot) 2adfeef185
bpo-33610: Update IDLE Code Context doc entry (GH-7597)
Users can now click on context lines.
(cherry picked from commit af4b0130d4)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-10 13:07:24 -07:00
Miss Islington (bot) 92a58417b3
Fix typo in object.__getnewargs__() documentation (GH-7554)
(cherry picked from commit 0e0534c402)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-09 18:01:36 -07:00
Miss Islington (bot) 055bd80fd9
doc: Fix typo in asyncio-eventloop.rst (GH-7345)
This is a fixup to 19a44f63c7
(cherry picked from commit 7e0d882a98)

Co-authored-by: MarcoFalke <falke.marco@gmail.com>
2018-06-09 16:30:16 -07:00
Miss Islington (bot) 416fbe41b7 bpo-33801: Remove non-ordered dict comment from plistlib doc (GH-7495) (GH-7546)
(cherry picked from commit 1cbdb2208a)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-08 17:57:43 -04:00
Miss Islington (bot) dc20d9d102 bpo-33800: Fix default argument for parameter dict_type of ConfigParser/RawConfigParser (GH-7494) (GH-7542)
(cherry picked from commit 3b0b90c8c3)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-08 15:26:07 -04:00
Miss Islington (bot) f4dcf49159
bpo-33736: Improve the documentation of asyncio stream APIs (GH-7326)
(cherry picked from commit c0d062f523)

Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
2018-06-08 08:54:31 -07:00
Miss Islington (bot) 9f56a93e89
bpo-33798: Update csv document about dict order (GH-7490)
(cherry picked from commit 6860629d87)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-08 06:33:32 -07:00
Miss Islington (bot) d16d72f555
bpo-31215: Add version changed notes for OpenSSL 1.1.0 compatibility (GH-7346)
(cherry picked from commit 9ef1b0690b)

Co-authored-by: Mayank Singhal <17mayank.singhal@gmail.com>
2018-06-08 03:22:40 -07:00
Miss Islington (bot) 9b0d4d04a1 bpo-33609: small wording fixes to dict ordering docs (#7497)
A few wording improvements to dict ordering documentation.
(cherry picked from commit d3ed67d14e)

Co-authored-by: Neil Schemenauer <nas-github@arctrix.com>
2018-06-07 20:38:22 -04:00
Miss Islington (bot) f38ace61a3
bpo-17909: Document that json.load can accept a binary IO (GH-7366)
(cherry picked from commit bb6366bd75)

Co-authored-by: Anthony Sottile <asottile@umich.edu>
2018-06-07 03:17:15 -07:00
Miss Islington (bot) 4705ea38c9 update to Unicode 11.0.0 (closes bpo-33778) (GH-7439) (GH-7470)
Also, standardize indentation of generated tables.
(cherry picked from commit 7c69c1c0fb)

Co-authored-by: Benjamin Peterson <benjamin@python.org>
2018-06-07 03:36:22 -04:00
Miss Islington (bot) cebd4b009a bpo-28240: timeit: Update repeat() doc (GH-7419) (GH-7457)
Document that the default value of repeat changed from 3 to 5 in
Python 3.7.
(cherry picked from commit 3ef769fcd3)

Co-authored-by: Victor Stinner <vstinner@redhat.com>
2018-06-06 19:05:46 +02:00
Miss Islington (bot) 23b7ee2052
bpo-32392: Document env keyword argument of subprocess.run() (GH-7289)
(cherry picked from commit af1ec97a6d)

Co-authored-by: Tobias Kunze <r@rixx.de>
2018-06-05 05:03:02 -07:00
Miss Islington (bot) 8585ec9b76
bpo-33609: Document dict insertion order guarantee as of 3.7 (GH-7093)
(cherry picked from commit f822549653)

Co-authored-by: INADA Naoki <methane@users.noreply.github.com>
2018-06-04 15:25:12 -07:00
Miss Islington (bot) 7548a93274
bpo-27902: Add compatibility note to Profile docs (GH-7295)
(cherry picked from commit f7745e1dcb)

Co-authored-by: Tobias Kunze <r@rixx.de>
2018-06-04 10:25:37 -07:00
Miss Islington (bot) 1cdd0e71ec
bpo-33640, uuid.UUID doc: document endian of bytes parameter (GH-7263)
The bytes parameter uses big endian.
(cherry picked from commit b75ec08567)

Co-authored-by: Farhaan Bukhsh <farhaan.bukhsh@gmail.com>
2018-06-04 10:17:28 -07:00
Miss Islington (bot) 87936d03cb bpo-33734: asyncio/ssl: a bunch of bugfixes (GH-7321) (GH-7396)
* Fix AttributeError (not all SSL exceptions have 'errno' attribute)

* Increase default handshake timeout from 10 to 60 seconds
* Make sure start_tls can be cancelled correctly
* Make sure any error in SSLProtocol gets propagated (instead of just being logged)
(cherry picked from commit 9602643120)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-06-04 12:05:46 -04:00
Miss Islington (bot) 949da9e44b
bpo-23495: Correct the documentation for writerows() of csv Writer objects (GH-6316)
`writerows()` takes an iterable.
(cherry picked from commit a801cf164b)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2018-06-02 08:40:00 -07:00
Miss Islington (bot) 283e12f91d bpo-32519: Removed misleading sentence from EnvBuilder documentation. (GH-7296) (#7300)
(cherry picked from commit c0d341d49b)

Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
2018-06-01 18:57:12 +01:00
Miss Islington (bot) 4b6691e40f bpo-33400: Removed references to RFC3339 and ISO8601 from the logging documentation. (GH-7297) (GH-7302)
(cherry picked from commit 23cee80cfa)

Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
2018-06-01 18:54:30 +01:00
Miss Islington (bot) 0f1a183269
bpo-33641: Convert RFC references into links. (GH-7103)
85% of them are already links.
(cherry picked from commit 0a36ac1a09)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2018-05-30 22:33:23 -07:00
Miss Islington (bot) 0e823c6efa
bpo-31368: Enhance os.preadv() documentation (GH-7254)
(cherry picked from commit 02e2a085dc)

Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
2018-05-30 16:22:13 -07:00
Miss Islington (bot) f95269404c [3.7] bpo-23859: Document that asyncio.wait() does not cancel its futures (GH-7217) (#7227)
* bpo-23859: Document that asyncio.wait() does not cancel its futures (GH-7217)

Unlike `asyncio.wait_for()`, `asyncio.wait()` does not cancel the passed
futures when a timeout accurs.
(cherry picked from commit f9aeca2085)

Co-authored-by: Elvis Pranskevichus <elvis@magic.io>

* Update asyncio-task.rst
2018-05-29 21:26:22 -04:00
Julien Palard 4f53e2ac16
[3.7] bpo-31639: Change ThreadedHTTPServer to ThreadingHTTPServer class name (GH-7195) (GH-7219)
* [3.7] bpo-31639: Change ThreadedHTTPServer to ThreadingHTTPServer class name (GH-7195).
(cherry picked from commit 1cee216cf3)

* Fix whatsnew entry about ThreadedHTTPServer. (GH-7220)
(cherry picked from commit a34e424bdb)
2018-05-30 02:24:17 +02:00
Miss Islington (bot) d8948c5e09
bpo-32751: Wait for task cancellation in asyncio.wait_for() (GH-7216)
Currently, asyncio.wait_for(fut), upon reaching the timeout deadline,
cancels the future and returns immediately.  This is problematic for
when *fut* is a Task, because it will be left running for an arbitrary
amount of time.  This behavior is iself surprising and may lead to
related bugs such as the one described in bpo-33638:

    condition = asyncio.Condition()
    async with condition:
        await asyncio.wait_for(condition.wait(), timeout=0.5)

Currently, instead of raising a TimeoutError, the above code will fail
with `RuntimeError: cannot wait on un-acquired lock`, because
`__aexit__` is reached _before_ `condition.wait()` finishes its
cancellation and re-acquires the condition lock.

To resolve this, make `wait_for` await for the task cancellation.
The tradeoff here is that the `timeout` promise may be broken if the
task decides to handle its cancellation in a slow way.  This represents
a behavior change and should probably not be back-patched to 3.6 and
earlier.
(cherry picked from commit e2b340ab41)

Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
2018-05-29 15:37:06 -07:00
Miss Islington (bot) 036434273e bpo-32684: Fix gather to propagate cancel of itself with return_exceptions (GH-7209) (#7222)
(cherry picked from commit 863b674909)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-05-29 18:29:12 -04:00
Miss Islington (bot) ca64f3ee5a
bpo-30935: update get_event_loop docs (GH-2731)
(cherry picked from commit e55de2d77f)

Co-authored-by: Mandeep Singh <daxlab@users.noreply.github.com>
2018-05-29 12:28:57 -07:00
Serhiy Storchaka 2641ee5040
bpo-32911: Revert bpo-29463. (GH-7121)
Remove the docstring attribute of AST types and restore docstring
expression as a first stmt in their body.

Co-authored-by: INADA Naoki <methane@users.noreply.github.com>
2018-05-29 10:49:10 +03:00
Miss Islington (bot) 78e14f8eb4 bpo-32878: Adds documentation for st_ino on Windows (GH-5764) (#7189)
(cherry picked from commit 3e51a3d592)

Co-authored-by: Steve Dower <steve.dower@microsoft.com>
2018-05-28 21:49:42 -04:00
Miss Islington (bot) ddc613f203
bpo-32610: Fix asyncio.all_tasks() to return only pending tasks. (GH-7174)
(cherry picked from commit 416c1ebd98)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-05-28 17:16:43 -07:00
Miss Islington (bot) bc3a002e7d
bpo-33654: Support BufferedProtocol in set_protocol() and start_tls() (GH-7130)
In this commit:

* Support BufferedProtocol in set_protocol() and start_tls()
* Fix proactor to cancel readers reliably
* Update tests to be compatible with OpenSSL 1.1.1
* Clarify BufferedProtocol docs
* Bump TLS tests timeouts to 60 seconds; eliminate possible race from start_serving
* Rewrite test_start_tls_server_1
(cherry picked from commit dbf102271f)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-05-28 11:50:45 -07:00
Miss Islington (bot) eb8516becc bpo-33400: Clarified documentation to indicate no strict adherence to ISO 8601. (GH-6702) (GH-6704)
(cherry picked from commit c4994dc00d)

Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
2018-05-28 13:29:13 +01:00
Miss Islington (bot) 82d727fce6
Document typing.NoReturn (GH-7107)
(cherry picked from commit 6e413f4327)

Co-authored-by: Ivan Levkivskyi <levkivskyi@gmail.com>
2018-05-24 21:51:14 -07:00
Miss Islington (bot) dd7a255911 bpo-33109: argparse subparsers are once again not required by default (GH-6919) (GH-7089)
bpo-26510 in 3.7.0a2 changed the behavior of argparse to make
subparsers required by default, returning to the behavior of 2.7
and 3.2. The behavior was changed in 3.3 to be no longer required.
While it might make more sense to have the default to required,
compatibility with 3.3 through 3.6 is probably less disruptive
than trying to reintroduce compatibility with 2.7 at this point.
This change restores the 3.6 behavior.
(cherry picked from commit 8ebf5ceb0f)

Co-authored-by: Ned Deily <nad@python.org>
2018-05-23 22:22:46 -04:00
Miss Islington (bot) fa286edbde
bpo-33540: Add block_on_close attr to socketserver (GH-6911)
Add a new block_on_close class attribute to ForkingMixIn and
ThreadingMixIn classes of socketserver to opt-in for pre-3.7 behaviour.
(cherry picked from commit 453bd0bc65)

Co-authored-by: Victor Stinner <vstinner@redhat.com>
2018-05-23 18:34:43 -07:00
Miss Islington (bot) 72ef4fc32b [3.7] bpo-33618: Enable TLS 1.3 in tests (GH-7079) (GH-7082)
TLS 1.3 behaves slightly different than TLS 1.2. Session tickets and TLS
client cert auth are now handled after the initialy handshake. Tests now
either send/recv data to trigger session and client certs. Or tests
ignore ConnectionResetError / BrokenPipeError on the server side to
handle clients that force-close the socket fd.

To test TLS 1.3, OpenSSL 1.1.1-pre7-dev (git master + OpenSSL PR
https://github.com/openssl/openssl/pull/6340) is required.

Signed-off-by: Christian Heimes <christian@python.org>
(cherry picked from commit 529525fb5a)
2018-05-23 22:49:04 +02:00
Miss Islington (bot) 2fc443c469
bpo-32436: Document PEP 567 changes to asyncio. (GH-7073)
(cherry picked from commit 28b9178023)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-05-23 10:59:17 -07:00
Miss Islington (bot) 2751dccca4
bpo-33604: Remove Pending from hmac Deprecation warning. (GH-7062)
bpo-33604: Bump removal notice from 3.6 to 3.8 and change PendingDeprecationWarning to DeprecationWarning as we had intended to do earlier...
(cherry picked from commit 8bb0b5b03c)

Co-authored-by: Matthias Bussonnier <bussonniermatthias@gmail.com>
2018-05-22 16:40:44 -07:00
Miss Islington (bot) cd57b48ef9
bpo-33570: TLS 1.3 ciphers for OpenSSL 1.1.1 (GH-6976)
Change TLS 1.3 cipher suite settings for compatibility with OpenSSL
1.1.1-pre6 and newer. OpenSSL 1.1.1 will have TLS 1.3 cipers enabled by
default.

Also update multissltests and Travis config to test with latest OpenSSL.

Signed-off-by: Christian Heimes <christian@python.org>
(cherry picked from commit e8eb6cb792)

Co-authored-by: Christian Heimes <christian@python.org>
2018-05-22 14:40:46 -07:00
Miss Islington (bot) 736e3b3219 bpo-30940: Updating round() docs. (GH-6342) (GH-7009)
(cherry picked from commit 900c48dba3)

Co-authored-by: Lisa Roach <lisaroach14@gmail.com>
2018-05-20 18:28:15 +03:00
Elvis Pranskevichus 15f3d0cc76 [3.7] bpo-32996: The bulk of What's New in Python 3.7 (GH-6978). (GH-6998)
(cherry picked from commit 63536bd286)

Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
2018-05-19 23:39:45 -04:00
Miss Islington (bot) 436972e295 bpo-19950: Clarify unittest TestCase instance use. (GH-6875) (GH-6938)
(cherry picked from commit dff46758f2)

Co-authored-by: Gregory P. Smith <greg@krypto.org> Google
2018-05-18 17:55:45 -07:00
Miss Islington (bot) 09ca5906b7 bpo-28556: Don't simplify unions at runtime (GH-6841) (GH-6979)
(cherry picked from commit f65e31fee3)

Co-authored-by: Ivan Levkivskyi <levkivskyi@gmail.com>
2018-05-18 16:27:14 -07:00
Miss Islington (bot) f34ade33ee asyncio/docs: Mark asyncio.run() as provisional in 3.7. (GH-6946) (GH-6949)
(cherry picked from commit d8d715f514)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-05-17 15:10:56 -04:00