branch merge

Merge from 3.2 for Issue #12084.

Fix #12084. os.stat on Windows wasn't working properly with relative symlinks.

Use of DeviceIoControl to obtain the symlink path via the reparse tag was
removed. The code now uses GetFinalPathNameByHandle in the case of a
symbolic link and works properly given the added test which creates a symbolic
link and calls os.stat on it from multiple locations.

Victor Stinner also noticed an issue with os.lstat following the os.stat
code path when being passed bytes. The posix_lstat function was adjusted to
properly hook up win32_lstat instead of the previous STAT macro (win32_stat).

Issue #12316: Fix sigwait() test using threads

Spawn a new process instead of using fork(). Patch written by Charles-François
Natali.

Also specify encoding when reading setup.cfg (#12320)

Specify the encoding of the setup.cfg in one packaging test (#12320)

Merged documentation update for Formatter.formatTime.

Updated Formatter.formatTime documentation.

Merged documentation update for issue #12206.

Issue #12206: documentation for LogRecord constructor updated re. the level argument.

quaint and completely out of date comment

allow __dir__ to return any sequence

merge 3.2 (#9284)

allow "fake" filenames in findsource (closes #9284)

This allows findsource() to work in doctests.

A patch from Dirkjan Ochtman.

Merge minor doc change from 3.2

Branch merge

Issue #12287: In ossaudiodev, check that the device isn't closed in several
methods.

merge 3.2

merge 3.1

onto 3.1.5

merge 3.2

merge 3.1

Added tag v3.1.4 for changeset c918ec9f3a76

bump to 3.1.4

Add missing reST target to one heading in the tutorial

Adjust logging in packaging.util.spawn (related to #11599)

Use correct directive to document one method

Allow multiple setup hooks in packaging’s setup.cfg files (#12240).

Original patch by Erik Bray.

setup.cfg: Document that description-file can contain more than one file

Fix assorted bugs in packaging.util.cfg_to_args (#11595).

Original patch by Erik Bray.

Move useful function to packaging.util.

Original patch by Erik Bray as part of #11595, changed by me to improve
readability.

Updated Formatter.formatTime docs to indicate configuration via class attributes.

Merged documentation change for Issue #12168.

Documented change for Issue #12168.

merge heads

merge 3.2 (#12009)

merge 3.1 (#12009)

Branch merge

fix regression in netrc comment handling (closes #12009)

Don’t try to install something when running from uninstalled source (#12246).

Original patch by Tshepang Lekhonkhobe.

null merge 3.2 (patch already applied to 3.3)

null merge 3.1 (patch already applied to 3.2)

Issue #10801: Fix test_unicode_filenames() of test_zipfile

Just try to open files from the ZIP for reading, don't extract them to avoid
UnicodeEncodeError if the filename is not encodable to the filesystem encoding
(e.g. ASCII locale encoding).

Issue #8407: skip sigwait() tests if pthread_sigmask() is missing

The new tests now requires pthread_sigmask(). Skip the test if the function is
missing, e.g. if Python is compiled without threads.

test_platform: ignore DeprecationWarning on popen() test

Issue #8407: write error message on sigwait test failure

Issue #8407: Make signal.sigwait() tests more reliable

Block the signal before calling sigwait(). Use os.fork() to ensure that we have
only one thread.

Initial patch written by Charles-François Natali.

Issue #9344: Add os.getgrouplist().

Clean up extra environment variable after packaging tests.

packaging.util.check_environ will define HOME and PLAT if they don’t exist; for
some reason, it does not define PLAT when running the tests from a checkout (so
no regrtest warning) but does when running from an installed Python.

Cleaning up the envvar in test_dist fixes the warning on my machine, but I
suspect that a test runner using a different order to run files or running them
in parallel may have PLAT defined in its environment because of another test.
Quite a lot of code ends up calling check_environ; maybe we should just clean
up PLAT in every test.  For now I’m doing this simple fix, we’ll see if we get
bug reports.

Fix omission in test for packaging install_distinfo command.

The code does not write checksum or file length for .pyc and .pyo in the RECORD
file, in compliance with PEP 376, but the test forgot to take .pyo into
account.  This was not caught because there were no .pyo in the checkout, but
after installing there are .pyo files created by compileall, and the test picks
them up.

Remove *.egg-info from Makefile.pre.in (follow-up to d615eb7bce33, #12218)

Packaging: use repr to display projects name (3ebabfbf6fe3 followup)

Issue #8407: signal.sigwait() releases the GIL

Initial patch by Charles-François Natali.

Removed a Windows 9x trick used before LoadLibraryExW.

Windows 9x has long been unsupported and the result of GetFullPathName
was not even being used in the first place.

Merge #10694: zipfile now ignores garbage at the end of a zipfile.

#10694: zipfile now ignores garbage at the end of a zipfile.

Original fix by 'rep', final patch (with tests) by Xuanji Li.

merge #12283: Fixed regression in smtplib quoting of leading dots in DATA.

#12283: Fixed regression in smtplib quoting of leading dots in DATA.

I unfortunately introduced the regression when I refactored the code,
and there were no tests of quoting so it wasn't caught.  Now there
is one.

Merged upstream changes.

Made time formats in Formatter more configurable.

#10424: argument names are now included in the missing argument message

Fix and initial test patch by Michele Orrù.

Merged fix for issue #12168 from 3.2.

Issue #12168: SysLogHandler now allows NUL termination to be controlled using a new 'append_nul' attribute on the handler.

Merge 3.2

Merge doc fixes from 3.2

Correction to 88e318166eaf - Issue #11583

Rather than wrapping the C _isdir function in a Python function,
just import the C _isdir function directly. Additionally, add in the
docstring which was left out.

The change done for #10645 deserves a NEWS entry

Branch merge

Stop creating a Python-X.Y.Z-pyX.Y.egg-info file on install (#10645)

Branch merge

Document how to define extension modules in setup.cfg

Fix incorrect nesting of sections in setup.cfg specification

Fix example in packaging test_config.

The example C extension used the “three.fast_taunt” name, but no “three” parent
was defined in the setup.cfg.  This did not cause a failure nor even print a
warning, we may want to change that.

Fix #11583. Changed os.path.isdir to use GetFileAttributes instead of os.stat.

By changing to the Windows GetFileAttributes API in nt._isdir we can figure
out if the path is a directory without opening the file via os.stat. This has
the minor benefit of speeding up os.path.isdir by at least 2x for regular
files and 10-15x improvements were seen on symbolic links (which opened the
file multiple times during os.stat). Since os.path.isdir is used in
several places on interpreter startup, we get a minor speedup in startup time.

Fix #11583. Changed os.path.isdir to use GetFileAttributes instead of os.stat.

By changing to the Windows GetFileAttributes API in nt._isdir we can figure
out if the path is a directory without opening the file via os.stat. This has
the minor benefit of speeding up os.path.isdir by at least 2x for regular
files and 10-15x improvements were seen on symbolic links (which opened the
file multiple times during os.stat). Since os.path.isdir is used in
several places on interpreter startup, we get a minor speedup in startup time.

Issue #12021: Make mmap's read() method argument optional. Patch by Petri
Lehtinen.

Issue #9205: concurrent.futures.ProcessPoolExecutor now detects killed
children and raises BrokenProcessPool in such a situation.  Previously it
would reliably freeze/deadlock.

Fix a few misuses of :option: I missed in r86521.

Extract of the commit message:

  Fix usage of :option: in the docs (#9312).

  :option: is used to create a link to an option of python, not to mark
  up any instance of any arbitrary command-line option.  These were
  changed to ````.

Revert a reversed comparison order introduced in r70695.

Add links from builtins module docs to built-in functions and constants docs

Style change in packaging: use “not in” over “not x in”.

Such tests are IMO easier to read if both operators are grouped.

Packaging: always use repr to display project names.

This helps debugging in case of trailing blanks and such things.

Fix misunderstanding of how booleans work

Packaging cleanup: normalize print calls.

Namely: use default arguments instead of explicit empty string; use multiple
arguments instead of building strings.

Packaging cleanup: remove use of script_name where obsolete

Add examples that work on Windows to distutils docs (#1626300)

Remove outdated bit of advice (584f9c213a6d follow-up)

Kill dead code in importlib.test.__main__ (#12019, reviewed by Brett Cannon)

Branch merge: packaging fixes

#12274: use proper escaping for % in IDLE config (merged from 3.2).

#12274: use proper escaping for % in IDLE config.

(Merge 3.2) test.support: don't catch OSError when can_symlink() removes the
temporary symbolic link.

test.support: can_symlink() removes the temporary symbolic link

Remove a redundant assignment.

Found by LLVM/clang 2.9.

Checking if an unsigned long is < 0 is pointless.

Found by LLVM/clang 2.9.

Remove some extraneous parentheses and swap the comparison order to
prevent accidental assignment.

Silences a warning from LLVM/clang 2.9.

When building sqlite3, the directory where sqlite.h was found was
always appended to the include directories regardless of whether it
was already in the list of directories. This could cause issue if
sqlite was installed in the same location as another install of
Python. Now a check is done to make sure the directory is not included
twice.

Use a sleep for test_subprocess timeout test

instead of an active loop (while True: pass) to limit race conditions.

Fix UnboundLocalError in a finally block of one packaging test

Fix sdist to always include setup.cfg (#11092), to comply with the spec