lebowski 0.1.0

data/History.md

@@ -0,0 +1,3 @@
+# lebowski 0.1.0 2010-06-07
+
+* Open source beta release

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Michael Cohen <http://frozencanuck.wordpress.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest.txt

@@ -0,0 +1,84 @@
+License.txt
+History.md
+Manifest.txt
+README.md
+Rakefile
+lib/lebowski.rb
+lib/lebowski/version.rb
+lib/lebowski/core.rb
+lib/lebowski/runtime.rb
+lib/lebowski/runtime/errors/remote_control_error.rb
+lib/lebowski/runtime/errors/remote_control_command_execution_error.rb
+lib/lebowski/runtime/errors/remote_control_command_timeout_error.rb
+lib/lebowski/runtime/errors/selenium_server_error.rb
+lib/lebowski/runtime/sprout_core_extensions.rb
+lib/lebowski/runtime/sprout_core_driver.rb
+lib/lebowski/runtime/object_encoder.rb
+lib/lebowski/foundation.rb
+lib/lebowski/foundation/core.rb
+lib/lebowski/foundation/errors/unexpected_type.rb
+lib/lebowski/foundation/errors/argument_invalid_type.rb
+lib/lebowski/foundation/mixins/key_check.rb
+lib/lebowski/foundation/mixins/positioned_element.rb
+lib/lebowski/foundation/mixins/user_actions.rb
+lib/lebowski/foundation/mixins/wait_actions.rb
+lib/lebowski/foundation/mixins/delegate_support.rb
+lib/lebowski/foundation/mixins/collection_item_view_support.rb
+lib/lebowski/foundation/mixins/list_item_view_support.rb
+lib/lebowski/foundation/mixins/inline_text_field_support.rb
+lib/lebowski/foundation/mixins/stall_support.rb
+lib/lebowski/foundation/proxy_object.rb
+lib/lebowski/foundation/sc_object.rb
+lib/lebowski/foundation/object_array.rb
+lib/lebowski/foundation/core_query.rb
+lib/lebowski/foundation/dom_element.rb
+lib/lebowski/foundation/views/view.rb
+lib/lebowski/foundation/views/label.rb
+lib/lebowski/foundation/views/button.rb
+lib/lebowski/foundation/views/container.rb
+lib/lebowski/foundation/views/segmented.rb
+lib/lebowski/foundation/views/radio.rb
+lib/lebowski/foundation/views/checkbox.rb
+lib/lebowski/foundation/views/disclosure.rb
+lib/lebowski/foundation/views/text_field.rb
+lib/lebowski/foundation/views/select_field.rb
+lib/lebowski/foundation/views/menu_item.rb
+lib/lebowski/foundation/views/collection.rb
+lib/lebowski/foundation/views/list.rb
+lib/lebowski/foundation/views/list_item.rb
+lib/lebowski/foundation/views/grid.rb
+lib/lebowski/foundation/views/support/simple_item_array.rb
+lib/lebowski/foundation/panes/pane.rb
+lib/lebowski/foundation/panes/main.rb
+lib/lebowski/foundation/panes/modal.rb
+lib/lebowski/foundation/panes/panel.rb
+lib/lebowski/foundation/panes/alert.rb
+lib/lebowski/foundation/panes/palette.rb
+lib/lebowski/foundation/panes/picker.rb
+lib/lebowski/foundation/panes/sheet.rb
+lib/lebowski/foundation/panes/menu.rb
+lib/lebowski/foundation/application.rb
+lib/lebowski/foundation/proxy_factory.rb
+lib/lebowski/scui.rb
+lib/lebowski/scui/views/combo_box.rb
+lib/lebowski/scui/views/date_picker.rb
+lib/lebowski/scui/views/linkit.rb
+lib/lebowski/scui/mixins/node_item_view_support.rb
+lib/lebowski/scui/mixins/terminal_view_support.rb
+lib/lebowski/spec.rb
+lib/lebowski/spec/core.rb
+lib/lebowski/spec/util.rb
+lib/lebowski/spec/operators/operator.rb
+lib/lebowski/spec/operators/that.rb
+lib/lebowski/spec/matchers/match_supporters/match_supporter.rb
+lib/lebowski/spec/matchers/match_supporters/has_object_function.rb
+lib/lebowski/spec/matchers/match_supporters/has_predicate_with_no_prefix.rb
+lib/lebowski/spec/matchers/match_supporters/has_predicate_with_prefix_has.rb
+lib/lebowski/spec/matchers/be.rb
+lib/lebowski/spec/matchers/has.rb
+lib/lebowski/spec/matchers/method_missing.rb
+bin/lebowski
+bin/lebowski-spec
+bin/lebowski-start-server
+resources/selenium-server.jar
+resources/user-extensions.js

