Jython 2.7.4 · org.python.compiler.Module · APIdia, the JavaDoc alternative

Field Summary

Modifier and Type	Field and Description
private static final char[]	base64enc Look-up table for `base64encodeToString(byte[])`.
pack-priv ClassFile	classfile
pack-priv List<PyCodeConstant>	codes
pack-priv Hashtable<Constant, Constant>	constants The pool of Python Constants
private static String	CPYTHON_CMD_MSG
pack-priv Constant	filename
pack-priv Future	futures
private static String	LARGE_METHOD_MSG
pack-priv boolean	linenumbers
pack-priv Constant	mainCode
private static final int	MAX_SETTINGS_PER_SETTER
private static final int	maxLiteral
pack-priv long	mtime
protected Hashtable<String, String>	oversized_methods Table of oversized methods represented as CPython bytecode.
private static String	PLEASE_PROVIDE_MSG
pack-priv Hashtable<PythonTree, ScopeInfo>	scopes
private int	setter_count
pack-priv String	sfilename
private static String	TRIED_CREATE_PYC_MSG
private static final int	USE_SETTERS_LIMIT

Constructor Summary

Access	Constructor and Description
public	Module(String name, String filename, boolean linenumbers)
public	Module(String name, String filename, boolean linenumbers, long mtime)
public	Module(String name)

Method Summary

Modifier and Type	Method and Description
protected static void	_module_init(mod node, Module module, boolean printResults, CompilerFlags cflags)
public void	addBootstrap()
pack-priv void	addConstants(Code c)
public void	addFunctions()
public void	addInit() This block of code writes out the various standard methods
public void	addMain()
public void	addRunnable()
private static String	Returns: the string encoding the data base64encodeToString(byte[] to encode data) Implement a simplified base64 encoding compatible with the decoding in BytecodeLoader.
pack-priv Constant	codeConstant(mod tree, String name, boolean fast_locals, String className, boolean classBody, boolean printResults, int firstlineno, ScopeInfo scope, CompilerFlags cflags)
pack-priv Constant	codeConstant(mod tree, String name, boolean fast_locals, String className, Str classDoc, boolean classBody, boolean printResults, int firstlineno, ScopeInfo scope, CompilerFlags cflags)
public static void	compile(mod node, OutputStream ostream, String name, String filename, boolean linenumbers, boolean printResults, CompilerFlags cflags)
public static void	compile(mod AST of the module to write node, OutputStream stream onto which to write it ostream, String name, String filename, boolean linenumbers, boolean printResults, CompilerFlags cflags, long mtime) Create and write a Python module as a Java class file.
pack-priv Constant	complexConstant(double value)
public void	emitNum(Num node, Code code)
public boolean	emitPrimitiveArraySetters(List<? extends PythonTree> nodes, Code code)
public void	emitStr(Str node, Code code)
public void	error(String msg, boolean err, PythonTree node) Implements org.python.compiler.CompilationContext.error.
private Constant	findConstant(Constant c)
pack-priv Constant	floatConstant(double value)
public String	getFilename() Implements org.python.compiler.CompilationContext.getFilename.
public Future	getFutures() Implements org.python.compiler.CompilationContext.getFutures.
public ScopeInfo	getScopeInfo(PythonTree node) Implements org.python.compiler.CompilationContext.getScopeInfo.
private static void	insert_code_str_to_classfile(String of the method or function being generated name, String Base64 encoded CPython byte code code_str, Module currently being defined as a class file module) This method stores Base64 encoded Python byte code in one or more String literals.
pack-priv Constant	integerConstant(int value)
private static PyBytecode	loadPyBytecode(String filename, boolean try_cpython)
pack-priv Constant	longConstant(String value)
private static String	serializePyBytecode(PyBytecode btcode)
pack-priv Constant	stringConstant(String value)
pack-priv Constant	unicodeConstant(String value)
public void	write(OutputStream stream)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

base64enc	back to summary
private static final char[] base64enc Look-up table for `base64encodeToString(byte[])`.

classfile	back to summary
pack-priv ClassFile classfile

codes	back to summary
pack-priv List<PyCodeConstant> codes

constants	back to summary
pack-priv Hashtable<Constant, Constant> constants The pool of Python Constants

CPYTHON_CMD_MSG	back to summary
private static String CPYTHON_CMD_MSG

filename	back to summary
pack-priv Constant filename

futures	back to summary
pack-priv Future futures

