view _ui_tests/README.txt @ 1862:afa63a0cc1e1

partial revert of dab0253193eb
author Reimar Bauer <rb.proj AT googlemail DOT com>
date Sun, 18 Nov 2012 16:58:06 +0100
parents f87d2e646c60
line wrap: on
line source
Functional tests


This directory contains functional tests, which directly test the ui, without
needing access to the underlying code.

These tests use selenium.

Licensing issues

The selenium license is apache 2.0.  MoinMoin license is "GPL v2 or later".  
GPL v2 license is currently considered by some to be incompatible with apache 
2 license. GPL v3 is currently considered by many to be ok for use in 
conjunction with apache 2 license.

By separating the functional tests from the unit tests, we avoid having to 
import selenium and MoinMoin in the same python runtime, which
means that there should not be any licensing issues.

Everything in this 'tests/functional' folder should be licensed "GPL v3 or 
later", and not link to anything GPL v2.  Specifically, these tests should 
not link with MoinMoin itself.


- have activated the MoinMoin environment:
      source env/bin/activate
- have installed selenium:
      pip install selenium
- have installed firefox


1. Open a terminal
2. Change into the directory of this README
3. Execute 'py.test -v -s'

If any tests fail, screenshots will be generated in the current directory 
with names corresponding to the test class name and method name.

To run in the background

- have installed xfvb

1. Open a terminal
2. Change into the directory of this README
3. Execute 'xfvb-run py.test -v -s'


configuration is in ''.  You can define where your MoinMoin 
installation is running, ie which URL.