Adding webdriver setup script.

tools/testing/browser_README.txt

Index: tools/testing/browser_README.txt
===================================================================
--- tools/testing/browser_README.txt	(revision 4633)
+++ tools/testing/browser_README.txt	(working copy)
@@ -1,103 +1,69 @@
-Setup to run all performance tests:
-
-TODO(efortuna): run through these steps again on a clean machine to make sure I
-didn't leave anything out!
-
 Overview:
- These are the instructions to run a wide variety of performance tests using 
- dart/tools/testing/perf_testing/create_graph.py. Currently the results are 
- uploaded to https://dartperf.googleplex.com/. 
+ These are the instructions to run a wide variety of browser tests using 
+ test.dart --component=webdriver or 
+ dart/tools/testing/perf_testing/create_graph.py. Currently the results of
+ create_graph are uploaded to https://dartperf.googleplex.com/. 
  
- A variant of these tests are running on our buildbots to test Chrome and 
- Firefox (since the buildbots are Linux) that simply ensure that no changes to
- frog have broken updating the dom, but not for testing performance.
+============== Windows Setup ==============
 
- This file details how to set up configurations for each setup. It is long,
- because there are many variants depending on what platform you're on, and what
- you want to set up.
+Open Internet Explorer. Open the Internet Options dialog, and move to the
+"Security" tab. Click through Internet, Local Intranet, Trusted sites, and
+Restricted site and ensure the "Enable Protected Mode" is checked for all zones
+or unchecked for all zones. Then click to the "Advanced" tab, scroll down to the
+"Security" section, and check the checkbox "Allow active content to run in files
+on My Computer."
 
-============ Windows Installation =============
+================ Mac Setup ================
 
-Setting up Windows on Mac hardware:
-  If you need to install Windows 7 via dual-boot mac, use BootCamp to install 
-  Windows 7 Professional. You can obtain a copy of Windows 7 (Google internal) 
-  by getting an MSDN subscription via GUTS. When installing via BootCamp, don't 
-  forget to also install the "WindowsSupport" drivers that are optional -- 
-  you'll need them to be able to connect to any wireless network in Windows.
+1) Ensure Java is installed and in your path (if you want to run Safari). If 
+   not, install the  Java jdk (so that we can run the webdriver server from its 
+  jar)
 
-Great! You have a shiny dual-booting machine!
+2) a) Disable pop-up blocking in Safari: 
+      Preferences -> Security -> (unselect) Block pop-up windows.
+   b) copy the file in /Library/Preferences/com.apple.Safari.plist to 
+      $DARTDIR/tools/testing/com.apple.Safari.plist
+      (We do this because Safari deletes our preferences (on no pop-up 
+      blocking) if it crashes (aka times out) two times in a row.)
 
-Use the following instructions to set up for Windows builds:
-http://www.chromium.org/developers/how-tos/build-instructions-windows
-
-NOTE: DO NOT USE Visual Studio 2010 to try to build the project!! Right now Dart
-only builds with VS2008 versions!
-
-Then:
-1) Download installer for OpenSSL for Windows via 
-   http://openssl.org/related/binaries.html
-2) Install OpenSSL
-3) Copy the directory OpenSSL-Win32/include/openssl to 
-   C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\include
-4) Copy the ***contents*** of the directory OpenSSL-Win32/lib/VC/static/ to 
-   C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\lib
-
 ============= All Platforms ================
 
+THE EASISET WAY:
 1) Ensure Python 2.7 is installed and in your path.
+2) Download and install Chrome in the default location if you haven't done so
+   already.
+3) Run the following script as root/administrator while standing in this
+   directory:
+   $> [sudo] python dart/tools/testing/perf_testing/webdriver_test_setup.py
+4) Profit!
 
-2) Run the following command while standing in this directory:
-     $> sudo buildbot_browser_test_setup.sh
-     
-     If that doesn't work, or you're running Windows, here are the manual steps:
-     a) Install selenium library python bindings
-        (http://pypi.python.org/pypi/selenium)
-     b) Ensure Firefox is installed.
+Example Run:
+$> tools/test.py --component=webdriver --report --timeout=20 --mode=release 
+--browser=[ff | safari | chrome | ie] 
+[--frog=path/to/frog/executable/like/Release_ia32/dart-sdk/frogc
+--froglib=path/to/frog/lib/like/dart/frog/lib] test_to_run(like "language" or
+"corelib")
 
-3) Mac only:
-     Download and install xcode 3.2: 
-     https://developer.apple.com/devcenter/download.action?path=/Developer_Tools/xcode_3.2.6_and_ios_sdk_4.3__final/xcode_3.2.6_and_ios_sdk_4.3.dmg
-       a) Mount dmg
-       b) LION only: At a terminal type:
-       TODO(efortuna): verify
-          $> export COMMAND_LINE_INSTALL=1
-          $> open "/Volumes/Xcode and iOS SDK/Xcode and iOS SDK.mpkg"
-       c) Install.
+(If you don't specify frog and froglib arguments, we default to using frog with
+the VM.)
 
-4) (Mac OS Lion only) Install xcode 4.0 and then run:
-   $> xcode-select -switch /path/to/xcode3.2.6/
 
-5) Ensure Java is installed and in your path. If not, install the  Java jdk 
-   (so that we can run the webdriver server from its jar)
+============================================
+Okay, so you're still here? Here's the long version of what that script does if
+it didn't work for you:
+a) Install selenium library python bindings
+   (http://pypi.python.org/pypi/selenium)
 
-6) Download selenium-server-standalone-2.15.0.jar (only to run Safari) 
-   http://selenium.googlecode.com/files/selenium-server-standalone-2.15.0.jar 
-   and run it:
-   $> java -jar selenium-server-standalone-2.15.0.jar
+b) Ensure that Firefox is installed in the default location.
 
-7) Ensure that Chrome, Safari and IE (Windows only) are installed.
-
-8)Download the Chrome Driver: http://code.google.com/p/chromium/downloads/list
+c) Download the Chrome Driver: http://code.google.com/p/chromium/downloads/list
    and make sure it is in your path.
 
-9) a) Disable pop-up blocking in Safari: 
-       Preferences -> Security -> (unselect) Block pop-up windows.
-    b) copy the file in /Library/Preferences/com.apple.Safari.plist to 
-       $DARTDIR/tools/testing/com.apple.Safari.plist
-       (We do this because Safari deletes our preferences (on no pop-up 
-       blocking) if it crashes (aka times out) two times in a row.)
+d) Download the selenium server (version 2.15 or newer) and place it in this 
+   directory: 
+    http://selenium.googlecode.com/files/selenium-server-standalone-2.15.0.jar
 
-If you just want smoketests, you're done! Run them by typing:
 
-$> tools/testing/bin/$YOUR_OS_DIR/dart tools/test.dart --component=webdriver
---report --timeout=20 --mode=release --browser=[ff | safari | chrome | ie]
-[--frog=path/to/frog/executable/like/Release_ia32/dart-sdk/frogc
---froglib=path/to/frog/lib/like/dart/frog/lib] test_to_run(like "language" or
-"corelib")
-
-(If you don't specify frog and froglib arguments, we default to using the frogsh
-living in your frog directory.)
-
 ========= Proceed further only if you also want to run performance tests.======
 
 10)Download appengine for Python and place it in third_party (http://code.google.com/appengine/downloads.html#Google_App_Engine_SDK_for_Python):