Commit Graph

21632 Commits

Author SHA1 Message Date
Miss Islington (bot) bbdf872332
Fix wrong exception reference: BrokenThreadPool -> BrokenProcessPool (GH-9533)
(cherry picked from commit b60b4683f6)

Co-authored-by: Joni Kähärä <joni.kahara@gmail.com>
2018-09-24 20:35:46 -07:00
Christophe Nanteuil 881ddffbff [3.7]Documentation minor update related to 3.6 - 3.7 migration (GH-9501)
Change version from 3.6 to 3.7 in the documentation when it addresses newcomers.

original request from python/python-docs-fr#273
2018-09-24 09:33:44 -07:00
Christian Heimes 394e55a927 [3.7] bpo-17239: Disable external entities in SAX parser (GH-9217) (GH-9511)
The SAX parser no longer processes general external entities by default
to increase security. Before, the parser created network connections
to fetch remote files or loaded local files from the file system for DTD
and entities.

Signed-off-by: Christian Heimes <christian@python.org>

https://bugs.python.org/issue17239.
(cherry picked from commit 17b1d5d4e3)

Co-authored-by: Christian Heimes <christian@python.org>



https://bugs.python.org/issue17239
2018-09-24 05:38:37 -07:00
Christian Heimes 2756ef3165 [3.7] bpo-34670: Add TLS 1.3 post handshake auth (GH-9460) (GH-9505)
Add SSLContext.post_handshake_auth and
SSLSocket.verify_client_post_handshake for TLS 1.3 post-handshake
authentication.

Signed-off-by: Christian Heimes <christian@python.org>q

https://bugs.python.org/issue34670.
(cherry picked from commit 9fb051f032)

Co-authored-by: Christian Heimes <christian@python.org>



https://bugs.python.org/issue34670
2018-09-23 00:22:52 -07:00
Ethan Furman 0c076caaa8
[3.7] bpo-29577: Enum: mixin classes don't mix well with already mixed Enums (GH-9328) (GH-9486)
* bpo-29577: allow multiple mixin classes
2018-09-21 22:26:32 -07:00
Miss Islington (bot) e45662c28b bpo-33649: Fix gather() docs; fix title; few other nits. (GH-9475) (GH-9481)
(cherry picked from commit db1a80e97a)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-09-21 16:35:34 -04:00
Miss Islington (bot) 914086aa2f
Make docs of exitcode for subprocess.getstatusoutput more clear. (GH-9477)
Make it more accurate and not limited to UNIX.
(cherry picked from commit 7d161726e4)

Co-authored-by: Xiang Zhang <angwerzx@126.com>
2018-09-21 13:34:46 -07:00
Miss Islington (bot) 187f2dd256
bpo-34762: Fix contextvars C API to use PyObject* pointer types. (GH-9473)
(cherry picked from commit 2ec872b31e)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-09-21 12:48:10 -07:00
Miss Islington (bot) 8e5ef58c10
bpo-33649: More improvements (GH-9439)
(cherry picked from commit e247b46cba)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-09-20 09:57:19 -07:00
Miss Islington (bot) 4fe8dc6857
bpo-34746: Fix stop -> close (GH-9437)
(cherry picked from commit ffef50f1f5)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-09-19 22:21:08 -07:00
Yury Selivanov 581890cda3
bpo-34733: Return of the docs search bar (GH-9431)
Partially revert changes to Doc/tools/templates/layout.html
accidentally committed in 512d710109.
2018-09-19 17:51:17 -04:00
Miss Islington (bot) d9c89111bd
bpo-34712: Fix style in examples in "Input and Output" (GH-9361)
A couple of fixes here to make this more PEP-8:

