1This directory contains semi-automated tests of Chrome with 2NVDA (NonVisual Desktop Access), a popular open-source screen reader for 3visually impaired users on Windows. It works by launching Chrome in a 4subprocess, then launching NVDA in a special environment that simulates 5speech rather than actually speaking, and ignores all events coming from 6processes other than a specific Chrome process ID. Each test automates 7Chrome with a series of actions and asserts that NVDA gives the expected 8feedback in response. 9 10Instructions for running these tests: 11 121. Install Python 2.7, 32-bit: http://www.python.org/ 13 14 Note - the version of Python installed by Chrome's depot_tools will not 15 work, it's 64-bit. 16 172. Download pywinauto here: 18 https://code.google.com/p/pywinauto/downloads/list 19 20 Unzip it, then install it by running this from a cmd shell in that directory: 21 python setup.py install 22 23 If you get an error, make sure you're using the 32-bit version of Python. 24 253. Install the latest NVDA "next" snapshot from: 26 http://community.nvda-project.org/wiki/Snapshots 27 28 In the installer, choose "Create Portable copy" rather than "Install...". 29 From the Browse dialog, create an new folder called nvdaPortable inside 30 this folder. 31 32 Note: after NVDA 2014.3 stable is released, just use the stable version 33 instead, from http://www.nvaccess.org/download/ 34 - if you do this, you need to run NVDA, then from the NVDA menu, choose 35 Tools > Create Portable Copy. 36 From the Browse dialog, create an new folder called nvdaPortable inside 37 this folder. 38 You should now have something like this: 39 d:\src\nvda_chrome_tests\nvdaPortable\nvda.exe 40 You can now exit NVDA. 41 424. Install Chrome Canary. The binary is typically installed in: 43 c:\Users\USERNAME\AppData\Local\Google\Chrome SxS\Application\chrome.exe 44 ...if not, edit nvda_chrome_tests.py to point to it. 45 465. Clone the nvda-proctest environment into this directory: 47 git clone https://bitbucket.org/nvaccess/nvda-proctest.git 48 496. Run the tests: 50 51 First make sure NVDA is not already running. 52 53 Open a cmd console, change to the nvda_chrome_tests directory, and run: 54 python nvda_chrome_tests.py 55 56 If you get an error, open the Windows task manager and make sure NVDA 57 isn't running, kill it if necessary. 58 59