lebowski 0.2.1 → 0.3.0

data/lib/lebowski/{spec → rspec}/operators/that.rb

@@ -4,7 +4,7 @@
 # ==========================================================================
 
 module Lebowski
-  module Spec
+  module RSpec
     module Operators
 
       class That < Operator
@@ -96,13 +96,19 @@ module Lebowski
           
         def contains?(value)
           return false if value.nil?
-          @args.all? do |x|
-            value.member? x
+          if value.kind_of? String
+            return false if @args.length > 1
+            return value == @args[0]
+          elsif value.kind_of? Array
+            return @args.all? do |x|
+              value.member? x
+            end
           end
+          return false
         end
         
         def matches?(value)
-          return Lebowski::Spec::Util.match?(@args[0], value)
+          return Lebowski::RSpec::Util.match?(@args[0], value)
         end
         
         def equals?(value)

data/lib/lebowski/{spec → rspec}/util.rb

@@ -4,7 +4,7 @@
 # ==========================================================================
 
 module Lebowski
-  module Spec
+  module RSpec
     module Util
       
       #

data/lib/lebowski/rspec.rb

@@ -0,0 +1,17 @@
+# ==========================================================================
+# Project:   Lebowski Framework - The SproutCore Test Automation Framework
+# License:   Licensed under MIT license (see License.txt)
+# ==========================================================================
+
+require File.expand_path(File.dirname(__FILE__) + '/../lebowski')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/core')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/util')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/operators/operator')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/operators/that')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/matchers/match_supporters/match_supporter')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/matchers/match_supporters/has_object_function')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/matchers/match_supporters/has_predicate_with_no_prefix')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/matchers/match_supporters/has_predicate_with_prefix_has')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/matchers/be')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/matchers/has')
+require File.expand_path(File.dirname(__FILE__) + '/rspec/matchers/method_missing')

data/lib/lebowski/runtime/sprout_core_extensions.rb

@@ -171,45 +171,45 @@ module Lebowski
       alias_method :sc_mouse_enter, :sc_mouse_move
       alias_method :sc_mouse_exit, :sc_mouse_move
       
-      def sc_mouse_move_at(type, x, y, *params)
-        coords = "#{x},#{y}"
-        __remote_control_command("mouseMoveAt", [__locator(type, *params), coords])
-      end
-      
       def sc_mouse_down(type, *params)
-        __remote_control_command("scMouseDown", [__locator(type, *params),])
+        __remote_control_command("scMouseDown", [__locator(type, *params)])
       end
       
       def sc_mouse_up(type, *params)
-        __remote_control_command("scMouseUp", [__locator(type, *params), ])
+        __remote_control_command("scMouseUp", [__locator(type, *params)])
       end
       
-      def sc_mouse_down_at(type, x, y, *params)
-        coords = "#{x},#{y}"
-        __remote_control_command("mouseDownAt", [__locator(type, *params), coords])
-      end
-    
-      def sc_mouse_up_at(type, x, y, *params)
-        coords = "#{x},#{y}"
-        __remote_control_command("mouseUpAt", [__locator(type, *params), coords])
-      end
-            
       def sc_right_mouse_down(type, *params)
-        __remote_control_command("scMouseDownRight", [__locator(type, *params), ])
+        __remote_control_command("scMouseDownRight", [__locator(type, *params)])
       end
       
       def sc_right_mouse_up(type, *params)
-        __remote_control_command("scMouseUpRight", [__locator(type, *params), ])
+        __remote_control_command("scMouseUpRight", [__locator(type, *params)])
+      end
+      
+      def sc_mouse_move_at(type, x, y, *params)
+        encoded_params = ObjectEncoder.encode_hash({ :x => x, :y => y })
+        __remote_control_command("scMouseMoveAt", [__locator(type, *params), encoded_params])
+      end
+      
+      def sc_mouse_down_at(type, x, y, *params)
+        encoded_params = ObjectEncoder.encode_hash({ :x => x, :y => y })
+        __remote_control_command("scMouseDownAt", [__locator(type, *params), encoded_params])
+      end
+    
+      def sc_mouse_up_at(type, x, y, *params)
+        encoded_params = ObjectEncoder.encode_hash({ :x => x, :y => y })
+        __remote_control_command("scMouseUpAt", [__locator(type, *params), encoded_params])
       end
       
       def sc_right_mouse_down_at(type, x, y, *params)