* Avoid multiple statements on one line with `;` statement separator -- this is very rare in Python and is "generally discouraged" in PEP 8 (and if used, per PEP 8 there shouldn't be a space before the `;`)
* Add output for the first "Formatted String Literals" example. (Side note: are the doctests for this being run? If so, why didn't it fail?)
* Avoid space before `!r`. I have generally not seen spaces before the `!`, and this also matches the style used in the docs here: https://docs.python.org/3/library/string.htmlGH-format-string-syntax

https://bugs.python.org/issue34712
(cherry picked from commit 3705b98620)

Co-authored-by: Ben Hoyt <benhoyt@gmail.com>
2018-09-19 13:30:40 -07:00
Victor Stinner 95cc3ee00c
Revert "[3.7] bpo-34589: Add -X coerce_c_locale option; C locale coercion off by default (GH-9379)" (GH-9416)
This reverts commit 144f1e2c6f.
2018-09-19 12:01:52 -07:00
Miss Islington (bot) 73c0006e71
bpo-33649: Add a high-level section about Futures; few quick fixes (GH-9403)
Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
(cherry picked from commit 471503954a)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-09-18 15:09:51 -07:00
Miss Islington (bot) 45452b738b
bpo-33649: Fix markup; add another note that asyncio.run is 3.7+ (GH-9389)
(cherry picked from commit b042cf10c6)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-09-18 00:00:58 -07:00
Miss Islington (bot) ee2ff1a335 Fix syntax error on Asyncio example in doc (GH-9387) (GH-9388)
The `gather` method requires to close the parenthesis, but it is being closed twice.
(cherry picked from commit 9c53fa6ad9)

Co-authored-by: Miguel Ángel García <magmax@users.noreply.github.com>
2018-09-18 02:27:27 -04:00
Miss Islington (bot) 9a89fd6884 Change "set_after" reference to `say_after`. (GH-9384) (GH-9386)
(cherry picked from commit 7bfbda46f4)

Co-authored-by: Danny Hermes <daniel.j.hermes@gmail.com>
2018-09-18 02:27:07 -04:00
Miss Islington (bot) 1f4ea58067
bpo-33649: Note that asyncio.run() calls shutdown_asyncgens() (GH-9380)
(cherry picked from commit ac94e38d07)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-09-17 21:12:05 -07:00
Victor Stinner 144f1e2c6f
[3.7] bpo-34589: Add -X coerce_c_locale option; C locale coercion off by default (GH-9379)
* bpo-34589: Make _PyCoreConfig.coerce_c_locale private (GH-9371)

_PyCoreConfig:

* Rename coerce_c_locale to _coerce_c_locale
* Rename coerce_c_locale_warn to _coerce_c_locale_warn

These fields are now private (name prefixed by "_").

(cherry picked from commit 188ebfa475)

* bpo-34589: C locale coercion off by default (GH-9073)

Py_Initialize() and Py_Main() cannot enable the C locale coercion
(PEP 538) anymore: it is always disabled. It can now only be enabled
by the Python program ("python3).

test_embed: get_filesystem_encoding() doesn't have to set PYTHONUTF8
nor PYTHONCOERCECLOCALE, these variables are already set in the
parent.

(cherry picked from commit 7a0791b699)

* bpo-34589: Add -X coerce_c_locale command line option (GH-9378)

Add a new -X coerce_c_locale command line option to control C locale
coercion (PEP 538).

(cherry picked from commit dbdee0073c)
2018-09-17 18:01:39 -07:00
Yury Selivanov 512d710109
bpo-33649: Backport asyncio docs from 'master' to 3.7 (GH-9377) 2018-09-17 19:35:30 -04:00
Miss Islington (bot) c63d81b3fe
bpo-34717: Stop numbering stdlib titles/sections in the docs (GH-9370)
(cherry picked from commit c62ab2862d)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-09-17 15:42:09 -07:00
Miss Islington (bot) f8e34eee74
bpo-33216: Improve the documentation for CALL_FUNCTION_* (GH-8338) (GH-8784)
(cherry picked from commit 5e99b56d6b)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2018-09-17 06:09:32 -07:00
Miss Islington (bot) c83c375ed9 bpo-32933: Implement __iter__ method on mock_open() (GH-5974)
(cherry picked from commit 2087023fde)

Co-authored-by: Tony Flury <anthony.flury@btinternet.com>
2018-09-15 00:30:04 +03:00
Miss Islington (bot) b2ecb8b486 Fix "Python" casing in a few places (GH-9001) (GH-9313)
(cherry picked from commit 271818fe27)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-09-14 12:15:10 -07:00
Miss Islington (bot) ca2fa2841f
closes bpo-28955: Clarified comparisons between NaN and number in reference documentation (GH-5982)
Co-authored-by: Benjamin Peterson <benjamin@python.org>
(cherry picked from commit ad8a000420)

Co-authored-by: Tony Flury <anthony.flury@btinternet.com>
2018-09-14 11:05:38 -07:00
Miss Islington (bot) a8f189f457 Note that distinct argument patterns can be cached separately (GH-9298) (GH-9299)
(cherry picked from commit 902bcd9a1e)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2018-09-14 01:13:17 -07:00
Miss Islington (bot) 305056494d
bpo-34247: add porting note to 3.7 What's New (GH-9223)
(cherry picked from commit 66755cbb1e)

Co-authored-by: Ned Deily <nad@python.org>
2018-09-13 12:14:46 -07:00
Miss Islington (bot) b608fcd444
closes bpo-34004: Skip lock interruption tests on musl. (GH-9224)
Returning EINTR from pthread semaphore or lock acquisition is an optional POSIX
feature. musl does not provide this feature, so some threadsignal tests fail
when Python is built against it.

There's no good way to test for musl, so we skip if we're on Linux and not using
glibc pthreads.

Also, hedge in the threading documentation about when we can provide interrupts
from lock acquisition.
(cherry picked from commit 5b10d5111d)

Co-authored-by: Benjamin Peterson <benjamin@python.org>
2018-09-12 14:10:56 -07:00
Benjamin Peterson cadb66e173
[3.7] closes bpo-25041: Document AF_PACKET socket address format. (GH-9207)
(cherry picked from commit 731ff68eee)

Co-authored-by: Cheryl Sabella <cheryl.sabella@gmail.com>
2018-09-11 18:46:36 -07:00
Miss Islington (bot) e2b40f4ce9
bpo-34365: Update date object documentation (GH-8814)
Python 3.x does not fall back to comparing object addresses when comparing two `dt` objects.

<!-- issue-number: [bpo-34365](https://www.bugs.python.org/issue34365) -->
https://bugs.python.org/issue34365
<!-- /issue-number -->
(cherry picked from commit 9c223794c7)

Co-authored-by: Danish Prakash <grafitykoncept@gmail.com>
2018-09-11 14:24:53 -07:00
Miss Islington (bot) e02ca4270e
bpo-34613: document the correct value of limit argument of asyncio.StreamReader (GH-9121)
The default value of asyncio.StreamReader *limit* is `_DEFAULT_LIMIT` instead of `None`.

<!-- issue-number: [bpo-34613](https://www.bugs.python.org/issue34613) -->
https://bugs.python.org/issue34613
<!-- /issue-number -->
(cherry picked from commit b4ec36200a)

Co-authored-by: Bram <cortex@worlddomination.be>
2018-09-11 11:59:29 -07:00
Miss Islington (bot) 3e648f8371
bpo-28617 Fixed docs inaccuracies about the types that support membership tests (GH-9086)
<!-- issue-number: [bpo-28617](https://www.bugs.python.org/issue28617) -->
https://bugs.python.org/issue28617
<!-- /issue-number -->
(cherry picked from commit 08bcf647d8)

Co-authored-by: wim glenn <wim.glenn@gmail.com>
2018-09-11 11:13:33 -07:00
Miss Islington (bot) c9ece5f4a9
closes bpo-33883: Mention type checkers in the FAQ. (GH-7760)
(cherry picked from commit a378254186)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-09-10 22:27:00 -07:00
Miss Islington (bot) 2110f78d92
bpo-33032: Mention the implicit cache in struct.Struct() docs (GH-7700)
Mention the implicit cache in struct.Struct() docs.

Consistent with the re.compile documentation note.
(cherry picked from commit 3666b3c1f6)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2018-09-10 21:50:41 -07:00
Miss Islington (bot) 6df2005b39 Fix missing line from example shell session (GH-9143) (GH-9155)
(cherry picked from commit 2064bb6d57)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2018-09-10 19:13:02 -07:00
Miss Islington (bot) 037582eb7f
bpo-33460: remove ellipsis that look like continuation prompts (GH-7851)
Remove ellipsis that look like continuation prompts,
has a side benefit of putting rest of error message in proper text color.
(cherry picked from commit f019579828)

Co-authored-by: Lew Kurtz <37632626+lew18@users.noreply.github.com>
2018-09-10 18:49:39 -07:00
Miss Islington (bot) f3d00ae3be
switch descriptor howto to return value annotation (GH-7796)
(cherry picked from commit 28ea4c2847)

Co-authored-by: NotAFile <notafile@gmail.com>
2018-09-10 17:44:58 -07:00
Miss Islington (bot) 011141f312
closes bpo-34525: Fix smtplib's authobject() documentation (GH-8965)
(cherry picked from commit 78deb7f332)

Co-authored-by: Sebastian Rittau <srittau@rittau.org>
2018-09-10 11:13:13 -07:00
Miss Islington (bot) 9c9ac9e697
Revert "Fix misindented yaml in logging how to example (GH-8604)" (GH-9081)
This reverts commit 10b59f1b01.
(cherry picked from commit 290a60bd8a)

Co-authored-by: Rémy HUBSCHER <hubscher.remy@gmail.com>
2018-09-10 02:13:18 -07:00
Miss Islington (bot) 9835696ec4
bpo-34246: Use no mutable default args in smtplib (GH-8554)
Some methods of the SMTP class use mutable default arguments. Specially
`send_message` is affected as it mutates one of the args by appending items
to it, which has side effects on further calls.
(cherry picked from commit d5fbe9b1a3)

Co-authored-by: Pablo Aguiar <scorphus@gmail.com>
2018-09-07 15:29:27 -07:00
Miss Islington (bot) 854b740910 Doc: Missing 'f' in an f-string. (GH-9074) (GH-9095)
(cherry picked from commit 25fa141487)

Co-authored-by: Julien Palard <julien@palard.fr>
2018-09-07 11:59:00 +02:00
Miss Islington (bot) f4c865eda8
Fix struct sequence glossary entry grammar (GH-9030)
... by removing a superfluous "either".

Reported by Никита Люшненко on docs@.
(cherry picked from commit 98b976a2f8)

Co-authored-by: Zachary Ware <zachary.ware@gmail.com>
2018-09-01 22:13:34 -04:00
Miss Islington (bot) fa3fd4cb18
bpo-34434: Update doc for bool(), float() and int() arguments (GH-8834)
(cherry picked from commit 3fe89dac42)

Co-authored-by: Louis Sautier <sautier.louis@gmail.com>
2018-08-27 06:58:56 -04:00
Miss Islington (bot) 42a1ca65d0
closes bpo-34502: Remove a note about utf8_mode from sys.exit() docs. (GH-8928)
(cherry picked from commit 44838be9f7)

Co-authored-by: Alexey Izbyshev <izbyshev@ispras.ru>
2018-08-25 14:36:18 -04:00
Miss Islington (bot) 6dc8f05437
Fix markup in stdtypes documentation (GH-8905)
(cherry picked from commit 2e5d2ea208)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-08-25 10:22:00 -04:00
Miss Islington (bot) 1f9621cb9b
Fixed typo with asynccontextmanager code example (GH-8845)
`yield conn`, instead of just `yield`.
(cherry picked from commit 416cbce22d)

Co-authored-by: Alexander Vasin <hi@alvass.in>
2018-08-24 22:51:10 -04:00
Miss Islington (bot) 7b0ed43af5 bpo-33550: Warn not to set SIGPIPE to SIG_DFL (GH-6773)
(cherry picked from commit a2510732da)

Co-authored-by: Alfred Perlstein <alfred@freebsd.org>
2018-08-24 19:28:58 -07:00
Miss Islington (bot) a8c749df59 Fix typo in the dataclasses's doc (GH-8896) (GH-8897)
(cherry picked from commit 075b3c3259)

Co-authored-by: Daniel Dương <dduong42@users.noreply.github.com>
2018-08-24 05:37:19 -04:00
Miss Islington (bot) 1d3d688b98
Fix doc for `add_subparsers` arguments (GH-8884)
There was a missing comma.
(cherry picked from commit cc18258daf)

Co-authored-by: Anthony Sottile <asottile@umich.edu>
2018-08-23 23:22:17 -04:00
Miss Islington (bot) 609c033f43
Fix typo in asyncio.BoundedSemaphore docs (GH-8882)
semapthores -> semaphores
(cherry picked from commit b8a181f4ae)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2018-08-23 22:03:23 -04:00
Miss Islington (bot) 1f7d0470c2
Make it more clear that setUpClass runs before each class, not "class run" (GH-8844)
(cherry picked from commit c33bb5d401)

Co-authored-by: Ville Skyttä <ville.skytta@iki.fi>
2018-08-23 11:02:46 -04:00
Miss Islington (bot) 0e1e8dbb0b
bpo-22057: Clarify eval() documentation (GH-8812)
If a globals dictionary without a '__builtins__' key is passed to
eval(), a '__builtins__' key will be inserted to the dictionary:

    >>> eval("print('__builtins__' in globals())", {})
    True

(As a result of this behavior, we can use the builtins
print() and globals() even if we passed a dictionary without a
'__builtins__' key to eval().)
(cherry picked from commit 225b055480)

Co-authored-by: Berker Peksag <berker.peksag@gmail.com>
2018-08-19 06:29:50 -04:00
Miss Islington (bot) 0fd6f832a9 bpo-34432: doc Mention complex and decimal.Decimal on str.format note about locales (GH-8808) (GH-8809)
(cherry picked from commit 93b5655c04)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-08-18 14:16:36 -04:00
Miss Islington (bot) 05d89ef785
bpo-34418: Fix HTTPErrorProcessor documentation (GH-8793)
The http_response() and https_response() methods of the HTTPErrorProcessor
class have two required parameters, 'request' and 'response'.
(cherry picked from commit c53aaec793)

Co-authored-by: Sebastian Rittau <srittau@rittau.org>
2018-08-17 06:02:08 -04:00
Miss Islington (bot) 6c14060977
smtplib documentation fixes (GH-8708)
* SMTP.startssl: Fix doc on keyfile and certfile use

* SMTP.startssl: Add missing keyfile and certfile deprecation notice

* SMTP: Doc grammar fixes
(cherry picked from commit da12063f2f)

Co-authored-by: Ville Skyttä <ville.skytta@iki.fi>
2018-08-12 21:06:22 -07:00
Miss Islington (bot) 393151e241
Fix misindented yaml in logging how to example (GH-8604)
(cherry picked from commit 10b59f1b01)

Co-authored-by: Rémy HUBSCHER <hubscher.remy@gmail.com>
2018-08-12 17:04:44 -07:00
Miss Islington (bot) 7e0153e166
Fix the versionadded indentation in exec_module doc (GH-8719)
(cherry picked from commit 65b5ef02ec)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-08-12 00:01:21 -07:00
Miss Islington (bot) 6b14508522
bpo-34379: Doc: Move note for json.dump (GH-8730)
(cherry picked from commit 9e84084851)

Co-authored-by: Evan Allrich <eallrich@gmail.com>
2018-08-11 01:02:03 -07:00
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) 426135b674
Improve grammar of asynchronous iterator glossary entry (GH-8657)
(cherry picked from commit cf2c5e8e28)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-08-09 09:08:49 -07:00
Miss Islington (bot) fe8f90aa3c
bpo-34324: Doc README wrong directory name for venv (GH-8650)
In the documentation, the `env` directory is specified when we execute
the `make venv` command. But in the code, `make venv` will create the
virtualenv inside the `venv` directory (defined by `VENVDIR`)
(cherry picked from commit 599bfa18f8)

Co-authored-by: Stéphane Wirtel <stephane@wirtel.be>
2018-08-09 08:10:27 -07:00
Miss Islington (bot) 292030354a
Make code examples in Functional Programming HOWTO to be PEP 8 compliant. (GH-8646)
(cherry picked from commit db8707c8ab)

Co-authored-by: Sergey Fedoseev <fedoseev.sergey@gmail.com>
2018-08-07 14:56:25 -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) b481aeeff7
Fix HTML formatting in datamodel.rst (GH-8693)
(cherry picked from commit 3c1b590472)

Co-authored-by: Berker Peksag <berker.peksag@gmail.com>
2018-08-06 14:12:37 -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) 34f59a7a78
bpo-34317: Fix a dead url to Windows documentation (GH-8622)
(cherry picked from commit 46ebe61c7f)

Co-authored-by: HiyashiChuka <41299525+hiyashichuka@users.noreply.github.com>
2018-08-02 20:29:39 -07:00
Miss Islington (bot) 66ff9d270c
Update list.remove(x) documentation (GH-8636)
Rephrase it to "It raises a `ValueError`"
(cherry picked from commit bcd1d971b6)

Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com>
2018-08-02 20:03:19 -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
Miss Islington (bot) a621f40640
bpo-27671: Update FAQ about why len is function (GH-8432)
(cherry picked from commit c48e26dcad)

Co-authored-by: INADA Naoki <methane@users.noreply.github.com>
2018-07-30 22:54:25 -07:00
Miss Islington (bot) 399b47fdf6
Use 'for example' instead of 'in other words' in compound statement doc (GH-8401)
(cherry picked from commit 6921ef7bef)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-30 12:30:31 -07:00
Miss Islington (bot) a060518204
Fix typos & formatting in Using Python on Windows doc (GH-8559)
(cherry picked from commit 8e7e8bd898)

Co-authored-by: Segev Finer <segev208@gmail.com>
2018-07-30 11:09:22 -07: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) 78c54de575 bpo-33666: Add what's new entry for os.errno removal (GH-8497) (GH-8526)
(cherry picked from commit 1d2dafa249)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: INADA Naoki <methane@users.noreply.github.com>
2018-07-29 10:39:48 +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) 21ed29ac29
bpo-12743: Delete comment from marshal.rst (GH-8457)
Also, update the list of exceptions that may raised by PyMarshal_*
functions. We usually don't document exceptions raised by a
function, but in this case most of them were already documented
in C API and standard library documentation.
(cherry picked from commit defcffdf86)

Co-authored-by: Berker Peksag <berker.peksag@gmail.com>
2018-07-26 21:40:37 -07:00
Miss Islington (bot) ec02c58f5a bpo-28677: Improve phrasing of when instance attribute is referenced (GH-6208)
(cherry picked from commit c0f0a7669c)

Co-authored-by: Aaron Ang <aaronang@users.noreply.github.com>
2018-07-25 20:52:18 +03: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) 49abd307d2 bpo-34161: Remove extra parentheses in output formatting tutorial (GH-8350)
The parentheses were incorrect.
(cherry picked from commit cb5f3fdb9d)

