global: use python3 in shebangs

Python 3 is the future. We want Python scripts to be using Python 3
by default.

This change updates all `#!/usr/bin/env python` shebangs to use
`python3`.

Does this mean all scripts use or require Python 3: no.

In the test environment, the `PATH` environment variable in tests is
updated to guarantee that the Python executable used to run
run-tests.py is used. Since test scripts all now use
`#!/usr/bin/env python3`, we had to update this code to install
a `python3` symlink instead of `python`.

It is possible there are some random scripts now executed with the
incorrect Python interpreter in some contexts. However, I would argue
that this was a pre-existing bug: we should almost always be executing
new Python processes using the `sys.executable` from the originating
Python script, as `python` or `python3` won't guarantee we'll use the
same interpreter.

Differential Revision: https://phab.mercurial-scm.org/D9273

contrib/check-code.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # check-code - a style and portability checker for Mercurial
 #

contrib/check-commit

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # Copyright 2014 Matt Mackall <[e-mail]>
 #

contrib/check-config.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # check-config - a config flag documentation checker for Mercurial
 #

contrib/check-py3-compat.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # check-py3-compat - check Python 3 compatibility of Mercurial files
 #

contrib/debugcmdserver.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # Dumps output generated by Mercurial's command server in a formatted style to a
 # given file or stderr if '-' is specified. Output is also written in its raw

contrib/dumprevlog

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 # Dump revlogs as raw data stream
 # $ find .hg/store/ -name "*.i" | xargs dumprevlog > repo.dump
 

contrib/hg-ssh

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # Copyright 2005-2007 by Intevation GmbH <[e-mail]>
 #

contrib/hgperf

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # hgperf - measure performance of Mercurial commands
 #

contrib/hgweb.fcgi

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # An example FastCGI script for use with flup, edit as necessary
 

contrib/import-checker.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 from __future__ import absolute_import, print_function
 

contrib/perf-utils/perf-revlog-write-plot.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 #  Copyright 2018 Paul Morelle <[e-mail]>
 #

contrib/phab-clean.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # A small script to automatically reject idle Diffs
 #

contrib/revsetbenchmarks.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 # Measure the performance of a list of revsets against multiple revisions
 # defined by parameter. Checkout one by one and run perfrevset with every

contrib/simplemerge

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 from __future__ import absolute_import
 
 import getopt

contrib/undumprevlog

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 # Undump a dump from dumprevlog
 # $ hg init
 # $ undumprevlog < repo.dump

doc/check-seclevel.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # checkseclevel - checking section title levels in each online help document
 

doc/docchecker

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # docchecker - look for problematic markup
 #

doc/gendoc.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 """usage: %s DOC ...
 
 where DOC is the name of a document

doc/runrst

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # runrst - register custom roles and run correct writer
 #

hg

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # mercurial - scalable distributed SCM
 #

hgweb.cgi

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # An example hgweb CGI script, edit as necessary
 # See also https://mercurial-scm.org/wiki/PublishingRepositories

i18n/check-translation.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # check-translation.py - check Mercurial specific translation problems
 from __future__ import absolute_import

i18n/hggettext

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # hggettext - carefully extract docstrings for Mercurial
 #

i18n/posplit

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # posplit - split messages in paragraphs on .po/.pot files
 #

tests/artifacts/scripts/generate-churning-bundle.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # generate-branchy-bundle - generate a branch for a "large" branchy repository
 #

tests/check-perf-code.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # check-perf-code - (historical) portability checker for contrib/perf.py
 

tests/dumbhttp.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 from __future__ import absolute_import
 

tests/dummysmtpd.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 """dummy SMTP server for use in tests"""
 

tests/dummyssh

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 from __future__ import absolute_import
 

tests/f

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 """
 Utility for inspecting files in various ways.

tests/filterpyflakes.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 # Filter output by pyflakes to control which warnings we check
 

tests/filtertraceback.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 # Filters traceback lines from stdin.
 

tests/fsmonitor-run-tests.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 # fsmonitor-run-tests.py - Run Mercurial tests with fsmonitor enabled
 #

tests/get-with-headers.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 """This does HTTP GET requests given a host:port and path and returns
 a subset of the headers plus the body of the result."""

tests/hghave

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 """Test the running system for features availability. Exit with zero
 if all features are there, non-zero otherwise. If a feature name is
 prefixed with "no-", the absence of feature is tested.

tests/killdaemons.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 from __future__ import absolute_import
 import errno

tests/ls-l.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 # like ls -l, but do not print date, user, or non-common mode bit, to avoid
 # using globs in tests.

tests/md5sum.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # Based on python's Tools/scripts/md5sum.py
 #

tests/printenv.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # simple script to be used in hooks
 #

tests/readlink.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 from __future__ import absolute_import, print_function
 

tests/revlog-formatv0.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 # Copyright 2010 Intevation GmbH
 # Author(s):
 # Thomas Arendsen Hein <[e-mail]>

tests/run-tests.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # run-tests.py - Run a set of tests on Mercurial
 #
@@ -3434,7 +3434,7 b' class TestRunner(object):'
     def _usecorrectpython(self):
         """Configure the environment to use the appropriate Python in tests."""
         # Tests must use the same interpreter as us or bad things will happen.
-        pyexename = sys.platform == 'win32' and b'python.exe' or b'python'
+        pyexename = sys.platform == 'win32' and b'python.exe' or b'python3'
 
         # os.symlink() is a thing with py3 on Windows, but it requires
         # Administrator rights.

tests/seq.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 #
 # A portable replacement for 'seq'
 #

tests/svn-safe-append.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 from __future__ import absolute_import
 

tests/test-filelog.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 """
 Tests the behavior of filelog w.r.t. data starting with '\1\n'
 """

tests/test-remotefilelog-datapack.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 from __future__ import absolute_import, print_function
 
 import hashlib

tests/test-remotefilelog-histpack.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 from __future__ import absolute_import
 
 import hashlib

tests/test-run-tests.t

@@ -1412,7 +1412,7 b' running is placed.'
   > This should print the start of check-code. If this passes but the
   > previous check failed, that means we found a copy of check-code at whatever
   > RUNTESTSDIR ended up containing, even though it doesn't match TESTDIR.
-  >   $ head -n 3 "\$RUNTESTDIR"/../contrib/check-code.py | sed 's@.!.*python@#!USRBINENVPY@'
+  >   $ head -n 3 "\$RUNTESTDIR"/../contrib/check-code.py | sed 's@.!.*python3@#!USRBINENVPY@'
   >   #!USRBINENVPY
   >   #
   >   # check-code - a style and portability checker for Mercurial

tests/test-status-inprocess.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 from __future__ import absolute_import, print_function
 
 import sys

tests/test-stdio.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 """
 Tests the buffering behavior of stdio streams in `mercurial.utils.procutil`.
 """

tests/tinyproxy.py

@@ -1,4 +1,4 b''
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 from __future__ import absolute_import, print_function