You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
357 lines
12 KiB
Python
357 lines
12 KiB
Python
# Copyright 2016 The Chromium Authors. All rights reserved.
|
|
# Use of this source code is governed by a BSD-style license that can be
|
|
# found in the LICENSE file.
|
|
|
|
import argparse
|
|
import collections
|
|
import contextlib
|
|
import fnmatch
|
|
import hashlib
|
|
import logging
|
|
import os
|
|
import platform
|
|
import posixpath
|
|
import shutil
|
|
import string
|
|
import subprocess
|
|
import sys
|
|
import tempfile
|
|
|
|
|
|
THIS_DIR = os.path.abspath(os.path.dirname(__file__))
|
|
ROOT_DIR = os.path.abspath(os.path.join(THIS_DIR, '..'))
|
|
|
|
DEVNULL = open(os.devnull, 'w')
|
|
|
|
IS_WIN = sys.platform.startswith('win')
|
|
BAT_EXT = '.bat' if IS_WIN else ''
|
|
|
|
# Top-level stubs to generate that fall through to executables within the Git
|
|
# directory.
|
|
WIN_GIT_STUBS = {
|
|
'git.bat': 'cmd\\git.exe',
|
|
'gitk.bat': 'cmd\\gitk.exe',
|
|
'ssh.bat': 'usr\\bin\\ssh.exe',
|
|
'ssh-keygen.bat': 'usr\\bin\\ssh-keygen.exe',
|
|
}
|
|
|
|
|
|
# Accumulated template parameters for generated stubs.
|
|
class Template(collections.namedtuple('Template', (
|
|
'PYTHON_RELDIR', 'PYTHON_BIN_RELDIR', 'PYTHON_BIN_RELDIR_UNIX',
|
|
'PYTHON3_BIN_RELDIR', 'PYTHON3_BIN_RELDIR_UNIX', 'GIT_BIN_RELDIR',
|
|
'GIT_BIN_RELDIR_UNIX', 'GIT_PROGRAM',
|
|
))):
|
|
|
|
@classmethod
|
|
def empty(cls):
|
|
return cls(**{k: None for k in cls._fields})
|
|
|
|
def maybe_install(self, name, dst_path):
|
|
"""Installs template |name| to |dst_path| if it has changed.
|
|
|
|
This loads the template |name| from THIS_DIR, resolves template parameters,
|
|
and installs it to |dst_path|. See `maybe_update` for more information.
|
|
|
|
Args:
|
|
name (str): The name of the template to install.
|
|
dst_path (str): The destination filesystem path.
|
|
|
|
Returns (bool): True if |dst_path| was updated, False otherwise.
|
|
"""
|
|
template_path = os.path.join(THIS_DIR, name)
|
|
with open(template_path, 'r', encoding='utf8') as fd:
|
|
t = string.Template(fd.read())
|
|
return maybe_update(t.safe_substitute(self._asdict()), dst_path)
|
|
|
|
|
|
def maybe_update(content, dst_path):
|
|
"""Writes |content| to |dst_path| if |dst_path| does not already match.
|
|
|
|
This function will ensure that there is a file at |dst_path| containing
|
|
|content|. If |dst_path| already exists and contains |content|, no operation
|
|
will be performed, preserving filesystem modification times and avoiding
|
|
potential write contention.
|
|
|
|
Args:
|
|
content (str): The file content.
|
|
dst_path (str): The destination filesystem path.
|
|
|
|
Returns (bool): True if |dst_path| was updated, False otherwise.
|
|
"""
|
|
# If the path already exists and matches the new content, refrain from writing
|
|
# a new one.
|
|
if os.path.exists(dst_path):
|
|
with open(dst_path, 'r', encoding='utf-8') as fd:
|
|
if fd.read() == content:
|
|
return False
|
|
|
|
logging.debug('Updating %r', dst_path)
|
|
with open(dst_path, 'w', encoding='utf-8') as fd:
|
|
fd.write(content)
|
|
os.chmod(dst_path, 0o755)
|
|
return True
|
|
|
|
|
|
def maybe_copy(src_path, dst_path):
|
|
"""Writes the content of |src_path| to |dst_path| if needed.
|
|
|
|
See `maybe_update` for more information.
|
|
|
|
Args:
|
|
src_path (str): The content source filesystem path.
|
|
dst_path (str): The destination filesystem path.
|
|
|
|
Returns (bool): True if |dst_path| was updated, False otherwise.
|
|
"""
|
|
with open(src_path, 'r', encoding='utf-8') as fd:
|
|
content = fd.read()
|
|
return maybe_update(content, dst_path)
|
|
|
|
|
|
def call_if_outdated(stamp_path, stamp_version, fn):
|
|
"""Invokes |fn| if the stamp at |stamp_path| doesn't match |stamp_version|.
|
|
|
|
This can be used to keep a filesystem record of whether an operation has been
|
|
performed. The record is stored at |stamp_path|. To invalidate a record,
|
|
change the value of |stamp_version|.
|
|
|
|
After |fn| completes successfully, |stamp_path| will be updated to match
|
|
|stamp_version|, preventing the same update from happening in the future.
|
|
|
|
Args:
|
|
stamp_path (str): The filesystem path of the stamp file.
|
|
stamp_version (str): The desired stamp version.
|
|
fn (callable): A callable to invoke if the current stamp version doesn't
|
|
match |stamp_version|.
|
|
|
|
Returns (bool): True if an update occurred.
|
|
"""
|
|
|
|
stamp_version = stamp_version.strip()
|
|
if os.path.isfile(stamp_path):
|
|
with open(stamp_path, 'r', encoding='utf-8') as fd:
|
|
current_version = fd.read().strip()
|
|
if current_version == stamp_version:
|
|
return False
|
|
|
|
fn()
|
|
|
|
with open(stamp_path, 'w', encoding='utf-8') as fd:
|
|
fd.write(stamp_version)
|
|
return True
|
|
|
|
|
|
def _in_use(path):
|
|
"""Checks if a Windows file is in use.
|
|
|
|
When Windows is using an executable, it prevents other writers from
|
|
modifying or deleting that executable. We can safely test for an in-use
|
|
file by opening it in write mode and checking whether or not there was
|
|
an error.
|
|
|
|
Returns (bool): True if the file was in use, False if not.
|
|
"""
|
|
try:
|
|
with open(path, 'r+'):
|
|
return False
|
|
except IOError:
|
|
return True
|
|
|
|
|
|
def _toolchain_in_use(toolchain_path):
|
|
"""Returns (bool): True if a toolchain rooted at |path| is in use.
|
|
"""
|
|
# Look for Python files that may be in use.
|
|
for python_dir in (
|
|
os.path.join(toolchain_path, 'python', 'bin'), # CIPD
|
|
toolchain_path, # Legacy ZIP distributions.
|
|
):
|
|
for component in (
|
|
os.path.join(python_dir, 'python.exe'),
|
|
os.path.join(python_dir, 'DLLs', 'unicodedata.pyd'),
|
|
):
|
|
if os.path.isfile(component) and _in_use(component):
|
|
return True
|
|
# Look for Pytho:n 3 files that may be in use.
|
|
python_dir = os.path.join(toolchain_path, 'python3', 'bin')
|
|
for component in (
|
|
os.path.join(python_dir, 'python3.exe'),
|
|
os.path.join(python_dir, 'DLLs', 'unicodedata.pyd'),
|
|
):
|
|
if os.path.isfile(component) and _in_use(component):
|
|
return True
|
|
return False
|
|
|
|
|
|
|
|
def _check_call(argv, stdin_input=None, **kwargs):
|
|
"""Wrapper for subprocess.check_call that adds logging."""
|
|
logging.info('running %r', argv)
|
|
if stdin_input is not None:
|
|
kwargs['stdin'] = subprocess.PIPE
|
|
proc = subprocess.Popen(argv, **kwargs)
|
|
proc.communicate(input=stdin_input)
|
|
if proc.returncode:
|
|
raise subprocess.CalledProcessError(proc.returncode, argv, None)
|
|
|
|
|
|
def _safe_rmtree(path):
|
|
if not os.path.exists(path):
|
|
return
|
|
|
|
def _make_writable_and_remove(path):
|
|
st = os.stat(path)
|
|
new_mode = st.st_mode | 0o200
|
|
if st.st_mode == new_mode:
|
|
return False
|
|
try:
|
|
os.chmod(path, new_mode)
|
|
os.remove(path)
|
|
return True
|
|
except Exception:
|
|
return False
|
|
|
|
def _on_error(function, path, excinfo):
|
|
if not _make_writable_and_remove(path):
|
|
logging.warning('Failed to %s: %s (%s)', function, path, excinfo)
|
|
|
|
shutil.rmtree(path, onerror=_on_error)
|
|
|
|
|
|
def clean_up_old_installations(skip_dir):
|
|
"""Removes Python installations other than |skip_dir|.
|
|
|
|
This includes an "in-use" check against the "python.exe" in a given directory
|
|
to avoid removing Python executables that are currently ruinning. We need
|
|
this because our Python bootstrap may be run after (and by) other software
|
|
that is using the bootstrapped Python!
|
|
"""
|
|
root_contents = os.listdir(ROOT_DIR)
|
|
for f in ('win_tools-*_bin', 'python27*_bin', 'git-*_bin', 'bootstrap-*_bin'):
|
|
for entry in fnmatch.filter(root_contents, f):
|
|
full_entry = os.path.join(ROOT_DIR, entry)
|
|
if full_entry == skip_dir or not os.path.isdir(full_entry):
|
|
continue
|
|
|
|
logging.info('Cleaning up old installation %r', entry)
|
|
if not _toolchain_in_use(full_entry):
|
|
_safe_rmtree(full_entry)
|
|
else:
|
|
logging.info('Toolchain at %r is in-use; skipping', full_entry)
|
|
|
|
|
|
# Version of "git_postprocess" system configuration (see |git_postprocess|).
|
|
GIT_POSTPROCESS_VERSION = '2'
|
|
|
|
|
|
def git_get_mingw_dir(git_directory):
|
|
"""Returns (str) The "mingw" directory in a Git installation, or None."""
|
|
for candidate in ('mingw64', 'mingw32'):
|
|
mingw_dir = os.path.join(git_directory, candidate)
|
|
if os.path.isdir(mingw_dir):
|
|
return mingw_dir
|
|
return None
|
|
|
|
|
|
def git_postprocess(template, git_directory):
|
|
# Update depot_tools files for "git help <command>"
|
|
mingw_dir = git_get_mingw_dir(git_directory)
|
|
if mingw_dir:
|
|
docsrc = os.path.join(ROOT_DIR, 'man', 'html')
|
|
git_docs_dir = os.path.join(mingw_dir, 'share', 'doc', 'git-doc')
|
|
for name in os.listdir(docsrc):
|
|
maybe_copy(
|
|
os.path.join(docsrc, name),
|
|
os.path.join(git_docs_dir, name))
|
|
else:
|
|
logging.info('Could not find mingw directory for %r.', git_directory)
|
|
|
|
# Create Git templates and configure its base layout.
|
|
for stub_name, relpath in WIN_GIT_STUBS.items():
|
|
stub_template = template._replace(GIT_PROGRAM=relpath)
|
|
stub_template.maybe_install(
|
|
'git.template.bat',
|
|
os.path.join(ROOT_DIR, stub_name))
|
|
|
|
# Set-up our system configuration environment. The following set of
|
|
# parameters is versioned by "GIT_POSTPROCESS_VERSION". If they change,
|
|
# update "GIT_POSTPROCESS_VERSION" accordingly.
|
|
def configure_git_system():
|
|
git_bat_path = os.path.join(ROOT_DIR, 'git.bat')
|
|
_check_call([git_bat_path, 'config', '--system', 'core.autocrlf', 'false'])
|
|
_check_call([git_bat_path, 'config', '--system', 'core.filemode', 'false'])
|
|
_check_call([git_bat_path, 'config', '--system', 'core.preloadindex',
|
|
'true'])
|
|
_check_call([git_bat_path, 'config', '--system', 'core.fscache', 'true'])
|
|
_check_call([git_bat_path, 'config', '--system', 'protocol.version', '2'])
|
|
|
|
call_if_outdated(
|
|
os.path.join(git_directory, '.git_postprocess'),
|
|
GIT_POSTPROCESS_VERSION,
|
|
configure_git_system)
|
|
|
|
|
|
def main(argv):
|
|
parser = argparse.ArgumentParser()
|
|
parser.add_argument('--verbose', action='store_true')
|
|
parser.add_argument('--bootstrap-name', required=True,
|
|
help='The directory of the Python installation.')
|
|
args = parser.parse_args(argv)
|
|
|
|
logging.basicConfig(level=logging.DEBUG if args.verbose else logging.WARN)
|
|
|
|
template = Template.empty()._replace(
|
|
PYTHON_RELDIR=os.path.join(args.bootstrap_name, 'python'),
|
|
PYTHON_BIN_RELDIR=os.path.join(args.bootstrap_name, 'python', 'bin'),
|
|
PYTHON_BIN_RELDIR_UNIX=posixpath.join(
|
|
args.bootstrap_name, 'python', 'bin'),
|
|
PYTHON3_BIN_RELDIR=os.path.join(args.bootstrap_name, 'python3', 'bin'),
|
|
PYTHON3_BIN_RELDIR_UNIX=posixpath.join(
|
|
args.bootstrap_name, 'python3', 'bin'),
|
|
GIT_BIN_RELDIR=os.path.join(args.bootstrap_name, 'git'),
|
|
GIT_BIN_RELDIR_UNIX=posixpath.join(args.bootstrap_name, 'git'))
|
|
|
|
bootstrap_dir = os.path.join(ROOT_DIR, args.bootstrap_name)
|
|
|
|
# Clean up any old Python and Git installations.
|
|
clean_up_old_installations(bootstrap_dir)
|
|
|
|
if IS_WIN:
|
|
git_postprocess(template, os.path.join(bootstrap_dir, 'git'))
|
|
templates = [
|
|
('git-bash.template.sh', 'git-bash', ROOT_DIR),
|
|
('python27.bat', 'python.bat', ROOT_DIR),
|
|
('python3.bat', 'python3.bat', ROOT_DIR),
|
|
]
|
|
for src_name, dst_name, dst_dir in templates:
|
|
# Re-evaluate and regenerate our root templated files.
|
|
template.maybe_install(src_name, os.path.join(dst_dir, dst_name))
|
|
|
|
# Emit our Python bin depot-tools-relative directory. This is read by
|
|
# python.bat, python3.bat, vpython[.bat] and vpython3[.bat] to identify the
|
|
# path of the current Python installation.
|
|
#
|
|
# We use this indirection so that upgrades can change this pointer to
|
|
# redirect "python.bat" to a new Python installation. We can't just update
|
|
# "python.bat" because batch file executions reload the batch file and seek
|
|
# to the previous cursor in between every command, so changing the batch
|
|
# file contents could invalidate any existing executions.
|
|
#
|
|
# The intention is that the batch file itself never needs to change when
|
|
# switching Python versions.
|
|
|
|
maybe_update(
|
|
template.PYTHON_BIN_RELDIR,
|
|
os.path.join(ROOT_DIR, 'python_bin_reldir.txt'))
|
|
|
|
maybe_update(
|
|
template.PYTHON3_BIN_RELDIR,
|
|
os.path.join(ROOT_DIR, 'python3_bin_reldir.txt'))
|
|
|
|
return 0
|
|
|
|
|
|
if __name__ == '__main__':
|
|
sys.exit(main(sys.argv[1:]))
|