Co-authored-by: Aaqa Ishtyaq <aaqaishtyaq@gmail.com>
2018-07-20 13:38:06 -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) 151820e7a0
bpo-34083: Update dict order in Functional HOWTO (GH-8230)
(cherry picked from commit 5e5bbbec46)

Co-authored-by: Stig Johan Berggren <stigjb@gmail.com>
2018-07-11 04:21:52 -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) c87b1aabbd
Fix documentation for input and output tutorial (GH-8231)
The ValueError message ends with a period.
(cherry picked from commit 9cffdbffc3)

Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com>
2018-07-10 17:51:03 -07:00
Miss Islington (bot) 5cca6f9fbe
bpo-34009: Expand on platform support changes (GH-8022)
Many users won't realise the implications the OpenSSL 1.0.2
minimum version requirement has when it comes to Ubuntu
14.04 and Debian 8, so expand on that in the platform support
section.

Also explicitly note the non-ASCII-based locale requirement for
full Unicode text handling support on non-Windows systems.
(cherry picked from commit 5fe7c98a54)

Co-authored-by: Nick Coghlan <ncoghlan@gmail.com>
2018-07-10 06:24:06 -07: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
Miss Islington (bot) 80a5f04592
bpo-28626: rearrange discussion of output formatting to encourage f-strings (GH-6036)
The 'output formatting' section of the tutorial talks a lot about manual formatting with things like .rjust() and .zfill(), with only a passing reference to 3.6's new f-strings.