LARGE_METHOD_MSG	back to summary
private static String LARGE_METHOD_MSG

linenumbers	back to summary
pack-priv boolean linenumbers

mainCode	back to summary
pack-priv Constant mainCode

MAX_SETTINGS_PER_SETTER	back to summary
private static final int MAX_SETTINGS_PER_SETTER

maxLiteral	back to summary
private static final int maxLiteral

mtime	back to summary
pack-priv long mtime

oversized_methods	back to summary
protected Hashtable<String, String> oversized_methods Table of oversized methods represented as CPython bytecode.

PLEASE_PROVIDE_MSG	back to summary
private static String PLEASE_PROVIDE_MSG

scopes	back to summary
pack-priv Hashtable<PythonTree, ScopeInfo> scopes

setter_count	back to summary
private int setter_count

sfilename	back to summary
pack-priv String sfilename

TRIED_CREATE_PYC_MSG	back to summary
private static String TRIED_CREATE_PYC_MSG

USE_SETTERS_LIMIT	back to summary
private static final int USE_SETTERS_LIMIT

Constructor Detail

Module	back to summary
public Module(String name, String filename, boolean linenumbers)

Module	back to summary
public Module(String name, String filename, boolean linenumbers, long mtime)

Module	back to summary
public Module(String name)

Method Detail

_module_init	back to summary
protected static void _module_init(mod node, Module module, boolean printResults, CompilerFlags cflags) throws Exception

addBootstrap	back to summary
public void addBootstrap() throws IOException

addConstants	back to summary
pack-priv void addConstants(Code c) throws IOException

addFunctions	back to summary
public void addFunctions() throws IOException

addInit	back to summary
public void addInit() throws IOException This block of code writes out the various standard methods

addMain	back to summary
public void addMain() throws IOException

addRunnable	back to summary
public void addRunnable() throws IOException

base64encodeToString back to summary

base64encodeToString	back to summary
private static String base64encodeToString(byte[] data) Implement a simplified base64 encoding compatible with the decoding in BytecodeLoader. This encoder adds no '=' padding or line-breaks. equivalent to `binascii.b2a_base64(bytes).rstrip('=\n')`. Parameters data:byte[] to encode Returns:String the string encoding the data

private static String base64encodeToString(byte[] data)

Implement a simplified base64 encoding compatible with the decoding in BytecodeLoader. This encoder adds no '=' padding or line-breaks. equivalent to binascii.b2a_base64(bytes).rstrip('=\n').

Parameters

data:byte[]: to encode

Returns:String

the string encoding the data

codeConstant	back to summary
pack-priv Constant codeConstant(mod tree, String name, boolean fast_locals, String className, boolean classBody, boolean printResults, int firstlineno, ScopeInfo scope, CompilerFlags cflags) throws Exception

codeConstant	back to summary
pack-priv Constant codeConstant(mod tree, String name, boolean fast_locals, String className, Str classDoc, boolean classBody, boolean printResults, int firstlineno, ScopeInfo scope, CompilerFlags cflags) throws Exception

compile	back to summary
public static void compile(mod node, OutputStream ostream, String name, String filename, boolean linenumbers, boolean printResults, CompilerFlags cflags) throws Exception

compile	back to summary
public static void compile(mod node, OutputStream ostream, String name, String filename, boolean linenumbers, boolean printResults, CompilerFlags cflags, long mtime) throws Exception Create and write a Python module as a Java class file. Parameters node:mod AST of the module to write ostream:OutputStream stream onto which to write it

compile

back to summary

public static void compile(mod node, OutputStream ostream, String name, String filename, boolean linenumbers, boolean printResults, CompilerFlags cflags, long mtime) throws Exception

Create and write a Python module as a Java class file.

Parameters

node:mod: AST of the module to write
ostream:OutputStream: stream onto which to write it

complexConstant	back to summary
pack-priv Constant complexConstant(double value)

emitNum	back to summary
public void emitNum(Num node, Code code) throws Exception

emitPrimitiveArraySetters	back to summary
public boolean emitPrimitiveArraySetters(List<? extends PythonTree> nodes, Code code) throws Exception

emitStr	back to summary
public void emitStr(Str node, Code code) throws Exception

error	back to summary
public void error(String msg, boolean err, PythonTree node) throws Exception Implements org.python.compiler.CompilationContext.error. Annotations @Override

error

back to summary

