Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 106 lines (68 sloc) 3.679 kB
54c2050 @rtomac Update readme files
authored
1 Selenium2Library Installation
4ab16a8 @yanne Initial import
yanne authored
2 =============================
3
4
5 Preconditions
6 -------------
7
1848011 @rtomac - Added robotframework >= 2.6.3 dependency to setup.py install_requires
authored
8 Selenium2Library supports all Python and Jython interpreters supported by the
89a233f @rtomac Update preconditions to reflect system requirements for Selenium Pyth…
authored
9 Robot Framework and the `Selenium Python Bindings`_. The Selenium Python Bindings
1848011 @rtomac - Added robotframework >= 2.6.3 dependency to setup.py install_requires
authored
10 are the most restrictive, and as of now require Python 2.6 or Python 2.7.
11
694eab5 @rtomac Roll publish to PyPI into build_dist.py and update BUILD documentation
authored
12 Selenium2Library depends on a few other Python libraries, including
2daee1e @rtomac Increment version, sort out some setuptools/ez_setup stuff, focus on …
authored
13 of course Robot Framework and Selenium. All dependencies are declared
b66f0bc @emanlove Enhanced both installation documentation, INSTALL.rst and developer d…
emanlove authored
14 in setup.py.
15
a5ea7a0 @emanlove Removed section stubs for "Different Flavors of Python" and
emanlove authored
16
17 Installing using pip (recommended) or easy_install
18 --------------------------------------------------
19
20 Selenium2Library is available in the Python Package Index (PyPI_). It is
21 recommended that you use `pip`_ to install. Using pip will ensure that
22 both Selenium2Library **and** it's dependiences are installed.
23 To install using pip, run::
2daee1e @rtomac Increment version, sort out some setuptools/ez_setup stuff, focus on …
authored
24
25 pip install robotframework-selenium2library
26
27 Or alternately, if you only have `easy_install`_,::
1848011 @rtomac - Added robotframework >= 2.6.3 dependency to setup.py install_requires
authored
28
29 easy_install robotframework-selenium2library
4ab16a8 @yanne Initial import
yanne authored
30
a5ea7a0 @emanlove Removed section stubs for "Different Flavors of Python" and
emanlove authored
31 If you install Selenium2Library under Windows **and** you use easy_install,
32 you will need to install Selenium2Library's dependencies seperately.
33 To install the dependencies, run::
34
35 easy_install robotframework
36 easy_install selenium
37 easy_install decorator
38 easy_install docutils
39
40 Once installation is completed, you should verify proper installation of
41 Selenium2Library and it's dependencies. See `Verifying Installation` section
42 below.
54c2050 @rtomac Update readme files
authored
43
4ab16a8 @yanne Initial import
yanne authored
44 Installing from source
45 ----------------------
46
1848011 @rtomac - Added robotframework >= 2.6.3 dependency to setup.py install_requires
authored
47 The source code can be retrieved either as a source distribution or as a clone
48 of the main source repository. The installer requires Python version 2.4 or
2daee1e @rtomac Increment version, sort out some setuptools/ez_setup stuff, focus on …
authored
49 newer. Install by running::
4ab16a8 @yanne Initial import
yanne authored
50
1848011 @rtomac - Added robotframework >= 2.6.3 dependency to setup.py install_requires
authored
51 python setup.py install
4ab16a8 @yanne Initial import
yanne authored
52
694eab5 @rtomac Roll publish to PyPI into build_dist.py and update BUILD documentation
authored
53 Or, if you'd like to automatically install dependencies, run::
2daee1e @rtomac Increment version, sort out some setuptools/ez_setup stuff, focus on …
authored
54
55 python setup.py develop
56
57 Note: In most linux systems, you need to have root privileges for installation.
4ab16a8 @yanne Initial import
yanne authored
58
59 Uninstallation is achieved by deleting the installation directory and its
60 contents from the file system. The default installation directory is
54c2050 @rtomac Update readme files
authored
61 `[PythonLibraries]/site-packages/Selenium2Library`.
62
4ab16a8 @yanne Initial import
yanne authored
63
64 Using Windows installer
65 -----------------------
66
1848011 @rtomac - Added robotframework >= 2.6.3 dependency to setup.py install_requires
authored
67 Currently, Windows installer is the only available binary installer. Just
1fb23e7 @kontulai Update INSTALL.rst
kontulai authored
68 double-click the installer and follow the instructions. The installer is missing
69 decorator module. It must be installed either via pip or easy install, or from
70 http://pypi.python.org/pypi/decorator/
4ab16a8 @yanne Initial import
yanne authored
71
54c2050 @rtomac Update readme files
authored
72 Selenium2Library can be uninstalled using the Programs and Features utility from
73 Control Panel (Add/Remove Programs on older versions of Windows).
89a233f @rtomac Update preconditions to reflect system requirements for Selenium Pyth…
authored
74
b66f0bc @emanlove Enhanced both installation documentation, INSTALL.rst and developer d…
emanlove authored
75 Verifying Installation
76 ----------------------
77
78 Once you have installed Selenium2Library it is a good idea to verify the installation. To verify installation start python::
79
80 C:\> python
81
82 and then at the Python prompt type::
83
84 >> import Selenium2Library
85 >>
86
87 If the python command line interpretor returns with another prompt ('>>' as shown above) then your installation was successful.
88
89 Troubleshooting Installation
90 ----------------------------
91
92 The most common issue with installing Selenium2Library is missing dependencies. An error like::
93
94 ImportError: No module named robot.variables
95
96 indicates that you are missing the Robot Framework package. To correct this problem try typing at the prompt::
97
98 easy_install robotframework
99
100 Similarly if you receive "No module named ..." error message then you have another missing dependency. To correct, use easy_install to install the missing package.
101
89a233f @rtomac Update preconditions to reflect system requirements for Selenium Pyth…
authored
102
1848011 @rtomac - Added robotframework >= 2.6.3 dependency to setup.py install_requires
authored
103 .. _Selenium Python Bindings: http://code.google.com/p/selenium/wiki/PythonBindings
104 .. _PyPI: http://code.google.com/p/selenium/wiki/PythonBindings
2daee1e @rtomac Increment version, sort out some setuptools/ez_setup stuff, focus on …
authored
105 .. _pip: http://www.pip-installer.org
ad239c5 @rtomac Documentation cleanup
authored
106 .. _easy_install: http://pypi.python.org/pypi/setuptools
Something went wrong with that request. Please try again.