This directory contains a very simple remote library example in examplelibrary.py file and tests using it in tests.robot file. The example library can be executed with Python (both 2 and 3), Jython, IronPython or PyPy. Also tests can be run with any of these interpreters, independently from the interpreter used for executing the library.
A precondition to running the example is installing the remote server or
putting it into PYTHONPATH or equivalent otherwise. After that the remote
library can be started from the command line by just executing it with
the selected interpreter:
python examplelibrary.py # Start library on Python jython examplelibrary.py # Start library on Jython
Depending on the operating system configuration, it may also be possible to simply double-click the library on a file manager.
After the library is running, tests can be executed normally:
robot tests.robot # Execute with the `robot` command pypy -m robot tests.robot # Execute `robot` module using PyPy
By default the library starts to listen on connections from the localhost on port 8270. Both the address and the port to listen to can be configured with command line arguments to the library, and also given as variables to tests that are run:
python examplelibrary.py 192.168.1.15 7777 robot --variable ADDRESS:192.168.1.15 --variable PORT:7777 tests.robot
Although the remote server in general can be used from a different machine, this example only works correctly when tests are run on the same machine where the server is running.
See the example library and tests themselves for details how configuration is implemented and the general remote server documentation for more information about configuring the remote server in general.