public void error(String msg, boolean err, PythonTree node) throws Exception

Implements org.python.compiler.CompilationContext.error.

Annotations

@Override

findConstant	back to summary
private Constant findConstant(Constant c)

floatConstant	back to summary
pack-priv Constant floatConstant(double value)

getFilename	back to summary
public String getFilename() Implements org.python.compiler.CompilationContext.getFilename. Annotations @Override

getFilename

back to summary

public String getFilename()

Implements org.python.compiler.CompilationContext.getFilename.

Annotations

@Override

getFutures	back to summary
public Future getFutures() Implements org.python.compiler.CompilationContext.getFutures. Annotations @Override

getFutures

back to summary

public Future getFutures()

Implements org.python.compiler.CompilationContext.getFutures.

Annotations

@Override

getScopeInfo	back to summary
public ScopeInfo getScopeInfo(PythonTree node) Implements org.python.compiler.CompilationContext.getScopeInfo. Annotations @Override

getScopeInfo

back to summary

public ScopeInfo getScopeInfo(PythonTree node)

Implements org.python.compiler.CompilationContext.getScopeInfo.

Annotations

@Override

insert_code_str_to_classfile back to summary

insert_code_str_to_classfile	back to summary
private static void insert_code_str_to_classfile(String name, String code_str, Module module) throws IOException This method stores Base64 encoded Python byte code in one or more String literals. While Java String objects are limited only by the address range of arrays, the class file standard only supports literals representable in at most 65535 bytes of modified UTF-8. This method us used only with base64 Strings (therefore ASCII without nulls) and so each character occupies exactly 1 byte in the class file after encoding to UTF-8. To work within the 65535 byte limitation, the `code_str` is split into several literals with the following naming-scheme: The marker-interface 'ContainsPyBytecode' indicates that a class contains (static final) literals of the following scheme: a prefix of '___' indicates a bytecode-containing string literal a number indicating the number of parts follows '0_' indicates that no splitting occurred otherwise another number follows, naming the index of the literal indexing starts at 0 Examples: `___0_method1` contains bytecode for method1 `___2_0_method2` contains first part of method2's bytecode `___2_1_method2` contains second part of method2's bytecode Note that this approach is provisional. In future, Jython might contain the bytecode directly as bytecode-objects. The current approach was feasible with far less complicated JVM bytecode-manipulation, but needs special treatment after class-loading. Parameters name:String of the method or function being generated code_str:String Base64 encoded CPython byte code module:Module currently being defined as a class file

private static void insert_code_str_to_classfile(String name, String code_str, Module module) throws IOException

This method stores Base64 encoded Python byte code in one or more String literals.

While Java String objects are limited only by the address range of arrays, the class file standard only supports literals representable in at most 65535 bytes of modified UTF-8. This method us used only with base64 Strings (therefore ASCII without nulls) and so each character occupies exactly 1 byte in the class file after encoding to UTF-8.

To work within the 65535 byte limitation, the code_str is split into several literals with the following naming-scheme:

The marker-interface 'ContainsPyBytecode' indicates that a class contains (static final) literals of the following scheme:
a prefix of '___' indicates a bytecode-containing string literal
a number indicating the number of parts follows
'0_' indicates that no splitting occurred
otherwise another number follows, naming the index of the literal
indexing starts at 0

Examples:

___0_method1 contains bytecode for method1
___2_0_method2 contains first part of method2's bytecode
___2_1_method2 contains second part of method2's bytecode

Note that this approach is provisional. In future, Jython might contain the bytecode directly as bytecode-objects. The current approach was feasible with far less complicated JVM bytecode-manipulation, but needs special treatment after class-loading.

Parameters

name:String: of the method or function being generated
code_str:String: Base64 encoded CPython byte code
module:Module: currently being defined as a class file

integerConstant	back to summary
pack-priv Constant integerConstant(int value)

loadPyBytecode	back to summary
private static PyBytecode loadPyBytecode(String filename, boolean try_cpython) throws RuntimeException

longConstant	back to summary
pack-priv Constant longConstant(String value)

serializePyBytecode	back to summary
private static String serializePyBytecode(PyBytecode btcode) throws IOException

stringConstant	back to summary
pack-priv Constant stringConstant(String value)

unicodeConstant	back to summary
pack-priv Constant unicodeConstant(String value)

write	back to summary
public void write(OutputStream stream) throws IOException

public Class Module

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail