[3.6] bpo-30197: Enhance functions swap_attr() and swap_item() in test.support. (GH-1341) (#1345)

They now work when delete replaced attribute or item inside the with
statement.  The old value of the attribute or item (or None if it doesn't
exist) now will be assigned to the target of the "as" clause, if there is
one.

(cherry picked from commit d1a1def7bf221b04dcf3fc3a67aa19aa2f622f83)

bpo-30125: disable faulthandler in ctypes test_SEH (#1237) (#1343)

Disable faulthandler to run test_SEH() of test_ctypes to prevent the
following log with a traceback:

    Windows fatal exception: access violation

Add support.disable_faulthandler() context manager.
(cherry picked from commit a36e939aeb3b5a2c56561eb24f0e339eee9f3f9d)

bpo-30131: test_logging now joins queue threads (#1298) (#1317)

QueueListenerTest of test_logging now closes the multiprocessing
Queue and joins its thread to prevent leaking dangling threads to
following tests.

Add also @support.reap_threads to detect earlier if a test leaks
threads (and try to "cleanup" these threads).
(cherry picked from commit 8ca2f2faefa8dba323a2e4c4b86efb633d7a53cf)

[3.6] bpo-30106: Fix test_asyncore.test_quick_connect() (#1336)

* Fix/optimize test_asyncore.test_quick_connect() (#1188)

Don't use addCleanup() in test_quick_connect() because it keeps the
Thread object alive and so @reap_threads fails on its timeout of 1
second. "./python -m test -v test_asyncore -m test_quick_connect"
now takes 185 ms, instead of 11 seconds.

Other minor changes:

* Use "with sock:" to close the socket instead of
  try/finally: sock.close()
* Use self.skipTest() in test_quick_connect() to remove one
  indentation level and notice user that the test is specific to
  AF_INET and AF_INET6

* bpo-30106: Fix tearDown() of test_asyncore (#1194)

Call asyncore.close_all() with ignore_all=True in the tearDown()
method of the test_asyncore base test case. It should prevent keeping
alive sockets in asyncore.socket_map if close() fails with an
unexpected error.

Revert also an unwanted change of my previous commit: remove name
parameter of Thread in test_quick_connect().

* bpo-30106: Fix test_asyncore.test_quick_connect() (#1234)

test_quick_connect() runs a thread up to 50 seconds, whereas the
socket is connected in 0.2 second and then the thread is expected to
end in less than 3 second. On Linux, the thread ends quickly because
select() seems to always return quickly. On FreeBSD, sometimes
select() fails with timeout and so the thread runs much longer than
expected.

Fix the thread timeout to fix a race condition in the test.

bpo-30107: Make SuppressCrashReport quiet on macOS (#1279) (#1335)

On macOS, SuppressCrashReport now redirects /usr/bin/defaults command
stderr into a pipe to not pollute stderr. It fixes a
test_io.test_daemon_threads_shutdown_stderr_deadlock() failure when
the CrashReporter domain doesn't exists. Message logged into stderr:

2017-04-24 16:57:21.432 defaults[41046:2462851]
The domain/default pair of (com.apple.CrashReporter, DialogType) does not exist
(cherry picked from commit d819ad9832292d854e9710493ecdf959b69802e3)

bpo-30175: Skip client cert tests of test_imaplib (#1320) (#1323)

* bpo-30175: Skip client cert tests of test_imaplib

The IMAP server cyrus.andrew.cmu.edu doesn't accept our randomly
generated client x509 certificate anymore.

* bpo-30188: Catch EOFError in NetworkedNNTPTests

test_nntplib fails randomly with EOFError in
NetworkedNNTPTests.setUpClass(). Catch EOFError to skip tests in that
case.

(cherry picked from commit 5bccca58b9b2b3a925b16750bedbd907695ea8d7)

[3.6] bpo-30182: Use the correct name for ISO in Unicode HOWTO. (GH-1312) (GH-1313)

(cherry picked from commit 6fde770e4e940c19cd62de0b6aeb77840690843e)

[3.6] bpo-30142: Remove "callable" from the 2to3fixer documentation. (GH-1303)

bpo-29974: Improve typing.TYPE_CHECKING example (GH-982)

* Fix PEP 8 (SomeType instead of some_type)
* Add a function parameter annotation
* Explain, using wording from PEP 484 and PEP 526,
  why one annotation is in quotes and another is not.

Suggested by Ivan Levkevskyi.

(cherry picked from commit 87c07fe9d908d0a2143fcc8369255c6ff3241503)

bpo-28698: Fix c_wchar_p doc example (GH-1160)

(cherry picked from commit 0d637e236d7099f7b724026c8cb7bd83d8e12e6b)

[3.6] bpo-28851: Improve namedtuple documentation (GH-1274) (GH-1286)

Clarify that a sequence of strings is the preferred value for 'field_names'.
(cherry picked from commit 97bf722fcd1de1236824377e052369dc7686b644)

[3.6] bpo-29751: Improve PyLong_FromString documentation (GH-915) (#1266)

(cherry picked from commit 26896f2832324dde85cdd63d525571ca669f6f0b)

[3.6] bpo-15718: Document the upper bound constrain on the __len__ return value. (GH-1256) (#1259)

(cherry picked from commit 85157cd)

[3.6] Fix trailing colon and newline in test.rst (GH-1250) (#1254)

(cherry picked from commit 7fae81e1672d0b4110d31ea6a765b54f63a2e54b)

bpo-30098: Clarify that run_coroutine_threadsafe expects asyncio.Future   (GH-1170) (#1247)

(cherry picked from commit ae5b3260dd459845aad8a30491b76d471577785d)

[3.6] Correct the README link in Unix install docs (GH-1245) (GH-1248)

(cherry picked from commit d1ae24e8880fe00d006eb2996af815c35fbcfb33)

bpo-30125: Fix faulthandler.disable() on Windows (#1243)

On Windows, faulthandler.disable() now removes the exception handler
installed by faulthandler.enable().

bpo-29191: Add liblzma.vcxproj to pcbuild.sln and other missing entries (GH-1222) (GH-1244)

liblzma is missing from pcbuild.sln. This causes the build of _lzma to fail when building the solution and not using build.bat.

bpo-30107: don't dump core on expected test_io crash (#1235) (#1241)

test_io has two unit tests which trigger a deadlock:

* test_daemon_threads_shutdown_stdout_deadlock()
* test_daemon_threads_shutdown_stderr_deadlock()

These tests call Py_FatalError() if the expected bug is triggered
which calls abort(). Use test.support.SuppressCrashReport to prevent
the creation on a core dump, to fix the warning:

Warning -- files was modified by test_io
  Before: []
  After:  ['python.core']
(cherry picked from commit 2a1aed04b0943636f605543522e16cca1dc23e70)

[3.6] Add missing .gitignore entries for VS2015 IntelliSense DB (GH-1223) (#1225)

(cherry picked from commit 8e675286a92f33837cfffac5914b5175dac5d573)

bpo-29802: Fix the cleaning up issue in PyUnicode_FSDecoder(). (#1217)

[3.6] bpo-30109: Fix reindent.py (GH-1207) (GH-1208)

Skip the file if it has bad encoding.
(cherry picked from commit 58f3c9dc8f5626abe09ac9738c34f6ba99ce2972)

[3.6] bpo-12414: Update code_sizeof() to take in account co_extra memory. (#1168) (#1198)

Remove redundant comma in argparse HOWTO (GH-1141)

Reported by Sean Canavan on docs@p.o.

(cherry picked from commit 8526fb74edf5ac9ca175b7cdcb0d82bb8780d2cf)

bpo-30078: Add an example of passing a path to unittest (GH-1178)

(cherry picked from commit f7e62cf8adfb8ab6a6a870903defe8ff218a0383)

bpo-19225: Remove duplicated description for standard warning categories (GH-1068)

[3.6] bpo-30065: Fixed arguments validation in _posixsubprocess.fork_exec(). (GH-1110) (#1186)

(cherry picked from commit 66bffd1)

[3.6] bpo-30070: Fixed leaks and crashes in errors handling in the parser module. (GH-1131). (#1184)

(cherry picked from commit a79f4c219531c05fc8f670c1e4bbf12c081935d3)

bpo-30061: Check if PyObject_Size()/PySequence_Size()/PyMapping_Size() (#1096) (#1180)

raised an error.

(cherry picked from commit bf623ae8843dc30b28c574bec8d29fc14be59d86)

bpo-30017: Allowed calling the close() method of the zip entry writer object (#1041) (#1092)

multiple times.  Writing to closed zip entry writer object now always produce
a ValueError.
(cherry picked from commit 4c0d9ea995da595e90e08813b89510de59907802)

bpo-30068: add missing iter(self) in _io._IOBase.readlines when hint is present (#1130) (#1150)

[3.6] bpo-30059: Include Py_Ellipsis in C API documentation (GH-1018) (GH-1149)

[3.6] bpo-29738: Fix memory leak in _get_crl_dp (GH-526) (GH-1142)

* Remove conditional on free of `dps`, since `dps` is now allocated for
all versions of OpenSSL
* Remove call to `x509_check_ca` since it was only used to cache
the `crldp` field of the certificate
CRL_DIST_POINTS_free is available in all supported versions of OpenSSL
(recent 0.9.8+) and LibreSSL.
(cherry picked from commit 2849cc34a8db93d448a62d69c462402347b50dcb)

improve alignment autoconf test (#1129) (#1139)

Replace the deprecated AC_TRY_RUN with AC_RUN_IFELSE. Also, standardize the
variable name and allow for caching of the result.

Fix misplaced positional argument in OS X support library (#1137)

Relax test timing (bpo-29861) to avoid sporadic failures (#1120) (#1132)

(cherry picked from commit 685cdb9acc3fca04a9897d88b89771ddfd50e772)

[3.6] bpo-29694: race condition in pathlib mkdir with flags parents=True (GH-1089). (GH-1126)

(cherry picked from commit 22a594a0047d7706537ff2ac676cdc0f1dcb329c)

[3.6] bpo-29869: Allow underscores in numeric literals in lib2to3. (GH-1119) (GH-1122)

* Allow underscores in numeric literals in lib2to3.
* Stricter literal parsing for Python 3.6 in lib2to3.pgen2.tokenize.
* Add test case for underscores in literals in Python 3.
(cherry picked from commit a6e395dffadf8c5124903c01ad69fefa36b1a935)

[3.6] Fix a typo in Doc/library/functions.rst (GH-1117) (GH-1123)

Replace `For object's ... ` with `For objects ...`
(cherry picked from commit 873ef20d0007b4b120933473e6252d2309a70102)

convert from long long to PyLong loselessly (#1106) (#1121)

bpo-30021: Add examples for re.escape(). (#1048) (#1115)

And fix the parameter name.

(cherry picked from commit 8fc7bc2b7631ee819ee614e47b6f44bacebe1574)

bpo-29791: Clarify that flush is keyword-only argument (GH-1093)

Reported by Lucio Ricardo Montero Valenzuela.

(cherry picked from commit 61b9ac93712df8092a25223cd56fa6528359792b)

Revert "bpo-29869: Allow underscores in numeric literals in lib2to3. (GH-752)" (GH-1109)

This reverts commit 97a40b7a5b2979fb17e1751c139fd4ba1ebd5276.
The commit is supposed to go to the master branch first.

bpo-29869: Allow underscores in numeric literals in lib2to3. (GH-752)

[3.6] bpo-29692: contextlib.contextmanager may incorrectly unchain RuntimeError (GH-949) (#1105)

contextlib._GeneratorContextManager.__exit__ includes a special case to deal with
PEP 479 RuntimeErrors created when `StopIteration` is thrown into the context
manager body.

Previously this check was too permissive, and undid one level of chaining on *all*
RuntimeError instances, not just those that wrapped a StopIteration instance.
(cherry picked from commit 00c75e9a45ff0366c185e9e8a2e23af5a35481b0)

[3.6] Clarify exception handler scope in contextlib (GH-1103)

Moved explicit raise from inside try to try...else.
(cherry picked from commit 680e20beee8bbce9f857b8e7795009191f98b0ba)

[3.6] Remove superfluous comment in urllib.error. (GH-1076) (GH-1101)

(cherry picked from commit 6fab78e9027f9ebd6414995580781b480433e595)

bpo-26985: Add missing info of code object in inspect documentation (GH-1090) (GH-1099)

[3.6] bpo-30047: Fix a typo in Doc/library/select.rst (GH-1086) (GH-1098)

(cherry picked from commit 3e0f1fc4e0ffcfcc706015fa3d67c262948ef171)

Remove OSError related comment in urllib.request. (#1072)

(cherry picked from commit 6dfcc81f6b1c82a71a1c876e14424fb8b3573447)

[3.6] Improvements to typing documentation (GH-967) (GH-1053)

Documents a few omitted classes and adds NamedTuple methods.
(cherry picked from commit 45d22c256bce3afcf57f49032a6b20fdec4f26ad)

[3.6] bpo-29549: Fixes docstring for str.index (GH-256) (GH-1028)

(cherry picked from commit 43ba8861e0ad044efafa46a7cc04e12ac5df640e)

[3.6] Correct typo in configparser.rst (GH-1012) (GH-1025)

(cherry picked from commit 01fa9ae5460b00bf1ced500c797176ebd3fb060d)

Remove invalid comment in urllib.request. (#1055)

(cherry picked from commit a2a9ddd923a849124bdd1c484f70f02df6fde0e9)

bpo-29506: Clarify deep copy note in copy module

The reference to administrative data was confusing to readers,
so this simplifies the note to explain that deep copying may copy
more then you intended, such as data that you expected to be
shared between copies.
(cherry picked from commit 19e04942562a980ad2519f6ff79c455a7472783b)

bpo-29798: Handle git worktree in patchcheck (#1058) (#1060)

The original attempted fix missed an `isdir()` call in
`get_base_branch()`.
(cherry picked from commit 2abfdf5a81383d3b1ed6b7321903a9a168c373c5)

bpo-29998: Pickling and copying ImportError now preserves name and path (#1010) (#1042)

attributes.
(cherry picked from commit b785396ab451b0c9d6ae9ee5a9e56c810209a6cb)

Expand the PySlice_GetIndicesEx macro. (#1023) (#1044)

(cherry picked from commit b879fe82e7e5c3f7673c9a7fa4aad42bd05445d8)

bpo-29939: suppress compiler warnings in _ctypes_test (#1038)

bpo-29939: Changed test code to suppress a compiler warning, while taking care to avoid the code being optimized out by the compiler.
(cherry picked from commit 164d30eb1e66575dafee6af4fca4cbf52c7fbe6a)

Fix a minor typo. (#1032) (#1037)

(cherry picked from commit dd9a0a14c89d57e43898d4b866b8c161e4ff8506)

Remove Invalid comment in test_urllib2.py. (#1022)

(cherry picked from commit fd0cd07a5a3c964c084f4efc5bbcb89dd2193ee6)

correct parse_qs and parse_qsl test case descriptions. (#968) (#997)

(cherry picked from commit 257b980b316a5206ecf6c23b958e2b7c4df4f3de)

Miscellaneous minor fixes of Misc/NEWS formatting. (#1002) (#1003)

(cherry picked from commit a0157b5f11e621f2196af4e918b9f07688a6cd1c)

remove merge=union attribute for Misc/NEWS (GH-460) (GH-988)

(cherry picked from commit 060d2d776a29341c079cce37220324f9775140ba)

bpo-29725: DOC: add text for arraysize in sqlite3.Cursor (#947) (#985)

(cherry picked from commit 02e12138000da834f23719521a011fa93763384d)

Keep the c-api exception doc up-to-date (#966)

cherry-pick'ed from ec1f5df..e3d6db3

Minor spell fix and formatting fixes in urllib tests. (#959) (#961)

(cherry picked from commit efbd4ea65dbb9f87b1afeec6a760802756badee5)

bpo-29941: Assert fixes (#886) (#955)

Make a non-Py_DEBUG, asserts-enabled build of CPython possible. This means
making sure helper functions are defined when NDEBUG is not defined, not
just when Py_DEBUG is defined.

Also fix a division-by-zero in obmalloc.c that went unnoticed because in
Py_DEBUG mode, elsize is never zero.

(cherry picked from commit a00c3fd12d421e41b769debd7df717d17b0deed5 and 06bb4873d6a9ac303701d08a851d6cd9a51e02a3)

bpo-26947: DOC: clarify wording on hashable in glossary (#948) (#957)

(cherry picked from commit 64c887ab3a400cf91bde4f0c5ef69eacc88bc5e1)

Add helpful explaination to test_password_manager tests. (#936) (#941)

Also uncomment and fix a path test.
(cherry picked from commit 1f5425ff69ea0531d869b4f9fa28bd3f66ca3de7)

bpo-29949: Fix set memory usage regression (GH-945)

Revert "Minor factoring:  move redundant resize scaling logic into the resize function."

This reverts commit 4897300276d870f99459c82b937f0ac22450f0b6.
(cherry picked from commit e82cf8675bacd7a03de508ed11865fc2701dcef5)

bpo-29953: Fix memory leaks in the replace() method of datetime and t… (#933)

objects when pass out of bound fold argument.
(cherry picked from commit 314d6fca36a4eaa0541218431d14804fadec6488)

bpo-28810: Update lnotab_notes.txt (GH-665) (GH-919)

(cherry picked from commit 9135275cba680902e6caf29461f0423dc570190d)

bpo-29952: Use usual terminology of dict  (GH-922)

s/keys and elements/keys and values/
(cherry picked from commit cdcac039fb447f2ab04efcacbe663751bb2cb4ec)

Remove catching OSError in ftphandler test. Only URLError is raised in urllib.request module. (#918) (#920)

(cherry picked from commit ed3dd1c02af6872bd0748f7b9a5dadb89f7b830f)

bpo-29942: Fix the use of recursion in itertools.chain.from_iterable. (#911)

* bpo-29942: Fix the use of recursion in itertools.chain.from_iterable.

Fix the use of recursion in itertools.chain.from_iterable. Using recursion
is unnecessary, and can easily cause stack overflows, especially when
building in low optimization modes or with Py_DEBUG enabled.
(cherry picked from commit 5466d4af5fe76ec0a5fbc8a05675287d9e8e9d14)

bpo-29928: Add f-string to the Glossary (GH-864) (GH-914)

(cherry picked from commit 33db068dac7686e37736f7ecf8abb2aee0345cf2)

bpo-29935: Fixed error messages in the index() method of tuple, list and deque (#887) (#907)

when pass indices of wrong type.
(cherry picked from commit d4edfc9abffca965e76ebc5957a92031a4d6c4d4)

bpo-27863: Fixed multiple crashes in ElementTree. (#765) (#903)

(cherry picked from commit 576def096ec7b64814e038f03290031f172886c3)

Remove an unrequired TODO in test_urllib2. (#897) (#900)

(cherry picked from commit e6911a44f69c0d302db60f49952a9cf69da69a2b)

bpo-29917: DOC: Remove link from PyMethodDef (#890) (#894)

(cherry picked from commit c3c7ef088583cc12bd218138036d1edb6de9c63f)

bpo-29677: DOC: clarify documentation for `round` (GH-877) (GH-892)

(cherry picked from commit 85deefcf61d3cc192846f41a4ccc6df17da60c98)

bpo-28699: fix abnormal behaviour of pools in multiprocessing.pool (GH-882)

an exception raised at the very first of an iterable would cause pools behave abnormally
(swallow the exception or hang)

bpo-16011: clarify that 'in' always returns a boolean value (GH-874)

(cherry picked from commit 0ae7c8bd614d3aa1fcaf2d71a10ff1148c80d9b5)

bpo-29643: Fix check for --enable-optimizations (GH-869)

The presence of the ``--enable-optimizations`` flag is indicated by the
value of ``$enableval``, but the configure script was checking ``$withval``,
resulting in the ``--enable-optimizations`` flag being effectively ignored.
(cherry picked from commit 8cea5929f52801b0ce5928b46ef836e99a24321a)

bpo-29677: DOC: clarify documentation for `round` (GH-357) (GH-862)

(cherry picked from commit 6003db7db5fec545c01923c198a5fdfca5a91538)

Drop the standard gcc test build on Travis (GH-853) (GH-859)

Instead have gcc be used for the coverage build so gcc is exercised in at least one place.
(cherry picked from commit ad2f9e2c8a0b44b3e6aec9d28ba59e13239236f7)

Minor test cleanup (GH-837) (GH-838)

* Remove unused test file

* Remove duplicated text in sndhdrdata README

(cherry picked from commit b8a7daf077dab18e9e3701c5380b542ae0aa9a94)

Treat Sphinx warnings as errors (GH-832) (GH-834)

* Treat Sphinx warnings as errors (GH-832)

(cherry picked from commit 334e9ec938ea9876baadef15edb135d6d2aff30c)

* Remove unused suspicious rules

import sys before we use it on line 9 (GH-828) (GH-833)

(cherry picked from commit 0579e81f30d00da562f021760d5b6a9c35186520)

bpo-29888: Fix the link referring to the "Python download page" (GH-824) (GH-826)

(cherry picked from commit f8beb9831acd5cf80b9c56aea5864e16118c5400)

bpo-29862: Fix grammar in importlib.reload() exception (GH-809) (GH-811)

(cherry picked from commit 9f0aa4843f8c26937d5817f27cac4aae9c0a034f)

bpo-29892: Fix wrong markup on doc-lib-functions (GH-802) (GH-810)

(cherry picked from commit 29540cdf6c66df9f806375a95078c0c63192ef78)

bpo-28810: Document remaining bytecode changes in 3.6 (GH-651) (GH-808)

(cherry picked from commit 8f9e1bbf2dbdf46a0bf920279568a31460043376)

bpo-25803: Avoid incorrect errors raised by Path.mkdir(exist_ok=True)… (#806)

when the OS gives priority to errors such as EACCES over EEXIST.

(cherry picked from commit af7b9ec5c855366feef4c67dc492d64b3baf84ca)

bpo-29861: release references to multiprocessing Pool tasks (#743) (#800)

* bpo-29861: release references to multiprocessing Pool tasks (#743)

* bpo-29861: release references to multiprocessing Pool tasks

Release references to tasks, their arguments and their results as soon
as they are finished, instead of keeping them alive until another task
arrives.

* Comments in test

(cherry picked from commit 8988945cdc27ffa86ba8c624e095b51c459f5154)

* Fix Misc/NEWS (hopefully)

faulthandler: Restore the old sigaltstack during teardown (GH-777) (GH-797)

(cherry picked from commit 20fbf8accd494fd15b0fc4c84928178c71ead4d1)

Remove an outdated statement in execution model docs (GH-754) (GH-775)

(cherry picked from commit fad7f1560669af1766c583c7ef242c55d8c8de41)

bpo-28331: fix impl-detail label is removed when content is translated. (GH-769)

(cherry picked from commit c351ce6a2c923c5016e48ecbf7b1e4833031d154)

doc: minor fix for library/profile (GH-766)

(cherry picked from commit bd3d8ba3b22da0bad018b53a3e6610ae03c5aa49)