data/README.md

@@ -0,0 +1,146 @@
+    Lebowski Framework
+  
+    -- the SproutCore feature and integration test automation framework
+
+#Overview
+
+The Lebowski framework is a test automation framework for applications built on the 
+[SproutCore](http://www.sproutcore.com/) framework. 
+
+Compared to unit testing frameworks that are perfect for testing individual objects
+and functions, Lebowski is an automated test framework designed for full 
+feature, integration, and regression testing of an application. 
+
+The framework was created with the following in mind:
+
+  * Provide a way for those who write feature and integration tests to build scripts 
+    that reflect how the application was build using the SproutCore framework and
+    abstract away from all the low-level HTML and JavaScript.
+
+  * Allow you to easily access any SproutCore objects that make up your application
+    
+  * Allow you to perform all the common user actions and will address all the subtle 
+    ways to correctly interact with the views that make up your application
+    
+  * Make it easy to add extensions so that you can work with custom views you've
+    built for your application.
+
+The Lebowski framework was built using the [Ruby](http://www.ruby-lang.org/en/) programming language. 
+Therefore, to use this framework you will have to know some basic Ruby in order to get started. 
+In addition, the framework also make use of [Selenium](http://seleniumhq.org/) remote control server 
+in order to open up a browser, load your SproutCore application, and communicate with the application. 
+Knowledge of selenium server is not required to use the framework. (Note that the selenium server is
+dependent on your system having the latest Java runtime installed). 
+
+The framework also comes with extensions to [RSpec](http://rspec.info/) that you can optionally use to 
+write your scripts, but RSpec is not required to use the Lebowski framework. 
+
+#Installing Lebowski
+
+Installing the Lebowski framework is simple. First, make sure that you have the latest Ruby installed 
+on your machine (version 1.9+). Once you have Ruby installed, you can get the Lebowski framework
+by invoking the following from your terminal:
+
+    $ gem install lebowski
+    
+Depending on the setup of your system you may have to call `gem1.9` and use the `sudo` command. 
+
+If everything worked out you should have the lebowski gem installed on your computer. The framework is
+dependent on two gems:
+
+  * selenium-client 1.2.18
+  * rspec 1.3.0
+
+For RSpec, it is only required if you plan on using the Lebowski's RSpec extensions.
+
+Once installed you will have three executables installed that you can use to run your
+Lebowski scripts:
+
+  * `lebowski-start-server` - Starts the selenium server
+  * `lebowski` - Can be used to run your Ruby scripts that use Lebowski
+  * `lebowski-spec` - Can be used to run your spec tests that use Lebowski
+
+Of the three listed above, the one that must always be executed before executing a script
+using Lebowski is the `lebowski-start-server`.
+
+It is assumed that you have the SproutCore framework installed on your machine, but if not,
+you can grab the framework by doing the following:
+
+    $ gem install sproutcore
+    
+At this time, the Lebowski framework works with SproutCore v1.0.1046.
+
+In addition to SproutCore, it is also advised that you, at minimum, have [Firefox](http://www.mozilla.com/en-US/firefox/personal.html) 
+installed on your system since that is the default browser used to run your SproutCore application using
+Lebowski.
+
+#Getting Started With Lebowski
+
+If you're new to the Lebowski framework then the best place to get started is to try
+and run the Hello World example that you can find in the `examples/hello_world` directory when
+you clone the Lebowski framework from github. In the directory you'll see two sub-directories: 
+app and spec. The app directory contains the Hello World SproutCore application. The spec folder 
+contains three files that will test the application using the Lebowski framework. 
+
+To get started, you'll first need to start the selenium server using `lebowski-start-server`. 
+Next, you will need to start up the hello world example app using `sc-server` within the app 
+directory. Check that you can see the application by opening a browser and going to the 
+following URL:
+
+    http://localhost:4020/hello_world
+  
+If the app started correctly you should see a label with the text "Click a button", and
+two buttons below the label with titles "Hello" and "World". If you click the two buttons
+you should see the label's caption change between "Hello" and "World". 
+
+You can see how the views were added to the application by looking at the `main_page.js` file 
+in the `app/apps/hello_world/resources` folder. 
+
+With the application started, you can start by running the first hello world spec file
+like so:
+
+    $ cd examples/hello_world/spec
+    $ lebowski-spec -f n hello_world_spec.rb
+  
+If everything worked you should see the following outputted your terminal:
+
+    Hello World Test
+      will check that label has an initial value 'click a button'
+      will check that hello button has title 'hello'
+      will check that world button has title 'world'
+      will click hello button and then confirm label has value 'hello'
+      will click world button and then confirm label has value 'world'
+
+    Finished in 1.810166 seconds
+
+    5 examples, 0 failures
+
+If you got output that looks like the output above then congratulations, you've just run 
+your first Lebowski script. For a slightly more complicated script, try running the
+`hello_world_2_spec.rb` file. 
+
+If you examine the hello world spec files, you'll see that they introduce to
+some of the main concepts of using the Lebowski framework, namely:
+
+  * Starting up the application
+  * Defining paths
+  * Accessing views by relative property paths and identifiers
+  * Accessing a view's properties
+  * Using the Lebowski RSpec extensions
+  * Creating a custom path proxy  
+
+After you get yourself familiar with the hello world example app, you can move on and learn
+how to make a custom type proxy by going to the `custom_view` example app. 
+
+If you like to know what proxies the Lebowski framework comes with and know how to use them, 
+be sure to check out the `sc_controls` example app.
+
+#Why the name "Lebowski"?
+
+> sometimes there's a man... I won't say a hero, 'cause, what's a hero? But sometimes, 
+> there's a man. And I'm talkin' about the [Dude](http://www.imdb.com/title/tt0118715/) here. 
+> Sometimes, there's a man, well, he's the man for his time and place. He fits right in there. 
+> And that's the Dude, in Los Angeles. And even if he's a lazy man - and the Dude was most certainly 
+> that. Quite possibly the laziest in Los Angeles County, which would place him high in the runnin' 
+> for laziest worldwide. But sometimes there's a man, sometimes, there's a man.
+

data/Rakefile

@@ -0,0 +1,42 @@
+require 'rubygems'
+gem 'hoe', '>= 2.1.0'
+require 'hoe'
+require 'fileutils'
+require './lib/lebowski'
+
+Hoe.plugin :newgem
+
+$hoe = Hoe.spec 'lebowski' do
+  self.version = Lebowski::VERSION::STRING
+  self.summary = "A feature and integration test automation framework for SproutCore applications"
+  self.description = <<-DESCRIPTION
+  
+  Compared to unit testing framework that are perfect for testing individual 
+  objects and functions, Lebowski is an automated test framework 
+  designed for full feature, integration, and regression testing of a
+  SproutCore application.
+  
+DESCRIPTION
+
+  self.developer 'Michael Cohen', 'michael.lee.cohen@gmail.com'
+  self.rubyforge_name = 'lebowski'
+  self.extra_deps << ['selenium-client', ">= 1.2.18"]
+  self.extra_deps << ['rspec', ">= 1.3.0"]
+  self.post_install_message = <<-POST_INSTALL_MESSAGE
+#{'*'*50}
+
+  Thank you for installing lebowski-#{Lebowski::VERSION::STRING}
+
+  Please be sure to read the README.md and History.md
+  for useful information on how to use this framework 
+  and about this release.
+  
+  For more information go to the following web sites:
+  
+    http://github.com/FrozenCanuck/Lebowski
+    http://frozencanuck.wordpress.com
+    http://www.sproutcore.com
+
+#{'*'*50}
+POST_INSTALL_MESSAGE
+end

data/bin/lebowski

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+
+#
+# Executable used to run a script that uses the Lebowski framework. Using
+# this instead of ruby directly will automtically require and include all
+# the nessary files, gems and modules to get you running with the framework
+#
+#   E.g. lebowski my_lebowski_script.rb
+#
+
+if ARGV.length == 0
+  puts "Error: Unable to run lebowski. A ruby file is required"
+  exit
+end
+
+require 'rubygems'
+gem 'lebowski'
+require 'lebowski'
+
+include Lebowski::Foundation
+include Lebowski::Foundation::Views
+include Lebowski::Foundation::Panes
+include Lebowski::SCUI::Views
+
+load ARGV[0]
+

data/bin/lebowski-spec

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+
+#
+# Executable used to run an RSpec script that makes use of the Lebowski framework. 
+# Using this instead of spec directly will automtically require and include all
+# the nessary files, gems and modules to get you running with the framework. 
+# Special spec extension will also be included.
+#
+#   E.g. lebowski-spec my_lebowski_spec.rb
+#
+
+if ARGV.length == 0
+  puts "Error: Unable to run lebowski-spec. A ruby file is required"
+  exit
+end
+
+require 'rubygems'
+gem 'rspec', '>=1.3.0'
+require 'spec'
+require 'spec/autorun'
+gem 'lebowski'
+require 'lebowski/spec'
+
+include Lebowski::Foundation
+include Lebowski::Foundation::Views
+include Lebowski::Foundation::Panes
+include Lebowski::SCUI::Views
+
+exit ::Spec::Runner::CommandLine.run

data/bin/lebowski-start-server

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+
+#
+# Executable to start the selenium server that will automically include
+# the required extension file
+#
+
+DEFAULT_SELENIUM_SERVER_PORT = 4444
+
+port = DEFAULT_SELENIUM_SERVER_PORT
+
+ARGV.each_with_index do |arg, index|
+  port = ARGV[index + 1] if arg == '-port' and (index + 1) < ARGV.count 
+end
+
+puts "Running Selenium Server for Lebowski"
+puts "Starting server on http://localhost:#{port}"
+puts "To quit server, press Control-C"
+
+resources_dir = File.expand_path(File.join(File.dirname(__FILE__), %w[.. resources]))
+selenium_server =  File.join(resources_dir, 'selenium-server.jar')
+user_extensions =  File.join(resources_dir, 'user-extensions.js')
+
+exec 'java', '-jar', selenium_server, '-userExtensions', user_extensions, *ARGV

data/lib/lebowski.rb

@@ -0,0 +1,15 @@
+# ==========================================================================
+# Project:   Lebowski Framework - The SproutCore Test Automation Framework
+# License:   Licensed under MIT license (see License.txt)
+# ==========================================================================
+
+require "rubygems"
+gem "selenium-client", ">=1.2.16"
+require "selenium/client"
+
+require File.expand_path(File.dirname(__FILE__) + '/lebowski/version')
+require File.expand_path(File.dirname(__FILE__) + '/lebowski/core')
+
+require File.expand_path(File.dirname(__FILE__) + '/lebowski/runtime')
+require File.expand_path(File.dirname(__FILE__) + '/lebowski/foundation')
+require File.expand_path(File.dirname(__FILE__) + '/lebowski/scui')

data/lib/lebowski/core.rb

@@ -0,0 +1,35 @@
+module Lebowski
+  
+  class Rect
+
+    attr_accessor :width, :height, :x, :y
+    
+    def initialize(width, height, x, y)
+      @width = width
+      @height = height
+      @x = x
+      @y = y
+    end
+    
+    def to_s()
+      return "Rect<width: #{width}, height: #{height},  x: #{x}, y: #{y}>"
+    end
+
+  end
+  
+  class Coords
+
+    attr_accessor :x, :y
+    
+    def initialize(x, y)
+      @x = x
+      @y = y
+    end
+    
+    def to_s()
+      return "Coords<x: #{x}, y: #{y}>"
+    end
+  
+  end
+  
+end

data/lib/lebowski/foundation.rb

@@ -0,0 +1,52 @@
+require File.expand_path(File.dirname(__FILE__) + '/foundation/core')
+
+require File.expand_path(File.dirname(__FILE__) + '/foundation/errors/unexpected_type')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/errors/argument_invalid_type')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/errors/timeout')
+
+require File.expand_path(File.dirname(__FILE__) + '/foundation/mixins/stall_support')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/mixins/key_check')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/mixins/positioned_element')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/mixins/user_actions')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/mixins/wait_actions')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/mixins/inline_text_field_support')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/mixins/delegate_support')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/mixins/collection_item_view_support')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/mixins/list_item_view_support')
+
+require File.expand_path(File.dirname(__FILE__) + '/foundation/proxy_object')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/sc_object')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/object_array')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/core_query')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/dom_element')
+
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/support/simple_item_array')
+
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/view')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/label')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/button')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/container')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/segmented')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/radio')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/checkbox')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/disclosure')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/text_field')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/select_field')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/menu_item')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/collection')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/list')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/list_item')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/views/grid')
+
+require File.expand_path(File.dirname(__FILE__) + '/foundation/panes/pane')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/panes/main')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/panes/modal')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/panes/panel')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/panes/alert')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/panes/palette')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/panes/picker')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/panes/sheet')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/panes/menu')
+
+require File.expand_path(File.dirname(__FILE__) + '/foundation/application')
+require File.expand_path(File.dirname(__FILE__) + '/foundation/proxy_factory')