Null merge

Fixed a bug in os.walk() with bytes path on Windows caused by merging fixes
for issues #25995 and #25911.

Issue #25913: Leading <~ is optional now in base64.a85decode() with adobe=True.
Patch by Swati Jaiswal.

Issue #25913: Leading <~ is optional now in base64.a85decode() with adobe=True.
Patch by Swati Jaiswal.

Issue #5824: Merge socketserver tests from 3.5

Issue #5824: Fix DatagramRequestHandler tests by binding the client socket

Issue #22088: Merge base64 docs from 3.5

Issue #22088: Clarify base-64 alphabets and which characters are discarded

* There are only two base-64 alphabets defined by the RFCs, not three
* Due to the internal translation, plus (+) and slash (/) are never discarded
* standard_ and urlsafe_b64decode() discard characters as well

Also update the doc strings to clarify data types, based on revision
92760d2edc9e, correct the exception raised by b16decode(), and correct the
parameter name for the base-85 functions.

Issue #26406: merge from 3.5

Issue #26406: Avoid unnecessary serialization of getaddrinfo(3) calls on
current versions of OpenBSD and NetBSD.  Patch by A. Jesse Jiryu Davis.

merge with 3.5

Update example; str(float) changed so there is difference now.

Issue #26268: Merge with 3.5

Issue #26261: Merge NamedTemporaryFile docs from 3.5

Issue #26261: Clarify NamedTemporaryFile name attribute vs file.name

Issue #26268: Update Windows builds to use OpenSSL 1.0.2f

Issue #26268: Update the prepare_ssl.py script

It can now handle OpenSSL versions 1.0.2e and greater, which don't
include include files in include/.

Note that sources prepared by this script no longer support the old
project files for 2.7; you now have to have Perl available to use
the old build_ssl.py script with sources from svn.python.org.

Merge XML-RPC client documentation from 3.5

Fix errors in XML-RPC client example code

* http.client.HTTP (does not exist in Python 3) → HTTPConnection
* Server (deprecated) → ServerProxy
* Transport.send_request() grew a new “debug” parameter in Python 3 (revision
  a528f7f8f97a)

Issue #26401: Fix compile() documentation

After 25032ec29315, compile() will raise a ValueError
if source contains null bytes.

Patch by SilentGhost.

Issue #26401: Fix compile() documentation

After 25032ec29315, compile() will raise a ValueError
if source contains null bytes.

Patch by SilentGhost.

Fix some typos in the NEWS file

Fix some typos in the NEWS file

Issue #23430: Stop socketserver from catching SystemExit etc from handlers

Also make handle_error() consistently output to stderr, and fix the
documentation.

Fix a name in an example

Issue #26397: Update an importlib example to use util.module_from_spec() instead of create_module()

Merge w/ 3.5

List what classes from importlib.machinery don't work with importlib.util.LazyLoader

Merge for issue #26186

Issue #26186: Remove an invalid type check in
importlib.util.LazyLoader.

The class was checking its argument as to whether its implementation
of create_module() came directly from importlib.abc.Loader. The
problem is that the classes coming from imoprtlib.machinery do not
directly inherit from the ABC as they come from _frozen_importlib.
Because the documentation has always said that create_module() was
ignored, the check has simply been removed.

Merge for issue #26367

Issue #26367: Have importlib.__init__() raise RuntimeError when
'level' is specified but no __package__.

This brings the function inline with builtins.__import__(). Thanks to
Manuel Jacob for the patch.

Merged cookbook update from 3.5.

Added simple threading example to logging cookbook.

Issue #22468: Merge gettarinfo() doc from 3.5

Issues #22468, #21996, #22208: Clarify gettarinfo() and TarInfo usage

* The Windows-specific binary notice was probably a Python 2 thing
* Make it more obvious gettarinfo() is based on stat(), and that non-ordinary
  files may need special care
* The file name must be text; suggest dummy arcname as a workaround
* Indicate TarInfo may be used directly, not just via gettarinfo()

merge with 3.5

Closes #20169: fix inner links random doc.

Issue #15608: Merge socketserver doc from 3.5

Issue #15608: Improve socketserver module documentation

* Add headings for each concrete and mix-in class and list methods and
  attributes under them
* Fix class and method cross references
* Changed RequestHandler to BaseRequestHandler and added class heading
* Pull out Stream/DatagramRequestHandler definitions
* Reordered the request handler setup(), handle(), finish() methods
* Document constructor parameters for the server classes
* Remove version 2.6 not relevant for Python 3 documentation

Issue #26309: Merge socketserver fix from 3.5

Issue #26309: Rewrite test in main thread and avoid race condition

Issue #16915: Clarify that mode parameter of socket.makefile() does not accept
the same values as open().

Issue #16915: Clarify that mode parameter of socket.makefile() does not accept
the same values as open().

Issue #26309: Merge socketserver fix from 3.5

Issue #26309: Shut down socketserver request if verify_request() is false

Patch by Aviv Palivoda.

