jython - Python seamlessly integrated with Java
Contents
Description
Jython is an implementation of the high-level, dynamic, object-oriented language Python seamlessly
integrated with the Java platform. The predecessor to Jython, JPython, is certified as 100% Pure Java.
Jython is complementary to Java and is especially suited for the following tasks:
Embeddedscripting:
Java programmers can add the Jython libraries to their system to allow end users to write simple
or complicated scripts that add functionality to the application.
Interactiveexperimentation:
Jython provides an interactive interpreter that can be used to interact with Java packages or with
running Java applications. This allows programmers to experiment with and debug any Java system
using Jython.
Rapidapplicationdevelopment:
Python programs are typically 2-10X shorter than the equivalent Java program. This translates
directly to increased programmer productivity. The seamless interaction between Python and Java
allows developers to freely mix the two languages both during development and in shipping
products.
To make a jython script executable on your system you can add the following line to the top of the file:
#!/usr/bin/envjython
You will also need to add execute permissions to the script using chmod(1). Note that #!/usr/bin/jython
will not work; you must use #!/usr/bin/envjython. This is because /usr/bin/jython is a script itself,
not a compiled binary.
Environment Variables
JAVA (default: /usr/bin/java)
The Java interpreter to use when running Jython.
JAVA_OPTIONS (default: empty)
Options to pass to the Java interpreter when running Jython.
Name
jython - Python seamlessly integrated with Java
Options
A summary of options is included below.
-i Continue running Jython interactively after running the given script, and force prompts even if
standard input doesn't appear to be a terminal.
-S Don't imply importsite on initialisation.
-v Trace import statements on error output.
-Dproperty=value
Set the Jython property property to value; see jython.conf(5) for details of available properties.
-Wargument
Warning control. The full form of argument is action:message:category:module:line. Trailing empty
fields may be omitted. Multiple -W options may be given. See documentation of the warnings module
for details.
-Ecodec
Set the encoding used to read module source files from disk.
-Qargument
Division control. See PEP 239 for details. Valid arguments are old, new, warn and warnall.
-jarjar
The program to run is read from the file __run__.py in the specified jar archive.
-ccmd The program to run is passed as the cmd string. This option terminates the options list.
file The program to run is the script file.
- The program to run is read from standard input (default behaviour). Interactive mode is used if
running on a tty. This flag allows you to pipe a file into Jython and have it be treated
correctly.
script-args
Command-line arguments to pass to the Jython script in sys.argv[1:].
--help Print a usage message and exit.
--version
Print the Jython version number and exit.
See Also
jythonc(1), jython.conf(5). If the Debian package jython-doc is installed, full documentation from the Jython authors will be available in /usr/share/doc/jython-doc/html/.
Synopsis
jython [ -i ] [ -S ] [ -v ] [ -Dproperty=value ... ] [ -Wargument ]
[ -Ecodec ] [ -Qargument ]
[ -jarjar | -ccmd | file | - ] [ script-args ]
jython [ --help | --version ]
