selenium-webdriver 0.0.9 → 0.0.10

data/common/src/js/jsunit/licenses/mpl-tri-license-c.txt

@@ -0,0 +1,35 @@
+/* ***** BEGIN LICENSE BLOCK *****
+ * Version: MPL 1.1/GPL 2.0/LGPL 2.1
+ *
+ * The contents of this file are subject to the Mozilla Public License Version
+ * 1.1 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ * http://www.mozilla.org/MPL/
+ *
+ * Software distributed under the License is distributed on an "AS IS" basis,
+ * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+ * for the specific language governing rights and limitations under the
+ * License.
+ *
+ * The Original Code is __________________________________________.
+ *
+ * The Initial Developer of the Original Code is
+ * ____________________________________________.
+ * Portions created by the Initial Developer are Copyright (C) 2___
+ * the Initial Developer. All Rights Reserved.
+ *
+ * Contributor(s):
+ *
+ * Alternatively, the contents of this file may be used under the terms of
+ * either the GNU General Public License Version 2 or later (the "GPL"), or
+ * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
+ * in which case the provisions of the GPL or the LGPL are applicable instead
+ * of those above. If you wish to allow use of your version of this file only
+ * under the terms of either the GPL or the LGPL, and not to allow others to
+ * use your version of this file under the terms of the MPL, indicate your
+ * decision by deleting the provisions above and replace them with the notice
+ * and other provisions required by the GPL or the LGPL. If you do not delete
+ * the provisions above, a recipient may use your version of this file under
+ * the terms of any one of the MPL, the GPL or the LGPL.
+ *
+ * ***** END LICENSE BLOCK ***** */

data/common/src/js/jsunit/licenses/mpl-tri-license-html.txt

@@ -0,0 +1,35 @@
+<!-- ***** BEGIN LICENSE BLOCK *****
+   - Version: MPL 1.1/GPL 2.0/LGPL 2.1
+   -
+   - The contents of this file are subject to the Mozilla Public License Version
+   - 1.1 (the "License"); you may not use this file except in compliance with
+   - the License. You may obtain a copy of the License at
+   - http://www.mozilla.org/MPL/
+   -
+   - Software distributed under the License is distributed on an "AS IS" basis,
+   - WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+   - for the specific language governing rights and limitations under the
+   - License.
+   -
+   - The Original Code is __________________________________________.
+   -
+   - The Initial Developer of the Original Code is
+   - ____________________________________________.
+   - Portions created by the Initial Developer are Copyright (C) 2___
+   - the Initial Developer. All Rights Reserved.
+   -
+   - Contributor(s):
+   -
+   - Alternatively, the contents of this file may be used under the terms of
+   - either the GNU General Public License Version 2 or later (the "GPL"), or
+   - the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
+   - in which case the provisions of the GPL or the LGPL are applicable instead
+   - of those above. If you wish to allow use of your version of this file only
+   - under the terms of either the GPL or the LGPL, and not to allow others to
+   - use your version of this file under the terms of the MPL, indicate your
+   - decision by deleting the provisions above and replace them with the notice
+   - and other provisions required by the LGPL or the GPL. If you do not delete
+   - the provisions above, a recipient may use your version of this file under
+   - the terms of any one of the MPL, the GPL or the LGPL.
+   -
+   - ***** END LICENSE BLOCK ***** -->

data/common/src/js/jsunit/readme.txt

@@ -0,0 +1,19 @@
+JsUnit
+Copyright (C) 2001-6 Edward Hieatt, edward@jsunit.net
+
+This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License
+as published by the Free Software Foundation; either version 2
+of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+
+Please see http://www.jsunit.net/ for JsUnit documentation and
+the "licenses" directory for license information.

data/common/src/js/jsunit/testRunner.html