-        coords = "#{x},#{y}"
-        __remote_control_command("mouseDownRightAt", [__locator(type, *params), coords])
+        encoded_params = ObjectEncoder.encode_hash({ :x => x, :y => y })
+        __remote_control_command("scMouseDownRightAt", [__locator(type, *params), encoded_params])
       end
       
       def sc_right_mouse_up_at(type, x, y, *params)
-        coords = "#{x},#{y}"
-        __remote_control_command("mouseUpRightAt", [__locator(type, *params), coords])
+        encoded_params = ObjectEncoder.encode_hash({ :x => x, :y => y })
+        __remote_control_command("scMouseUpRightAt", [__locator(type, *params), encoded_params])
       end
       
       def sc_basic_click(type, *params)
@@ -228,6 +228,18 @@ module Lebowski
         __remote_control_command("scDoubleClick", [__locator(type, *params), ])
       end
       
+      def sc_mouse_wheel_delta_x(type, delta, *params)
+        __remote_control_command("scMouseWheelDeltaX", [__locator(type, *params), delta])
+      end
+      
+      def sc_mouse_wheel_delta_y(type, delta, *params)
+        __remote_control_command("scMouseWheelDeltaY", [__locator(type, *params), delta])
+      end
+      
+      def sc_enable_mouse_move_event()
+        __remote_control_command("scEnableMouseMoveEvent", [])
+      end
+      
       def sc_focus(type, *params)
         __remote_control_command("focus", [__locator(type, *params), ])
       end
@@ -365,6 +377,25 @@ module Lebowski
       
       # Selenium User Extension Utility Function Selenium Calls
       
+      # Disables all autoscrolling when performing a drag and drop
+      # operation within a SproutCore Application. Call this
+      # when you don't want autoscrolling to interfere with some
+      # user action. 
+      #
+      # @see sc_disable_all_autoscrolling
+      def sc_disable_all_autoscrolling
+        __remote_control_command("scDisableAllAutoscrolling")
+      end
+      
+      # Used to enable all autoscrolling. Call this after you have
+      # completed a user action that you did not want autoscrolling
+      # to intefere with.
+      #
+      # @see sc_disable_all_autoscrolling
+      def sc_enable_all_autoscrolling
+        __remote_control_command("scEnableAllAutoscrolling")
+      end
+      
       def is_sc_bundle_loaded(bundle) 
         return __boolean_command("isScBundleLoaded", [bundle])
       end
@@ -501,6 +532,10 @@ module Lebowski
         return __number_command("getElementChildNodesCount", [selector, index])
       end
       
+      def get_sc_scrollable_parent_view_layer_id(path)
+        return __string_command("getScScrollableParentViewLayerId", [path])
+      end
+      
       # Selenium User Extensions Testing/Debugging Calls   
     
       def __sc_test_computing_property_path(key, path)

data/lib/lebowski/version.rb

@@ -3,14 +3,14 @@
 # License:   Licensed under MIT license (see License.txt)
 # ==========================================================================
 
-module Lebowski # :nodoc:
-  module VERSION # :nodoc:
-    MAJOR  = 0
-    MINOR  = 2
-    TINY   = 1
-    PRE    = nil
+module Lebowski
+  module Version
+    MAJOR = 0
+    MINOR = 3
+    PATCH = 0
+    BUILD = nil
 
-    STRING = [MAJOR, MINOR, TINY, PRE].compact.join('.')
+    STRING = [MAJOR, MINOR, PATCH, BUILD].compact.join('.')
 
     SUMMARY = "lebowski #{STRING}"
   end

data/resources/README

