Package ai.timefold.jpyinterpreter

Class PythonBytecodeToJavaBytecodeTranslator

java.lang.Object

ai.timefold.jpyinterpreter.PythonBytecodeToJavaBytecodeTranslator

public class PythonBytecodeToJavaBytecodeTranslator
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ANNOTATION_DIRECTORY_INSTANCE_FIELD_NAME
static final String	ARGUMENT_SPEC_GETTER_STATIC_FIELD_NAME
static final String	ARGUMENT_SPEC_INSTANCE_FIELD_NAME
static final String	CELLS_INSTANCE_FIELD_NAME
static final String	CLASS_CELL_STATIC_FIELD_NAME
static final Map<String,Integer>	classNameToSharedInstanceCount
static Path	classOutputRootPath
static final String	CONSTANTS_STATIC_FIELD_NAME
static final String	DEFAULT_KEYWORD_ARGS_INSTANCE_FIELD_NAME
static final String	DEFAULT_POSITIONAL_ARGS_INSTANCE_FIELD_NAME
static final String	GENERATED_PACKAGE_BASE
static final String	GLOBALS_MAP_STATIC_FIELD_NAME
static final String	INTERPRETER_INSTANCE_FIELD_NAME
static final String	NAMES_STATIC_FIELD_NAME
static final String	PYTHON_WRAPPER_CODE_STATIC_FIELD_NAME
static final String	PYTHON_WRAPPER_FUNCTION_INSTANCE_FIELD_NAME
static final String	QUALIFIED_NAME_INSTANCE_FIELD_NAME
static final String	USER_PACKAGE_BASE
static final String	VARIABLE_NAMES_STATIC_FIELD_NAME

Constructor Summary

Constructors

Constructor	Description
PythonBytecodeToJavaBytecodeTranslator()

Method Summary

Modifier and Type	Method	Description
static void	createFields(org.objectweb.asm.ClassWriter classWriter)
static <T> T	createInstance(Class<T> functionClass, PythonInterpreter pythonInterpreter)
static <T> T	forceTranslatePythonBytecodeToGenerator(PythonCompiledFunction pythonCompiledFunction, Class<T> javaFunctionalInterfaceType)
static <T> Class<T>	forceTranslatePythonBytecodeToGeneratorClass(PythonCompiledFunction pythonCompiledFunction, MethodDescriptor methodDescriptor, Method methodWithoutGenerics, boolean isVirtual)	Used for testing; force translate the python to a generator, even if it is not a generator
static Method	getFunctionalInterfaceMethod(Class<?> interfaceClass)
static PythonFunctionType	getFunctionType(PythonCompiledFunction pythonCompiledFunction)
static StackMetadata	getInitialStackMetadata(LocalVariableHelper localVariableHelper, MethodDescriptor method, boolean isVirtual)
static List<Opcode>	getOpcodeList(PythonCompiledFunction pythonCompiledFunction)
static String	getPythonBytecodeListing(PythonCompiledFunction pythonCompiledFunction)
static void	print(org.objectweb.asm.MethodVisitor methodVisitor)	Used for debugging; prints TOS
static void	printStack(FunctionMetadata functionMetadata, StackMetadata stackMetadata)	Used for debugging; prints the entire stack
static <T> T	translatePythonBytecode(PythonCompiledFunction pythonCompiledFunction, Class<T> javaFunctionalInterfaceType)
static <T> T	translatePythonBytecode(PythonCompiledFunction pythonCompiledFunction, Class<T> javaFunctionalInterfaceType, List<Class<?>> genericTypeArgumentList)
static <T> Class<T>	translatePythonBytecodeToClass(PythonCompiledFunction pythonCompiledFunction, MethodDescriptor methodDescriptor)
static <T> Class<T>	translatePythonBytecodeToClass(PythonCompiledFunction pythonCompiledFunction, MethodDescriptor methodDescriptor, boolean isVirtual)
static <T> Class<T>	translatePythonBytecodeToClass(PythonCompiledFunction pythonCompiledFunction, MethodDescriptor methodDescriptor, Method methodWithoutGenerics, boolean isVirtual)
static <T> Class<T>	translatePythonBytecodeToClass(PythonCompiledFunction pythonCompiledFunction, Class<T> javaFunctionalInterfaceType)
static <T> Class<T>	translatePythonBytecodeToClass(PythonCompiledFunction pythonCompiledFunction, Class<T> javaFunctionalInterfaceType, List<Class<?>> genericTypeArgumentList)
static <T> T	translatePythonBytecodeToInstance(PythonCompiledFunction pythonCompiledFunction, MethodDescriptor methodDescriptor)
static <T> T	translatePythonBytecodeToInstance(PythonCompiledFunction pythonCompiledFunction, MethodDescriptor methodDescriptor, boolean isVirtual)
static <T> Class<T>	translatePythonBytecodeToPythonWrapperClass(PythonCompiledFunction pythonCompiledFunction, OpaquePythonReference codeReference)
static void	visitGeneratedLineNumber(org.objectweb.asm.MethodVisitor methodVisitor)
static void	writeClassOutput(Map<String,byte[]> classNameToBytecode, String className, byte[] classByteCode)
static void	writeInstructionsForOpcodes(FunctionMetadata functionMetadata, List<StackMetadata> stackMetadataForOpcodeIndex, List<Opcode> opcodeList)
static void	writeInstructionsForOpcodes(FunctionMetadata functionMetadata, List<StackMetadata> stackMetadataForOpcodeIndex, List<Opcode> opcodeList, Consumer<PythonBytecodeInstruction> runAfterLabelAndBeforeArgumentors)

