NAME
jython - Python seamlessly integrated with Java
SYNOPSIS
jython [ -i ] [ -S ] [ -v ] [ -Dproperty=value ... ] [ -Wargument ]
[ -Ecodec ] [ -Qargument ]
[ -jar jar | -c cmd | file | - ] [ script-args ]
jython [ --help | --version ]
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:
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.
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 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.
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.
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/.
AUTHOR
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.
July 7, 2001