This doesn't drop all of the old material, but it does rearrange the topics into a more modern order: f-strings first, discussing formatting specifiers a bit; then calling .format(); finally manual formatting with .ljust().
(cherry picked from commit ced350b195)

Co-authored-by: Andrew Kuchling <amk@amk.ca>
2018-07-09 06:52:48 -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) 21fe81c1fe
bpo-33888: Use CPython instead of Python in the FAQ (GH-7767)
Make the change where discussing the CPython implementation of lists and dicts.
(cherry picked from commit 8d41278045)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-07 16:42:33 -07: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) 80c188f3ef
bpo-33702: Add some missing links in production lists and do a little polish (GH-7259)
(cherry picked from commit caccca78e4)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-07-07 14:09:09 -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
Julien Palard e6f7ee01eb
Update Stackless Python wiki URL (GH-8072)
It was moved from bitbucket to GitHub.

(cherry picked from commit a6e1e41e05)
2018-07-06 11:33:02 +02:00
Miss Islington (bot) 4881360d1f
Removed unused import from tzinfo_examples.py. (GH-7994)
(cherry picked from commit 3a9bb5f269)

Co-authored-by: Sergey Fedoseev <fedoseev.sergey@gmail.com>
2018-07-04 22:08:26 -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
Miss Islington (bot) 4d02ad856f
bpo-34006: Revert line length limit for Windows help docs (GH-8051)
The line-length limit is not needed because the pages appear in a separate app rather
 than on a browser tab.  It can also interact badly with the DPI setting.
