annotate _ui_tests/README.txt @ 2860:233d63abbdaf

reorder modernized blog.css rules to match basic blog.css sequence no code changes, rules remain unnecessarily inconsistent
author RogerHaase <haaserd@gmail.com>
date Tue, 02 Dec 2014 14:21:32 -0700
parents f87d2e646c60
children
rev   line source
1782
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
1 Functional tests
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
2 ================
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
3
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
4 Summary
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
5 =======
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
6
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
7 This directory contains functional tests, which directly test the ui, without
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
8 needing access to the underlying code.
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
9
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
10 These tests use selenium.
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
11
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
12 Licensing issues
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
13 ----------------
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
14
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
15 The selenium license is apache 2.0. MoinMoin license is "GPL v2 or later".
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
16 GPL v2 license is currently considered by some to be incompatible with apache
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
17 2 license. GPL v3 is currently considered by many to be ok for use in
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
18 conjunction with apache 2 license.
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
19
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
20 By separating the functional tests from the unit tests, we avoid having to
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
21 import selenium and MoinMoin in the same python runtime, which
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
22 means that there should not be any licensing issues.
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
23
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
24 Everything in this 'tests/functional' folder should be licensed "GPL v3 or
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
25 later", and not link to anything GPL v2. Specifically, these tests should
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
26 not link with MoinMoin itself.
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
27
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
28 Pre-requisites
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
29 --------------
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
30
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
31 - have activated the MoinMoin environment:
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
32 source env/bin/activate
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
33 - have installed selenium:
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
34 pip install selenium
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
35 - have installed firefox
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
36
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
37 Instructions
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
38 ------------
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
39
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
40 1. Open a terminal
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
41 2. Change into the directory of this README
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
42 3. Execute 'py.test -v -s'
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
43
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
44 If any tests fail, screenshots will be generated in the current directory
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
45 with names corresponding to the test class name and method name.
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
46
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
47 To run in the background
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
48 ------------------------
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
49
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
50 Pre-requisite:
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
51 - have installed xfvb
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
52
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
53 1. Open a terminal
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
54 2. Change into the directory of this README
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
55 3. Execute 'xfvb-run py.test -v -s'
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
56
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
57 Configuration
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
58 -------------
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
59
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
60 configuration is in 'config.py'. You can define where your MoinMoin
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
61 installation is running, ie which URL.
f87d2e646c60 created a first selenium test, specifically of adding subitems
Hugh Perkins <hughperkins@gmail.com>
parents:
diff changeset
62