bret-watircraft 0.4.4 → 0.4.5

data/History.txt

@@ -1,3 +1,26 @@
+=== 0.4.5 / 2009-04-07
+
+New Features
+
+* Will now use the latest version of Rspec and Cucumber. Previously we
+  declared dependencies on specific versions of Rspec and Cucumber. Now we
+  will install and use the latest version. If you have a specific version
+  you want to use, you should install it first. WatirCraft will use it,
+  instead of installing its own.
+* When you create a new project, your site.rb file will now contain a 
+  template initialize_browser method, making it easier to see how to
+  customize it.
+  
+Bug Fixes
+
+* Some "should" commands were not working in the script\console.
+  (e.g. "browser.text.should include('Google')"
+
+Documentation
+
+* Fixed incorrect reference to config file in "startup instructions".
+* Moved documentation from project readme to the wiki.  
+
 === 0.4.4 / 2009-04-02
 
 This release provides a number of new configuration options for managing

data/README.rdoc

@@ -1,126 +1,7 @@
 = WatirCraft
 
-== DESCRIPTION
-
-WatirCraft is a testing framework that builds on Watir. 
-It allows tests to be expressed as Rspec or Cucumber tests and provides 
-a library structure to support maintainable testing. It gives you
-a place to put things.
-
-* http://testobsessed.com/2008/05/31/a-place-to-put-things
-
-== FEATURES
-
-* Generates a directory structure for your test suite with one command.
-* Provides page adapters you can customize for your application.
-* Configure environment URLs and browser type (IE, Firefox) in one location.
-* Supports multiple environments; specify which to test at run time.
-* Uses templates to create tests and libraries.
-* Automatically initializes browser for testing.
-* Provides the glue to ensure your tests can find your libraries. Don't
-  write another "require" statement again.
-
-== APPROACH
-
-WatirCraft is an object-oriented testing framework that helps you create
-class libraries to support the tests for your application. On their own,
-many testers have created procedural libraries for testing because they
-understand these and find them easier to create and understand.
-
-Although object-oriented frameworks like WatirCraft are somewhat more difficult
-to understand at first, they are easier to customize and upgrade. As we add
-more features to the WatirCraft framework, your test suite will automatically
-get the benefit.
-
-== INSTALL
-
-Run the following if you haven't already:
-
-  > gem update --system
-  > gem sources -a http://gems.github.com
-
-Install the gem:
-
-  > gem install bret-watircraft
-  
+For documentation, see http://wiki.github.com/bret/watircraft
 See the History.txt file for detailed notes on the contents of each release.
-  
-== GETTING STARTED
-
-Use the +watircraft+ command to create your project. Your project will contain
-your tests, your libraries, your configuration files, and all the glue code
-necessary to allow it all to work together. Let's create a project for 
-testing Google.
-
-  > watircraft google
-  
-This will create a directory called "google" and populate it with a bunch of
-directories and files.
-
-You'll need to edit the <tt>config\environments.yml</tt> file to point to you base
-url of your project.
-
-  test:
-    url: http://google.com
-
-By default, your tests will run in the "test" environment, but you can specify
-additional environments later. When you run your tests, you can specify which environment
-to use on the command line.
-
-Use the <tt>script\generate</tt> command to populate your project with project files.
-This command must be run from the top of your project.
-
-  > cd google
-
-Create a test. WatirCraft uses the RSpec test harness and therefore calls a 
-test a "spec".
-
-  > script\generate spec search
-
-This creates a bare template for a test. Edit the file that was just created
-(<tt>test/specs/search_spec.rb</tt>) and add the following
-lines.
-
-  browser.text_field(:name, 'q').set 'WatirCraft'
-  browser.button(:name, 'btnG').click
-  browser.text.should include('Test automation for web applications')
-
-The WatirCraft framework will automatically start the browser at the 
-configured url when you run it. 
-
-After you have added these lines to the template, the complete file will 
-look like this.
-
-	$LOAD_PATH.unshift File.dirname(__FILE__) unless 
-	  $LOAD_PATH.include? File.dirname(__FILE__)
-	require 'spec_helper'
-	
-	describe "Search" do
-	
-	  it "should find WatirCraft" do
-	    browser.text_field(:name, 'q').set 'WatirCraft'
-	    browser.button(:name, 'btnG').click
-	    browser.text.should include('Test automation for web applications')
-	  end
-	  
-	end
-
-Use the +rake+ command to run the tests for your project(only one so far). 
-This needs to be run from the base of your project.
-
-  > rake spec
-
-By default, your test runs with Internet Explorer, but you can also run it
-with Firefox.
-
-  > rake spec BROWSER=firefox
-
-You can also just run individual files.
-
-  > ruby test/specs/search_spec.rb
-  
-Note that many editors will do this automatically for you. For example the
-Scite editor will do this when you hit "F5".
 
 == EXAMPLE
 

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
 :minor: 4
-:patch: 4
+:patch: 5
 :major: 0

data/app_generators/watircraft/templates/readme.txt

@@ -3,7 +3,7 @@ How to create a WatirCraft Project
 ==================================
 
  1. DONE - Run the WatirCraft command: watircraft projectname
- 2. Edit config/config.yml to include the base url of your application.
+ 2. Edit config/environments.yml to include the base url of your application.
  3. CD into your new project directory. All of the following commands assume 
     that your current directory is the base of your project. 
 

data/app_generators/watircraft/templates/site.rb.erb

@@ -6,5 +6,10 @@ module <%= site.camelize %>
 
   class <%= site.camelize %> < ::Taza::Site
 
+    # Sets @browser to be a browser initialized for testing your site.	
+    def initialize_browser
+      super # configure the browser based on the configuration settings
+    end
+
   end
 end

data/lib/taza/site.rb

@@ -1,6 +1,7 @@
 require 'rubygems'
 require 'activesupport'
 require 'taza/settings'
+require 'spec/matchers'
 
 module Taza
   # An abstraction of a website, but more really a container for a sites pages.
@@ -43,6 +44,8 @@ module Taza
       end
 
     end
+    include Spec::Matchers
+
     
     @@before_browser_closes = Proc.new() {}
     # Use this to do something with the browser before it closes, but note that it is a class method which
@@ -157,6 +160,7 @@ module Taza
     
     def initialize_context!(context)
       context.extend @methods_module
+      context.extend Spec::Matchers
       context.site = @site
       context.browser = @site.browser
       context

data/lib/watircraft/version.rb

@@ -1,3 +1,3 @@
 # This file is autogenerated. Do not edit.
 # Use 'rake version.rb' to update.
-module WatirCraft; VERSION = '0.4.4'; end
+module WatirCraft; VERSION = '0.4.5'; end

data/spec/site_spec.rb

@@ -87,6 +87,10 @@ describe do
     it "should list the site's pages" do
       @context.pages.should == ["bar_page", "partial_the_reckoning"]
     end
+    
+    it "should provide Spec::Matchers" do
+      @context.instance_eval { [1,2,3].should include(2) }
+    end
   end
     
   describe Taza::Site do
@@ -227,6 +231,17 @@ describe do
       Taza::Settings.expects(:environment_settings).returns({:url => 'http://www.zoro.com'}).at_least_once
       @site.origin.should == 'http://www.zoro.com'
     end
+
+    it "should call the initialize method" do
+      
+      class SubClass < Taza::Site
+        def initialize_browser
+          @browser = 'provided'
+        end
+      end
+      
+      SubClass.new.browser.should == 'provided'
+    end
         
   end
   
@@ -247,23 +262,4 @@ describe do
     end
   end
   
-  describe Taza::Site do
-    it_should_behave_like "an execution context"
-    before do
-      @context = @site
-    end
-
-    it "should call the initialize method" do
-      
-      class SubClass < Taza::Site
-        def initialize_browser
-          @browser = 'provided'
-        end
-      end
-      
-      SubClass.new.browser.should == 'provided'
-    end
-    
-    
-  end
 end

data/watircraft.gemspec

@@ -2,11 +2,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{watircraft}
-  s.version = "0.4.4"
+  s.version = "0.4.5"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Bret Pettichord", "Jim Matthews", "Charley Baker", "Adam Anderson"]
-  s.date = %q{2009-04-03}
+  s.date = %q{2009-04-07}
   s.default_executable = %q{watircraft}
   s.description = %q{WatirCraft is a framework for testing web apps.}
   s.email = %q{bret@pettichord.com}
@@ -14,9 +14,10 @@ Gem::Specification.new do |s|
   s.extra_rdoc_files = ["History.txt", "README.rdoc"]
   s.files = ["History.txt", "Manifest.txt", "README.rdoc", "VERSION.yml", "watircraft.gemspec", "bin/watircraft", "lib/extensions", "lib/extensions/array.rb", "lib/extensions/hash.rb", "lib/extensions/object.rb", "lib/extensions/string.rb", "lib/extensions/watir.rb", "lib/taza", "lib/taza/browser.rb", "lib/taza/entity.rb", "lib/taza/fixture.rb", "lib/taza/flow.rb", "lib/taza/page.rb", "lib/taza/settings.rb", "lib/taza/site.rb", "lib/taza/tasks.rb", "lib/taza.rb", "lib/watircraft", "lib/watircraft/generator_helper.rb", "lib/watircraft/table.rb", "lib/watircraft/version.rb", "lib/watircraft.rb", "spec/array_spec.rb", "spec/browser_spec.rb", "spec/entity_spec.rb", "spec/fake_table.rb", "spec/fixtures_spec.rb", "spec/fixture_spec.rb", "spec/hash_spec.rb", "spec/object_spec.rb", "spec/page_generator_spec.rb", "spec/page_spec.rb", "spec/project_generator_spec.rb", "spec/sandbox", "spec/sandbox/config", "spec/sandbox/config/config.yml", "spec/sandbox/config/environments.yml", "spec/sandbox/config/simpler.yml", "spec/sandbox/config/simpler_site.yml", "spec/sandbox/config.yml", "spec/sandbox/fixtures", "spec/sandbox/fixtures/examples.yml", "spec/sandbox/fixtures/users.yml", "spec/sandbox/flows", "spec/sandbox/flows/batman.rb", "spec/sandbox/flows/robin.rb", "spec/sandbox/pages", "spec/sandbox/pages/foo", "spec/sandbox/pages/foo/bar_page.rb", "spec/sandbox/pages/foo/partials", "spec/sandbox/pages/foo/partials/partial_the_reckoning.rb", "spec/settings_spec.rb", "spec/site_spec.rb", "spec/spec_generator_helper.rb", "spec/spec_generator_spec.rb", "spec/spec_helper.rb", "spec/steps_generator_spec.rb", "spec/string_spec.rb", "spec/table_spec.rb", "spec/taza_spec.rb", "spec/watircraft_bin_spec.rb", "spec/watir_spec.rb", "app_generators/watircraft", "app_generators/watircraft/templates", "app_generators/watircraft/templates/config.yml.erb", "app_generators/watircraft/templates/environments.yml.erb", "app_generators/watircraft/templates/feature_helper.rb", "app_generators/watircraft/templates/initialize.rb.erb", "app_generators/watircraft/templates/rakefile.rb", "app_generators/watircraft/templates/readme.txt", "app_generators/watircraft/templates/script", "app_generators/watircraft/templates/script/console", "app_generators/watircraft/templates/script/console.cmd", "app_generators/watircraft/templates/site.rb.erb", "app_generators/watircraft/templates/site_start.rb.erb", "app_generators/watircraft/templates/spec_helper.rb", "app_generators/watircraft/templates/spec_initialize.rb", "app_generators/watircraft/templates/world.rb", "app_generators/watircraft/USAGE", "app_generators/watircraft/watircraft_generator.rb", "watircraft_generators/page", "watircraft_generators/page/page_generator.rb", "watircraft_generators/page/templates", "watircraft_generators/page/templates/page.rb.erb", "watircraft_generators/page/USAGE", "watircraft_generators/spec", "watircraft_generators/spec/spec_generator.rb", "watircraft_generators/spec/templates", "watircraft_generators/spec/templates/spec.rb.erb", "watircraft_generators/spec/USAGE", "watircraft_generators/steps", "watircraft_generators/steps/steps_generator.rb", "watircraft_generators/steps/templates", "watircraft_generators/steps/templates/steps.rb.erb", "watircraft_generators/steps/USAGE"]
   s.has_rdoc = true
-  s.homepage = %q{http://github.com/bret/watircraft/tree/master}
+  s.homepage = %q{http://wiki.github.com/bret/watircraft}
   s.rdoc_options = ["--main", "README.rdoc"]
   s.require_paths = ["lib"]
+  s.requirements = ["watir(ie) and/or firewatir 1.6.2 or newer"]
   s.rubyforge_project = %q{watir}
   s.rubygems_version = %q{1.3.1}
   s.summary = %q{WatirCraft is a framework for testing web apps.}
@@ -30,22 +31,22 @@ Gem::Specification.new do |s|
       s.add_runtime_dependency(%q<rake>, [">= 0.8.3"])
       s.add_runtime_dependency(%q<mocha>, [">= 0.9.3"])
       s.add_runtime_dependency(%q<rubigen>, [">= 1.4.0"])
-      s.add_runtime_dependency(%q<rspec>, ["= 1.1.12"])
-      s.add_runtime_dependency(%q<cucumber>, ["= 0.1.16"])
+      s.add_runtime_dependency(%q<rspec>, [">= 1.1.12"])
+      s.add_runtime_dependency(%q<cucumber>, [">= 0.1.16"])
     else
       s.add_dependency(%q<taglob>, [">= 1.1.1"])
       s.add_dependency(%q<rake>, [">= 0.8.3"])
       s.add_dependency(%q<mocha>, [">= 0.9.3"])
       s.add_dependency(%q<rubigen>, [">= 1.4.0"])
-      s.add_dependency(%q<rspec>, ["= 1.1.12"])
-      s.add_dependency(%q<cucumber>, ["= 0.1.16"])
+      s.add_dependency(%q<rspec>, [">= 1.1.12"])
+      s.add_dependency(%q<cucumber>, [">= 0.1.16"])
     end
   else
     s.add_dependency(%q<taglob>, [">= 1.1.1"])
     s.add_dependency(%q<rake>, [">= 0.8.3"])
     s.add_dependency(%q<mocha>, [">= 0.9.3"])
     s.add_dependency(%q<rubigen>, [">= 1.4.0"])
-    s.add_dependency(%q<rspec>, ["= 1.1.12"])
-    s.add_dependency(%q<cucumber>, ["= 0.1.16"])
+    s.add_dependency(%q<rspec>, [">= 1.1.12"])
+    s.add_dependency(%q<cucumber>, [">= 0.1.16"])
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: bret-watircraft
 version: !ruby/object:Gem::Version 
-  version: 0.4.4
+  version: 0.4.5
 platform: ruby
 authors: 
 - Bret Pettichord
@@ -12,7 +12,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-04-03 00:00:00 -07:00
+date: 2009-04-07 00:00:00 -07:00
 default_executable: watircraft
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -61,7 +61,7 @@ dependencies:
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
-    - - "="
+    - - ">="
       - !ruby/object:Gem::Version 
         version: 1.1.12
     version: 
@@ -71,7 +71,7 @@ dependencies:
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
-    - - "="
+    - - ">="
       - !ruby/object:Gem::Version 
         version: 0.1.16
     version: 
@@ -186,7 +186,7 @@ files:
 - watircraft_generators/steps/templates/steps.rb.erb
 - watircraft_generators/steps/USAGE
 has_rdoc: true
-homepage: http://github.com/bret/watircraft/tree/master
+homepage: http://wiki.github.com/bret/watircraft
 post_install_message: 
 rdoc_options: 
 - --main
@@ -205,8 +205,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version 
       version: "0"
   version: 
-requirements: []
-
+requirements: 
+- watir(ie) and/or firewatir 1.6.2 or newer
 rubyforge_project: watir
 rubygems_version: 1.2.0
 signing_key: