|Deletions are marked like this.||Additions are marked like this.|
|Line 3:||Line 3:|
|.. |stable.installer.jar| replace:: jython_installer-2.2.1.jar||.. |stable.installer.jar| replace:: jython_installer-2.5.0.jar|
|Line 5:||Line 5:|
|.. _stable.download: http://downloads.sourceforge.net/jython/jython_installer-2.2.1.jar||.. _stable.download: http://downloads.sourceforge.net/jython/jython_installer-2.5.0.jar|
|Line 13:||Line 13:|
Jython 2.5.x and 2.2.x
|Line 20:||Line 20:|
|Jython 2.2.1 is distributed as an executable jar file installer. After
`downloading <download.html>`__ it, either double click the
|Jython 2.5 and 2.2.1 are distributed as executable jar file installers. After
`downloading <DownloadInstructions>`__ it, either double click the
|Line 29:||Line 29:|
|consoler installer on headless systems. To force the installer to
work in headless mode invoke the installer with a console switch
|console installer on headless systems. To force the installer to
work in headless mode invoke the installer as:
|Line 40:||Line 40:|
|selected. There's a script in the install directory, jython on Unix
like systems or jython.bat on Windows, that will start up the Jython
console which can be used to dynamically explore Jython and the Java
|selected. Executing a script in the install directory, ``jython`` on Unix-like systems or ``jython.bat`` on Windows, will start up the Jython
console, which can be used to dynamically explore Jython and the Java
runtime, or to run Jython scripts.
|Line 75:||Line 74:|
|You can get a list of the installer options by running:||You can get a list of installer options by running:|
|Line 80:||Line 79:|
Jython 2.1 is distributed as a self-extracting .class file created by
LiftOff. It is known to have problems running on Java 6, so if you
want to use Jython with that JVM either install Jython-2.1 with an earlier
JVM or use Jython-2.2.1.
To install Jython, open the command line to the directory in which you have placed the jython-21.class file and then type:
<java interpreter> jython-21
You will probably type one of the following three lines, depending on your system. Be sure not to put ".class" at the end of the file name.
It can be necessay to set the CLASSPATH to include the current directory
env CLASSPATH=. java jython-21
java -cp . jython-21
java -classpath . jython-21
jview /cp:. jython-21
Which command to use depends on your operating system and java version. If you have more than one java installed, you may have to supply an explicit path the java command.
If you do not have a GUI, then add -o dir_to_install_to to the command above. Jython will install to the specified directory without bringing up the graphical installer. E.g. to install all modules to a Jython-2.1 subdirectory in the current directory do:
<java interpreter> jython-21 -o Jython-2.1 demo lib source
After completing installation, you should be able to run Jython by typing:
What Can Go Wrong
You should check out this section if your Jython installation doesn't
quite work right. It will contain tips for solving the most common
Can't Access Standard Python Modules
Not all the modules form CPython is available in Jython. Some modules require a C language dynamic link library that doesn't exists in java. Other modules are missing from Jython just because nobody have had a need for it before and no-one have tested the CPython module with Jython. If you discover that you are missing a module, try to copy the .py file from a CPython distribution to a directory on your Jython sys.path. If that works you are set. If it doesn't work, try asking on jython-users mailing list.
Any other problems with the installation should be reported to jython-dev.
As a workaround you can extract the jython-21.class manually. The class file is basicly a .zip file and most unzip programs can manage to extract the contents of the class into a directory. After doing that, you must
* Remove the net directory. It isn't needed.
* Create the startup script by hand. Use the installer/template* files as a starting point in doing so.
Jython 2.5 and 2.2.1 are distributed as executable jar file installers. After downloading it, either double click the jython_installer-2.5.0.jar or run java with the -jar option
java -jar jython_installer-2.5.0.jar
This will start the regular GUI installer on most systems, or a console installer on headless systems. To force the installer to work in headless mode invoke the installer as:
java -jar jython_installer-2.5.0.jar --console
The installer will then walk through a similar set of steps in graphical or console mode: showing the license, selecting an install directory and JVM and actually copying Jython to the filesystem. After this completes, Jython is installed in the directory you selected. Executing a script in the install directory, jython on Unix-like systems or jython.bat on Windows, will start up the Jython console, which can be used to dynamically explore Jython and the Java runtime, or to run Jython scripts.
The standalone option does no caching and so avoids the startup overhead (most likely at the cost of some speed in calling Java classes, but I have not profiled it)
You can try it out by downloading the installer from here
running it like so:
$ java -jar jython_installer-2.5.0.jar
And when you come to the "Installation type" page, select "Standalone".
When the installation is done, you will have a jython.jar with the /Lib files included that can be run like this:
$ java -jar jython.jar
You will get a jython prompt with no caching. Of course you can run scripts just by calling them as you might expect:
$ java -jar jython.jar script.py
And you can add this jar to the classpath of your app, which will allow standard imports.
You can get a list of installer options by running:
$ java -jar jython_installer-2.5.0.jar --help