jython - Python seamlessly integrated with Java
jython [ -i ] [ -S ] [ -v ] [
-Dproperty=value ... ] [
-Wargument ]
[ -Ecodec ] [ -Qargument ]
[ -jar jar | -c cmd | file | - ] [
script-args ]
jython [ --help | --version ]
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:
- Embedded
scripting:
- 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.
- Interactive
experimentation:
- 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.
- Rapid application
development:
- 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/env jython
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/env jython. This is because /usr/bin/jython is a
script itself, not a compiled binary.
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 import site 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.
- -jar jar
- The program to run is read from the file __run__.py in the
specified jar archive.
- -c cmd
- 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.
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/.
This manual page was prepared by Ben Burton <bab@debian.org>
for the Debian GNU/Linux system (but may be used by others). It is based
upon the official Jython documentation.