Revision: 3232
Author: janne.t.harkonen
Date: Thu May 6 23:33:16 2010
Log: Updated Jython installation instructions
http://code.google.com/p/robotframework/source/detail?r=3232
Modified:
/wiki/Installation.wiki
=======================================
--- /wiki/Installation.wiki Thu May 6 07:33:48 2010
+++ /wiki/Installation.wiki Thu May 6 23:33:16 2010
@@ -90,37 +90,49 @@
= Preconditions =
-Robot Framework runs both on [http://python.org Python] and
[http://www.jython.org Jython], and you need to have at least one of them
to be able to use it. However, the provided installers only work with
Python, so installing it is always recommended.
+Robot Framework runs both on [http://python.org Python] and
+[http://www.jython.org Jython], and you need to have at least one of them
to be
+able to use it. However, some of the provided installers only work with
Python, so
+installing it is always recommended.
== Python installation ==
-Latest Python 2.6 or 2.5 versions are recommended, although Python 2.4 and
2.3 are also supported. On most UNIX-like systems, you have Python
installed by default. If you are on Windows or otherwise need to install
Python yourself, your best place to start is probably the
[http://python.org Python homepage]. There you can download a suitable
installer and get more information about the installation and Python in
general.
+Starting from Robot Framework 2.5, Python 2.5 is the minimum supported
Python
+version. Earlier versions support also Python 2.4 and 2.3. On
+most UNIX-like systems, you have Python installed by default. If you are on
+Windows or otherwise need to install Python yourself, your best place to
start
+is probably the [http://python.org Python homepage]. There you can
download a
+suitable installer and get more information about the installation and
Python
+in general.
*NOTE:*
- Robot Framework is not compatible with Python 3.x versions. Python 3.0
was
- [http://docs.python.org/3.0/whatsnew/3.0.html intentionally backwards
incompatible]
- with earlier Python releases, and supporting it as long as we need to
support very
- old Python versions (most notably Jython 2.2) is not feasible.
+ Robot Framework is currently not compatible with Python 3.x versions
because
+ Python 3.0 was intentionally backwards incompatible with earlier Python
releases.
On Windows, and especially on Windows Vista, it is recommended to
install Python to all users, and to run the installation as an
administrator.
== Jython installation ==
-Using test libraries implemented with Java or using Java tools directly
requires running Robot Framework on Jython, which then requires Java
Runtime Environment (JRE). The minimum required Java version is 1.4, but
newer versions are recommended, as they tend to be faster with dynamic
languages, such as Jython. Both Sun and IBM Java versions are supported.
-
-Robot Framework requires Jython version 2.2. The earlier Jython version
2.1 is not compatible with Robot, and also 2.2 betas and alphas have some
problems and are not supported. Unfortunately, also Jython 2.2.1 has
certain Unicode problems which makes it incompatible with Robot Framework
if Unicode support is needed.
-
-Installing Jython is a fairly easy procedure. First you need to get an
installer from the [http://www.jython.org Jython homepage] or directly from
http://downloads.sourceforge.net/jython/jython_installer-2.2.jar. Note that
the installer is an executable JAR package, which you need to run as `java
-jar jython_installer-2.2.jar`. Depending on your system, the installer
runs either in the graphical or the textual mode, but in both cases, the
actual installation steps are very simple.
-
-When installing Robot Framework, its installer tries to find the Jython
executable on the system to create the `jybot` runner script correctly.
Jython is found if:
-
- # Jython can be executed in the system directly (i.e. it is in the PATH).
- # An environment variable JYTHON_HOME is set and it points to the Jython
installation directory.
- # The installer finds the Jython installation directory from the system.
On Windows, it is searched from the _C:\_ and _D:\_ drives, and on other
systems from the _/usr/local_ and _/opt_ directories. The directory is
found if it is under the searched directories mentioned above, or one level
deeper. For example, the following Jython installation directories would be
found by the installer:
- * _C:\APPS\Jython2.2_
- * _D:\Jython22_
- * _/usr/local/jython2.2_
- * _/opt/whatever/Jython22_
+Using test libraries implemented with Java or using Java tools directly
+requires running Robot Framework on Jython, which in turn requires Java
Runtime
+Environment (JRE). Minimum required JRE version depends on the Jython
version
+used. Jython 2.5 requires Java 1.5 or newer, whereas Jython 2.2 works
also with
+Java 1.4. Both Sun and IBM Java implementations are supported.
+
+Starting from Robot Framework 2.5, the minimum supported Jython version is
2.5.
+Earlier Robot Framework versions support also Jython 2.2.
+
+Installing Jython is a fairly easy procedure, and the first step is
getting an
+installer from the [http://www.jython.org Jython homepage]. Note that the
+installer is an executable JAR package, which you need to run as `java -jar
+jython_installer-<version>.jar`. Depending on your system, the installer
runs
+either in graphical or textual mode, but in both cases, the actual
installation
+procedure is very easy.
+
+If you have Jython installed when Robot Framework is installed with Python,
+`jybot` runner script will be (most of the time) created correctly. The
details,
+as well as instructions how to install Robot Framework using only Jython
can be found
+from the [UserGuide User Guide].
= Uninstallation =