@@ -0,0 +1,167 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>JsUnit Test Runner</title>
+<script language="JavaScript" type="text/javascript" src="app/xbDebug.js"></script>
+<script language="JavaScript" type="text/javascript" src="app/jsUnitCore.js"></script>
+<script language="JavaScript" type="text/javascript">
+    var DEFAULT_TEST_FRAME_HEIGHT = 250;
+
+    function jsUnitParseParms(string) {
+        var i;
+        var searchString = unescape(string);
+        var parameterHash = new Object();
+
+        if (!searchString) {
+            return parameterHash;
+        }
+
+        i = searchString.indexOf('?');
+        if (i != -1) {
+            searchString = searchString.substring(i + 1);
+        }
+
+        var parmList = searchString.split('&');
+        var a;
+        for (i = 0; i < parmList.length; i++) {
+            a = parmList[i].split('=');
+            a[0] = a[0].toLowerCase();
+            if (a.length > 1) {
+                parameterHash[a[0]] = a[1];
+            }
+            else {
+                parameterHash[a[0]] = true;
+            }
+        }
+        return parameterHash;
+    }
+
+    function jsUnitConstructTestParms() {
+        var p;
+        var parms = '';
+
+        for (p in jsUnitParmHash) {
+            var value = jsUnitParmHash[p];
+
+            if (!value ||
+                p == 'testpage' ||
+                p == 'autorun' ||
+                p == 'submitresults' ||
+                p == 'showtestframe' ||
+                p == 'resultid') {
+                continue;
+            }
+
+            if (parms) {
+                parms += '&';
+            }
+
+            parms += p;
+
+            if (typeof(value) != 'boolean') {
+                parms += '=' + value;
+            }
+        }
+        return escape(parms);
+    }
+
+    var jsUnitParmHash = jsUnitParseParms(document.location.search);
+
+    // set to true to turn debugging code on, false to turn it off.
+    xbDEBUG.on = jsUnitGetParm('debug') ? true : false;
+</script>
+
+<script language="JavaScript" type="text/javascript" src="app/jsUnitTestManager.js"></script>
+<script language="JavaScript" type="text/javascript" src="app/jsUnitTracer.js"></script>
+<script language="JavaScript" type="text/javascript" src="app/jsUnitTestSuite.js"></script>
+<script language="JavaScript" type="text/javascript">
+
+    var testManager;
+    var utility;
+    var tracer;
+
+
+    if (!Array.prototype.push) {
+        Array.prototype.push = function (anObject) {
+            this[this.length] = anObject;
+        }
+    }
+
+    if (!Array.prototype.pop) {
+        Array.prototype.pop = function () {
+            if (this.length > 0) {
+                delete this[this.length - 1];
+                this.length--;
+            }
+        }
+    }
+
+    function shouldKickOffTestsAutomatically() {
+        return jsUnitGetParm('autorun') == "true";
+    }
+
+    function shouldShowTestFrame() {
+        return jsUnitGetParm('showtestframe');
+    }
+
+    function shouldSubmitResults() {
+        return jsUnitGetParm('submitresults');
+    }
+
+    function getResultId() {
+        if (jsUnitGetParm('resultid'))
+            return jsUnitGetParm('resultid');
+        return "";
+    }
+
+    function submitResults() {
+        window.mainFrame.mainData.document.testRunnerForm.runButton.disabled = true;
+        window.mainFrame.mainResults.populateHeaderFields(getResultId(), navigator.userAgent, JSUNIT_VERSION, testManager.resolveUserEnteredTestFileName());
+        window.mainFrame.mainResults.submitResults();
+    }
+
+    function wasResultUrlSpecified() {
+        return shouldSubmitResults() && jsUnitGetParm('submitresults') != 'true';
+    }
+
+    function getSpecifiedResultUrl() {
+        return jsUnitGetParm('submitresults');
+    }
+
+    function init() {
+        var testRunnerFrameset = document.getElementById('testRunnerFrameset');
+        if (shouldShowTestFrame() && testRunnerFrameset) {
+            var testFrameHeight;
+            if (jsUnitGetParm('showtestframe') == 'true')
+                testFrameHeight = DEFAULT_TEST_FRAME_HEIGHT;
+            else
+                testFrameHeight = jsUnitGetParm('showtestframe');
+            testRunnerFrameset.rows = '*,0,' + testFrameHeight;
+        }
+        testManager = new jsUnitTestManager();
+        tracer = new JsUnitTracer(testManager);
+        if (shouldKickOffTestsAutomatically()) {
+            window.mainFrame.mainData.kickOffTests();
+        }
+    }
+
+
+</script>
+</head>
+
+<frameset id="testRunnerFrameset" rows="*,0,0" border="0" onload="init()">
+
+    <frame frameborder="0" name="mainFrame" src="./app/main-frame.html">
+    <frame frameborder="0" name="documentLoader" src="./app/main-loader.html">
+    <frame frameborder="0" name="testContainer" src="./app/testContainer.html">
+
+    <noframes>
+        <body>
+        <p>Sorry, JsUnit requires support for frames.</p>
+        </body>
+    </noframes>
+</frameset>
+
+</html>

data/common/src/js/jsunit/version.txt

@@ -0,0 +1 @@
+JsUnit 22.2 alpha 11

data/common/src/rb/README

@@ -0,0 +1,29 @@
+= selenium-webdriver
+
+This gem provides Ruby bindings for WebDriver and has been tested to work on MRI (1.8.6 through 1.9), JRuby and Rubinius.
+
+= INSTALL
+
+gem install selenium-webdriver
+
+= LINKS
+
+* http://gemcutter.org/gems/selenium-webdriver
+* http://code.google.com/p/selenium/wiki/RubyBindings
+* http://code.google.com/p/selenium/issues/list
+
+= LICENSE
+
+Copyright 2009 WebDriver committers
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/common/src/rb/lib/selenium/webdriver/driver.rb

@@ -1,11 +1,33 @@
 module Selenium
   module WebDriver