(cherry picked from commit d824ca7f4d)

Co-authored-by: Zachary Ware <zachary.ware@gmail.com>
2018-07-02 15:23:22 -07: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) 48dc7527e3
bpo-32996: Enhancements to What's New based on feedback (GH-7988)
(cherry picked from commit 4d26c8a177)

Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
2018-06-28 09:14:52 -07:00
Miss Islington (bot) 702d43cab6
bpo-33958: Doc: Remove unused variable in example (GH-7927)
(cherry picked from commit 62b6cea6b8)

Co-authored-by: Srinivas Reddy Thatiparthy (శ్రీనివాస్ రెడ్డి తాటిపర్తి) <srinivasreddy@users.noreply.github.com>
2018-06-27 23:41:29 -07:00
Ned Deily 933c4513c6 Python 3.7.0
-----BEGIN PGP SIGNATURE-----
 
 iQIzBAABCgAdFiEEDZbfTUEQ5cQ/v7F/LTR+pqplQh0FAlszAEkACgkQLTR+pqpl
 Qh3umg//a3eSst508H59PVuPoiQv4JeX4lvV2WMy//51qk47tlgdJp8OXcYM6Y11
 uCrQSTFVJaRu+/gBiPgT4yiXdCh/DsphLhqsgm1vSlzego+J+hkdREelUeWKhX/X
 Pyu2GbOwxtyOfaWjyRNEtT2/8XdCBjo4dw68p2JvlQ65X/duCHM3dp4PIL2u5CHH
 5/DeBrqLBWyYUwumyWFx4z5PrTN1EmO8yR6B9F0u518k1pgTqd7flRefHwyd2jzA
 S9F7JgUgyTiwO3FmjylIem9uLgOyWuldH+czsAqyEmodo7jb4ekxv+jVMiLStt2r
 Ct/yxx+rPNjhtJZtiWUd6gl6Z5Z9tLx7qc13RoryijFhiUD/G8gFx28wVMExzW05
 fkNKNHNhM0iN4L1FCZuyLxFri8BX9gdpmY6XEuKffzhiGjcwnf0kMn5p5pmWrQbX
 vXnvtOabXqr71jNDy4SbzI+CsTQcTSQYkVAZiPOwBjjt/cKhyUO6B5NHA8A3MYxK
 Uevqr6rUC2x7rrTCh9lroJ7Npg8q3R1e6rd57MVumQlnyl8LQR5jpNuwcQjcV7Go
 IsIZ3VYVUYRJh1a2dTI3Cu6Z3RbFVbLChWGVTQ3kxd9pZ8oRx8Ts49BteUxo5VcY
 XQnMxIOifWAFkc5Y/yT5IiS+IXtQm8xqkpwsg6kfP5dI8/dxMQo=
 =jOsP
 -----END PGP SIGNATURE-----

Merge 3.7.0 final changes
2018-06-27 18:23:18 -04:00
Miss Islington (bot) 79f70cee7b
use rich markup for PEP reference (GH-7939)
it's better to refer to PEP with `pep` role in reStructuredText. It also links to the PEP page.
(cherry picked from commit df748c20da)

Co-authored-by: Behzad B. Mokhtari <35877268+perplexionist@users.noreply.github.com>
2018-06-26 21:17:14 -07:00
Ned Deily 1bf9cc5093 3.7.0 final 2018-06-26 23:07:35 -04:00
Miss Islington (bot) 2d10166998 Fix nested list in 3.7 What's New (GH-7659) (GH-7660)
(cherry picked from commit 5a98209180)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-26 19:52:17 -04:00
Miss Islington (bot) 829b7669f0
bpo-33957: Doc: Use better wording (GH-7912)
(cherry picked from commit 866c168a5f)

Co-authored-by: Srinivas Reddy Thatiparthy (శ్రీనివాస్ రెడ్డి తాటిపర్తి) <srinivasreddy@users.noreply.github.com>
2018-06-26 01:47:10 -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) 070c91e465
bpo-33887: Add TOC to Design and History FAQ(GH-7766)
(cherry picked from commit 38cf49bf69)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-23 11:43:43 -07:00
Miss Islington (bot) f47d8983fe
bpo-33877: Remove UNIX qualification for running complete programs (GH-7744)
The statement is true for Windows (and macOS) also.
(cherry picked from commit c9d43c702a)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-22 14:51:07 -07: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) 380a2b09e8
bpo-33571: Improve the glossary description for '...' prompt (GH-6971)
Mention that it can be triggered by triple quotes and after specifying decorators.
(cherry picked from commit 6868003514)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 21:03:20 -07:00
Miss Islington (bot) 5a0bf74d4e
bpo-33836: Recommend keyword-only param for memoization in FAQ (GH-7687)
Update the the signature in the code example to make `_cache` a keyword-only parameter.
(cherry picked from commit 2707e41a5c)

Co-authored-by: Noah Haasis <haasis_noah@yahoo.de>
2018-06-15 20:46:30 -07:00
Miss Islington (bot) 18793e1f60 Improve the grammar in the glossary item for `list`
" ... access to elements is O(1)."

(cherry picked from commit 7469ff5017)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 20:00:36 -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) c05c0e045c
bpo-33847: Add '@' operator entry to index (GH-7669)
(cherry picked from commit 695118600f)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 12:42:30 -07:00
Miss Islington (bot) 0113391e3f
bpo-33852: Remove misplaced parentheses around 'list'. (GH-7672)
'expresson list' refers to the grammar term 'expression_list' in the subscription production.
(cherry picked from commit 4fddd4e406)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 11:45:37 -07: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) 66cea5cb1b Fix nested list in 3.7 What's New (GH-7659) (GH-7660)
(cherry picked from commit 5a98209180)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-12 05:02:53 -04:00
Miss Islington (bot) ef5f4ba96e bpo-25612: Add minimal What's New in 3.7 entry (GH-7656) (GH-7658)
(cherry picked from commit 04290cb994)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-12 00:26:30 -04: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) 60c699374c
bpo-33656: Add entry to What's New 3.7. (GH-7638)
This is a separate PR because this does not backport to 3.6.
(cherry picked from commit 8a05f559ce)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-11 11:45:49 -07:00
Miss Islington (bot) 144a8670f2
bpo-33656: On Windows, add API call saying that tk scales for DPI (GH-7137)
On Windows 8.1+ or 10, with DPI compatibility properties of the Python binary
unchanged, and a monitor resolution greater than 96 DPI, this should
make text and lines sharper. It should otherwise have no effect.

Using a magnifier, I determined that the improvement comes from horizontal and
lines being better lined up with the monitor pixels. I checked that this call causes
no problem on any Windows buildbot, including the Win7 buildbots. Unlike most
IDLE patches, this one can be easily reverted by users by removing a few lines,
at the top of idlelib/pyshell.py.
(cherry picked from commit 800415e3df)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-11 11:35:13 -07:00
Miss Islington (bot) 904cdbaa9b
bpo-33831: Make htmlview run again (GH-7628)
(cherry picked from commit 0e5f901508)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-11 10:16:03 -07: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) 144493dd7f bpo-23404: Update/sync What's New files for 3.6/3.5/2.7 (GH-7620) (GH-7621)
(cherry picked from commit 9d6171ded5)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-11 04:18:49 -04:00
Miss Islington (bot) 14a190c882
bpo-33745: Add What's New for empty function docstring change. (GH-7611)
(cherry picked from commit 12c6cdf4d1)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-10 20:00:17 -07:00
Miss Islington (bot) a73399d596 bpo-33109: Remove now-obsolete What's New entry for bpo-26510. (GH-7609) (GH-7610)
(cherry picked from commit ef057bfb06)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-10 22:30:57 -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) 3da01813c8
bpo-33820: Fix IDLE What's New typo (GH-7594)
(cherry picked from commit 820c53ac61)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-10 12:26:44 -07:00
Miss Islington (bot) 1ed8294924
bpo-33821: Update idlelib subsection of What's New 3.7 (GH-7590)
(cherry picked from commit 222f7f4033)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-10 11:35:22 -07:00
Miss Islington (bot) 953d300ffa
bpo-33820: Update idlelib subsection of What's New 3.6 (GH-7589)
(cherry picked from commit e226eb7157)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-10 11:30:28 -07:00
Miss Islington (bot) 082920026a
Remove hyphens from phrase "picks up where it left off" (GH-7410)
(cherry picked from commit d689f97619)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-09 19:00:36 -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) 0cf58f494c
bpo-33766: Document that end of file or string is a newline (GH-7383)
(cherry picked from commit 0aa17ee6a7)

Co-authored-by: Ammar Askar <ammar_askar@hotmail.com>
2018-06-09 17:05:49 -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) dd613cf335
bpo-33409: Clarify PEP 538/540 relationship (GH-7534)
While locale coercion and UTF-8 mode turned out to
be complementary ideas rather than competing ones,
it isn't immediately obvious why it's useful to
have both, or how they interact at runtime.

This updates both the Python 3.7 What's New doc
and the PYTHONCOERCECLOCALE and PYTHONUTF8
documentation in an attempt to clarify that
relationship:

- in the respective What's New sections, add a closing paragraph
  explaining which problem each one solves, and pointing to the
  other PEP's section for the specific aspects it relies on the other
  PEP to solve
- use "locale-aware mode" as a more descriptive term for the
  default non-UTF-8 mode
- improve wording conistenccy between the PYTHONCOERCECLOCALE
  and PYTHONUTF8 docs when they cover the same thing (mostly
  related to legacy locale detection and setting the standard
  stream error handler)
- improve the description of the locale coercion trigger conditions
  (including pointing out that setting LC_ALL turns off locale coercion)
- port the full description of the UTF-8 mode behaviour changes
  from PEP 540 into the PYTHONUTF8 documentation
- be explicit that PYTHONIOENCODING still overrides the settings
  for the standard streams
- mention concrete examples of things that do and don't get their
  text encoding assumptions adjusted by the two text encoding
  assumption override techniques
(cherry picked from commit 1bcb8a6368)

Co-authored-by: Nick Coghlan <ncoghlan@gmail.com>
2018-06-09 00:13:53 -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) 5c7f22c2a3 bpo-33799: Remove non-ordered dicts comments from FAQ (GH-7520)
(cherry picked from commit 396ecb9c3e)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-08 14:43:14 -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) 0738443a5b
bpo-33792: Add selector and proactor windows policies (GH-7487)
(cherry picked from commit 8f4042964d)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-06-07 18:31:50 -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) 942b7ff11a
update 3.7 whatsnew entry about Unicode version (GH-7480)
Followup to 4705ea38c9 and bpo-33778.
(cherry picked from commit 34b734699b)

Co-authored-by: Benjamin Peterson <benjamin@python.org>
2018-06-07 07:50:33 -07: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) 57f1f5b91b
Fix typo in datamodel.rst (GH-6964)
This is a simple grammatical fix correcting "...object whose `__self__` attributes is ..." to "...object whose `__self__` attribute is ...".
(cherry picked from commit 00818c8ffd)

Co-authored-by: Zach Mitchell <zmitchell@users.noreply.github.com>
2018-06-02 07:53:30 -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) 5191892c29 3.6 what's new: fix a reference to PEP 528 (GH-7113) (#7256)
(cherry picked from commit 495e567a2b)

Co-authored-by: Dmitry Shachnev <mitya57@users.noreply.github.com>
2018-05-30 19:09:00 -04:00
Miss Islington (bot) ea1982a475
bpo-33696: Install python-docs-theme even if SPHINXBUILD is defined (GH-7242)
(cherry picked from commit 05f1c8902c)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-05-30 10:32:33 -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) 1827615500
bpo-33670: Expose Sphinx errorlevel (GH-7156)
(cherry picked from commit 8c1ad0c4f6)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-05-28 18:45:34 -07:00