Package org.python.core

Class imp

java.lang.Object

org.python.core.imp

public class imp
extends Object

Utility functions for "import" support.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	APIVersion

Method Summary

Modifier and Type	Method	Description
static PyModule	addModule(String name)	If the given name is found in sys.modules, the entry from there is returned.
static String	cacheCompiledSource(String sourceFilename, String compiledFilename, byte[] compiledSource)	Stores the bytes in compiledSource in compiledFilename.
static boolean	caseok(File file, String filename, int namelen)
static byte[]	compileSource(String name, File file, String sourceFilename, String compiledFilename)
static PyObject	createFromSource(String name, InputStream fp, String filename)
static String	defaultEmptyPathDirectory(String directoryName)	If directoryName is empty, return a correct directory name for a path.
static ClassLoader	getSyspathJavaLoader()
static void	importAll(String mod, PyFrame frame)	Called from jython generated code when a statement like "from spam.eggs import *" is executed.
static PyObject[]	importFrom(String mod, String[] names, PyFrame frame)	Called from jython generated code when a stamenet like "from spam.eggs import foo, bar" is executed.
static PyObject[]	importFromAs(String mod, String[] names, String[] asnames, PyFrame frame)	Called from jython generated code when a statement like "from spam.eggs import foo as spam" is executed.
static PyObject	importName(String name, boolean top)	Import a module by name.
static PyObject	importName(String name, boolean top, PyObject modDict, PyObject fromlist)	Import a module by name.
static PyObject	importOne(String mod, PyFrame frame)	Called from jython generated code when a statement like "import spam" is executed.
static PyObject	importOneAs(String mod, PyFrame frame)	Called from jython generated code when a statement like "import spam as foo" is executed.
static PyObject	load(String name)	Load the module by name.
static PyObject	loadFromCompiled(String name, InputStream stream, String filename)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

APIVersion

public static final int APIVersion

See Also:

• Constant Field Values

Method Details

getSyspathJavaLoader

public static ClassLoader getSyspathJavaLoader()

addModule

public static PyModule addModule(String name)

If the given name is found in sys.modules, the entry from there is returned. Otherwise a new PyModule is created for the name and added to sys.modules

compileSource

public static byte[] compileSource(String name,
 File file,
 String sourceFilename,
 String compiledFilename)

cacheCompiledSource

public static String cacheCompiledSource(String sourceFilename,
 String compiledFilename,
 byte[] compiledSource)

Stores the bytes in compiledSource in compiledFilename. If compiledFilename is null it's set to the results of makeCompiledFilename(sourcefileName) If sourceFilename is null or set to UNKNOWN_SOURCEFILE null is returned

Returns:

the compiledFilename eventually used or null if a compiledFilename couldn't be determined of if an error was thrown while writing to the cache file.

createFromSource

public static PyObject createFromSource(String name,
 InputStream fp,
 String filename)

loadFromCompiled

public static PyObject loadFromCompiled(String name,
 InputStream stream,
 String filename)

defaultEmptyPathDirectory

public static String defaultEmptyPathDirectory(String directoryName)

If directoryName is empty, return a correct directory name for a path. If directoryName is not an empty string, this method returns directoryName unchanged.

caseok

public static boolean caseok(File file,
 String filename,
 int namelen)

load

public static PyObject load(String name)

Load the module by name. Upon loading the module it will be added to sys.modules.

Parameters:

name - the name of the module to load

Returns:

the loaded module

importName

public static PyObject importName(String name,
 boolean top)

Import a module by name.

Parameters:

name - the name of the package to import

top - if true, return the top module in the name, otherwise the last

Returns:

an imported module (Java or Python)

importName

public static PyObject importName(String name,
 boolean top,
 PyObject modDict,
 PyObject fromlist)

Import a module by name. This is the default call for __builtin__.__import__.

Parameters:

name - the name of the package to import

top - if true, return the top module in the name, otherwise the last

modDict - the __dict__ of an already imported module

Returns:

an imported module (Java or Python)

importOne

public static PyObject importOne(String mod,
 PyFrame frame)

Called from jython generated code when a statement like "import spam" is executed.

importOneAs

public static PyObject importOneAs(String mod,
 PyFrame frame)

Called from jython generated code when a statement like "import spam as foo" is executed.

importFrom

public static PyObject[] importFrom(String mod,
 String[] names,
 PyFrame frame)

Called from jython generated code when a stamenet like "from spam.eggs import foo, bar" is executed.

importFromAs

public static PyObject[] importFromAs(String mod,
 String[] names,
 String[] asnames,
 PyFrame frame)

Called from jython generated code when a statement like "from spam.eggs import foo as spam" is executed.

importAll

public static void importAll(String mod,
 PyFrame frame)

Called from jython generated code when a statement like "from spam.eggs import *" is executed.