moin-2.0 / _ui_tests /

Filename Size Date modified Message
..
1.6 KB
209 B
1.2 KB
560 B
2.7 KB
1.5 KB
Functional tests
================

Summary
=======

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.

Pre-requisites
--------------

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

Instructions
------------

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
------------------------

Pre-requisite:
- have installed xfvb

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

Configuration
-------------

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

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.