Merge 3.5 (issue #26221)

asyncio: Prevent StopIteration from being thrown into a Future

Patch by Chris Angelico (issue #26221)

Merge 3.5 (issue #25647)

asyncio: Fix @coroutine to recognize CoroWrapper (issue #25647)

Patch by Vladimir Rutsky.

Sync selectors.py with upstream asyncio

Merge 3.5

asyncio, selectors: Update to the upstream version

Merge 3.5

Merge 3.4

asyncio: Update 3.4 asyncio/test_tasks to upstream version

Factor-out common subexpression.

Put block length computations in a more logical order.

Update assertion in compiler_addop_i()

In practice, bytecode instruction arguments are unsigned. Update the assertion
to make it more explicit that argument must be greater or equal than 0.

Rewrite also the comment.

Merge 3.5

Issue #26464: Fix unicode_fast_translate() again

Initialize i variable if the string is non-ASCII.

Merge 3.5

Fix str.translate()

Issue #26464: Fix str.translate() when string is ASCII and first replacements
removes character, but next replacement uses a non-ASCII character or a string
longer than 1 character. Regression introduced in Python 3.5.0.

Issue #26457: Fixed the subnets() methods in IP network classes for the case
when resulting prefix length is equal to maximal prefix length.
Based on patch by Xiang Zhang.

Issue #26457: Fixed the subnets() methods in IP network classes for the case
when resulting prefix length is equal to maximal prefix length.
Based on patch by Xiang Zhang.

Merge with 3.5

Whitespace

Merge with 3.5

Document maintenance of idlelib/help.html in idlelib.

Merge with 3.5

Rebase the 3.x version of idlelib/help.html on the 3.5 version of
Doc/build/html/library/idle.html, which is built from Doc/library/idle.rst.
Help.html is an rstrip()ed copy of idle.html that can be pushed.

The displayed content is unchanged because a) the version number is not
displayed, being inherent in the version displaying the file and b) the tt
tag was ignored by the custom parser in idlelib/help.py.  The wrapped
<span class="pre"> tags remain as they were.

This will be merged in 3.6 (without conflict) because the 3.6 help.html is
a copy of the 3.5 file (which was a copy of the 3.4 file).  The two files will
remain the same until either a) there is a content change that only applies
to one of them or b) 3.5 maintenance ends and the 3.6 file is itself rebased.

Issue #26385: Merge NamedTemporaryFile fix from 3.5

merge with 3.5

Update susp-ignore file (#25910).

merge with 3.5

Fix typo.

Issue #26385: Cleanup NamedTemporaryFile if open() fails, by SilentGhost

Issue #22836: Merge exception reporting from 3.5

Issue #22836: Keep exception reports sensible despite errors

#26246: merge with 3.5.

#26246: merge with 3.4.

#26246: update copybutton.js after JQuery update.  Patch by Liang-Bo Wang.

compile.c: inline compiler_use_new_block()

* Inline compiler_use_new_block() function into its only callee,
  compiler_enter_scope()
* Remove unused NEW_BLOCK() macro

merge with 3.5

Closes #25910: fix dead and permanently redirected links in the docs. Thanks to SilentGhost for the patch.

merge with 3.5

Fix version.

merge with 3.5

Closes #26442: fix copy-paste.

merge with 3.5

Closes #26444: typo fixes.

remove unused c_encoding struct member

rewrite parsestr() so it's comprehensible; remove dead code

c_encoding can never be NULL, which allows some code simplification

Dummy merge with 3.5

Issue #26390: Merge pbkdf2_hmac() doc from 3.5

merge with 3.5

Closes #26435: fix syntax in directives. Thanks to Jakub Stasiak.

merge with 3.5

Fix rstlint to also look for indented comments that should be directives.

Issue #26402: Merge XML-RPC client fix from 3.5

Issue #26402: Fix XML-RPC client retrying after server disconnection

This is a regression introduced in 3.5 by revision eba80326ba53. Fix by Jelte
Fennema, test case by me.

Issue #25801: Fixed resource warnings in test_zipfile64.
Patch by SilentGhost.

Issue #25801: Fixed resource warnings in test_zipfile64.
Patch by SilentGhost.

Fix out-of-date comment

Issue #25136: merge from 3.5

Issue #25136: Add reference to 'xcode-select --install' to Mac README.

Change OS X installer builds targeted for 10.10 and above to build
and link with a private copy of OpenSSL, like installers targeted
for 10.5 already do, since Apple has deprecated use of the system
OpenSSL and removed its header files from the Xcode 7 SDK.  Note
that this configuration is not currently used to build any
python.org-supplied installers and that the private copy of
OpenSSL requires its own root certificates.

Change OS X installer builds targeted for 10.10 and above to build
and link with a private copy of OpenSSL, like installers targeted
for 10.5 already do, since Apple has deprecated use of the system
OpenSSL and removed its header files from the Xcode 7 SDK.  Note
that this configuration is not currently used to build any
python.org-supplied installers and that the private copy of
OpenSSL requires its own root certificates.

Issue #25136: merge from 3.5

Issue #25136: Support Apple Xcode 7's new textual SDK stub libraries.

As of Xcode 7, SDKs for Apple platforms now include textual-format stub
libraries whose file names have a .tbd extension rather than the
standard OS X .dylib extension.  The Apple compiler tool chain handles
these stub libraries transparently and the installed system shared libraries
are still .dylibs.  However, the new stub libraries cause problems for
third-party programs that support building with Apple SDKs and make
build-time decisions based on the presence or paths of system-supplied
shared libraries in the SDK.  In particular, building Python itself with
an SDK fails to find system-supplied libraries during setup.py's build of
standard library extension modules.  The solution is to have
find_library_file() in Distutils search for .tbd files, along with
the existing types (.a, .so, and .dylib).  Patch by Tim Smith.

Issue #26302: merge from 3.5

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.

Issue #26390: Fix and test pbkdf2_hmac() parameter names

Based on patch by Daan Bakker.

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.