| """ Copies the build output of a custom python interpreter to a directory |
| structure that mirrors that of an official Python distribution. |
| |
| -------------------------------------------------------------------------- |
| File: install_custom_python.py |
| |
| Overview: Most users build LLDB by linking against the standard |
| Python distribution installed on their system. Occasionally |
| a user may want to build their own version of Python, and on |
| platforms such as Windows this is a hard requirement. This |
| script will take the build output of a custom interpreter and |
| install it into a canonical structure that mirrors that of an |
| official Python distribution, thus allowing PYTHONHOME to be |
| set appropriately. |
| |
| Gotchas: None. |
| |
| Copyright: None. |
| -------------------------------------------------------------------------- |
| |
| """ |
| |
| import argparse |
| import itertools |
| import os |
| import shutil |
| import sys |
| |
| |
| def copy_one_file(dest_dir, source_dir, filename): |
| source_path = os.path.join(source_dir, filename) |
| dest_path = os.path.join(dest_dir, filename) |
| print('Copying file %s ==> %s...' % (source_path, dest_path)) |
| shutil.copyfile(source_path, dest_path) |
| |
| |
| def copy_named_files( |
| dest_dir, |
| source_dir, |
| files, |
| extensions, |
| copy_debug_suffix_also): |
| for (file, ext) in itertools.product(files, extensions): |
| copy_one_file(dest_dir, source_dir, file + '.' + ext) |
| if copy_debug_suffix_also: |
| copy_one_file(dest_dir, source_dir, file + '_d.' + ext) |
| |
| |
| def copy_subdirectory(dest_dir, source_dir, subdir): |
| dest_dir = os.path.join(dest_dir, subdir) |
| source_dir = os.path.join(source_dir, subdir) |
| print('Copying directory %s ==> %s...' % (source_dir, dest_dir)) |
| shutil.copytree(source_dir, dest_dir) |
| |
| |
| def copy_distro(dest_dir, dest_subdir, source_dir, source_prefix): |
| dest_dir = os.path.join(dest_dir, dest_subdir) |
| |
| print('Copying distribution %s ==> %s' % (source_dir, dest_dir)) |
| |
| os.mkdir(dest_dir) |
| PCbuild_dir = os.path.join(source_dir, 'PCbuild') |
| if source_prefix: |
| PCbuild_dir = os.path.join(PCbuild_dir, source_prefix) |
| # First copy the files that go into the root of the new distribution. This |
| # includes the Python executables, python27(_d).dll, and relevant PDB |
| # files. |
| print('Copying Python executables...') |
| copy_named_files( |
| dest_dir, PCbuild_dir, ['w9xpopen'], [ |
| 'exe', 'pdb'], False) |
| copy_named_files( |
| dest_dir, PCbuild_dir, [ |
| 'python_d', 'pythonw_d'], ['exe'], False) |
| copy_named_files( |
| dest_dir, PCbuild_dir, [ |
| 'python', 'pythonw'], [ |
| 'exe', 'pdb'], False) |
| copy_named_files(dest_dir, PCbuild_dir, ['python27'], ['dll', 'pdb'], True) |
| |
| # Next copy everything in the Include directory. |
| print('Copying Python include directory') |
| copy_subdirectory(dest_dir, source_dir, 'Include') |
| |
| # Copy Lib folder (builtin Python modules) |
| print('Copying Python Lib directory') |
| copy_subdirectory(dest_dir, source_dir, 'Lib') |
| |
| # Copy tools folder. These are probably not necessary, but we copy them anyway to |
| # match an official distribution as closely as possible. Note that we don't just copy |
| # the subdirectory recursively. The source distribution ships with many more tools |
| # than what you get by installing python regularly. We only copy the tools that appear |
| # in an installed distribution. |
| tools_dest_dir = os.path.join(dest_dir, 'Tools') |
| tools_source_dir = os.path.join(source_dir, 'Tools') |
| os.mkdir(tools_dest_dir) |
| copy_subdirectory(tools_dest_dir, tools_source_dir, 'i18n') |
| copy_subdirectory(tools_dest_dir, tools_source_dir, 'pynche') |
| copy_subdirectory(tools_dest_dir, tools_source_dir, 'scripts') |
| copy_subdirectory(tools_dest_dir, tools_source_dir, 'versioncheck') |
| copy_subdirectory(tools_dest_dir, tools_source_dir, 'webchecker') |
| |
| pyd_names = [ |
| '_ctypes', |
| '_ctypes_test', |
| '_elementtree', |
| '_multiprocessing', |
| '_socket', |
| '_testcapi', |
| 'pyexpat', |
| 'select', |
| 'unicodedata', |
| 'winsound'] |
| |
| # Copy builtin extension modules (pyd files) |
| dlls_dir = os.path.join(dest_dir, 'DLLs') |
| os.mkdir(dlls_dir) |
| print('Copying DLLs directory') |
| copy_named_files(dlls_dir, PCbuild_dir, pyd_names, ['pyd', 'pdb'], True) |
| |
| # Copy libs folder (implibs for the pyd files) |
| libs_dir = os.path.join(dest_dir, 'libs') |
| os.mkdir(libs_dir) |
| print('Copying libs directory') |
| copy_named_files(libs_dir, PCbuild_dir, pyd_names, ['lib'], False) |
| copy_named_files(libs_dir, PCbuild_dir, ['python27'], ['lib'], True) |
| |
| |
| parser = argparse.ArgumentParser( |
| description='Install a custom Python distribution') |
| parser.add_argument( |
| '--source', |
| required=True, |
| help='The root of the source tree where Python is built.') |
| parser.add_argument( |
| '--dest', |
| required=True, |
| help='The location to install the Python distributions.') |
| parser.add_argument( |
| '--overwrite', |
| default=False, |
| action='store_true', |
| help='If the destination directory already exists, destroys its contents first.') |
| parser.add_argument( |
| '--silent', |
| default=False, |
| action='store_true', |
| help='If --overwite was specified, suppress confirmation before deleting a directory tree.') |
| |
| args = parser.parse_args() |
| |
| args.source = os.path.normpath(args.source) |
| args.dest = os.path.normpath(args.dest) |
| |
| if not os.path.exists(args.source): |
| print('The source directory %s does not exist. Exiting...') |
| sys.exit(1) |
| |
| if os.path.exists(args.dest): |
| if not args.overwrite: |
| print('The destination directory \'%s\' already exists and --overwrite was not specified. Exiting...' % args.dest) |
| sys.exit(1) |
| while not args.silent: |
| print('Ok to recursively delete \'%s\' and all contents (Y/N)? Choosing Y will permanently delete the contents.' % args.dest) |
| result = str.upper(sys.stdin.read(1)) |
| if result == 'N': |
| print('Unable to copy files to the destination. The destination already exists.') |
| sys.exit(1) |
| elif result == 'Y': |
| break |
| shutil.rmtree(args.dest) |
| |
| os.mkdir(args.dest) |
| copy_distro(args.dest, 'x86', args.source, None) |
| copy_distro(args.dest, 'x64', args.source, 'amd64') |
