author Chris Pearce <>
Wed, 16 Mar 2016 13:49:26 +0800
changeset 288911 49aa9281700cdacc521a7fa851abfc019831f1eb
parent 288873 93df41fba9ac836323de8643237c9c0943f28b95
child 289100 a989025d727f70b7c0a709e5658d58ab0eb9ee4d
permissions -rw-r--r--
Bug 1256065. r=gerald

# -*- Mode: python; c-basic-offset: 4; indent-tabs-mode: nil; tab-width: 40 -*-
# vim: set filetype=python:
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at

# Templates implementing some generic checks.

# Helper to display "checking" messages
#   @checking('for foo')
#   def foo():
#       return 'foo'
# is equivalent to:
#   def foo():
#       sys.stdout.write('checking for foo... ')
#       ret = foo
#       sys.stdout.write(ret + '\n')
#       return ret
# This can be combined with e.g. @depends:
#   @depends(some_option)
#   @checking('for something')
#   def check(value):
#       ...
def checking(what):
    def decorator(func):
        def wrapped(*args, **kwargs):
            import sys
            print('checking', what, end='... ')
            ret = func(*args, **kwargs)
            if ret is True:
            elif ret is False:
            return ret
        return wrapped
    return decorator

# Template to check for programs in $PATH.
#   check('PROG', ('a', 'b'))
# will look for 'a' or 'b' in $PATH, and set_config PROG to the one
# it can find. If PROG is already set from the environment or command line,
# use that value instead.
def check_prog(var, progs, allow_missing=False):
    option(env=var, nargs=1, help='Path to the %s program' % var.lower())

    not_found = 'not found'
    progs = list(progs)

    @checking('for %s' % var.lower())
    def check(value):
        if value:
            progs[:] = value
        for prog in progs:
            result = find_program(prog)
            if result:
                return result
        return not_found

    def postcheck(value):
        set_config(var, ':' if value is not_found else value)
        if not value and not allow_missing:
            from mozbuild.shellutil import quote
            error('Cannot find %s (tried: %s)'
                  % (var.lower(), ', '.join(quote(p) for p in progs)))

    return check