Methods inherited from class java.lang.Object

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

Field Details

USER_PACKAGE_BASE

public static final String USER_PACKAGE_BASE

See Also:

• Constant Field Values

GENERATED_PACKAGE_BASE

public static final String GENERATED_PACKAGE_BASE

See Also:

• Constant Field Values

CONSTANTS_STATIC_FIELD_NAME

public static final String CONSTANTS_STATIC_FIELD_NAME

See Also:

• Constant Field Values

NAMES_STATIC_FIELD_NAME

public static final String NAMES_STATIC_FIELD_NAME

See Also:

• Constant Field Values

VARIABLE_NAMES_STATIC_FIELD_NAME

public static final String VARIABLE_NAMES_STATIC_FIELD_NAME

See Also:

• Constant Field Values

GLOBALS_MAP_STATIC_FIELD_NAME

public static final String GLOBALS_MAP_STATIC_FIELD_NAME

See Also:

• Constant Field Values

CLASS_CELL_STATIC_FIELD_NAME

public static final String CLASS_CELL_STATIC_FIELD_NAME

See Also:

• Constant Field Values

ARGUMENT_SPEC_GETTER_STATIC_FIELD_NAME

public static final String ARGUMENT_SPEC_GETTER_STATIC_FIELD_NAME

See Also:

• Constant Field Values

PYTHON_WRAPPER_CODE_STATIC_FIELD_NAME

public static final String PYTHON_WRAPPER_CODE_STATIC_FIELD_NAME

See Also:

• Constant Field Values

DEFAULT_POSITIONAL_ARGS_INSTANCE_FIELD_NAME

public static final String DEFAULT_POSITIONAL_ARGS_INSTANCE_FIELD_NAME

See Also:

• Constant Field Values

DEFAULT_KEYWORD_ARGS_INSTANCE_FIELD_NAME

public static final String DEFAULT_KEYWORD_ARGS_INSTANCE_FIELD_NAME

See Also:

• Constant Field Values

ANNOTATION_DIRECTORY_INSTANCE_FIELD_NAME

public static final String ANNOTATION_DIRECTORY_INSTANCE_FIELD_NAME

See Also:

• Constant Field Values

CELLS_INSTANCE_FIELD_NAME

public static final String CELLS_INSTANCE_FIELD_NAME

See Also:

• Constant Field Values

QUALIFIED_NAME_INSTANCE_FIELD_NAME

public static final String QUALIFIED_NAME_INSTANCE_FIELD_NAME

See Also:

• Constant Field Values

ARGUMENT_SPEC_INSTANCE_FIELD_NAME

public static final String ARGUMENT_SPEC_INSTANCE_FIELD_NAME

See Also:

• Constant Field Values

INTERPRETER_INSTANCE_FIELD_NAME

public static final String INTERPRETER_INSTANCE_FIELD_NAME

See Also:

• Constant Field Values

PYTHON_WRAPPER_FUNCTION_INSTANCE_FIELD_NAME

public static final String PYTHON_WRAPPER_FUNCTION_INSTANCE_FIELD_NAME

See Also:

• Constant Field Values

classNameToSharedInstanceCount

public static final Map<String,Integer> classNameToSharedInstanceCount

classOutputRootPath

public static Path classOutputRootPath

Constructor Details

PythonBytecodeToJavaBytecodeTranslator

public PythonBytecodeToJavaBytecodeTranslator()

Method Details

writeClassOutput

public static void writeClassOutput(Map<String,byte[]> classNameToBytecode,
 String className,
 byte[] classByteCode)

