Issue #26173: Merge SSL tests from 3.5

Issue #26173: Separate bad cert file tests and client rejection test

Test test_wrong_cert() runs a server that rejects the client's certificate,
so ECONNRESET is reasonable in addition to SSLError. On the other hand, the
other three tests don't even need to run a server because they are just
testing the parsing of invalid certificate files.

Also fix a ResourceWarning by closing the wrapped socket.

Merge 3.5 (doc)

Enhance os.scandir() doc

Issue #26248, patch written by Ben Hoyt:

1) Clarify that the return values of is_dir()/is_file()/etc are cached
   separately for follow_symlinks True and False.
2) Be more specific about when the functions require a system call, and how it
   relates to caching and follow_symlinks.
3) DRY up common stuff between is_dir and is_file by saying "Caching, system
   calls made, and exceptions raised are as per is_dir" in is_file.
4) Tweak to the first paragraph of docs for is_dir/is_file to simplify: assume
   the follow_symlinks=True default, then note the follow_symlinks=False
   non-default case after.

Issue #23601:  Use small object allocator for dict key objects

Issue #26242: Fix another one in importlib.rst

Issue #26242: Fix another one in importlib.rst

Fix a markup error in socket.rst

Fix a markup error in socket.rst

Issue #23076: Path.glob() now raises a ValueError if it's called with an
invalid pattern.

Patch by Thomas Nyberg.

Issue #23076: Path.glob() now raises a ValueError if it's called with an
invalid pattern.

Patch by Thomas Nyberg.

Simply docstrings of venv module

This will hopefully make maintenance of venv documentation easier.
For example, see commits a4f0d76af176 and 5764cc02244d.

This patch has been reviewed by Vinaj Sajip, the maintainer of
venv module.

Update "Creating Virtual Environments" link in venv documentation

Update "Creating Virtual Environments" link in venv documentation

Update output of venv -h

* Update description of the --system-site-packages option
* Show --copies option in the usage

Issue #4806: Merge * unpacking fix from 3.5

Issue #4806: Avoid masking original TypeError in call with * unpacking

Based on patch by Hagen Fürstenau and Daniel Urban.

Update output of venv -h

* Update description of the --system-site-packages option
* Show --copies option in the usage

Issue #25934: Merge with 3.5

Issue #26173: Merge wrongcert test from 3.5

Issue #26173: Fix test_ssl confusion with non-existing cert and wrongcert.pem

Testing for a non-existing certificate file is already done in test_errors().
Copy wrongcert.pem from Python 2 and use it to test the behaviour with a
mismatched certificate.

Issue #25934: Default to /fp:strict for ICC builds

Issue #26202: copy.deepcopy() now correctly copies range() objects with
non-atomic attributes.

Issue #26202: copy.deepcopy() now correctly copies range() objects with
non-atomic attributes.

Issue #19883: Fixed possible integer overflows in zipimport.

Issue #19883: Fixed possible integer overflows in zipimport.

Null merge

Merge heads

Issue #26198: Added tests for "es", "et", "es#", "et#" and "C" format units
of PyArg_Parse*() functions.

Issue #26198: Added tests for "es", "et", "es#", "et#" and "C" format units
of PyArg_Parse*() functions.

Null merge 3.5

Backport fixes on test_eintr

* Issue #25234: Skip test_eintr.test_open() under OS X to avoid hanging
* Issue #25868: Try to make test_eintr.test_sigwaitinfo() more reliable
  especially on slow buildbots. Use a pipe to synchronize the parent and the
  child processes.

Issue #24705: Add a test case for ef84d21f5292

Issue #24705: Add a test case for ef84d21f5292

Merge 3.5: Issue #26227

Windows: Decode hostname from ANSI code page

Issue #26227: On Windows, getnameinfo(), gethostbyaddr() and gethostbyname_ex()
functions of the socket module now decode the hostname from the ANSI code page
rather than UTF-8.

Add a link to PEP 384 in stable.rst

Issue #19023: Merge ctypes doc and tests from 3.5

Issue #19023: Document ctypes array and pointer classes

Also add some more tests. Based on patch by Sye van der Veen.

Add a link to PEP 384 in stable.rst

Issue #26034: Improve wording of clear parameter

Issue #26034: Improve wording of clear parameter

Issue #26034: Sync documentation of --clear with its behavior

Most of the docs has already been updated in c3c188a0325a.

Issue #26034: Sync documentation of --clear with its behavior

Most of the docs has already been updated in c3c188a0325a.

Issue #26199: Fix broken link in unittest.mock-examples.rst

Patch by Raphael Das Gupta.

Issue #26220: Merge Unicode how-to from 3.5

Issue #26220: Remove outdated comment about a question mark

Issue #26199: Fix broken link in unittest.mock-examples.rst

Patch by Raphael Das Gupta.

Merge with 3.5

Issue #25507: revert incorrect movement of idleConf import in c548ad75160c.
Augment htest to include all major IOBinding functions.

Merge 3.5

Fix resize_compact()

Issue #26217: resize_compact() must set wstr_length to 0 after freeing the wstr
string. Otherwise, an assertion fails in _PyUnicode_CheckConsistency().

merge

Issue #26194: Fix undefined behavior for deque.insert() when len(d) == maxlen

Issue #26146: enhance ast.Constant error message

Mention the name of the invalid type in error message of AST validation for
constants.

Suggestion made by Joseph Jevnik on a review.

Issue #26146: remove useless code

obj2ast_constant() code is baesd on obj2ast_object() which has a special case
for Py_None. But in practice, we don't need to have a special case for
constants.

Issue noticed by Joseph Jevnik on a review.

Fix a refleak in validate_constant()

Issue #26146.

Fix typo

merge from 3.5

Remove unnecessary test case comment in urllib.parse.py. These are asserted as test cases.

Remove unnecessary test case comment in urllib.parse.py. These are asserted as test cases.

Add ast.Constant

Issue #26146: Add a new kind of AST node: ast.Constant. It can be used by
external AST optimizers, but the compiler does not emit directly such node.

An optimizer can replace the following AST nodes with ast.Constant:

* ast.NameConstant: None, False, True
* ast.Num: int, float, complex
* ast.Str: str
* ast.Bytes: bytes
* ast.Tuple if items are constants too: tuple
* frozenset

Update code to accept ast.Constant instead of ast.Num and/or ast.Str:

* compiler
* docstrings
* ast.literal_eval()
* Tools/parser/unparse.py

Tests versus zero are more compact than tests versus -1.

Fix compiler warning about obviously unreachable code.

Convert another post-decrement while-loop to pre-decrement for consistency
and better generated code (on both GCC and CLang).

Convert two other post-decrement while-loops to pre-decrements for consistency
and for better code generation.

Miscellaneous refactorings

* Add comment to the maxlen structure entry about the meaning of maxlen == -1
* Factor-out code common to deque_append(left) and deque_extend(left)
* Factor inner-loop in deque_clear() to use only 1 test per loop instead of 2
* Tighten inner-loops for deque_item() and deque_ass_item() so that the
  compiler can combine the decrement and test into a single step.

Issue #26146: marshal.loads() now uses the empty frozenset singleton

Cleanup test_dict

* Write one import per line
* Sort imports by name
* Add an empty line: 2 empty lines between code blocks at the module level (PEP 8)

test_gc: remove unused imports

Issue #18018: Raise an ImportError if a relative import is attempted
with no known parent package.

Previously SystemError was raised if the parent package didn't exist
(e.g., __package__ was set to '').
Thanks to Florent Xicluna and Yongzhi Pan for reporting the issue.

Issue #25234: Skip test_eintr.test_open() under OS X to avoid hanging

whitespace cleanup

Issue #25791: Warn when __package__ != __spec__.parent.

