Package org.python.core
Class Options
java.lang.Object
org.python.core.Options
A class with static fields for each of the settable options. The options from registry and
command line is copied into the fields here and the rest of Jython checks these fields.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic intstatic booleanIf true, Jython will use the first module found on sys.path where java File.isFile() returns true.static intEnable division warning.static booleanWhether -B (don't write bytecode on import) was enabled via the command line.static booleanWhether -E (ignore environment) was enabled via the command line.static booleanWhenfalsethesite.pywill not be imported.static booleanIf true, exceptions raised from Python code will include a Java stack trace in addition to the Python traceback.static booleanWhen a script given on the command line finishes, start an interactive interpreter.static booleanSet by the-ioption to the interpreter command, to ask for an interactive session to start after the script ends.static booleanWhentruethesite.pywas not imported.static booleanWhether -s (don't add user site directory tosys.path) was on the command line.static intCorresponds to -O (Python bytecode optimization), -OO (remove docstrings) flags in CPython.static StringA directory where the dynamically generated classes are written.static booleanWhether -3 (py3k warnings) was enabled via the command line.static booleanIf true, enable true division for the '/' operator.static booleanIf true, Jython respects Java the accessibility flag for fields, methods, and constructors.static booleanwhen an exception occurs in Java code, and it is not caught, should the interpreter print out the Java exception in the traceback?static booleanWhen true, python exception raised in overridden methods will be shown on stderr.static Stringstatic final StringCache spec for the SRE_STATE code point cache.static booleanForce stdin, stdout and stderr to be unbuffered, and opened in binary mode.static intDeprecated. -
Method Summary
Modifier and TypeMethodDescriptionstatic voidInitialize the static fields from the registry options.
-
Field Details
-
showJavaExceptions
public static boolean showJavaExceptionswhen an exception occurs in Java code, and it is not caught, should the interpreter print out the Java exception in the traceback? -
includeJavaStackInExceptions
public static boolean includeJavaStackInExceptionsIf true, exceptions raised from Python code will include a Java stack trace in addition to the Python traceback. This can slow raising considerably.- See Also:
-
showPythonProxyExceptions
public static boolean showPythonProxyExceptionsWhen true, python exception raised in overridden methods will be shown on stderr. This option is remarkably useful when python is used for implementing CORBA server. Some CORBA servers will turn python exception (say a NameError) into an anonymous user exception without any stacktrace. Setting this option will show the stacktrace.- See Also:
-
respectJavaAccessibility
public static boolean respectJavaAccessibilityIf true, Jython respects Java the accessibility flag for fields, methods, and constructors. This means you can only access public members. Set this to false to access all members by toggling the accessible flag on the member.- See Also:
-
importSite
public static boolean importSiteWhenfalsethesite.pywill not be imported. This may be set by the command line main class (-Soption) or from the registry and is checked inPythonInterpreter.- See Also:
-
no_site
public static boolean no_siteWhentruethesite.pywas not imported. This is may be set by the command line main class (-Soption) or from the registry. However, in Jython 2,no_siteis simply the opposite ofimportSite, as the interpreter starts up, provided for compatibility with the standard Pythonsys.flags. Actual control over the import of the site module in Jython 2, when necessary from Java, is accomplished throughimportSite. -
verbose
Deprecated.UsePrePy.getLoggingLevel(),PrePy.setLoggingLevel(java.util.logging.Level), orjava.util.loggingpreferences to configure logging levels.Verbosity of informative messages from Jython, retained as a field for reasons of backward-compatibility. Normally this option should be allowed to find its value indirectly throughjava.util.logging, as adjusted by the command line-voption. -
interactive
public static boolean interactiveSet by the-ioption to the interpreter command, to ask for an interactive session to start after the script ends. It also allows certain streams to be considered interactive whenisattyis not available. -
inspect
public static boolean inspectWhen a script given on the command line finishes, start an interactive interpreter. It is settrueby the-ioption on the command-line, or programmatically from the script, and reset tofalsejust before the interactive session starts. (This session only actually starts if the console is interactive.) -
proxyDebugDirectory
A directory where the dynamically generated classes are written. Nothing is ever read from here, it is only for debugging purposes. -
caseok
public static boolean caseokIf true, Jython will use the first module found on sys.path where java File.isFile() returns true. Setting this to true have no effect on unix-type filesystems. On Windows/HFS+ systems setting it to true will enable Jython-2.0 behaviour.- See Also:
-
Qnew
public static boolean QnewIf true, enable true division for the '/' operator.- See Also:
-
unbuffered
public static boolean unbufferedForce stdin, stdout and stderr to be unbuffered, and opened in binary mode. -
py3k_warning
public static boolean py3k_warningWhether -3 (py3k warnings) was enabled via the command line. -
dont_write_bytecode
public static boolean dont_write_bytecodeWhether -B (don't write bytecode on import) was enabled via the command line. -
ignore_environment
public static boolean ignore_environmentWhether -E (ignore environment) was enabled via the command line. -
no_user_site
public static boolean no_user_siteWhether -s (don't add user site directory tosys.path) was on the command line. The implementation is mostly in thesitemodule. -
bytes_warning
public static int bytes_warning -
optimize
public static int optimizeCorresponds to -O (Python bytecode optimization), -OO (remove docstrings) flags in CPython. Jython processes the option and makes it visible as of 2.7, but there is no change of behaviour in the current version. -
division_warning
public static int division_warningEnable division warning. The value maps to the registry values of- old: 0
- warn: 1
- warnall: 2
-
sreCacheSpecDefault
Cache spec for the SRE_STATE code point cache. The value maps to the CacheBuilderSpec string and affects how the SRE_STATE cache will behave/evict cachedPyString -> int[]code points.- See Also:
-
sreCacheSpec
-
-
Method Details
-
setFromRegistry
public static void setFromRegistry()Initialize the static fields from the registry options.
-
PrePy.getLoggingLevel(),PrePy.setLoggingLevel(java.util.logging.Level), orjava.util.loggingpreferences to configure logging levels.