Package org.python.core

Class Py

java.lang.Object

org.python.core.Py

public final class Py
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static PyObject	ArithmeticError
static PyObject	AssertionError
static PyObject	AttributeError
static final int	COMMENT
static final int	DEBUG
static PySystemState	defaultSystemState
static PyObject	DeprecationWarning
static PyObject	Ellipsis	The singleton Ellipsis Python object - written as ... when indexing
static PyObject[]	EmptyObjects	A zero-length array of PyObject's to pass to functions that expect zero-arguments
static PyString	EmptyString	A zero-length Python string
static PyTuple	EmptyTuple	A tuple with zero elements
static PyObject	EnvironmentError
static PyObject	EOFError
static final int	ERROR
static PyObject	Exception
static PyObject	FloatingPointError
static PyObject	ImportError
static PyObject	IndentationError
static PyObject	IndexError
static PyObject	IOError
static PyObject	JavaError
static PyObject	KeyboardInterrupt
static PyObject	KeyError
static PyObject	LookupError
static PyObject	MemoryError
static final int	MESSAGE
static PyObject	NameError
static PyString	Newline	A Python string containing '\n'
static Object	NoConversion	A unique object to indicate no conversion is possible in __tojava__ methods
static String[]	NoKeywords	A zero-length array of Strings to pass to functions that don't have any keyword arguments
static PyObject	None	The singleton None Python object
static PyObject	NotImplemented	The singleton NotImplemented Python object.
static PyObject	NotImplementedError
static PyInteger	One	The Python integer 1 - also used as true
static PyObject	OSError
static PyObject	OverflowError
static PyObject	OverflowWarning
static PyObject	ReferenceError
static PyObject	RuntimeError
static PyObject	RuntimeWarning
static PyString	Space	A Python string containing ' '
static PyObject	StandardError
static StdoutWrapper	stderr
static PyObject	StopIteration
static PyObject	SyntaxError
static PyObject	SyntaxWarning
static PyObject	SystemError
static PyObject	SystemExit
static PyObject	TabError
static PyObject	TypeError
static PyObject	UnboundLocalError
static PyObject	UnicodeError
static PyObject	UserWarning
static PyObject	ValueError
static PyObject	Warning
static final int	WARNING
static PyInteger	Zero	The Python integer 0 - also used as false
static PyObject	ZeroDivisionError

Method Summary