In a previous change, __spec__.parent was prioritized over
__package__. That is a backwards-compatibility break, but we do
eventually want __spec__ to be the ground truth for module details. So
this change reverts the change in semantics and instead raises an
ImportWarning when __package__ != __spec__.parent to give people time
to adjust to using spec objects.

Merge from 3.5

Fix a typo in a code example

Merge 3.5 (i18n doc, issue #25907)

doc: i18n HTML templates

Issue #25907: Use {% trans %} tags in HTML templates to ease the translation of
the documentation. The tag comes from Jinja templating system, used by Sphinx.

Patch written by Julien Palard.

Null merge 3.5 (change already applied to default)

Issue #25876: Fix also test_set() of test_gdb when -E command line is used

Issue #25876: test_gdb: use subprocess._args_from_interpreter_flags() to test
Python with more options.

Use Py_uintptr_t for atomic pointers

Issue #26161: Use Py_uintptr_t instead of void* for atomic pointers in
pyatomic.h. Use atomic_uintptr_t when <stdatomic.h> is used.

Using void* causes compilation warnings depending on which implementation of
atomic types is used.

code_richcompare() now uses the constants types

Issue #25843: When compiling code, don't merge constants if they are equal but
have a different types. For example, "f1, f2 = lambda: 1, lambda: 1.0" is now
correctly compiled to two different functions: f1() returns 1 (int) and f2()
returns 1.0 (int), even if 1 and 1.0 are equal.

Add a new _PyCode_ConstantKey() private function.

code_richcompare() now uses the constants types

Issue #25843: When compiling code, don't merge constants if they are equal but
have a different types. For example, "f1, f2 = lambda: 1, lambda: 1.0" is now
correctly compiled to two different functions: f1() returns 1 (int) and f2()
returns 1.0 (int), even if 1 and 1.0 are equal.

Add a new _PyCode_ConstantKey() private function.

site: error on sitecustomize import error

Issue #26099: The site module now writes an error into stderr if sitecustomize
module can be imported but executing the module raise an ImportError. Same
change for usercustomize.

merge 3.5

merge 3.4

reject negative data_size

merge from 3.5

minor clarification on Zipfile 'x' mode - exclusive creation of a file.

(Based on the feedback from docs@python.org list)

minor clarification on Zipfile 'x' mode - exclusive creation of a file.

Merge update to pip

Merge update to pip

Upgrade pip to 8.0.2

Issue #18620: Improve Pool examples in multiprocessing documentation

A single call to Pool.apply_async() will create only one process. To use all
of the pool's processes, it should be invoked multiple times:

    with Pool(processes=4) as pool:
        results = [pool.apply_async(func, ()) for i in range(4)]

Patch by Davin Potts.

Issue #18620: Improve Pool examples in multiprocessing documentation

A single call to Pool.apply_async() will create only one process. To use all
of the pool's processes, it should be invoked multiple times:

    with Pool(processes=4) as pool:
        results = [pool.apply_async(func, ()) for i in range(4)]

Patch by Davin Potts.

merge from 3.5

issue25909 - Correct the documentation of PyMapping_Items, PyMapping_Keys and
PyMapping_Values in Include/abstract.h and Doc/c-api/mapping.rst.

Patch contributed by Sonali Gupta.

issue25909 - Correct the documentation of PyMapping_Items, PyMapping_Keys and
PyMapping_Values in Include/abstract.h and Doc/c-api/mapping.rst.

Patch contributed by Sonali Gupta.

Issue #26107: Fix typo in Objects/lnotab_notes.txt

Double parenthesis

Merge 3.5 (doc)

Issue #26106: doc: Move text of licenses to parsed literal block

This change helps to ignore text of PSF, BEOPEN.com and CNRI licenses when
translating the documentation. Patch written by Julien Palard who is
translating Python 3.5 doc to french. Text of other licenses already used
preformatted format.

merge 3.5 (#26171)