@@ -0,0 +1 @@
+The selenium-server.jar is part of the Selenium Framework (http://seleniumhq.org)

data/resources/user-extensions.js

@@ -96,6 +96,16 @@ ScExt.viewScrollToVisible = function(view) {
   $SC.RunLoop.end();
 };
 
+/**
+  Will return a scrollable parent view of a given view. If no scrollable
+  parent view can be found then null is returned. 
+*/
+ScExt.getScrollableParentView = function(view) {
+  var pv = view.get('parentView');
+  while (pv && !pv.get('isScrollable')) pv = pv.get('parentView');
+  return (pv && pv.get('isScrollable')) ? pv : null;
+};
+
 /**
   Gets all the class names that the given object inherits from. For instance, if
   an object is of type SC.ButtonView, then the following will be returned
@@ -338,26 +348,65 @@ var $ScPath = ScExt.PathParser;
 ScExt.MouseEventSimulation = {
   
   simulateEvent: function(mouseEvent, locator, x, y, button) {
-    var element = selenium.browserbot.findElement(locator);
+    var element = selenium.browserbot.findElement(locator),
+        coord = element ? $SC.viewportOffset(element) : { x: 0, y: 0 },
+        width = element ? element.clientWidth : 0,
+        height = element ? element.clientHeight : 0;
+    
+    x = x ? (x === 'center' ? width / 2 : x) : 0;
+    y = y ? (y === 'center' ? height / 2 : y) : 0;
+    
+    var coords = element ? $SC.viewportOffset(element) : { x: 0, y: 0 },
+        clientX = coords.x + x,
+        clientY = coords.y + y;
+        
     event = $SC.Event.simulateEvent(element, mouseEvent, { 
-      screenX: 0,
-      screenY: 0,
-      clientX: $SC.none(x) ? 0 : x,
-      clientY: $SC.none(x) ? 0 : y,
-      pageX: 0,
-      pageY: 0,
+      screenX: 0, // assume 0 is fine
+      screenY: 0, // assume 0 is fine
+      clientX: clientX,
+      clientY: clientY,
+      pageX: clientX,
+      pageY: clientY,
       bubbles: true,
-      button: $SC.none(button) ? 0 : button,
+      button: button ? button : 0,
       altKey: selenium.browserbot.altKeyDown,
       metaKey: selenium.browserbot.metaKeyDown,
       ctrlKey: selenium.browserbot.controlKeyDown,
       shiftKey: selenium.browserbot.shiftKeyDown
     });
+    
     $SC.Event.trigger(element, mouseEvent, event);
   },
+
+  /**
+    Will simulate a mouse move event
+    
+    Simulating a mouse move event works a bit differently from the other
+    mouse events. This is due to the way certain browsers behave when you
+    perform a mouse move. 
+    
+    In Safari, when you invoke a mouse move event and your mouse is placed 
+    over the browser, it causes another mouse move event to occur having 
+    clientX and clientY coordinates where the mouse is positioned. This causes 
+    unexpected behavior and prevents not only mouse move to not behave correctly, 
+    but also any drag and drop operation. 
+    
+    In order to prevent this unexpected behavior, the mousemove event is temporarily 
+    enabled and then immediately disabled so that no other mouse move events 
+    raised by the browser itself will intefere.
+    
+    Because the mouse move event is immediate disabled after triggering a simulated
+    mouse move event, you may want to enable it later. To do so, you will need
+    to invoke the doScEnableMouseMoveEvent method.
+  */
+  mouseMove: function(locator, x, y) {
+    this.enableMouseMoveEvent();
+    this.simulateEvent('mousemove', locator, x, y, 0);
+    this.disableMouseMoveEvent();
+  },
   
   /**
-    Will simulate a mouse down on a function key
+    Will simulate a mouse down event
   */
   mouseDown: function(locator, x, y) {
     this.simulateEvent('mousedown', locator, x, y, 0);
@@ -382,6 +431,64 @@ ScExt.MouseEventSimulation = {
   */
   mouseUpRight: function(locator, x, y) {
     this.simulateEvent('mouseup', locator, x, y, Selenium.RIGHT_MOUSE_CLICK);
+  },
+  
+  disableMouseMoveEvent: function() {
+    var responder = this._getRootResponder();
+    var doc = this._getDocument();
+
+    $SC.Event.remove(doc, "mousemove", responder, responder["mousemove"]);
+  },
+
+  enableMouseMoveEvent: function() {
+    var responder = this._getRootResponder();
+    var doc = this._getDocument();
+
+    $SC.Event.add(doc, "mousemove", responder, responder["mousemove"]);
+  },
+  
+  _getRootResponder: function() {
+    return $SC.RootResponder.responder;
+  },
+  
+  _getDocument: function() {
+    return selenium.browserbot.currentWindow.document;
+  }
+  
+};
+
+/**
+  Used to simulate a mouse wheel events using SproutCore's SC.Event object
+*/
+ScExt.MouseWheelSimulation = {
+  
+  simulateEvent: function(locator, deltaX, deltaY, delta) {
+    var element = selenium.browserbot.findElement(locator);
+    event = $SC.Event.simulateEvent(element, 'mousewheel', { 
+      wheelDelta: !!delta ? delta : 0,
+      wheelDeltaX: !!deltaX ? deltaX : 0,
+      wheelDeltaY: !!deltaY ? deltaY : 0,
+      bubbles: true,
+      altKey: selenium.browserbot.altKeyDown,
+      metaKey: selenium.browserbot.metaKeyDown,
+      ctrlKey: selenium.browserbot.controlKeyDown,
+      shiftKey: selenium.browserbot.shiftKeyDown
+    });
+    $SC.Event.trigger(element, 'mousewheel', event);
+  },
+  
+  /**
+    Will simulate a mouse wheel on the x-axis
+  */
+  wheelDeltaX: function(locator, delta) {
+    this.simulateEvent(locator, delta, 0, delta);
+  },
+  
+  /**
+    Will simulate a mouse wheel on the y-axis
+  */
+  wheelDeltaY: function(locator, delta) {
+    this.simulateEvent(locator, 0, delta, delta);
   }
   
 };
@@ -1116,8 +1223,8 @@ Selenium.prototype.doScViewScrollToVisible = function(path) {
 */
 Selenium.prototype.doScMouseDown = function(locator) {
   try {
-    this.doMouseDown(locator);
-  } catch (ex) {}
+    ScExt.MouseEventSimulation.mouseDown(locator);
+  } catch (e) {}
 };
 
 /**
@@ -1125,8 +1232,8 @@ Selenium.prototype.doScMouseDown = function(locator) {
 */
 Selenium.prototype.doScMouseUp = function(locator) {
   try {
-    this.doMouseUp(locator);
-  } catch (ex) {}
+    ScExt.MouseEventSimulation.mouseUp(locator);
+  } catch (e) {}
 };
 
 /**
@@ -1134,8 +1241,8 @@ Selenium.prototype.doScMouseUp = function(locator) {
 */
 Selenium.prototype.doScMouseDownRight = function(locator) {
   try {
-    this.doMouseDownRight(locator);
-  } catch (ex) {}
+    ScExt.MouseEventSimulation.mouseDownRight(locator);
+  } catch (e) {}
 };
 
 /**
@@ -1143,8 +1250,73 @@ Selenium.prototype.doScMouseDownRight = function(locator) {
 */
 Selenium.prototype.doScMouseUpRight = function(locator) {
   try {
-    this.doMouseUpRight(locator);
-  } catch (ex) {}
+    ScExt.MouseEventSimulation.mouseUpRight(locator);
+  } catch (e) {}
+};
+
+/**
+  Action to raise a mouse move at event
+*/
+Selenium.prototype.doScMouseMoveAt = function(locator, params) {
+  var decodedParams = ScExt.ObjectDecoder.decodeHash(params),
+      x = decodedParams ? decodedParams.x : 0,
+      y = decodedParams ? decodedParams.y : 0;
+
+  try {
+    ScExt.MouseEventSimulation.mouseMove(locator, x, y);
+  } catch (e) {}
+};
+
+/**
+  Action to raise a mouse up at event
+*/
+Selenium.prototype.doScMouseUpAt = function(locator, params) {
+  var decodedParams = ScExt.ObjectDecoder.decodeHash(params),
+      x = decodedParams ? decodedParams.x : 0,
+      y = decodedParams ? decodedParams.y : 0;
+
+  try {
+    ScExt.MouseEventSimulation.mouseUp(locator, x, y);
+  } catch (e) {}
+};
+
+/**
+  Action to raise a mouse down at event
+*/
+Selenium.prototype.doScMouseDownAt = function(locator, params) {
+  var decodedParams = ScExt.ObjectDecoder.decodeHash(params),
+      x = decodedParams ? decodedParams.x : 0,
+      y = decodedParams ? decodedParams.y : 0;
+
+  try {
+    ScExt.MouseEventSimulation.mouseDown(locator, x, y);
+  } catch (e) {}
+};
+
+/**
+  Action to raise a right mouse up at event
+*/
+Selenium.prototype.doScMouseUpRightAt = function(locator, params) {
+  var decodedParams = ScExt.ObjectDecoder.decodeHash(params),
+      x = decodedParams ? decodedParams.x : 0,
+      y = decodedParams ? decodedParams.y : 0;
+
+  try {
+    ScExt.MouseEventSimulation.mouseUpRight(locator, x, y);
+  } catch (e) {}
+};
+
+/**
+  Action to raise a right mouse down at event
+*/
+Selenium.prototype.doScMouseDownRightAt = function(locator, params) {
+  var decodedParams = ScExt.ObjectDecoder.decodeHash(params),
+      x = decodedParams ? decodedParams.x : 0,
+      y = decodedParams ? decodedParams.y : 0;
+
+  try {
+    ScExt.MouseEventSimulation.mouseDownRight(locator, x, y);
+  } catch (e) {}
 };
 
 /**
@@ -1171,6 +1343,22 @@ Selenium.prototype.doScDoubleClick = function(locator) {
   this.doScClick(locator);
 };
 
+/**
+  Action performs a mouse wheel event on the x-axis that is recognized
+  by the SproutCore framework. 
+*/
+Selenium.prototype.doScMouseWheelDeltaX = function(locator, delta) {
+  ScExt.MouseWheelSimulation.wheelDeltaX(locator, delta*1); 
+};
+
+/**
+  Action performs a mouse wheel event on the y-axis that is recognized
+  by the SproutCore framework. 
+*/
+Selenium.prototype.doScMouseWheelDeltaY = function(locator, delta) {
+  ScExt.MouseWheelSimulation.wheelDeltaY(locator, delta*1); 
+};
+
 /** @private
   Check that the element is a valid text entry field
 */