getFunctionalInterfaceMethod

public static Method getFunctionalInterfaceMethod(Class<?> interfaceClass)

createInstance

public static <T> T createInstance(Class<T> functionClass,
 PythonInterpreter pythonInterpreter)

translatePythonBytecode

public static <T> T translatePythonBytecode(PythonCompiledFunction pythonCompiledFunction,
 Class<T> javaFunctionalInterfaceType)

translatePythonBytecode

public static <T> T translatePythonBytecode(PythonCompiledFunction pythonCompiledFunction,
 Class<T> javaFunctionalInterfaceType,
 List<Class<?>> genericTypeArgumentList)

forceTranslatePythonBytecodeToGenerator

public static <T> T forceTranslatePythonBytecodeToGenerator(PythonCompiledFunction pythonCompiledFunction,
 Class<T> javaFunctionalInterfaceType)

translatePythonBytecodeToClass

public static <T> Class<T> translatePythonBytecodeToClass(PythonCompiledFunction pythonCompiledFunction,
 Class<T> javaFunctionalInterfaceType)

translatePythonBytecodeToClass

public static <T> Class<T> translatePythonBytecodeToClass(PythonCompiledFunction pythonCompiledFunction,
 Class<T> javaFunctionalInterfaceType,
 List<Class<?>> genericTypeArgumentList)

translatePythonBytecodeToClass

public static <T> Class<T> translatePythonBytecodeToClass(PythonCompiledFunction pythonCompiledFunction,
 MethodDescriptor methodDescriptor)

translatePythonBytecodeToInstance

public static <T> T translatePythonBytecodeToInstance(PythonCompiledFunction pythonCompiledFunction,
 MethodDescriptor methodDescriptor)

translatePythonBytecodeToInstance

public static <T> T translatePythonBytecodeToInstance(PythonCompiledFunction pythonCompiledFunction,
 MethodDescriptor methodDescriptor,
 boolean isVirtual)

translatePythonBytecodeToClass

public static <T> Class<T> translatePythonBytecodeToClass(PythonCompiledFunction pythonCompiledFunction,
 MethodDescriptor methodDescriptor,
 boolean isVirtual)

translatePythonBytecodeToClass

public static <T> Class<T> translatePythonBytecodeToClass(PythonCompiledFunction pythonCompiledFunction,
 MethodDescriptor methodDescriptor,
 Method methodWithoutGenerics,
 boolean isVirtual)

translatePythonBytecodeToPythonWrapperClass

public static <T> Class<T> translatePythonBytecodeToPythonWrapperClass(PythonCompiledFunction pythonCompiledFunction,
 OpaquePythonReference codeReference)

forceTranslatePythonBytecodeToGeneratorClass

public static <T> Class<T> forceTranslatePythonBytecodeToGeneratorClass(PythonCompiledFunction pythonCompiledFunction,
 MethodDescriptor methodDescriptor,
 Method methodWithoutGenerics,
 boolean isVirtual)

Used for testing; force translate the python to a generator, even if it is not a generator

createFields

public static void createFields(org.objectweb.asm.ClassWriter classWriter)

getOpcodeList

public static List<Opcode> getOpcodeList(PythonCompiledFunction pythonCompiledFunction)

getInitialStackMetadata

public static StackMetadata getInitialStackMetadata(LocalVariableHelper localVariableHelper,
 MethodDescriptor method,
 boolean isVirtual)

getFunctionType

public static PythonFunctionType getFunctionType(PythonCompiledFunction pythonCompiledFunction)

writeInstructionsForOpcodes

public static void writeInstructionsForOpcodes(FunctionMetadata functionMetadata,
 List<StackMetadata> stackMetadataForOpcodeIndex,
 List<Opcode> opcodeList)

writeInstructionsForOpcodes

public static void writeInstructionsForOpcodes(FunctionMetadata functionMetadata,
 List<StackMetadata> stackMetadataForOpcodeIndex,
 List<Opcode> opcodeList,
 Consumer<PythonBytecodeInstruction> runAfterLabelAndBeforeArgumentors)

print

public static void print(org.objectweb.asm.MethodVisitor methodVisitor)

Used for debugging; prints TOS

printStack

public static void printStack(FunctionMetadata functionMetadata,
 StackMetadata stackMetadata)

Used for debugging; prints the entire stack

getPythonBytecodeListing

public static String getPythonBytecodeListing(PythonCompiledFunction pythonCompiledFunction)

visitGeneratedLineNumber

public static void visitGeneratedLineNumber(org.objectweb.asm.MethodVisitor methodVisitor)