+
+    #
+    # The main class through which you control the browser.
+    #
+    # @see Find
+    # @see Navigation
+    # @see TargetLocator
+    # @see Options
+    #
+
     class Driver
       include Find
 
       attr_reader :bridge
 
       class << self
+
+        #
+        # Create a new Driver instance with the correct bridge for the given browser
+        #
+        # @param browser [Symbol]
+        #   the driver type to use
+        # @param *rest
+        #   arguments passed to the Bridge.new
+        #
+        # @return [Driver]
+        #
+
         def for(browser, *args)
           bridge = case browser
                    when :ie, :internet_explorer
@@ -30,6 +52,12 @@ module Selenium
         end
       end
 
+      #
+      # A new Driver instance
+      #
+      # @api private
+      #
+
       def initialize(bridge)
         @bridge = bridge
       end
@@ -38,54 +66,140 @@ module Selenium
         '#<%s:0x%x browser=%s>' % [self.class, hash*2, bridge.browser.inspect]
       end
 
+      #
+      # @return [Navigation]
+      # @see Navigation
+      #
+
       def navigate
         @navigate ||= WebDriver::Navigation.new(self)
       end
 
+      #
+      # @return [TargetLocator]
+      # @see TargetLocator
+      #
+
       def switch_to
         @switch_to ||= WebDriver::TargetLocator.new(self)
       end
 
+      #
+      # @return [Options]
+      # @see Options
+      #
+
       def manage
         @manage ||= WebDriver::Options.new(self)
       end
 
+      #
+      # Opens the specified URL in the browser.
+      #
+
+      def get(url)
+        navigate.to(url)
+      end
+
+      #
+      # Get the URL of the current page
+      #
+      # @return [String]
+      #
+
       def current_url
         bridge.getCurrentUrl
       end
 
+      #
+      # Get the title of the current page
+      #
+      # @return [String]
+      #
+
       def title
         bridge.getTitle
       end
 
+      #
+      # Get the source of the current page
+      #
+      # @return [String]
+      #
+
       def page_source
         bridge.getPageSource
       end
 
+      #
+      # Get the visibility of the browser. Not applicable for all browsers.
+      #
+      # @return [Boolean]
+      #
+
       def visible?
         bridge.getBrowserVisible
       end
 
+      #
+      # Set the visibility of the browser. Not applicable for all browsers.
+      #
+      # @param [Boolean]
+      #
+
       def visible=(bool)
         bridge.setBrowserVisible bool
       end
 
+      #
+      # Quit the browser
+      #
+
       def quit
         bridge.quit
       end
 
+      #
+      # Close the current window, or the browser if no windows are left.
+      #
+
       def close
         bridge.close
       end
 
+      #
+      # Get the window handles of open browser windows.
+      #
+      # @return [Array]
+      # @see TargetLocator#window
+      #
+
       def window_handles
         bridge.getWindowHandles
       end
 
+      #
+      # Get the current window handle
+      #
+      # @return [String]
+      #
+
       def window_handle
         bridge.getCurrentWindowHandle
       end
 
+      #
+      # Execute the given JavaScript
+      #
+      # @param [String] script
+      #   JavaScript source to execute
+      # @param [WebDriver::Element,Integer, Float, Boolean, NilClass, String, Array] *args
+      #   Arguments will be available in the given script as the 'arguments' array.
+      #
+      # @return [WebDriver::Element,Integer,Float,Boolean,NilClass,String,Array]
+      #   The value returned from the script.
+      #
+
       def execute_script(script, *args)
         bridge.executeScript(script, *args)
       end
@@ -93,33 +207,29 @@ module Selenium
       #-------------------------------- sugar  --------------------------------
 
       #
-      # driver.first(:id, 'foo')
+      #   driver.first(:id, 'foo')
       #
 
       alias_method :first, :find_element
 
       #
-      # driver.all(:class, 'bar') #=> [#<WebDriver::Element:0x1011c3b88, ...]
+      #   driver.all(:class, 'bar') #=> [#<WebDriver::Element:0x1011c3b88, ...]
       #
 
       alias_method :all, :find_elements
 
       #
-      # opens the specified URL in the browser.
-      #
-
-      def get(url)
-        navigate.to(url)
-      end
-
-      #
-      # driver.script('function() { ... };')
+      #   driver.script('function() { ... };')
       #
 
       alias_method :script, :execute_script
 
+      # Get the first element matching the given id.
       #
-      # driver['someElementId'] #=> #<WebDriver::Element:0x1011c3b88>
+      # @param [String] id
+      # @return [WebDriver::Element]
+      #
+      #   driver['someElementId'] #=> #<WebDriver::Element:0x1011c3b88>
       #
 
       def [](id)
@@ -130,6 +240,8 @@ module Selenium
       #
       # for Find
       #
+      # @api private
+      #
 
       def ref
         nil