Modifier and Type	Method	Description
static void	addTraceback(Throwable t, PyFrame frame)
static void	assert_(PyObject test)
static void	assert_(PyObject test, PyObject message)
static PyException	AssertionError(String message)
static PyException	AttributeError(String message)
static PyCode	compile(InputStream istream, String filename, String type)
static PyCode	compile(org.python.parser.ast.modType node, String filename)
static PyCode	compile(org.python.parser.ast.modType node, String name, String filename)
static PyCode	compile(org.python.parser.ast.modType node, String name, String filename, boolean linenumbers, boolean printResults)
static PyObject	compile_command_flags(String string, String filename, String kind, CompilerFlags cflags, boolean stdprompt)
static PyCode	compile_flags(InputStream istream, String filename, String type, CompilerFlags cflags)
static PyCode	compile_flags(String data, String filename, String type, CompilerFlags cflags)
static PyCode	compile_flags(org.python.parser.ast.modType node, String name, String filename, boolean linenumbers, boolean printResults, CompilerFlags cflags)
static void	DeprecationWarning(String message)
static void	displayException(PyObject type, PyObject value, PyObject tb, PyObject file)
static PyException	EOFError(String message)
static void	exec(PyObject o, PyObject globals, PyObject locals)
static Class	findClass(String name)
static Class	findClassEx(String name, String reason)
static PyException	FloatingPointError(String message)
static org.python.core.adapter.ExtensiblePyObjectAdapter	getAdapter()
static CompilerFlags	getCompilerFlags()
static CompilerFlags	getCompilerFlags(int flags, boolean dont_inherit)
static PyFrame	getFrame()
static String	getName()
static final PySystemState	getSystemState()
static final ThreadState	getThreadState()
static final ThreadState	getThreadState(PySystemState newSystemState)
static long	id(PyObject o)
static String	idstr(PyObject o)
static PyException	ImportError(String message)
static PyException	IndexError(String message)
static void	initProxy(PyProxy proxy, String module, String pyclass, Object[] args, String[] packages, String[] props, boolean frozen)
static void	initProxy(PyProxy proxy, String module, String pyclass, Object[] args, String[] packages, String[] props, String frozenPackage, String[] modules)
static boolean	initPython()
static void	initRunnable(String module, PyObject dict)
static PyException	IOError(IOException ioe)
static PyException	IOError(String message)
static boolean	isInstance(PyObject obj, PyObject cls)
static boolean	isSubClass(PyObject derived, PyObject cls)
static PyObject	iter(PyObject seq, String message)
static long	java_obj_id(Object o)
static PyObject	java2py(Object o)	Uses the PyObjectAdapter passed to PySystemState.initialize() to turn o into a PyObject.
static PyException	JavaError(Throwable t)
static PyObject	jfindattr(PyProxy proxy, String name)	Deprecated. *
static PyObject	jgetattr(PyProxy proxy, String name)	Deprecated. *
static PyException	KeyError(String message)
static final PyString	makeCharacter(Character o)
static PyObject	makeClass(String name, PyObject[] bases, PyCode code, PyObject doc)
static PyObject	makeClass(String name, PyObject[] bases, PyCode code, PyObject doc, Class proxyClass)
static PyObject	makeClass(String name, PyObject[] bases, PyCode code, PyObject doc, Class proxyClass, PyObject[] closure_cells)
static PyObject	makeClass(String name, PyObject[] bases, PyCode code, PyObject doc, PyObject[] closure_cells)
static PyException	makeException()
static PyException	makeException(PyObject type)
static PyException	makeException(PyObject type, PyObject value)
static PyException	makeException(PyObject type, PyObject value, PyObject traceback)
static boolean	matchException(PyException pye, PyObject e)
static void	maybeWrite(String type, String msg, int level)
static void	memory_error(OutOfMemoryError t)
static PyException	MemoryError(String message)
static PyException	NameError(String message)
static PyInteger	newBoolean(boolean t)
static PyCode	newCode(int argcount, String[] varnames, String filename, String name, boolean args, boolean keywords, PyFunctionTable funcs, int func_id)
static PyCode	newCode(int argcount, String[] varnames, String filename, String name, boolean args, boolean keywords, PyFunctionTable funcs, int func_id, String[] cellvars, String[] freevars, int npurecell, int moreflags)
static PyCode	newCode(int argcount, String[] varnames, String filename, String name, int firstlineno, boolean args, boolean keywords, PyFunctionTable funcs, int func_id)
static PyCode	newCode(int argcount, String[] varnames, String filename, String name, int firstlineno, boolean args, boolean keywords, PyFunctionTable funcs, int func_id, String[] cellvars, String[] freevars, int npurecell, int moreflags)
static PyFloat	newFloat(double v)
static PyFloat	newFloat(float v)
static PyComplex	newImaginary(double v)
static final PyInteger	newInteger(int i)
static PyObject	newInteger(long i)
static PyCode	newJavaCode(Class cls, String name)
static PyObject	newJavaFunc(Class cls, String name)
static PyLong	newLong(int i)
static PyLong	newLong(String s)
static PyLong	newLong(BigInteger i)
static PyString	newString(char c)
static PyString	newString(String s)
static PyUnicode	newUnicode(char c)
static PyUnicode	newUnicode(String s)
static PyException	OverflowError(String message)
static void	OverflowWarning(String message)
static void	print(PyObject o)
static void	print(PyObject file, PyObject o)
static void	printComma(PyObject o)
static void	printComma(PyObject file, PyObject o)
static void	printException(Throwable t)
static void	printException(Throwable t, PyFrame f)
static void	printException(Throwable t, PyFrame f, PyObject file)
static void	println()
static void	println(PyObject o)
static void	println(PyObject file, PyObject o)
static void	printlnv(PyObject file)
static void	printResult(PyObject ret)
static boolean	py2boolean(PyObject o)
static byte	py2byte(PyObject o)
static char	py2char(PyObject o)
static char	py2char(PyObject o, String msg)
static double	py2double(PyObject o)
static float	py2float(PyObject o)
static int	py2int(PyObject o)
static int	py2int(PyObject o, String msg)
static long	py2long(PyObject o)
static short	py2short(PyObject o)
static void	py2void(PyObject o)
static PyException	ReferenceError(String message)
static Class	relFindClass(Class home, String name)
static PyObject	runCode(PyCode code, PyObject locals, PyObject globals)
static void	runMain(Class mainClass, String[] args, String[] packages, String[] props, String frozenPackage, String[] modules)
static void	runMain(PyRunnable main, String[] args)	Initializes a default PythonInterpreter and runs the code from PyRunnable.getMain() as __main__ Called by the code generated in Module.addMain()
static PyException	RuntimeError(String message)
static void	RuntimeWarning(String message)
static String	safeRepr(PyObject o)
static void	saveClassFile(String name, ByteArrayOutputStream bytestream)
static PyException	setException(Throwable t, PyFrame frame)
static void	setFrame(PyFrame f)
static final PySystemState	setSystemState(PySystemState newSystemState)
static PyException	StopIteration(String message)
static PyException	SyntaxError(String message)
static void	SyntaxWarning(String message)
static PyException	SystemError(String message)
static Object	tojava(PyObject o, Class c)	Deprecated.
static Object	tojava(PyObject o, String s)
static PyException	TypeError(String message)
static PyException	UnboundLocalError(String message)
static PyException	UnicodeError(String message)
static PyObject[]	unpackSequence(PyObject o, int length)
static void	UserWarning(String message)
static PyException	ValueError(String message)
static void	warning(PyObject category, String message)
static void	warning(PyObject category, String message, String filename, int lineno, String module, PyObject registry)
static void	Warning(String message)
static void	writeComment(String type, String msg)
static void	writeDebug(String type, String msg)
static void	writeError(String type, String msg)
static void	writeMessage(String type, String msg)
static void	writeWarning(String type, String msg)
static PyException	ZeroDivisionError(String message)

Methods inherited from class java.lang.Object

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

Field Details

None

public static PyObject None

The singleton None Python object

Ellipsis

public static PyObject Ellipsis

The singleton Ellipsis Python object - written as ... when indexing

NotImplemented

public static PyObject NotImplemented

The singleton NotImplemented Python object. Used in rich comparison

NoKeywords

public static String[] NoKeywords

A zero-length array of Strings to pass to functions that don't have any keyword arguments

EmptyObjects

public static PyObject[] EmptyObjects

A zero-length array of PyObject's to pass to functions that expect zero-arguments

EmptyTuple

public static PyTuple EmptyTuple

A tuple with zero elements

Zero

public static PyInteger Zero

The Python integer 0 - also used as false

One

public static PyInteger One

The Python integer 1 - also used as true

EmptyString

public static PyString EmptyString

A zero-length Python string

Newline

public static PyString Newline

A Python string containing '\n'

Space

public static PyString Space

A Python string containing ' '

NoConversion

public static Object NoConversion

A unique object to indicate no conversion is possible in __tojava__ methods

OSError

public static PyObject OSError

NotImplementedError

public static PyObject NotImplementedError

EnvironmentError

public static PyObject EnvironmentError

OverflowError

public static PyObject OverflowError

RuntimeError

public static PyObject RuntimeError

KeyboardInterrupt

public static PyObject KeyboardInterrupt

FloatingPointError

public static PyObject FloatingPointError

SyntaxError

public static PyObject SyntaxError

IndentationError

public static PyObject IndentationError

TabError

public static PyObject TabError

AttributeError

public static PyObject AttributeError

IOError

public static PyObject IOError

KeyError

public static PyObject KeyError

AssertionError

public static PyObject AssertionError

TypeError

public static PyObject TypeError

ReferenceError

public static PyObject ReferenceError

SystemError

public static PyObject SystemError

IndexError

public static PyObject IndexError

ZeroDivisionError