@@ -1315,6 +1503,44 @@ Selenium.prototype.doRangeInsertContent = function(params) {
   }
 };
 
+/**
+  Will disable all autoscrolling within the SproutCore application. Useful
+  when you do not want scrollable views to automatically scroll since they
+  can interfere with certain automated user actions like drag and drop. When
+  the action is complete be use to enable all autoscrolling.
+  
+  @see doScEnableAllAutoscrolling
+*/
+Selenium.prototype.doScDisableAllAutoscrolling = function() {
+  var sv = $SC.Drag._scrollableViews;
+  this._scrollableViews = sv;
+  $SC.Drag._scrollableViews = {};
+};
+
+/**
+  Will enable all autoscrolling within the SproutCore application. Call 
+  this after a user action is complete that you did not want autoscrolling
+  to interfere with.
+  
+  @see doScDisableAllAutoscrolling
+*/
+Selenium.prototype.doScEnableAllAutoscrolling = function() {
+  var sv = this._scrollableViews ? this._scrollableViews : {};
+  $SC.Drag._scrollableViews = sv;
+};
+
+/**
+  Will enabled the mouse move event so that SproutCore will respond to it.
+  The mouse move event gets disabled whenever the need to invoke a mouse
+  mouse event is simulated by the ScExt.MouseEventSimulation's mouseMove
+  method.
+  
+  @see ScExt.MouseEventSimulation#mouseMove
+*/
+Selenium.prototype.doScEnableMouseMoveEvent = function() {
+  ScExt.MouseEventSimulation.enableMouseMoveEvent();
+};
+
 ///////////////////// Selenium Core API Extensions - Accessors ////////////////////////////////////
 
 /**
@@ -1423,9 +1649,11 @@ Selenium.prototype.getScViewFrame = function(path) {
   Gets a DOM element's current window position
 */
 Selenium.prototype.getScElementWindowPosition = function(path) {
-  var x = this.getElementPositionLeft(path);
-  var y = this.getElementPositionTop(path);
-  return [x, y];
+  var element = this.browserbot.findElement(path);
+  if (!element) return null;
+  var coords = $SC.viewportOffset(element);
+  if (!coords) return null;
+  return [coords.x, coords.y];
 };
 
 /**
@@ -1450,6 +1678,12 @@ Selenium.prototype.isScBundleLoaded = function(bundle) {
   return $SC.bundleIsLoaded(bundle);
 };
 
+Selenium.prototype.getScScrollableParentViewLayerId = function(path) {
+  var view = $ScPath.getPath(path, 'SC.View');
+  var parent = view ? ScExt.getScrollableParentView(view) : null;
+  return parent ? parent.get('layerId') : null;  
+};
+
 /////// SC Core Query Specific Selenium Calls /////////////////
 
 /**

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require File.expand_path(File.dirname(__FILE__) + '/../lib/lebowski')