From bc18e4f0f0268476c0217721161958ef4e640da9 Mon Sep 17 00:00:00 2001
From: Ian Ross <iross@cadasta.org>
Date: Mon, 22 Feb 2016 21:09:49 +0100
Subject: [PATCH 1/2] Functional testing

 * Move Webpack setup into development VM
 * Functional test support: Selenium + PhantomJS
 * Functional testing infrastructure: test runner and "pages" pattern
 * Functional tests for: login, registration, user profile editing
 * Functional tests on Travis

See documentation at:

 - https://github.com/Cadasta/cadasta-platform/wiki/Running-functional-tests
 - https://github.com/Cadasta/cadasta-platform/wiki/Writing-functional-tests
---
 .gitignore                                    |   5 +
 .travis.yml                                   |  13 +-
 README.md                                     |   6 +-
 Vagrantfile                                   |   4 +-
 app/src/js/account/components/Login.jsx       |   1 +
 app/src/js/account/components/Profile.jsx     |   3 +-
 .../account/components/RegistrationForm.jsx   |   1 +
 app/src/locale/gettext.po                     | 144 ++++++++---------
 app/webpack.config.js                         |   8 +
 functional_tests/accounts/test_login.py       |  56 +++++++
 functional_tests/accounts/test_profile.py     |  41 +++++
 .../accounts/test_registration.py             |  78 +++++++++
 functional_tests/base.py                      | 150 ++++++++++++++++++
 functional_tests/pages/Login.py               |  38 +++++
 functional_tests/pages/Profile.py             |  42 +++++
 functional_tests/pages/Registration.py        |  80 ++++++++++
 functional_tests/pages/base.py                |   4 +
 functional_tests/run.py                       |  12 ++
 .../roles/cadasta/application/tasks/main.yml  |  21 ++-
 .../roles/cadasta/production/tasks/main.yml   |  13 --
 provision/roles/testing/tasks/main.yml        |  18 +++
 .../development/templates/nginx-development   |  10 +-
 provision/vagrant.yml                         |   5 +-
 requirements/dev.txt                          |   1 +
 24 files changed, 655 insertions(+), 99 deletions(-)
 create mode 100644 functional_tests/accounts/test_login.py
 create mode 100644 functional_tests/accounts/test_profile.py
 create mode 100644 functional_tests/accounts/test_registration.py
 create mode 100644 functional_tests/base.py
 create mode 100644 functional_tests/pages/Login.py
 create mode 100644 functional_tests/pages/Profile.py
 create mode 100644 functional_tests/pages/Registration.py
 create mode 100644 functional_tests/pages/base.py
 create mode 100755 functional_tests/run.py
 create mode 100644 provision/roles/testing/tasks/main.yml

diff --git a/.gitignore b/.gitignore
index fd3388955..efb5ab9da 100644
--- a/.gitignore
+++ b/.gitignore
@@ -19,3 +19,8 @@ htmlcov
 # JS
 */dist/bundle.js
 node_modules/
+/.envrc
+/.virtualenv/
+
+ghostdriver.log
+npm-debug.log
diff --git a/.travis.yml b/.travis.yml
index 37a9718af..cdb087cca 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -6,6 +6,13 @@ services:
   - postgresql
 addons:
   postgresql: "9.4"
+# env:
+#  - DJANGO_LIVE_TEST_SERVER_ADDRESS=127.0.0.1:5000
+# before_install:
+#  - travis_retry sudo apt-get update
+#  - travis_retry sudo apt-get install phantomjs
+#  - sudo mkdir /var/log/django
+#  - sudo chmod 777 /var/log/django
 install:
   - pip install -r requirements/common.txt
   - pip install -r requirements/dev.txt
@@ -23,4 +30,8 @@ script:
   - py.test cadasta --cov=cadasta --ds=config.settings.travis
   - cd app
   - npm run travis-test
-  - cd ..
+#   - npm start | tee /tmp/npm-start.log &
+#   - while ! grep 'bundle is now VALID' /tmp/npm-start.log; do sleep 1; done
+#   - sleep 2
+#   - cd ../functional_tests
+#   - ./run.py --ds=config.settings.travis
diff --git a/README.md b/README.md
index e2ec463a4..21a81ea29 100644
--- a/README.md
+++ b/README.md
@@ -23,15 +23,17 @@ SSH into to the VM, activate the virtualenv and run the server:
 ```
 vagrant ssh
 cd /vagrant/
-source env/bin/activate
+source /opt/cadasta/env/bin/activate
 python cadasta/manage.py runserver
 ```
 
 Open `http://localhost:5000/` in your browser, you should see a default Django page.
 
+See the wiki ([here](https://github.com/Cadasta/cadasta-platform/wiki/Installation) and [here](https://github.com/Cadasta/cadasta-platform/wiki/Run-for-development)) for detailed instructions on installation and running the platform for development.
+
 ## Run tests
 
-From the repository's root run:
+Within the development VM, from the `/vagrant` directory run:
 
 ```
 py.test cadasta
diff --git a/Vagrantfile b/Vagrantfile
index c5831bdc6..f962852e3 100644
--- a/Vagrantfile
+++ b/Vagrantfile
@@ -22,7 +22,9 @@ Vagrant.configure(2) do |config|
   # Create a forwarded port mapping which allows access to a specific port
   # within the machine from a port on the host machine. In the example below,
   # accessing "localhost:8080" will access port 80 on the guest machine.
-  config.vm.network "forwarded_port", guest: 8080, host: 5000
+  config.vm.network "forwarded_port", guest: 5000, host: 5000
+  config.vm.network "forwarded_port", guest: 3000, host: 3000
+  config.vm.network "forwarded_port", guest: 8080, host: 8080
 
   # Create a private network, which allows host-only access to the machine
   # using a specific IP.
diff --git a/app/src/js/account/components/Login.jsx b/app/src/js/account/components/Login.jsx
index 36a7a293f..2eddf895e 100644
--- a/app/src/js/account/components/Login.jsx
+++ b/app/src/js/account/components/Login.jsx
@@ -85,6 +85,7 @@ export class Login extends React.Component {
         />
 
         <button
+          name="sign-in"
           type="submit"
           formNoValidate
           className="btn btn-default btn-lg btn-block text-uppercase"
diff --git a/app/src/js/account/components/Profile.jsx b/app/src/js/account/components/Profile.jsx
index 4792507a2..751c00346 100644
--- a/app/src/js/account/components/Profile.jsx
+++ b/app/src/js/account/components/Profile.jsx
@@ -47,7 +47,7 @@ export class Profile extends React.Component {
   render() {
     return (
       <Form
-        className="form-narrow"
+        className="profile-form form-narrow"
         onValidSubmit={this.handleFormSubmit}
         ref="form"
       >
@@ -105,6 +105,7 @@ export class Profile extends React.Component {
 
         <button
           formNoValidate
+          name="update"
           type="submit"
           className="btn btn-default btn-lg btn-block text-uppercase"
         >
diff --git a/app/src/js/account/components/RegistrationForm.jsx b/app/src/js/account/components/RegistrationForm.jsx
index 1569af518..2fae973b5 100644
--- a/app/src/js/account/components/RegistrationForm.jsx
+++ b/app/src/js/account/components/RegistrationForm.jsx
@@ -109,6 +109,7 @@ class RegistrationForm extends React.Component {
         />
 
         <button
+          name="register"
           type="submit"
           formNoValidate
           className="btn btn-default btn-lg btn-block text-uppercase"
diff --git a/app/src/locale/gettext.po b/app/src/locale/gettext.po
index 81e098613..1cd194a35 100644
--- a/app/src/locale/gettext.po
+++ b/app/src/locale/gettext.po
@@ -3,69 +3,31 @@ msgstr ""
 "Content-Type: text/plain; charset=utf-8\n"
 "Plural-Forms: nplurals = 2; plural = (n !== 1);\n"
 
-#: src/js/account/components/Profile.jsx:60
-msgid "Username"
-msgstr ""
-
-#: test/locale/test_locale.js:16
-msgid "Hello %(name)s"
-msgstr ""
-
-#: test/locale/test_locale.js:33
-msgid "%d unread message"
-msgid_plural "%d unread messages"
-msgstr[0] ""
-msgstr[1] ""
-
-#: test/locale/test_locale.js:38
-msgid "Need more information? [link:Click here]."
-msgstr ""
-
-#: src/js/account/components/Password.jsx:34
-msgid "Change your password"
+#: src/js/account/components/Login.jsx:48
+msgid "Sign in to your account"
 msgstr ""
 
-#: src/js/account/components/Password.jsx:40
-msgid "Current password"
+#: src/js/account/components/Profile.jsx:60
+msgid "Username"
 msgstr ""
 
-#: src/js/account/components/PasswordResetConfirm.jsx:50
-msgid "New password"
+#: src/js/account/components/RegistrationForm.jsx:88
+msgid "This field is required"
 msgstr ""
 
 #: src/js/account/components/RegistrationForm.jsx:67
-msgid "Your password must be at least 6 characters long."
-msgstr ""
-
-#: src/js/account/components/PasswordResetConfirm.jsx:62
-msgid "Repeat new password"
-msgstr ""
-
-#: src/js/account/components/RegistrationForm.jsx:80
-msgid "Passwords must match."
-msgstr ""
-
-#: src/js/account/components/Profile.jsx:112
-msgid "Change password"
-msgstr ""
-
-#: src/js/account/components/Login.jsx:48
-msgid "Sign in to your account"
-msgstr ""
-
-#: src/js/account/components/RegistrationForm.jsx:63
 msgid "Password"
 msgstr ""
 
-#: src/js/account/components/Login.jsx:71
+#: src/js/account/components/Login.jsx:77
 msgid "Forgotten password?"
 msgstr ""
 
-#: src/js/account/components/Login.jsx:78
+#: src/js/account/components/Login.jsx:84
 msgid "Remember me"
 msgstr ""
 
-#: src/js/account/components/Login.jsx:86
+#: src/js/account/components/Login.jsx:93
 msgid "Sign in"
 msgstr ""
 
@@ -73,72 +35,68 @@ msgstr ""
 msgid "Update your profile"
 msgstr ""
 
-#: src/js/account/components/RegistrationForm.jsx:50
+#: src/js/account/components/RegistrationForm.jsx:53
 msgid "Email"
 msgstr ""
 
-#: src/js/account/components/RegistrationForm.jsx:54
+#: src/js/account/components/RegistrationForm.jsx:57
 msgid "Please provide a valid email address"
 msgstr ""
 
-#: src/js/account/components/RegistrationForm.jsx:90
+#: src/js/account/components/RegistrationForm.jsx:98
 msgid "First name"
 msgstr ""
 
-#: src/js/account/components/RegistrationForm.jsx:99
+#: src/js/account/components/RegistrationForm.jsx:107
 msgid "Last name"
 msgstr ""
 
-#: src/js/account/components/Profile.jsx:107
+#: src/js/account/components/Profile.jsx:112
 msgid "Update profile"
 msgstr ""
 
-#: src/js/account/components/Profile.jsx:110
+#: src/js/account/components/Profile.jsx:115
 msgid "Password options"
 msgstr ""
 
-#: src/js/account/components/PasswordResetConfirm.jsx:77
-msgid "Reset password"
-msgstr ""
-
-#: src/js/account/components/PasswordReset.jsx:34
-msgid "Reset your password"
+#: src/js/account/components/Password.jsx:84
+msgid "Change password"
 msgstr ""
 
-#: src/js/account/components/PasswordReset.jsx:41
-msgid "Enter email"
+#: src/js/account/components/PasswordResetConfirm.jsx:81
+msgid "Reset password"
 msgstr ""
 
-#: src/js/account/components/PasswordResetConfirm.jsx:44
-msgid "Create a new password"
+#: src/js/account/components/Password.jsx:34
+msgid "Change your password"
 msgstr ""
 
-#: src/js/account/components/RegistrationForm.jsx:33
-msgid "Sign up for a free account"
+#: src/js/account/components/Password.jsx:40
+msgid "Current password"
 msgstr ""
 
-#: src/js/account/components/RegistrationForm.jsx:40
-msgid "Choose username"
+#: src/js/account/components/PasswordResetConfirm.jsx:50
+msgid "New password"
 msgstr ""
 
-#: src/js/account/components/RegistrationForm.jsx:75
-msgid "Confirm password"
+#: src/js/account/components/RegistrationForm.jsx:72
+msgid "Your password must be at least 6 characters long."
 msgstr ""
 
-#: src/js/core/components/Header.jsx:33
-msgid "Register"
+#: src/js/account/components/PasswordResetConfirm.jsx:65
+msgid "Repeat new password"
 msgstr ""
 
-#: src/js/core/components/Header.jsx:23
-msgid "Profile"
+#: src/js/account/components/RegistrationForm.jsx:87
+msgid "Passwords must match."
 msgstr ""
 
-#: src/js/core/components/Header.jsx:24
-msgid "Logout"
+#: src/js/account/components/PasswordReset.jsx:34
+msgid "Reset your password"
 msgstr ""
 
-#: src/js/core/components/Header.jsx:32
-msgid "Login"
+#: src/js/account/components/PasswordReset.jsx:41
+msgid "Enter email"
 msgstr ""
 
 #: src/js/messages/reducer.js:10
@@ -205,4 +163,36 @@ msgstr ""
 
 #: src/js/messages/reducer.js:29
 msgid "Account successfully activated."
+msgstr ""
+
+#: src/js/account/components/PasswordResetConfirm.jsx:44
+msgid "Create a new password"
+msgstr ""
+
+#: src/js/core/components/Header.jsx:23
+msgid "Profile"
+msgstr ""
+
+#: src/js/core/components/Header.jsx:24
+msgid "Logout"
+msgstr ""
+
+#: src/js/core/components/Header.jsx:32
+msgid "Login"
+msgstr ""
+
+#: src/js/account/components/RegistrationForm.jsx:117
+msgid "Register"
+msgstr ""
+
+#: src/js/account/components/RegistrationForm.jsx:33
+msgid "Sign up for a free account"
+msgstr ""
+
+#: src/js/account/components/RegistrationForm.jsx:40
+msgid "Choose username"
+msgstr ""
+
+#: src/js/account/components/RegistrationForm.jsx:82
+msgid "Confirm password"
 msgstr ""
\ No newline at end of file
diff --git a/app/webpack.config.js b/app/webpack.config.js
index aef1c0797..214b68c5c 100755
--- a/app/webpack.config.js
+++ b/app/webpack.config.js
@@ -34,11 +34,19 @@ module.exports = {
   },
   devServer: {
     contentBase: './dist',
+    host: '0.0.0.0',
     hot: true,
     historyApiFallback: true,
+    watchOptions: {
+      aggregateTimeout: 300,
+      poll: 1000
+    }
   },
   plugins: [
     new webpack.HotModuleReplacementPlugin(),
     new webpack.DefinePlugin(BUILD_OPTIONS),
   ],
+  watchOptions: {
+    poll: true
+  }
 };
diff --git a/functional_tests/accounts/test_login.py b/functional_tests/accounts/test_login.py
new file mode 100644
index 000000000..298cba433
--- /dev/null
+++ b/functional_tests/accounts/test_login.py
@@ -0,0 +1,56 @@
+from base import FunctionalTest
+from pages.Login import LoginPage
+from accounts.models import User
+
+
+class LoginTest(FunctionalTest):
+    def setUp(self):
+        user1 = User(username='user1', email='user1@example.org',
+                     first_name='User', last_name='One')
+        user1.set_password('user1pwd')
+        user1.save()
+        user2 = User(username='user2', email='user2@example.com',
+                     first_name='User', last_name='Two')
+        user2.set_password('user2pwd')
+        user2.save()
+
+    def test_unregistered_user(self):
+        """An unregistered user cannot log in."""
+
+        sign_in = LoginPage(self).setup('baduser', 'password')
+        self.click_through(sign_in, self.BY_ALERT)
+
+        self.assert_has_message('alert', "Unable to login")
+
+    def test_wrong_password(self):
+        """An user cannot log in with an invalid password."""
+
+        sign_in = LoginPage(self).setup('user1', 'not_right')
+        self.click_through(sign_in, self.BY_ALERT)
+
+        self.assert_has_message('alert', "Unable to login")
+
+    def test_valid_login(self):
+        """A registered user can log in with their username and password and
+        log out again.  The logged in and logged out states are
+        persistent across page refreshes.
+
+        """
+
+        sign_in = LoginPage(self).setup('user1', 'user1pwd')
+        self.click_through(sign_in, self.BY_ALERT)
+        self.browser.find_element_by_xpath("//h1[.='Dashboard']")
+
+        self.browser.refresh()
+        self.wait_for_no_alerts()
+        self.browser.find_element_by_xpath("//h1[.='Dashboard']")
+
+        self.click_through(
+            self.browser.find_element_by_xpath("//a[.='Logout']"),
+            self.BY_ALERT
+        )
+        self.assert_has_message('alert', "logged out")
+
+        self.browser.refresh()
+        self.wait_for_no_alerts()
+        self.browser.find_element_by_xpath("//h1[.='Sign in to your account']")
diff --git a/functional_tests/accounts/test_profile.py b/functional_tests/accounts/test_profile.py
new file mode 100644
index 000000000..21e55fa2f
--- /dev/null
+++ b/functional_tests/accounts/test_profile.py
@@ -0,0 +1,41 @@
+from base import FunctionalTest
+from pages.Profile import ProfilePage
+from pages.Login import LoginPage
+from accounts.models import User
+
+
+class ProfileTest(FunctionalTest):
+    def setUp(self):
+        user1 = User(username='user1', email='user1@example.org',
+                     first_name='User', last_name='One')
+        user1.set_password('user1pwd')
+        user1.save()
+
+    def test_profile_view_and_edit(self):
+        """A registered user can view and edit their profile."""
+        LoginPage(self).login('user1', 'user1pwd')
+
+        page = ProfilePage(self)
+        page.go_to()
+        fields = page.get_fields()
+
+        fields['first_name'].clear()
+        fields['first_name'].send_keys('Kenny')
+        fields['last_name'].clear()
+        fields['last_name'].send_keys('Everett')
+        self.click_through(fields['update'], self.BY_ALERT)
+        self.assert_has_message('alert',
+                                "Successfully updated profile information")
+
+        self.click_through(
+            self.browser.find_element_by_xpath("//a[.='Logout']"),
+            self.BY_ALERT
+        )
+        self.assert_has_message('alert', "logged out")
+        LoginPage(self).login('user1', 'user1pwd')
+
+        page = ProfilePage(self)
+        page.go_to()
+        fields = page.get_fields()
+        assert fields['first_name'].get_attribute('value') == 'Kenny'
+        assert fields['last_name'].get_attribute('value') == 'Everett'
diff --git a/functional_tests/accounts/test_registration.py b/functional_tests/accounts/test_registration.py
new file mode 100644
index 000000000..34ca50884
--- /dev/null
+++ b/functional_tests/accounts/test_registration.py
@@ -0,0 +1,78 @@
+from base import FunctionalTest
+from pages.Registration import RegistrationPage
+from pages.Login import LoginPage
+from accounts.models import User
+
+
+class RegistrationTest(FunctionalTest):
+    def setUp(self):
+        user1 = User(username='user1', email='user1@example.org',
+                     first_name='User', last_name='One')
+        user1.set_password('user1pwd')
+        user1.save()
+
+    def test_register_user(self):
+        """An unregistered user can register with valid user details."""
+
+        page = RegistrationPage(self)
+        page.go_to()
+        fields = page.get_fields()
+
+        # Try to submit an empty form and check for validation errors.
+        page.try_submit(err=['username', 'email',
+                             'password', 'password_repeat'])
+
+        # Fill in required fields one by one, try to submit and check
+        # for errors.
+        fields['username'].send_keys('user3')
+        page.try_submit(err=['email', 'password', 'password_repeat'],
+                        ok=['username'])
+        fields['email'].send_keys('user3@example.net')
+        page.try_submit(err=['password', 'password_repeat'],
+                        ok=['username', 'email'])
+        fields['password'].send_keys('very_secret')
+        page.try_submit(err=['password_repeat'],
+                        ok=['username', 'email', 'password'])
+        fields['password_repeat'].send_keys('not_very_secret')
+        page.try_submit(err=['password_repeat'],
+                        ok=['username', 'email', 'password'])
+
+        # Fill in extra fields, fill in final required form and
+        # submit.
+        fields['first_name'].send_keys('User')
+        fields['last_name'].send_keys('Three')
+        fields['password_repeat'].clear()
+        fields['password_repeat'].send_keys('very_secret')
+        self.click_through(fields['register'], self.BY_ALERT)
+        self.assert_has_message('alert', "logged in")
+        self.browser.find_element_by_xpath("//h1[.='Dashboard']")
+
+        # Log out.
+        self.click_through(
+            self.browser.find_element_by_xpath("//a[.='Logout']"),
+            self.BY_ALERT
+        )
+        self.assert_has_message('alert', "logged out")
+
+        # Log in as new user.
+        sign_in = LoginPage(self).setup('user3', 'very_secret')
+        self.click_through(sign_in, self.BY_ALERT)
+        self.browser.find_element_by_xpath("//h1[.='Dashboard']")
+
+    def test_register_duplicate_user(self):
+        page = RegistrationPage(self)
+        page.go_to()
+        fields = page.get_fields()
+
+        fields['username'].send_keys('user1')
+        fields['email'].send_keys('b@lah.net')
+        fields['password'].send_keys('password123')
+        fields['password_repeat'].send_keys('password123')
+        fields['first_name'].send_keys('Jane')
+        fields['last_name'].send_keys('Doe')
+        self.click_through(fields['register'], self.BY_ALERT)
+        self.assert_has_message('alert',
+                                "Unable to register with provided credentials")
+        self.browser.find_element_by_xpath(
+            "//h1[.='Sign up for a free account']"
+        )
diff --git a/functional_tests/base.py b/functional_tests/base.py
new file mode 100644
index 000000000..11c88d188
--- /dev/null
+++ b/functional_tests/base.py
@@ -0,0 +1,150 @@
+from django.test import LiveServerTestCase
+
+import sys
+import time
+import re
+import os
+import os.path
+import shutil
+
+from selenium import webdriver
+from selenium.common.exceptions import (
+    NoSuchElementException, WebDriverException
+)
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+
+
+class FunctionalTest(LiveServerTestCase):
+    DEFAULT_UI_ENDPOINT = 'localhost:8080'
+    DEFAULT_WAIT = 5
+
+    BY_ALERT = (By.CLASS_NAME, 'alert')
+
+    @classmethod
+    def setUpClass(cls):
+        # IMPORTANT: Make sure the window size is big enough to see
+        # everything (e.g. links in the nav bar).  Otherwise tests
+        # will fail mysteriously because PhantomJS will clip the
+        # viewport.
+        cls.browser = webdriver.PhantomJS()
+        cls.browser.set_window_size(1024, 768)
+
+        # Set up API and UI URLs.  This is intended for future testing
+        # against a staging server.  Don't know if it works properly
+        # yet (and there are other concerns to be dealt with for
+        # staging testing, like database fixtures).
+        cls.api_url = None
+        cls.ui_url = 'http://' + cls.DEFAULT_UI_ENDPOINT
+        for arg in sys.argv:
+            if 'ui' in arg:
+                cls.ui_url = 'http://' + arg.split('=')[1]
+            if 'api' in arg:
+                cls.api_url = 'http://' + arg.split('=')[1]
+        if cls.api_url is None:
+            super().setUpClass()
+            cls.api_url = cls.live_server_url
+
+        print('Live server URL:', cls.live_server_url)
+        print('        API URL:', cls.api_url)
+        cls.screenshot_dir = os.path.join(
+            os.path.dirname(os.path.realpath(__file__)),
+            'screenshots'
+        )
+        if os.path.exists(cls.screenshot_dir):
+            shutil.rmtree(cls.screenshot_dir)
+        os.makedirs(cls.screenshot_dir, exist_ok=True)
+        cls.screenshot_index = 1
+
+    @classmethod
+    def tearDownClass(cls):
+        cls.browser.quit()
+        super(FunctionalTest, cls).tearDownClass()
+
+    def form(self, f):
+        """Find a form of a given class."""
+        return self.browser.find_element_by_xpath(
+            "//form[contains(@class,'{}')]".format(f)
+        )
+
+    def form_field(self, f, field):
+        """Find a field in a form of a given class."""
+        return self.form(f).find_element_by_xpath("//" + field)
+
+    def wait_for(self, function_with_assertion, timeout=DEFAULT_WAIT):
+        """Wait for an assertion to become true."""
+        start_time = time.time()
+        while time.time() - start_time < timeout:
+            try:
+                return function_with_assertion()
+            except (AssertionError, WebDriverException):
+                time.sleep(0.1)
+        return function_with_assertion()
+
+    def click_through(self, button, wait, screenshot=None):
+        """Click a button or link and wait for something to appear."""
+        button.click()
+        if screenshot is not None:
+            self.screenshot(screenshot)
+        WebDriverWait(self.browser, 10).until(
+            EC.presence_of_element_located(wait)
+        )
+
+    def wait_for_no_alerts(self):
+        """Wait for all alerts to be cleared by a page reload."""
+        WebDriverWait(self.browser, 10).until_not(
+            EC.presence_of_element_located((By.CLASS_NAME, 'alert'))
+        )
+
+    def assert_has_message(self, msg_type, msg):
+        """Check for the presence of a message of a particular type containing
+        given text.
+
+        """
+        msgs = self.browser.find_element_by_xpath("//div[@id='messages']")
+        try:
+            msgs.find_element_by_xpath(
+                ("div[contains(@class,'{}')]//p[contains(.,'{}')]").
+                format(msg_type, msg)
+            )
+        except NoSuchElementException as e:
+            # Debugging help.
+            print("Messages: " + msgs.text)
+            raise e
+
+    def assert_field_has_error(self, field):
+        """Check whether a form field has an error marker: this will be a
+        ``has_error`` class on the field's immediate parent.
+
+        """
+        cls = field.find_element_by_xpath('..').get_attribute('class')
+        assert re.search(r'\bhas-error\b', cls)
+
+    def assert_field_has_no_error(self, field):
+        """Check that a form field has no error marker: this will be a
+        ``has_error`` class on the field's immediate parent.
+
+        """
+        cls = field.find_element_by_xpath('..').get_attribute('class')
+        assert not re.search(r'\bhas-error\b', cls)
+
+    def screenshot(self, title=None):
+        if title is not None:
+            f, _ = unique_file(self.screenshot_dir, title, 1)
+        else:
+            f, self.screenshot_index = unique_file(self.screenshot_dir,
+                                                   'screenshot',
+                                                   self.screenshot_index)
+        self.browser.save_screenshot(f)
+
+
+def unique_file(dir, base, startidx):
+    f = os.path.join(dir, base + '.png')
+    idx = startidx
+    if os.path.exists(f):
+        f = os.path.join(dir, base + '-{:04d}.png'.format(idx))
+        while os.path.exists(f):
+            idx = idx + 1
+            f = os.path.join(dir, base + '-{:04d}.png'.format(idx))
+    return f, idx
diff --git a/functional_tests/pages/Login.py b/functional_tests/pages/Login.py
new file mode 100644
index 000000000..b171c7645
--- /dev/null
+++ b/functional_tests/pages/Login.py
@@ -0,0 +1,38 @@
+from .base import Page
+
+
+class LoginPage(Page):
+    def __init__(self, test):
+        super(LoginPage, self).__init__(test)
+        self.url = self.test.ui_url + '/account/login/'
+
+    def go_to(self):
+        self.browser.get(self.url)
+        self.test.wait_for(self.get_form)
+        return self
+
+    def get_form(self):
+        return self.test.form('login-form')
+
+    def get_form_field(self, xpath):
+        return self.test.form_field('login-form', xpath)
+
+    def get_username_input(self):
+        return self.get_form_field("input[@name='username']")
+
+    def get_password_input(self):
+        return self.get_form_field("input[@name='password']")
+
+    def get_sign_in_button(self):
+        return self.get_form_field("button[@name='sign-in']")
+
+    def setup(self, username, password):
+        """Go to login page and set up user and password fields."""
+        self.go_to()
+        self.get_username_input().send_keys(username)
+        self.get_password_input().send_keys(password)
+        return self.get_sign_in_button()
+
+    def login(self, username, password):
+        self.test.click_through(self.setup(username, password),
+                                self.test.BY_ALERT)
diff --git a/functional_tests/pages/Profile.py b/functional_tests/pages/Profile.py
new file mode 100644
index 000000000..9776ce2bc
--- /dev/null
+++ b/functional_tests/pages/Profile.py
@@ -0,0 +1,42 @@
+from .base import Page
+
+
+class ProfilePage(Page):
+    def __init__(self, test):
+        super(ProfilePage, self).__init__(test)
+        self.url = self.test.ui_url + '/account/profile/'
+
+    def go_to(self):
+        self.browser.get(self.url)
+        self.test.wait_for(self.get_form)
+        return self
+
+    def get_form(self):
+        return self.test.form('profile-form')
+
+    def get_form_field(self, xpath):
+        return self.test.form_field('profile-form', xpath)
+
+    def get_username_input(self):
+        return self.get_form_field("input[@name='username']")
+
+    def get_email_input(self):
+        return self.get_form_field("input[@name='email']")
+
+    def get_first_name_input(self):
+        return self.get_form_field("input[@name='first_name']")
+
+    def get_last_name_input(self):
+        return self.get_form_field("input[@name='last_name']")
+
+    def get_update_button(self):
+        return self.get_form_field("button[@name='update']")
+
+    def get_fields(self):
+        return {
+            'username':   self.get_username_input(),
+            'email':      self.get_email_input(),
+            'first_name': self.get_first_name_input(),
+            'last_name':  self.get_last_name_input(),
+            'update':     self.get_update_button()
+        }
diff --git a/functional_tests/pages/Registration.py b/functional_tests/pages/Registration.py
new file mode 100644
index 000000000..9e0bc9ca6
--- /dev/null
+++ b/functional_tests/pages/Registration.py
@@ -0,0 +1,80 @@
+from .base import Page
+
+
+class RegistrationPage(Page):
+    def __init__(self, test):
+        super(RegistrationPage, self).__init__(test)
+        self.url = self.test.ui_url + '/account/register/'
+
+    def go_to(self):
+        self.browser.get(self.url)
+        self.test.wait_for(self.get_form)
+        return self
+
+    def get_form(self):
+        return self.test.form('account-register')
+
+    def get_form_field(self, xpath):
+        return self.test.form_field('account-register', xpath)
+
+    def get_username_input(self):
+        return self.get_form_field("input[@name='username']")
+
+    def get_email_input(self):
+        return self.get_form_field("input[@name='email']")
+
+    def get_password_input(self):
+        return self.get_form_field("input[@name='password']")
+
+    def get_password_repeat_input(self):
+        return self.get_form_field("input[@name='password_repeat']")
+
+    def get_first_name_input(self):
+        return self.get_form_field("input[@name='first_name']")
+
+    def get_last_name_input(self):
+        return self.get_form_field("input[@name='last_name']")
+
+    def get_register_button(self):
+        return self.get_form_field("button[@name='register']")
+
+    def get_fields(self):
+        return {
+            'username':        self.get_username_input(),
+            'email':           self.get_email_input(),
+            'password':        self.get_password_input(),
+            'password_repeat': self.get_password_repeat_input(),
+            'first_name':      self.get_first_name_input(),
+            'last_name':       self.get_last_name_input(),
+            'register':        self.get_register_button()
+        }
+
+    def setup(self, values):
+        """Go to registration page and set up selected fields."""
+        self.go_to()
+        fields = self.get_fields()
+        for k, v in values:
+            fields[k].send_keys(v)
+        return fields['register']
+
+    def register(self, values):
+        self.test.click_through(self.setup(values),
+                                self.test.BY_ALERT)
+
+    def try_submit(self, err=None, ok=None):
+        fields = self.get_fields()
+        fields['register'].click()
+        if err is not None:
+            for f in err:
+                try:
+                    self.test.assert_field_has_error(fields[f])
+                except:
+                    raise AssertionError('Field "' + f +
+                                         '" should have error, but does not')
+        if ok is not None:
+            for f in ok:
+                try:
+                    self.test.assert_field_has_no_error(fields[f])
+                except:
+                    raise AssertionError('Field "' + f +
+                                         '" should not have error, but does')
diff --git a/functional_tests/pages/base.py b/functional_tests/pages/base.py
new file mode 100644
index 000000000..9df68929b
--- /dev/null
+++ b/functional_tests/pages/base.py
@@ -0,0 +1,4 @@
+class Page:
+    def __init__(self, test):
+        self.test = test
+        self.browser = test.browser
diff --git a/functional_tests/run.py b/functional_tests/run.py
new file mode 100755
index 000000000..4d31c4d49
--- /dev/null
+++ b/functional_tests/run.py
@@ -0,0 +1,12 @@
+#!/usr/bin/env python
+
+import os.path
+import sys
+import pytest
+
+if __name__ == '__main__':
+    d = os.path.dirname(os.path.realpath(__file__))
+    sys.path.append(d)
+    sys.path.append(os.path.join(os.path.dirname(d), 'cadasta'))
+    os.environ['DJANGO_SETTINGS_MODULE'] = 'config.settings.dev'
+    pytest.main()
diff --git a/provision/roles/cadasta/application/tasks/main.yml b/provision/roles/cadasta/application/tasks/main.yml
index aef966cf8..c51cc6602 100644
--- a/provision/roles/cadasta/application/tasks/main.yml
+++ b/provision/roles/cadasta/application/tasks/main.yml
@@ -7,11 +7,17 @@
       - python-virtualenv
       - git
 
+- name: Create base directory for virtual environment
+  become: yes
+  become_user: root
+  file: path="{{ virtualenv_path | dirname }}" state=directory
+        owner="{{ app_user }}" mode=0755
+
 - name: Manually create the initial virtualenv
   become: yes
   become_user: "{{ app_user }}"
   command: virtualenv {{ virtualenv_path }} --python=python3
-           creates="{{ virtualenv_path }}"
+           creates="{{ virtualenv_path }}bin"
 
 - name: Install requirements
   become: yes
@@ -37,3 +43,16 @@
   become_user: "{{ app_user }}"
   template: src=settings.j2
             dest="{{ application_path }}/app/src/js/settings.js"
+
+- name: Install NodeJS dependencies
+  become: yes
+  become_user: "{{ app_user }}"
+  ignore_errors: yes
+  command: npm install
+           chdir="{{ application_path }}app"
+
+- name: Fix node-sass problem
+  become: yes
+  become_user: "{{ app_user }}"
+  command: npm rebuild node-sass
+           chdir="{{ application_path }}app"
diff --git a/provision/roles/cadasta/production/tasks/main.yml b/provision/roles/cadasta/production/tasks/main.yml
index 903de09bd..dcc6da6b2 100644
--- a/provision/roles/cadasta/production/tasks/main.yml
+++ b/provision/roles/cadasta/production/tasks/main.yml
@@ -1,16 +1,3 @@
-- name: Install NodeJS dependencies
-  become: yes
-  become_user: "{{ app_user }}"
-  ignore_errors: yes
-  command: npm install
-           chdir="{{ application_path }}app"
-
-- name: Fix node-sass problem
-  become: yes
-  become_user: "{{ app_user }}"
-  command: npm rebuild node-sass
-           chdir="{{ application_path }}app"
-
 - name: Install npm-run
   become: yes
   become_user: root
diff --git a/provision/roles/testing/tasks/main.yml b/provision/roles/testing/tasks/main.yml
new file mode 100644
index 000000000..d02f95c69
--- /dev/null
+++ b/provision/roles/testing/tasks/main.yml
@@ -0,0 +1,18 @@
+- name: Install PhantomJS
+  become: yes
+  become_user: root
+  apt: pkg={{ item }} state=installed update_cache=yes
+  with_items:
+      - phantomjs
+
+- name: Install Python Selenium driver
+  become: yes
+  become_user: "{{ app_user }}"
+  pip: virtualenv="{{ virtualenv_path }}"
+       name=selenium
+
+- name: Fix Django live test server address
+  become: yes
+  become_user: "{{ app_user }}"
+  lineinfile: dest=/home/vagrant/.bashrc
+              line="export DJANGO_LIVE_TEST_SERVER_ADDRESS=0.0.0.0:8000"
diff --git a/provision/roles/webserver/development/templates/nginx-development b/provision/roles/webserver/development/templates/nginx-development
index b15e0c348..be14fd466 100644
--- a/provision/roles/webserver/development/templates/nginx-development
+++ b/provision/roles/webserver/development/templates/nginx-development
@@ -1,5 +1,5 @@
 server {
-    listen      8080;
+    listen      5000;
     charset     utf-8;
 
     client_max_body_size 75M;
@@ -15,3 +15,11 @@ server {
         add_header 'Access-Control-Allow-Headers' 'Authorization,Access-Control-Allow-Origin,Content-Type';
     }
 }
+
+server {
+    listen 3000;
+
+    location / {
+        root /vagrant/app/dist;
+    }
+}
diff --git a/provision/vagrant.yml b/provision/vagrant.yml
index c23d4a7c7..c80fc7437 100644
--- a/provision/vagrant.yml
+++ b/provision/vagrant.yml
@@ -1,9 +1,9 @@
 - hosts: all
   vars:
     application_path: /vagrant/
-    virtualenv_path: /vagrant/env/
+    virtualenv_path: /opt/cadasta/env/
     django_settings: config.settings.dev
-    api_url: localhost:5000
+    api_url: 0.0.0.0:5000
     api_version: v1
     app_user: vagrant
     uwsgi_socket: /tmp/uwsgi.sock
@@ -18,3 +18,4 @@
     - cadasta/development
     - webserver/common
     - webserver/development
+    - testing
diff --git a/requirements/dev.txt b/requirements/dev.txt
index 041b5de75..15f7b2bb2 100644
--- a/requirements/dev.txt
+++ b/requirements/dev.txt
@@ -1,3 +1,4 @@
 pytest-django
 pytest-cov
 factory_boy
+selenium

From 161dd5d1dd03de4578c1455c2dbc56105035c64e Mon Sep 17 00:00:00 2001
From: Oliver Roick <oliver.roick@gmail.com>
Date: Wed, 2 Mar 2016 11:25:38 +0100
Subject: [PATCH 2/2] Replace User instantiation with model factories

---
 cadasta/accounts/tests/factories.py            |  3 ++-
 functional_tests/accounts/test_login.py        | 13 ++-----------
 functional_tests/accounts/test_profile.py      |  7 ++-----
 functional_tests/accounts/test_registration.py |  7 ++-----
 4 files changed, 8 insertions(+), 22 deletions(-)

diff --git a/cadasta/accounts/tests/factories.py b/cadasta/accounts/tests/factories.py
index c642b6522..8bcece306 100644
--- a/cadasta/accounts/tests/factories.py
+++ b/cadasta/accounts/tests/factories.py
@@ -2,6 +2,7 @@
 
 from ..models import User
 
+
 class UserFactory(factory.django.DjangoModelFactory):
     class Meta:
         model = User
@@ -18,4 +19,4 @@ def _prepare(cls, create, **kwargs):
             user.set_password(password)
             if create:
                 user.save()
-        return user
\ No newline at end of file
+        return user
diff --git a/functional_tests/accounts/test_login.py b/functional_tests/accounts/test_login.py
index 298cba433..b26dc014e 100644
--- a/functional_tests/accounts/test_login.py
+++ b/functional_tests/accounts/test_login.py
@@ -1,18 +1,11 @@
 from base import FunctionalTest
 from pages.Login import LoginPage
-from accounts.models import User
+from accounts.tests.factories import UserFactory
 
 
 class LoginTest(FunctionalTest):
     def setUp(self):
-        user1 = User(username='user1', email='user1@example.org',
-                     first_name='User', last_name='One')
-        user1.set_password('user1pwd')
-        user1.save()
-        user2 = User(username='user2', email='user2@example.com',
-                     first_name='User', last_name='Two')
-        user2.set_password('user2pwd')
-        user2.save()
+        UserFactory.create(username='user1', password='user1pwd')
 
     def test_unregistered_user(self):
         """An unregistered user cannot log in."""
@@ -24,7 +17,6 @@ def test_unregistered_user(self):
 
     def test_wrong_password(self):
         """An user cannot log in with an invalid password."""
-
         sign_in = LoginPage(self).setup('user1', 'not_right')
         self.click_through(sign_in, self.BY_ALERT)
 
@@ -36,7 +28,6 @@ def test_valid_login(self):
         persistent across page refreshes.
 
         """
-
         sign_in = LoginPage(self).setup('user1', 'user1pwd')
         self.click_through(sign_in, self.BY_ALERT)
         self.browser.find_element_by_xpath("//h1[.='Dashboard']")
diff --git a/functional_tests/accounts/test_profile.py b/functional_tests/accounts/test_profile.py
index 21e55fa2f..710f96a5e 100644
--- a/functional_tests/accounts/test_profile.py
+++ b/functional_tests/accounts/test_profile.py
@@ -1,15 +1,12 @@
 from base import FunctionalTest
 from pages.Profile import ProfilePage
 from pages.Login import LoginPage
-from accounts.models import User
+from accounts.tests.factories import UserFactory
 
 
 class ProfileTest(FunctionalTest):
     def setUp(self):
-        user1 = User(username='user1', email='user1@example.org',
-                     first_name='User', last_name='One')
-        user1.set_password('user1pwd')
-        user1.save()
+        UserFactory.create(username='user1', password='user1pwd')
 
     def test_profile_view_and_edit(self):
         """A registered user can view and edit their profile."""
diff --git a/functional_tests/accounts/test_registration.py b/functional_tests/accounts/test_registration.py
index 34ca50884..9e9f05221 100644
--- a/functional_tests/accounts/test_registration.py
+++ b/functional_tests/accounts/test_registration.py
@@ -1,15 +1,12 @@
 from base import FunctionalTest
 from pages.Registration import RegistrationPage
 from pages.Login import LoginPage
-from accounts.models import User
+from accounts.tests.factories import UserFactory
 
 
 class RegistrationTest(FunctionalTest):
     def setUp(self):
-        user1 = User(username='user1', email='user1@example.org',
-                     first_name='User', last_name='One')
-        user1.set_password('user1pwd')
-        user1.save()
+        UserFactory.create(username='user1', password='user1pwd')
 
     def test_register_user(self):
         """An unregistered user can register with valid user details."""