public static PyObject ZeroDivisionError

NameError

public static PyObject NameError

UnboundLocalError

public static PyObject UnboundLocalError

SystemExit

public static PyObject SystemExit

StopIteration

public static PyObject StopIteration

ImportError

public static PyObject ImportError

ValueError

public static PyObject ValueError

UnicodeError

public static PyObject UnicodeError

EOFError

public static PyObject EOFError

MemoryError

public static PyObject MemoryError

ArithmeticError

public static PyObject ArithmeticError

LookupError

public static PyObject LookupError

StandardError

public static PyObject StandardError

Exception

public static PyObject Exception

Warning

public static PyObject Warning

UserWarning

public static PyObject UserWarning

DeprecationWarning

public static PyObject DeprecationWarning

SyntaxWarning

public static PyObject SyntaxWarning

OverflowWarning

public static PyObject OverflowWarning

RuntimeWarning

public static PyObject RuntimeWarning

JavaError

public static PyObject JavaError

defaultSystemState

public static PySystemState defaultSystemState

stderr

public static StdoutWrapper stderr

ERROR

public static final int ERROR

See Also:

• Constant Field Values

WARNING

public static final int WARNING

See Also:

• Constant Field Values

MESSAGE

public static final int MESSAGE

See Also:

• Constant Field Values

COMMENT

public static final int COMMENT

See Also:

• Constant Field Values

DEBUG

public static final int DEBUG

See Also:

• Constant Field Values

Method Details

OverflowError

public static PyException OverflowError(String message)

RuntimeError

public static PyException RuntimeError(String message)

FloatingPointError

public static PyException FloatingPointError(String message)

SyntaxError

public static PyException SyntaxError(String message)

AttributeError

public static PyException AttributeError(String message)

IOError

public static PyException IOError(IOException ioe)

IOError

public static PyException IOError(String message)

KeyError

public static PyException KeyError(String message)

AssertionError

public static PyException AssertionError(String message)

TypeError

public static PyException TypeError(String message)

ReferenceError

public static PyException ReferenceError(String message)

SystemError

public static PyException SystemError(String message)

IndexError

public static PyException IndexError(String message)

ZeroDivisionError

public static PyException ZeroDivisionError(String message)

NameError

public static PyException NameError(String message)

UnboundLocalError

public static PyException UnboundLocalError(String message)

StopIteration

public static PyException StopIteration(String message)

ImportError

public static PyException ImportError(String message)

ValueError

public static PyException ValueError(String message)

UnicodeError

public static PyException UnicodeError(String message)

EOFError

public static PyException EOFError(String message)

memory_error

public static void memory_error(OutOfMemoryError t)

MemoryError

public static PyException MemoryError(String message)

Warning

public static void Warning(String message)

UserWarning

public static void UserWarning(String message)

DeprecationWarning

public static void DeprecationWarning(String message)

SyntaxWarning

public static void SyntaxWarning(String message)

OverflowWarning

public static void OverflowWarning(String message)

RuntimeWarning

public static void RuntimeWarning(String message)

warning

public static void warning(PyObject category,
 String message)

warning

public static void warning(PyObject category,
 String message,
 String filename,
 int lineno,
 String module,
 PyObject registry)

JavaError

public static PyException JavaError(Throwable t)

tojava

public static Object tojava(PyObject o,
 Class c)

Deprecated.

Convert a given PyObject to an instance of a Java class. Identical to o.__tojava__(c) except that it will raise a TypeError if the conversion fails.

Parameters:

o - the PyObject to convert.

c - the class to convert it to.

tojava

public static Object tojava(PyObject o,
 String s)

jfindattr

public static PyObject jfindattr(PyProxy proxy,
 String name)

Deprecated.

*

jgetattr

public static PyObject jgetattr(PyProxy proxy,
 String name)

Deprecated.

*

newInteger

public static final PyInteger newInteger(int i)

newInteger

public static PyObject newInteger(long i)

newLong

public static PyLong newLong(String s)

newLong

public static PyLong newLong(BigInteger i)

newLong

public static PyLong newLong(int i)

newImaginary

public static PyComplex newImaginary(double v)

