poky/scripts/pythondeps
Christopher Larson 1b7b58ac97 recipetool: add python dependency scanning support
This uses a standalone python script named `pythondeps` which now lives in
scripts. It supports scanning for provided packages and imported
modules/packages, the latter via the python ast. It's not perfect, and
obviously conditional imports and try/except import blocks are handled
naively, listing all the imports even if they aren't all used at once, but it
gives the user a solid starting point for the recipe.

Currently `python_dir` from setup.py isn't being handled in an ideal way. This
is easily seen when testing the python-async package. There, the root of the
project is the async package, so the root has __init__.py and friends, and the
python provides scanning currently just assumes the basedir of that dir is the
package name in this case, which is not correct. Forthcoming patches will
resolve this.

(From OE-Core rev: cb093aca3b78f130dc7da820a8710342a12d1231)

Signed-off-by: Christopher Larson <kergoth@gmail.com>
Signed-off-by: Ross Burton <ross.burton@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-01-23 11:36:28 +00:00

7.5 KiB
Executable File

#!/usr/bin/env python

Determine dependencies of python scripts or available python modules in a search path.

Given the -d argument and a filename/filenames, returns the modules imported by those files.

Given the -d argument and a directory/directories, recurses to find all

python packages and modules, returns the modules imported by these.

Given the -p argument and a path or paths, scans that path for available python modules/packages.

import argparse import ast import imp import logging import os.path import sys

logger = logging.getLogger('pythondeps')

suffixes = [] for triple in imp.get_suffixes(): suffixes.append(triple[0])

class PythonDepError(Exception): pass

class DependError(PythonDepError): def init(self, path, error): self.path = path self.error = error PythonDepError.init(self, error)

def __str__(self):
    return "Failure determining dependencies of {}: {}".format(self.path, self.error)

class ImportVisitor(ast.NodeVisitor): def init(self): self.imports = set() self.importsfrom = []

def visit_Import(self, node):
    for alias in node.names:
        self.imports.add(alias.name)

def visit_ImportFrom(self, node):
    self.importsfrom.append((node.module, [a.name for a in node.names], node.level))

def walk_up(path): while path: yield path path, _, _ = path.rpartition(os.sep)

def get_provides(path): path = os.path.realpath(path)

def get_fn_name(fn):
    for suffix in suffixes:
        if fn.endswith(suffix):
            return fn[:-len(suffix)]

isdir = os.path.isdir(path)
if isdir:
    pkg_path = path
    walk_path = path
else:
    pkg_path = get_fn_name(path)
    if pkg_path is None:
        return
    walk_path = os.path.dirname(path)

for curpath in walk_up(walk_path):
    if not os.path.exists(os.path.join(curpath, '__init__.py')):
        libdir = curpath
        break
else:
    libdir = ''

package_relpath = pkg_path[len(libdir)+1:]
package = '.'.join(package_relpath.split(os.sep))
if not isdir:
    yield package, path
else:
    if os.path.exists(os.path.join(path, '__init__.py')):
        yield package, path

    for dirpath, dirnames, filenames in os.walk(path):
        relpath = dirpath[len(path)+1:]
        if relpath:
            if '__init__.py' not in filenames:
                dirnames[:] = []
                continue
            else:
                context = '.'.join(relpath.split(os.sep))
                if package:
                    context = package + '.' + context
                yield context, dirpath
        else:
            context = package

        for fn in filenames:
            adjusted_fn = get_fn_name(fn)
            if not adjusted_fn or adjusted_fn == '__init__':
                continue

            fullfn = os.path.join(dirpath, fn)
            if context:
                yield context + '.' + adjusted_fn, fullfn
            else:
                yield adjusted_fn, fullfn

def get_code_depends(code_string, path=None, provide=None, ispkg=False): try: code = ast.parse(code_string, path) except TypeError as exc: raise DependError(path, exc) except SyntaxError as exc: raise DependError(path, exc)

visitor = ImportVisitor()
visitor.visit(code)
for builtin_module in sys.builtin_module_names:
    if builtin_module in visitor.imports:
        visitor.imports.remove(builtin_module)

if provide:
    provide_elements = provide.split('.')
    if ispkg:
        provide_elements.append("__self__")
    context = '.'.join(provide_elements[:-1])
    package_path = os.path.dirname(path)
else:
    context = None
    package_path = None

levelzero_importsfrom = (module for module, names, level in visitor.importsfrom
                         if level == 0)
for module in visitor.imports | set(levelzero_importsfrom):
    if context and path:
        module_basepath = os.path.join(package_path, module.replace('.', '/'))
        if os.path.exists(module_basepath):
            # Implicit relative import
            yield context + '.' + module, path
            continue

        for suffix in suffixes:
            if os.path.exists(module_basepath + suffix):
                # Implicit relative import
                yield context + '.' + module, path
                break
        else:
            yield module, path
    else:
        yield module, path

for module, names, level in visitor.importsfrom:
    if level == 0:
        continue
    elif not provide:
        raise DependError("Error: ImportFrom non-zero level outside of a package: {0}".format((module, names, level)), path)
    elif level > len(provide_elements):
        raise DependError("Error: ImportFrom level exceeds package depth: {0}".format((module, names, level)), path)
    else:
        context = '.'.join(provide_elements[:-level])
        if module:
            if context:
                yield context + '.' + module, path
            else:
                yield module, path

def get_file_depends(path): try: code_string = open(path, 'r').read() except (OSError, IOError) as exc: raise DependError(path, exc)

return get_code_depends(code_string, path)

def get_depends_recursive(directory): directory = os.path.realpath(directory)

provides = dict((v, k) for k, v in get_provides(directory))
for filename, provide in provides.iteritems():
    if os.path.isdir(filename):
        filename = os.path.join(filename, '__init__.py')
        ispkg = True
    elif not filename.endswith('.py'):
        continue
    else:
        ispkg = False

    with open(filename, 'r') as f:
        source = f.read()

    depends = get_code_depends(source, filename, provide, ispkg)
    for depend, by in depends:
        yield depend, by

def get_depends(path): if os.path.isdir(path): return get_depends_recursive(path) else: return get_file_depends(path)

def main(): logging.basicConfig()

parser = argparse.ArgumentParser(description='Determine dependencies and provided packages for python scripts/modules')
parser.add_argument('path', nargs='+', help='full path to content to be processed')
group = parser.add_mutually_exclusive_group()
group.add_argument('-p', '--provides', action='store_true',
                   help='given a path, display the provided python modules')
group.add_argument('-d', '--depends', action='store_true',
                   help='given a filename, display the imported python modules')

args = parser.parse_args()
if args.provides:
    modules = set()
    for path in args.path:
        for provide, fn in get_provides(path):
            modules.add(provide)

    for module in sorted(modules):
        print(module)
elif args.depends:
    for path in args.path:
        try:
            modules = get_depends(path)
        except PythonDepError as exc:
            logger.error(str(exc))
            sys.exit(1)

        for module, imp_by in modules:
            print("{}\t{}".format(module, imp_by))
else:
    parser.print_help()
    sys.exit(2)

if name == 'main': main()