public Class RegistryKey

python.cachedir defines the directory to use for caches (currently just package information). This directory should be writable by the user. If this is an absolute path it is used as given, otherwise it is interpreted relative to sys.prefix (typically the directory of this file).

Setting python.cachedir.skip to true disables the package scan for the cachedir (as defined by python.cachedir or a default). Please be aware that disabling this will break importing from java packages.

python.console names the class used for the Jython console. Jython ships with a JLine console (http://jline.sourceforge.net/) out of the box. This is selected by default in the Jython command-line application (org.python.util.jython) if you do not define python.console to be another class on the command line. Alternatively, you can set python.console in the registry, but be aware that this will also affect the console in applications that embed a PythonInterpreter, or use Jython as a JSR-223 script engine.

You may also set this to the name of a different console class in your classpath that extends PlainConsole. Note that org.python.util.ReadlineConsole has been removed in 2.7.

python.console.encoding is the encoding used reading commands from the console. Must be a valid Java codec name, such as cp850.

python.cpython2 is the name of a CPython executable, version 2.7.

python.division.warning will print deprecation warnings when doing forced floor rounding with the / division operator.

"3/2" equals 1 in Python 2.x (forced floor rounding) and 1.5 in Python 3 (convert ints to floats). This is equivalent to -Qwarn on the command line. See PEP 238.

Values: old, warn, warnall.

This property will be deprecated and removed in 3.x.

python.import.site controls whether to import site.py. Boolean.

Equivalent to -S on the command line.

When python.inspect is set, and a script given on the command line finishes, start an interactive interpreter. Any non-empty string value will enable this behaviour.

Equivalent to the -i option on the command-line, or The session only actually starts if the console is interactive.

python.io.encoding controls the encoding of sys.stdin, sys.stdout, and sys.stderr. The encoding must name a Python codec, as in codecs.encode().

python.io.errors is the unicode error handler for I/O encoding problems.

python.locale.control determines locale module behaviour, including enabling locale module support, currently in beta.

Values:

More detail can be found in the documentation for the locale module and the underlying platform services exposed in org.python.modules._locale._locale.

python.modules.builtin controls the list of builtin modules; you can add, remove, or override builtin modules. The value for this registry key is a comma separated list of module entries, each entry of which has the following allowable forms:

A good example would be to use a jni version of os for more functionality by having an entry such as os:com.foo.jni.os

If python.options.caseok is true, Jython will use the first module found on sys.path where java File.isFile() returns true. Setting this will have no effect on unix-type filesystems. On Windows/HFS+ systems setting it to true will enable Jython-2.0 behaviour.

python.options.includeJavaStackInExceptions controls whether exceptions raised from Python code will include a Java stack trace in addition to the Python traceback. This can slow raising considerably. Boolean, true by default.

python.options.proxyDebugDirectory is the directory where dynamically generated classes are written. Nothing is ever read from here, it is only for debugging purposes.

python.options.Qnew controls whether true division is enabled for the / operator. See PEP 238. Boolean.

Equivalent to -Qnew on the command line.

When an exception occurs in Java code, and it is not caught, python.options.showJavaExceptions controls whether the interpreter prints out the Java exception in the traceback. Boolean, false by default.

When python.options.showPythonProxyExceptions is true, python exceptions raised in overridden methods will be shown on stderr.

python.os defines the string used to report the underlying operating system. Used as prefix when resolving which operating system, impacting some OS-specific behaviour.

python.packages.directories defines a sequence of property names. Each property name is a path string, in which the elements are directories. Each directory contains JAR/ZIP files that are to be a source of Python packages. By default, these directories are those where the JVM stores its optional packages as JARs (a mechanism withdrawn in Java 9).

python.packages.fakepath defines a sequence of directories and JARs that are to be sources of Python packages.

python.packages.paths defines a sequence of property names. Each property is a path string. The default setting causes directories and JARs on the classpath and in the JRE (before Java 9) to be sources of Python packages.

python.path is the search path for Python modules, equivalent to CPython's PYTHONPATH environment variable.

If python.security.respectJavaAccessibility is false, and you are using a Java version before Java 9, then Jython can access non-public fields, methods, and constructors. Normally, Jython can only provide access to public members of classes.

This may be deprecated in the future due to Java changes to accessibility from version 9 (at least for Oracle JDK and OpenJDK). See documentation on the --illegal-access (new) and --permit-illegal-access java command line flags for more detail.

Boolean.

python.sre.cachespec is the specification for the SRE_STATE code point cache used by regular expressions. The spec string is in the comma separated key=value format of com.google.common.cache.CacheBuilder, within guava (which is also the source of the cache implementation).

python.startup is the name of a file to be run at the start of each interactive session, but not when dropping in with the -i flag in after a script has run.

python.verbose sets the verbosity level for varying degrees of informative messages. Valid values in order of increasing verbosity are error, warning, message, comment, debug.

user.home sets the user home directory.