newFloat

public static PyFloat newFloat(float v)

newFloat

public static PyFloat newFloat(double v)

newString

public static PyString newString(char c)

newString

public static PyString newString(String s)

newUnicode

public static PyUnicode newUnicode(char c)

newUnicode

public static PyUnicode newUnicode(String s)

newBoolean

public static PyInteger newBoolean(boolean t)

newCode

public static PyCode newCode(int argcount,
 String[] varnames,
 String filename,
 String name,
 boolean args,
 boolean keywords,
 PyFunctionTable funcs,
 int func_id,
 String[] cellvars,
 String[] freevars,
 int npurecell,
 int moreflags)

newCode

public static PyCode newCode(int argcount,
 String[] varnames,
 String filename,
 String name,
 int firstlineno,
 boolean args,
 boolean keywords,
 PyFunctionTable funcs,
 int func_id,
 String[] cellvars,
 String[] freevars,
 int npurecell,
 int moreflags)

newCode

public static PyCode newCode(int argcount,
 String[] varnames,
 String filename,
 String name,
 boolean args,
 boolean keywords,
 PyFunctionTable funcs,
 int func_id)

newCode

public static PyCode newCode(int argcount,
 String[] varnames,
 String filename,
 String name,
 int firstlineno,
 boolean args,
 boolean keywords,
 PyFunctionTable funcs,
 int func_id)

newJavaCode

public static PyCode newJavaCode(Class cls,
 String name)

newJavaFunc

public static PyObject newJavaFunc(Class cls,
 String name)

initPython

public static boolean initPython()

relFindClass

public static Class relFindClass(Class home,
 String name)

findClass

public static Class findClass(String name)

findClassEx

public static Class findClassEx(String name,
 String reason)

initProxy

public static void initProxy(PyProxy proxy,
 String module,
 String pyclass,
 Object[] args,
 String[] packages,
 String[] props,
 boolean frozen)

initProxy

public static void initProxy(PyProxy proxy,
 String module,
 String pyclass,
 Object[] args,
 String[] packages,
 String[] props,
 String frozenPackage,
 String[] modules)

initRunnable

public static void initRunnable(String module,
 PyObject dict)

runMain

public static void runMain(PyRunnable main,
 String[] args)
                    throws Exception

Initializes a default PythonInterpreter and runs the code from PyRunnable.getMain() as __main__ Called by the code generated in Module.addMain()

Throws:

Exception

runMain

public static void runMain(Class mainClass,
 String[] args,
 String[] packages,
 String[] props,
 String frozenPackage,
 String[] modules)
                    throws Exception

Throws:

Exception

printException

public static void printException(Throwable t)

printException

public static void printException(Throwable t,
 PyFrame f)

printException

public static void printException(Throwable t,
 PyFrame f,
 PyObject file)

displayException

public static void displayException(PyObject type,
 PyObject value,
 PyObject tb,
 PyObject file)

assert_

public static void assert_(PyObject test,
 PyObject message)

assert_

public static void assert_(PyObject test)

addTraceback

public static void addTraceback(Throwable t,
 PyFrame frame)

setException

public static PyException setException(Throwable t,
 PyFrame frame)

matchException

public static boolean matchException(PyException pye,
 PyObject e)

makeException

public static PyException makeException()

makeException

public static PyException makeException(PyObject type)

makeException

public static PyException makeException(PyObject type,
 PyObject value)

makeException

public static PyException makeException(PyObject type,
 PyObject value,
 PyObject traceback)

runCode

public static PyObject runCode(PyCode code,
 PyObject locals,
 PyObject globals)

exec

public static void exec(PyObject o,
 PyObject globals,
 PyObject locals)

getThreadState

public static final ThreadState getThreadState()

getThreadState

public static final ThreadState getThreadState(PySystemState newSystemState)

setSystemState

public static final PySystemState setSystemState(PySystemState newSystemState)

getSystemState

public static final PySystemState getSystemState()

getFrame

public static PyFrame getFrame()

setFrame

public static void setFrame(PyFrame f)

print

public static void print(PyObject file,
 PyObject o)

printComma

