Merge branch 'master' into GPII-1318

* master:
  GPII-1557: Fixes typo
  GPII-1557: Specifies minimum Vagrant version requirement
  GPII-1557: Updates path and builds framework as part of provisioning process
  GPII-1557: Adds files required for creating test VMs

Author: colinbdclark

README.md

@@ -37,4 +37,16 @@ will be withdrawn soon. You can operate these as follows:
 * `build.cmd` will check out GPII's universal project https://github.com/GPII/universal in a subdirectory. 
 * `start.cmd` will run the GPII personalisation system
 
+# Test VM
 
+It is possible to provision a Windows VM for testing purposes. Please ensure you have met [these VM requirements](https://github.com/GPII/qi-development-environments/#requirements) before proceeding. After that you can use the ``vagrant up`` command to create an instance of a [Windows 10 Evaluation VM](https://github.com/idi-ops/packer-windows) which will boot an instance of the Windows 10 VM, pull in the GPII Framework's npm dependencies, and then build it. 
+
+If this is your first time creating this VM a 6.5GB download will take place. The downloaded image will be valid for 90 days after which the Windows installation will no longer be useable. To remove an expired image you can use the ``vagrant box remove "inclusivedesign/windows10-eval"`` command.
+
+Once the VM has finished booting up you can open a command prompt window and use the following commands to test the framework:
+
+```
+cd c:\vagrant
+node tests\UnitTests.js
+node tests\AcceptanceTests.js builtIn
+```

Vagrantfile

@@ -0,0 +1,41 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+Vagrant.require_version ">= 1.8.0"
+
+# By default this VM will use 2 processor cores and 2GB of RAM. The 'VM_CPUS' and
+# "VM_RAM" environment variables can be used to change that behaviour.
+cpus = ENV["VM_CPUS"] || 2
+ram = ENV["VM_RAM"] || 2048
+
+Vagrant.configure(2) do |config|
+
+  config.vm.box = "inclusivedesign/windows10-eval"
+  config.vm.guest = :windows
+
+  config.vm.communicator = "winrm"
+  config.winrm.username = "vagrant"
+  config.winrm.password = "vagrant"
+  config.vm.network :forwarded_port, guest: 3389, host: 3389, id: "rdp", auto_correct:true
+  config.vm.network :forwarded_port, guest: 5985, host: 5985, id: "rdp", auto_correct:true
+
+  config.vm.provider :virtualbox do |vm|
+    vm.gui = true
+    vm.customize ["modifyvm", :id, "--memory", ram]
+    vm.customize ["modifyvm", :id, "--cpus", cpus]
+    vm.customize ["modifyvm", :id, "--vram", "128"]
+    vm.customize ["modifyvm", :id, "--accelerate3d", "on"]
+    vm.customize ["modifyvm", :id, "--audio", "null", "--audiocontroller", "hda"]
+    vm.customize ["modifyvm", :id, "--ioapic", "on"]
+    vm.customize ["setextradata", "global", "GUI/SuppressMessages", "all"]
+  end
+
+  config.vm.provision "shell", inline: <<-SHELL
+    choco upgrade firefox googlechrome -y
+  SHELL
+  
+  config.vm.provision "shell", path: "provisioning/chocolatey-packages.bat"
+  config.vm.provision "shell", path: "provisioning/npm-packages.bat"
+  config.vm.provision "shell", path: "provisioning/build.bat"
+
+end

provisioning/build.bat

@@ -0,0 +1,3 @@
+cd c:\vagrant
+npm install --ignore-scripts=true
+grunt build

provisioning/chocolatey-packages.bat

@@ -0,0 +1,3 @@
+choco install nodejs -version 0.10.36 --forcex86 -y
+choco install nodejs.install -version 0.10.36 --forcex86 -y
+setx /M PATH "%PATH%;c:\programdata\chocolatey\lib\nodejs.commandline\tools;c:\users\vagrant\appdata\roaming\npm"

provisioning/npm-packages.bat

@@ -0,0 +1,2 @@
+call npm install grunt-cli -g
+call npm install testem -g