blob: 1999e4cacd8450801b164e68402762661f3275f7 [file] [log] [blame]
# Copyright (c) 2012 The Chromium OS Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
"""Creates a self-extracting Python executable."""
DESCRIPTION = """Creates a self-extracting Python executable.
The generated executable contains a copy of the entire factory code
and can be used to executed any "well-behaved" executable, in
particular the shopfloor server and tools like mount_partition. Simply
generate an output file whose name is the same as any symlink in the bin
directory, or create a symlink to the generated archive with such a name.
For instance:
make_par -o shopfloor_server
# ./shopfloor_server is now a fully-functional, standalone shopfloor server
# including all dependencies.
make_par # Generates factory.par
ln -s factory.par shopfloor_server
ln -s factory.par mount_partition
# You can now run either ./shopfloor_server or ./mount_partition.
import argparse
import glob
import logging
import os
import re
import shutil
import subprocess
import sys
import tempfile
from distutils.sysconfig import get_python_lib
import factory_common # pylint: disable=W0611
from cros.factory.test.env import paths
from cros.factory.utils.process_utils import Spawn, SpawnOutput
# Template for the header that will be placed before the ZIP file to
# execute a script based on the name which is used to execute it. The
# literal string "MODULES" is replaced with a map from executable name
# to fully-qualified module name (e.g., {'mount_partition':
# ''}).
HEADER_TEMPLATE = """#!/bin/sh
# This par file.
par="$(readlink -f $0)"
# The directory this par file is in.
dir="$(dirname "$par")"
if [ -e $dir/ ]; then
# The .par file has been expanded. Print a warning and use the expanded
# file.
echo WARNING: factory.par has been unzipped. Using the unzipped files. >& 2
exec python -c \
"import os, runpy, sys
# Remove '-c' from argument list.
sys.argv = sys.argv[1:]
# List of modules, based on symlinks in 'bin' when make_par was run.
# The actual list is substituted in by the make_par script.
modules = MODULES
# Use the name we were executed as to determine which module to run.
if sys.argv[0].endswith('.par') and len(sys.argv) > 1:
# Not run as a symlink; remove argv[0]. This allows you to run, e.g.,
# factory.par gooftool probe.
sys.argv = sys.argv[1:]
name = os.path.basename(sys.argv[0])
module = modules.get(name)
# Set the process title, if available
from setproctitle import setproctitle
setproctitle(' '.join(sys.argv))
pass # Oh well
# Set process title so killall/pkill will work.
import ctypes
buff = ctypes.create_string_buffer(len(name) + 1)
buff.value = name
ctypes.cdll.LoadLibrary('').prctl(15, ctypes.byref(buff), 0, 0, 0)
pass # Oh well
if not module:
# Display an error message describing the valid commands.
print >>sys.stderr, (
'Unable to run %s. To run a file within this archive,' % name)
print >>sys.stderr, (
'rename it to (or create a symbolic link from) one of the following:')
print >>sys.stderr
for m in sorted(modules.keys()):
print >>sys.stderr, ' %s' % m
runpy.run_module(module, run_name='__main__')" "$0" "$@"
echo Unable to exec "$*" >& 2
exit 1
# ZIP file follows...
def main(argv=None):
parser = argparse.ArgumentParser(
parser.add_argument('--verbose', '-v', action='count')
'--output', '-o', metavar='FILE', default='factory.par',
help='output file (default: %(default)s')
'--add-zip', action='append', default=[],
help='zip files containing extra files to include')
'--mini', action='store_true',
help='Build smaller version suitable for installation into test image')
args = parser.parse_args(argv)
logging.basicConfig(level=logging.WARNING - 10 * (args.verbose or 0))
tmp = os.path.realpath(tempfile.mkdtemp(prefix='make_par.'))
par_build = os.path.join(tmp, 'par_build')
# Copy our py sources and bins, and any overlays, into the src
# directory.
src = os.path.join(tmp, 'src')
Spawn(['rsync', '-a',
'--exclude', 'testdata',
os.path.join(paths.FACTORY_PATH, 'py'),
os.path.join(paths.FACTORY_PATH, 'bin'),
log=True, check_call=True)
# Add files from overlay.
for f in args.add_zip:
Spawn(['unzip', '-oq', f, '-d', src],
log=True, check_call=True)
cros_dir = os.path.join(par_build, 'cros')
rsync_args = ['rsync', '-a',
'--exclude', '*',
'--exclude', '*',
'--include', '*.py']
# Exclude some piggy directories we'll never need for the mini
# par, since we will not run these things in a test image.
rsync_args.extend(['--exclude', 'static',
'--exclude', 'testdata',
'--exclude', 'goofy',
'--exclude', 'minijack',
'--exclude', 'pytests'])
rsync_args.extend(['--include', '*.css',
'--include', '*.csv',
'--include', '*.html',
'--include', '*.js',
'--include', '*.png',
'--include', '*.json',
# Config file templates needed by the factory_flow
# tool.
'--include', 'factory_flow/templates/*',
# We must include goofy explicitly, as it is
# a symlink that would otherwise be excluded
# by the * wildcard.
'--include', 'goofy'])
'--include', '*/',
'--exclude', '*',
os.path.join(src, 'py/'),
os.path.join(cros_dir, 'factory')])
Spawn(rsync_args, log=True, check_call=True)
# Copy necessary third-party packages. They are already present in test
# images, so no need in mini version.
if not
python_lib = get_python_lib()
rsync_args = ['rsync', '-a',
os.path.join(python_lib, 'enum'),
os.path.join(python_lib, 'google'),
os.path.join(python_lib, 'jsonrpclib'),
os.path.join(python_lib, 'yaml')]
Spawn(rsync_args, log=True, check_call=True,
# Add empty files so Python realizes these directories
# are modules.
open(os.path.join(cros_dir, ''), 'w')
open(os.path.join(cros_dir, 'factory', ''), 'w')
# Add an empty factory_common file (since many scripts import
# factory_common).
open(os.path.join(par_build, ''), 'w')
# Zip 'em up!
factory_par = os.path.join(tmp, 'factory.par')
Spawn(['zip', '-qr', factory_par, '.'],
check_call=True, log=True, cwd=par_build)
# Build a map of runnable modules based on symlinks in bin.
modules = {}
bin_dir = os.path.join(src, 'bin')
for f in glob.glob(os.path.join(bin_dir, '*')):
if not os.path.islink(f):
dest = os.readlink(f)
match = re.match(r'\.\./py/(.+)\.py$', dest)
if not match:
module = 'cros.factory.%s' %'/', '.')
name = module.rpartition('.')[2]'Mapping binary %s to %s', name, module)
modules[name] = module
# Also map the name of symlink to binary.
link_name = os.path.basename(f)
if link_name != name:'Mapping binary %s to %s', link_name, module)
modules[link_name] = module
# Concatenate the header and the par file.
with open(args.output, 'wb') as out:
out.write(HEADER_TEMPLATE.replace('MODULES', repr(modules)))
shutil.copyfileobj(open(factory_par), out)
os.fchmod(out.fileno(), 0755)
# Done!
print 'Created %s (%d bytes)' % (args.output, os.path.getsize(args.output))
# Sanity check: make sure we can run 'make_par --help' within the
# archive, in a totally clean environment, and see the help
# message.
link = os.path.join(tmp, 'make_par')
os.symlink(os.path.realpath(args.output), link)
output = SpawnOutput(
[link, '--help'], env={}, cwd='/',
check_call=True, read_stdout=True, log_stderr_on_error=True)
if 'show this help message and exit' not in output:
logging.error('Unable to run "make_par --help": output is %r', output)
except subprocess.CalledProcessError:
logging.error('Unable to run "make_par --help" within the .par file')
return False
return True
if __name__ == '__main__':
sys.exit(0 if main() else 1)