public static void printComma(PyObject file,
 PyObject o)

println

public static void println(PyObject file,
 PyObject o)

printlnv

public static void printlnv(PyObject file)

print

public static void print(PyObject o)

printComma

public static void printComma(PyObject o)

println

public static void println(PyObject o)

println

public static void println()

py2boolean

public static boolean py2boolean(PyObject o)

py2byte

public static byte py2byte(PyObject o)

py2short

public static short py2short(PyObject o)

py2int

public static int py2int(PyObject o)

py2int

public static int py2int(PyObject o,
 String msg)

py2long

public static long py2long(PyObject o)

py2float

public static float py2float(PyObject o)

py2double

public static double py2double(PyObject o)

py2char

public static char py2char(PyObject o)

py2char

public static char py2char(PyObject o,
 String msg)

py2void

public static void py2void(PyObject o)

makeCharacter

public static final PyString makeCharacter(Character o)

java2py

public static PyObject java2py(Object o)

Uses the PyObjectAdapter passed to PySystemState.initialize() to turn o into a PyObject.

See Also:

• - default PyObjectAdapter type

getAdapter

public static org.python.core.adapter.ExtensiblePyObjectAdapter getAdapter()

Returns:

the ExtensiblePyObjectAdapter used by java2py.

makeClass

public static PyObject makeClass(String name,
 PyObject[] bases,
 PyCode code,
 PyObject doc)

makeClass

public static PyObject makeClass(String name,
 PyObject[] bases,
 PyCode code,
 PyObject doc,
 PyObject[] closure_cells)

makeClass

public static PyObject makeClass(String name,
 PyObject[] bases,
 PyCode code,
 PyObject doc,
 Class proxyClass)

makeClass

public static PyObject makeClass(String name,
 PyObject[] bases,
 PyCode code,
 PyObject doc,
 Class proxyClass,
 PyObject[] closure_cells)

getName

public static String getName()

getCompilerFlags

public static CompilerFlags getCompilerFlags()

getCompilerFlags

public static CompilerFlags getCompilerFlags(int flags,
 boolean dont_inherit)

compile

public static PyCode compile(org.python.parser.ast.modType node,
 String filename)

compile

public static PyCode compile(org.python.parser.ast.modType node,
 String name,
 String filename)

compile

public static PyCode compile(org.python.parser.ast.modType node,
 String name,
 String filename,
 boolean linenumbers,
 boolean printResults)

compile

public static PyCode compile(InputStream istream,
 String filename,
 String type)

compile_flags

public static PyCode compile_flags(org.python.parser.ast.modType node,
 String name,
 String filename,
 boolean linenumbers,
 boolean printResults,
 CompilerFlags cflags)

compile_flags

public static PyCode compile_flags(InputStream istream,
 String filename,
 String type,
 CompilerFlags cflags)

compile_flags

public static PyCode compile_flags(String data,
 String filename,
 String type,
 CompilerFlags cflags)

compile_command_flags

public static PyObject compile_command_flags(String string,
 String filename,
 String kind,
 CompilerFlags cflags,
 boolean stdprompt)

unpackSequence

public static PyObject[] unpackSequence(PyObject o,
 int length)

iter

public static PyObject iter(PyObject seq,
 String message)

id

public static long id(PyObject o)

idstr

public static String idstr(PyObject o)

java_obj_id

public static long java_obj_id(Object o)

safeRepr

public static String safeRepr(PyObject o)

printResult

public static void printResult(PyObject ret)

maybeWrite

public static void maybeWrite(String type,
 String msg,
 int level)

writeError

public static void writeError(String type,
 String msg)

writeWarning

public static void writeWarning(String type,
 String msg)

writeMessage

public static void writeMessage(String type,
 String msg)

writeComment

public static void writeComment(String type,
 String msg)

writeDebug

public static void writeDebug(String type,
 String msg)

saveClassFile

public static void saveClassFile(String name,
 ByteArrayOutputStream bytestream)

isInstance

public static boolean isInstance(PyObject obj,
 PyObject cls)

isSubClass

public static boolean isSubClass(PyObject derived,
 PyObject cls)