merge 3.5 (#26378)

fix typo (closes #26378)

merge 3.5 (closes #25939)

merge 3.4 (closes #25939)

open the cert store readonly

Patch from Chi Hsuan Yen.

Issue #26368: fix typo in asynchio stream doc, reported by Ryan Stuart.

Issue #26368: fix typo in asynchio stream doc, reported by Ryan Stuart.

Minor clarification in tutorial.

Issue #25924: merge with 3.5

Issue #25924: Avoid unnecessary serialization of getaddrinfo(3) calls on OS X
versions 10.5 or higher.  Original patch by A. Jesse Jiryu Davis.

Issue #26268: merge from 3.5

Issue #26268: Update OS X 10.5+ installer build to use OpenSSL 1.0.2f.

The return type of a rich comparison is an int

Issue #26316: Merge Arg Clinic fix from 3.5

Issue #26316: Fix variable name typo in Argument Clinic

Merge 3.5 (issue #25887)

Issue #25887: Raise a RuntimeError when a coroutine is awaited more than once.

Fixes #26348: Merged fix from 3.5.

Fixes #26348: Corrected typos in activate.fish script.

Issue #25179: Documentation for formatted string literals aka f-strings

Some of the inspiration and wording is taken from the text of PEP 498 by Eric
V. Smith, and the existing str.format() documentation.

Issues #26289 and #26315: Optimize floor/modulo div for single-digit longs

Microbenchmarks show 2-2.5x improvement.  Built-in 'divmod' function
is now also ~10% faster.

-m timeit -s "x=22331" "x//2;x//-3;x//4;x//5;x//-6;x//7;x//8;x//-99;x//100;"
with patch: 0.321          without patch: 0.633

-m timeit -s "x=22331" "x%2;x%3;x%-4;x%5;x%6;x%-7;x%8;x%99;x%-100;"
with patch: 0.224          without patch: 0.66

Big thanks to Serhiy Storchaka, Mark Dickinson and Victor Stinner for
thorow code reviews and algorithms improvements.

Null merge

Issue #25995: os.walk() no longer uses FDs proportional to the tree depth.
Different solution from 3.5.

Issue #25995: os.walk() no longer uses FDs proportional to the tree depth.

Issue #25994: Added the close() method and the support of the context manager
protocol for the os.scandir() iterator.

Issue #26325: Added test.support.check_no_resource_warning() to check that
no ResourceWarning is emitted.

Issue #26325: Added test.support.check_no_resource_warning() to check that
no ResourceWarning is emitted.

Issue #25985: sys.version_info is now used instead of sys.version
to format short Python version.

Issue #26312: SystemError is now raised in all programming bugs with using
PyArg_ParseTupleAndKeywords().  RuntimeError did raised before in some
programming bugs.

Issue #23992: multiprocessing: make MapResult not fail-fast upon exception.

Null merge of typing.rst change

Hopefully clarify the difference between Optional[t] and an optional argument.

Hopefully clarify the difference between Optional[t] and an optional argument.

Issue #25698: Prevent possible replacing imported module with the empty one
if the stack is too deep.

Issue #25698: Prevent possible replacing imported module with the empty one
if the stack is too deep.

Issue #26304: Additional “allows to” fix specific to 3.6

Issue #26304: Merge doc wording from 3.5

Issue #26304: Change "allows to <verb>" to "allows <verb>ing" or similar

The original form is incorrect grammar and feels awkward, even though the
meaning is clear.

Issue #26136: Upgrade the generator_stop warning to DeprecationWarning

Patch by Anish Shah.

Issue 26243: Forgot to update zlib doc strings in Argument Clinic

Issue #26243: zlib.compress() keyword argument support by Aviv Palivoda

Issues #26310, #26311: Fix typos in the documentation and code comments

Issue #26200:  The SETREF macro adds unnecessary work in some cases.

Issues #26310, 26311: Merge typo fixes from 3.5

compiler: don't emit SyntaxWarning on const stmt

Issue #26204: the compiler doesn't emit SyntaxWarning warnings anymore when
constant statements are ignored.

Issue #25983: Added tests for multi-argument type().

Issue #25983: Added tests for multi-argument type().

Clarify "cardinality of" as "number of elements in" as many readers do
not have a math vocabulary.

Clarify "cardinality of" as "number of elements in" as many readers do
not have a math vocabulary.

Updates build to use SHA256 hash when signing files

Updates build to use SHA256 hash when signing files.

compiler now ignores constant statements

The compile ignores constant statements and emit a SyntaxWarning warning.

Don't emit the warning for string statement because triple quoted string is a
common syntax for multiline comments.

Don't emit the warning on ellipis neither: 'def f(): ...' is a legit syntax for
abstract functions.

Changes:

* test_ast: ignore SyntaxWarning when compiling test statements. Modify
  test_load_const() to use assignment expressions rather than constant
  expression.
* test_code: add more kinds of constant statements, ignore SyntaxWarning when
  testing that the compiler removes constant statements.
* test_grammar: ignore SyntaxWarning on the statement "1"

Replace noop constant statement with expression

* Constant statements will be ignored and the compiler will emit a
  SyntaxWarning.
* Replace constant statement (ex: "1") with an expression statement
  (ex: "x=1").
* test_traceback: use context manager on the file.

Issue #26204.

Simplify main() of test_ast

* Use ast.parse() to get the AST for a statement
* Use str%args syntax for format a line

Issue #26204.