summaryrefslogtreecommitdiffstats
path: root/Doc/library
Commit message (Collapse)AuthorAgeFilesLines
* bpo-31432: Clarify ssl CERT_NONE/OPTIONAL/REQUIRED docs. (GH-3530) (GH-7649)Miss Islington (bot)2018-06-111-13/+25
| | | | | | | | | | | 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 ef24b6c54d40e7820456873a6eab6ef57d2bd0db) Co-authored-by: Christian Heimes <christian@python.org>
* bpo-30820: Remove incorrect docs for email.contentmanager.raw_data_manager ↵Miss Islington (bot)2018-06-111-9/+0
| | | | | | | | | (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 2c071cebe67f517f191f4074757a79b0f597d886) Co-authored-by: Zackery Spytz <zspytz@gmail.com>
* bpo-33812: Corrected astimezone for naive datetimes. (GH-7578) (GH-7600)Miss Islington (bot)2018-06-101-2/+1
| | | | | | | | | | | | | | | | | | | | | 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 877b23202b7e7d4f57b58504fd0eb886e8c0b377) Co-authored-by: Alexander Belopolsky <abalkin@users.noreply.github.com>
* bpo-33610: Update IDLE Code Context doc entry (GH-7597)Miss Islington (bot)2018-06-101-1/+2
| | | | | | Users can now click on context lines. (cherry picked from commit af4b0130d44bf8a1ff4f7b46195d1dc79add444a) Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* Fix typo in object.__getnewargs__() documentation (GH-7554)Miss Islington (bot)2018-06-101-1/+1
| | | | | (cherry picked from commit 0e0534c4024c181aa47a300142c59eeeee71db46) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* doc: Fix typo in asyncio-eventloop.rst (GH-7345)Miss Islington (bot)2018-06-091-2/+2
| | | | | | This is a fixup to 19a44f63c738388ef3c8515348b4ffc061dfd627 (cherry picked from commit 7e0d882a98169e6d8d1507224b83ff0264c2afee) Co-authored-by: MarcoFalke <falke.marco@gmail.com>
* bpo-33801: Remove non-ordered dict comment from plistlib doc (GH-7495) (GH-7546)Miss Islington (bot)2018-06-081-3/+1
| | | | | (cherry picked from commit 1cbdb2208aa309cf288ee0b53f0ecd85279bb934) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-33800: Fix default argument for parameter dict_type of ↵Miss Islington (bot)2018-06-081-2/+9
| | | | | | | ConfigParser/RawConfigParser (GH-7494) (GH-7542) (cherry picked from commit 3b0b90c8c3b8161f0ae9005b83b9b6449d4a8476) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-33736: Improve the documentation of asyncio stream APIs (GH-7326)Miss Islington (bot)2018-06-082-32/+69
| | | | | (cherry picked from commit c0d062f523b16331444ff910e4596ee5608c8170) Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
* bpo-33798: Update csv document about dict order (GH-7490)Miss Islington (bot)2018-06-081-3/+1
| | | | | (cherry picked from commit 6860629d87d0f6728ff7430453d4900b695adf7b) Co-authored-by: Andrés Delfino <adelfino@gmail.com>
* bpo-31215: Add version changed notes for OpenSSL 1.1.0 compatibility (GH-7346)Miss Islington (bot)2018-06-081-0/+3
| | | | | (cherry picked from commit 9ef1b0690b90c526798b6b3125b0fa7ae98319a2) Co-authored-by: Mayank Singhal <17mayank.singhal@gmail.com>
* bpo-33609: small wording fixes to dict ordering docs (#7497)Miss Islington (bot)2018-06-081-5/+5
| | | | | | A few wording improvements to dict ordering documentation. (cherry picked from commit d3ed67d14ed401dfe2b5d07b6941adc3ecacb268) Co-authored-by: Neil Schemenauer <nas-github@arctrix.com>
* bpo-17909: Document that json.load can accept a binary IO (GH-7366)Miss Islington (bot)2018-06-071-3/+7
| | | | | (cherry picked from commit bb6366bd7570ff3b74bc66095540bea78f31504e) Co-authored-by: Anthony Sottile <asottile@umich.edu>
* update to Unicode 11.0.0 (closes bpo-33778) (GH-7439) (GH-7470)Miss Islington (bot)2018-06-071-4/+4
| | | | | | Also, standardize indentation of generated tables. (cherry picked from commit 7c69c1c0fba8c1c8ff3969bce4c1135736a4cc58) Co-authored-by: Benjamin Peterson <benjamin@python.org>
* bpo-28240: timeit: Update repeat() doc (GH-7419) (GH-7457)Miss Islington (bot)2018-06-061-4/+10
| | | | | | | Document that the default value of repeat changed from 3 to 5 in Python 3.7. (cherry picked from commit 3ef769fcd378a7f1cda19c0dfec2e79613d79e48) Co-authored-by: Victor Stinner <vstinner@redhat.com>
* bpo-32392: Document env keyword argument of subprocess.run() (GH-7289)Miss Islington (bot)2018-06-051-1/+6
| | | | | (cherry picked from commit af1ec97a6d1dde68b2dc0ee9b78965eb219061a8) Co-authored-by: Tobias Kunze <r@rixx.de>
* bpo-33609: Document dict insertion order guarantee as of 3.7 (GH-7093)Miss Islington (bot)2018-06-041-0/+23
| | | | | (cherry picked from commit f822549653d8d09bffff5b7dcddfdf12679a787c) Co-authored-by: INADA Naoki <methane@users.noreply.github.com>
* bpo-27902: Add compatibility note to Profile docs (GH-7295)Miss Islington (bot)2018-06-041-5/+6
| | | | | (cherry picked from commit f7745e1dcb8e8473cc86112a0213b3f244a07230) Co-authored-by: Tobias Kunze <r@rixx.de>
* bpo-33640, uuid.UUID doc: document endian of bytes parameter (GH-7263)Miss Islington (bot)2018-06-041-6/+7
| | | | | | The bytes parameter uses big endian. (cherry picked from commit b75ec0856771b51684b08c4e5068fbfad25c5e83) Co-authored-by: Farhaan Bukhsh <farhaan.bukhsh@gmail.com>
* bpo-33734: asyncio/ssl: a bunch of bugfixes (GH-7321) (GH-7396)Miss Islington (bot)2018-06-041-4/+4
| | | | | | | | | | * 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 9602643120a509858d0bee4215d7f150e6125468) Co-authored-by: Yury Selivanov <yury@magic.io>
* bpo-23495: Correct the documentation for writerows() of csv Writer objects ↵Miss Islington (bot)2018-06-021-2/+3
| | | | | | | | (GH-6316) `writerows()` takes an iterable. (cherry picked from commit a801cf164be7c62b6a6dba47ff91d6c3edb67729) Co-authored-by: Zackery Spytz <zspytz@gmail.com>
* bpo-32519: Removed misleading sentence from EnvBuilder documentation. ↵Miss Islington (bot)2018-06-011-2/+1
| | | | | | | (GH-7296) (#7300) (cherry picked from commit c0d341d49b3ffc8b0037e501c246271be9c69f55) Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
* bpo-33400: Removed references to RFC3339 and ISO8601 from the logging ↵Miss Islington (bot)2018-06-012-12/+12
| | | | | | | documentation. (GH-7297) (GH-7302) (cherry picked from commit 23cee80cfade1a9019c52b3a17d8e5c1b5db17e2) Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
* bpo-33641: Convert RFC references into links. (GH-7103)Miss Islington (bot)2018-05-3118-50/+46
| | | | | | 85% of them are already links. (cherry picked from commit 0a36ac1a09587735237c5978ebd046313922869c) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* bpo-31368: Enhance os.preadv() documentation (GH-7254)Miss Islington (bot)2018-05-301-95/+114
| | | | | (cherry picked from commit 02e2a085dc1740b1cbf4ba2ed77335c84ce8a367) Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
* [3.7] bpo-23859: Document that asyncio.wait() does not cancel its futures ↵Miss Islington (bot)2018-05-301-0/+3
| | | | | | | | | | | | | | (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 f9aeca2085464838f04bf13f816a1f861d43541f) Co-authored-by: Elvis Pranskevichus <elvis@magic.io> * Update asyncio-task.rst
* [3.7] bpo-31639: Change ThreadedHTTPServer to ThreadingHTTPServer class name ↵Julien Palard2018-05-301-2/+2
| | | | | | | | | | (GH-7195) (GH-7219) * [3.7] bpo-31639: Change ThreadedHTTPServer to ThreadingHTTPServer class name (GH-7195). (cherry picked from commit 1cee216cf383eade641aed22f4ec7d4cb565ecff) * Fix whatsnew entry about ThreadedHTTPServer. (GH-7220) (cherry picked from commit a34e424bdbc62b4d83593af1c0d459d8aaac90f3)
* bpo-32751: Wait for task cancellation in asyncio.wait_for() (GH-7216)Miss Islington (bot)2018-05-291-1/+8
| | | | | | | | | | | | | | | | | | | | | | | | | 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 e2b340ab4196e1beb902327f503574b5d7369185) Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
* bpo-32684: Fix gather to propagate cancel of itself with return_exceptions ↵Miss Islington (bot)2018-05-291-0/+4
| | | | | | | (GH-7209) (#7222) (cherry picked from commit 863b6749093a86810c4077112a857363410cc221) Co-authored-by: Yury Selivanov <yury@magic.io>
* bpo-30935: update get_event_loop docs (GH-2731)Miss Islington (bot)2018-05-291-1/+4
| | | | | (cherry picked from commit e55de2d77f10d524be0b426e587fbc820f76de71) Co-authored-by: Mandeep Singh <daxlab@users.noreply.github.com>
* bpo-32911: Revert bpo-29463. (GH-7121)Serhiy Storchaka2018-05-291-4/+0
| | | | | | | 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>
* bpo-32878: Adds documentation for st_ino on Windows (GH-5764) (#7189)Miss Islington (bot)2018-05-291-1/+11
| | | | | (cherry picked from commit 3e51a3d5927c680d5410ff11ff8d5e5bb9ffb1e7) Co-authored-by: Steve Dower <steve.dower@microsoft.com>
* bpo-32610: Fix asyncio.all_tasks() to return only pending tasks. (GH-7174)Miss Islington (bot)2018-05-291-2/+5
| | | | | (cherry picked from commit 416c1ebd9896b394790dcb4f9f035b1a44ebe9ff) Co-authored-by: Yury Selivanov <yury@magic.io>
* bpo-33654: Support BufferedProtocol in set_protocol() and start_tls() (GH-7130)Miss Islington (bot)2018-05-281-5/+12
| | | | | | | | | | | | | 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 dbf102271fcc316f353c7e0a283811b661d128f2) Co-authored-by: Yury Selivanov <yury@magic.io>
* bpo-33400: Clarified documentation to indicate no strict adherence to ISO ↵Miss Islington (bot)2018-05-282-9/+10
| | | | | | | 8601. (GH-6702) (GH-6704) (cherry picked from commit c4994dc00d9828a99510f3851da93b0e1c18361d) Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
* Document typing.NoReturn (GH-7107)Miss Islington (bot)2018-05-251-0/+12
| | | | | (cherry picked from commit 6e413f4327a68c4c7d62e0b6d0f9144be11dd6cd) Co-authored-by: Ivan Levkivskyi <levkivskyi@gmail.com>
* bpo-33109: argparse subparsers are once again not required by default ↵Miss Islington (bot)2018-05-241-1/+1
| | | | | | | | | | | | | | (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 8ebf5ceb0f5408d1ebc26c19702ac0762ef5ea04) Co-authored-by: Ned Deily <nad@python.org>
* bpo-33540: Add block_on_close attr to socketserver (GH-6911)Miss Islington (bot)2018-05-241-2/+7
| | | | | | | 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 453bd0bc65b7ea6a18c43da69143ab10d54c0a35) Co-authored-by: Victor Stinner <vstinner@redhat.com>
* [3.7] bpo-33618: Enable TLS 1.3 in tests (GH-7079) (GH-7082)Miss Islington (bot)2018-05-231-1/+27
| | | | | | | | | | | | | | 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 529525fb5a8fd9b96ab4021311a598c77588b918)
* bpo-32436: Document PEP 567 changes to asyncio. (GH-7073)Miss Islington (bot)2018-05-232-6/+45
| | | | | (cherry picked from commit 28b9178023a445b1da2694774c265cd4b7a244ec) Co-authored-by: Yury Selivanov <yury@magic.io>
* bpo-33604: Remove Pending from hmac Deprecation warning. (GH-7062)Miss Islington (bot)2018-05-221-1/+1
| | | | | | 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 8bb0b5b03cffa2a2e74f248ef479a9e7fbe95cf4) Co-authored-by: Matthias Bussonnier <bussonniermatthias@gmail.com>
* bpo-33570: TLS 1.3 ciphers for OpenSSL 1.1.1 (GH-6976)Miss Islington (bot)2018-05-221-5/+3
| | | | | | | | | | | | 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 e8eb6cb7920ded66abc5d284319a8539bdc2bae3) Co-authored-by: Christian Heimes <christian@python.org>
* bpo-30940: Updating round() docs. (GH-6342) (GH-7009)Miss Islington (bot)2018-05-201-4/+5
| | | | | (cherry picked from commit 900c48dba3f3eb8fb03ea766a5646f81c3bf3e9c) Co-authored-by: Lisa Roach <lisaroach14@gmail.com>
* [3.7] bpo-32996: The bulk of What's New in Python 3.7 (GH-6978). (GH-6998)Elvis Pranskevichus2018-05-202-4/+1
| | | | | (cherry picked from commit 63536bd286097e770909052052a21804a5e09b66) Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
* bpo-19950: Clarify unittest TestCase instance use. (GH-6875) (GH-6938)Miss Islington (bot)2018-05-191-9/+15
| | | | | (cherry picked from commit dff46758f267ad6c13096c69c4e1dee17f9969aa) Co-authored-by: Gregory P. Smith <greg@krypto.org> Google
* bpo-28556: Don't simplify unions at runtime (GH-6841) (GH-6979)Miss Islington (bot)2018-05-181-4/+3
| | | | | (cherry picked from commit f65e31fee3b55dfb6ed5398179d5c5d6b502dee5) Co-authored-by: Ivan Levkivskyi <levkivskyi@gmail.com>
* asyncio/docs: Mark asyncio.run() as provisional in 3.7. (GH-6946) (GH-6949)Miss Islington (bot)2018-05-171-0/+2
| | | | | (cherry picked from commit d8d715f5148d0c10e93a79bc4172fbd9c5b3a86e) Co-authored-by: Yury Selivanov <yury@magic.io>
* bpo-13631: Fix the order of initialization for readline libedit on macOS. ↵Miss Islington (bot)2018-05-171-7/+15
| | | | | | | | | (GH-6915) (GH-6928) The editline emulation needs to be initialized *after* the name is defined. This fixes the long open issue. (cherry picked from commit c2f082e9d164acfa8f96de9526f0f47ae92c426a) Co-authored-by: Zvezdan Petkovic <zpetkovic@acm.org>
* bpo-32216: Update dataclasses documentation (GH-6913) (#6918)Miss Islington (bot)2018-05-161-75/+79
| | | | | (cherry picked from commit 713a9367366c88662c39ed20dd6bce22399299f1) Co-authored-by: Barry Warsaw <barry@python.org>
* [3.7] bpo-32257: Add ssl.OP_NO_RENEGOTIATION (GH-5904) (#6877)Miss Islington (bot)2018-05-161-0/+9
| | | | | | | | | | | The ssl module now contains OP_NO_RENEGOTIATION constant, available with OpenSSL 1.1.0h or 1.1.1. Note, OpenSSL 1.1.0h hasn't been released yet. Signed-off-by: Christian Heimes <christian@python.org> (cherry picked from commit 67c48016638aac9a15afe6fd6754d53d2bdd6b76) Co-authored-by: Christian Heimes <christian@python.org>