Note

This documentation is for a development version of IPython. There may be significant differences from the latest stable release (1.2.1).

Module: utils.module_paths

Utility functions for finding modules

Utility functions for finding modules on sys.path.

find_mod finds named module on sys.path.

get_init helper function that finds __init__ file in a directory.

find_module variant of imp.find_module in std_lib that only returns path to module and not an open file object as well.

3 Functions

IPython.utils.module_paths.find_module(name, path=None)

imp.find_module variant that only return path of module.

The imp.find_module returns a filehandle that we are not interested in. Also we ignore any bytecode files that imp.find_module finds.

Parameters:

name : str

name of module to locate

path : list of str

list of paths to search for name. If path=None then search sys.path

Returns:

filename : str

Return full path of module or None if module is missing or does not have .py or .pyw extension

IPython.utils.module_paths.get_init(dirname)

Get __init__ file path for module directory

Parameters:

dirname : str

Find the __init__ file in directory dirname

Returns:

init_path : str

Path to __init__ file

IPython.utils.module_paths.find_mod(module_name)

Find module module_name on sys.path

Return the path to module module_name. If module_name refers to a module directory then return path to __init__ file. Return full path of module or None if module is missing or does not have .py or .pyw extension. We are not interested in running bytecode.

Parameters:

module_name : str

Returns:

modulepath : str

Path to module module_name.