bret-watircraft 0.4.2 → 0.4.3

data/BUGS.txt

@@ -1,9 +1,6 @@
 Known Bugs
 
 * Can't install on mac. (This used to work.)
-* The name of the element underlying each field is not consistent. In pages,
-  it is called foo_field; in tables, foo_element. (Should probably be
-  foo_element in both places.)
 * Page fields do not support Radio lists. Workaround: use elements.
-* Need to provide homepage for project.
+
   

data/History.txt

@@ -1,3 +1,28 @@
+=== 0.4.3 / 2009-03-31
+
+Bug Fixes
+
+* WatirCraft can now be installed on a Mac (again).
+* Page#url now returns the full url of the page.
+
+Table Fixes
+
+* Field elements/fields can now reference current row as "row", consistent
+  with page elements/fields being referencing browser as "browser".
+  (Previously you had to use @row, which still works.)
+* Element names of table fields are now named x_field, consistent with page
+  fields. (Previously was x_element.)
+* Fields that aren't found for some rows will no longer cause errors
+  when used as accessors.  
+  
+Readme Updates
+
+* Update install instructions.
+* Add Google example.
+* Update feature list.
+* Add additional information (feedback, mailing list, WatirCraft LLC)
+* Identify Github/readme as homepage for project.
+
 === 0.4.2 / 2009-03-24
 
 * Fixed "can't find site generator" bug that occured when creating a new project.

data/README.rdoc

@@ -14,7 +14,10 @@ a place to put things.
 * Generates a directory structure for your test suite with one command.
 * Provides page adapters you can customize for your application.
 * Configure application URL and browser type (IE, Firefox) in one location.
-* Framework automatically initializes browser for testing.
+* 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
 
@@ -30,19 +33,111 @@ get the benefit.
 
 == INSTALL
 
-  gem update --system
-  gem install watircraft
+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
+  
+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
 
 An example test suite for this framework can be found in the framework 
-examples project on github. Look in the watircraft directory.
-* http://github.com/bret/framework-examples/
+examples project on github. Look in the +watircraft+ directory.
+* http://github.com/bret/framework-examples
+
+== QUESTIONS AND FEEDBACK
+
+Join our mailing list for WatirCraft users.
+* http://tech.groups.yahoo.com/group/watir-framework
 
-== ORIGIN
+The WatirCraft framework is developed by WatirCraft LLC, based on Taza[http://github.com/scudco/taza/wikis]. 
+Please send bug reports, feature requests and other comments to us at feedback@watircraft.com[mailto:feedback@watircraft.com]
 
-WatirCraft is based on the Taza framework. 
-* http://github.com/scudco/taza/wikis
+WatirCraft LLC provides training and consulting for Watir, Ruby and the 
+WatirCraft framework. 
+* http://www.watircraft.com
 
 == LICENSE
 

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
-:minor: 4
-:patch: 2
+:patch: 3
 :major: 0
+:minor: 4

data/app_generators/watircraft/templates/world.rb

@@ -1,6 +1,7 @@
 # This file is autogenerated. Do not edit this file.
 # It may be replaced when you upgrade to new versions of watircraft.
 
+require 'rubygems'
 require 'spec'
 require 'cucumber'
 

data/lib/taza/page.rb

@@ -197,6 +197,7 @@ module Taza
     def full_url
       File.join(@site.origin, self.class.url)
     end
+    alias :url :full_url
     
     # Enter values into fields on the page using a hash, using the key of
     # each pair to name the field.

data/lib/watircraft/table.rb

@@ -19,8 +19,9 @@ module WatirCraft
         wrapped = self.class.row_class.new row
         # note: we are only looking at the first key/value
         method = selector.keys[0]
-        value = selector[method]
-        return wrapped if wrapped.send(method) == value
+        target_value = selector[method]
+        row_value = wrapped.send(method) rescue next
+        return wrapped if row_value == target_value
       end
       nil
     end
@@ -34,7 +35,7 @@ module WatirCraft
         end
       end
       def field name, &block
-        element_name = "#{name}_element"
+        element_name = "#{name}_field"
         element element_name, &block
         define_method(name) do
           send(element_name).display_value
@@ -44,6 +45,7 @@ module WatirCraft
         end
       end
     end
+    attr_reader :row
     def initialize watir_row
       @row = watir_row
     end

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.2'; end
+module WatirCraft; VERSION = '0.4.3'; end

data/spec/page_spec.rb

@@ -119,6 +119,7 @@ describe Taza::Page do
     page = CheckOutPage.new
     page.site = Class.new(Taza::Site).new(:browser => browser)
     page.full_url.should == 'http://www.llamas.com/check_out'
+    page.url.should == page.full_url
   end
     
   it "should create elements for fields" do    
@@ -289,8 +290,9 @@ describe Taza::Page do
       @page_class.class_eval do
         element(:results_table) {fake_table}
         table(:results) do
-          field(:name){@row.element(:letter)}
-          field(:phone){@row.element(:number)}
+          field(:name){row.element(:letter)}
+          field(:phone){row.element(:number)}
+          field(:missing){raise 'not found'}
         end
       end
       @table_page = @page_class.new
@@ -305,7 +307,7 @@ describe Taza::Page do
     
     it "fields should have underlying elements" do
       uses_table_page
-      @table_page.results.row(:name => 'x').phone_element.should exist
+      @table_page.results.row(:name => 'x').phone_field.should exist
     end
     
     it "should have elements" do
@@ -316,8 +318,8 @@ describe Taza::Page do
           ]
         end
         table(:results) do
-          field(:name){@row.element(:letter)}
-          element(:phone){@row.element(:number)}
+          field(:name){row.element(:letter)}
+          element(:phone){row.element(:number)}
         end
       end
       @table_page = @page_class.new
@@ -335,7 +337,10 @@ describe Taza::Page do
       @table_page.results.row(:name => 'x').should exist
     end
         
-
+    it "should not raise an exception if a field isn't found" do
+      uses_table_page
+      @table_page.results.row(:missing => 'nada').should be_nil
+    end
   
   end
   

data/spec/watir_spec.rb

@@ -1,36 +1,39 @@
-require 'spec/spec_helper'
-require 'watir'
-require 'watir/ie'
-require 'firewatir'
-require 'extensions/watir'
-
-describe 'Watir Extensions' do
-  share_examples_for 'extended watir' do
-    def should_provide_display_value_method_for_class klass
-      container = stub()
-      container.stubs(:page_container)
-      element = klass.new container, :index, 1
-      element.method(:display_value) # should be defined
-    end
-    
-    specify { should_provide_display_value_method_for_class @module::TextField }
-    specify { should_provide_display_value_method_for_class @module::NonControlElement}
-    specify { should_provide_display_value_method_for_class @module::H3 }
-  end
-
-  describe "IE Watir" do
-    it_should_behave_like 'extended watir'
-    Watir.add_display_value_methods_to Watir
-    before do
-      @module = Watir
-    end
-  end
-  
-  describe "Fire Watir" do
-    it_should_behave_like 'extended watir'
-    Watir.add_display_value_methods_to FireWatir
-    before do
-      @module = FireWatir
-    end
-  end
-end
+
+require 'spec/spec_helper'
+require 'watir'
+require 'firewatir'
+require 'extensions/watir'
+
+describe 'Watir Extensions' do
+  share_examples_for 'extended watir' do
+    def should_provide_display_value_method_for_class klass
+      container = stub()
+      container.stubs(:page_container)
+      element = klass.new container, :index, 1
+      element.method(:display_value) # should be defined
+    end
+    
+    specify { should_provide_display_value_method_for_class @module::TextField }
+    specify { should_provide_display_value_method_for_class @module::NonControlElement}
+    specify { should_provide_display_value_method_for_class @module::H3 }
+  end
+
+  if PLATFORM =~ /mswin/  
+    describe "IE Watir" do
+      require 'watir/ie'
+      it_should_behave_like 'extended watir'
+      Watir.add_display_value_methods_to Watir
+      before do
+        @module = Watir
+      end
+    end
+  end
+  
+  describe "Fire Watir" do
+    it_should_behave_like 'extended watir'
+    Watir.add_display_value_methods_to FireWatir
+    before do
+      @module = FireWatir
+    end
+  end
+end

data/watircraft.gemspec

@@ -2,30 +2,30 @@
 
 Gem::Specification.new do |s|
   s.name = %q{watircraft}
-  s.version = "0.4.2"
+  s.version = "0.4.3"
 
   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-03-24}
+  s.date = %q{2009-03-31}
   s.default_executable = %q{watircraft}
-  s.description = %q{WatirCraft is a framework for web testing.}
+  s.description = %q{WatirCraft is a framework for testing web apps.}
   s.email = %q{bret@pettichord.com}
   s.executables = ["watircraft"]
   s.extra_rdoc_files = ["History.txt", "README.rdoc"]
   s.files = ["BUGS.txt", "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/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.rdoc_options = ["--main", "README.rdoc"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{watir}
   s.rubygems_version = %q{1.3.1}
-  s.summary = %q{WatirCraft is a framework for web testing.}
+  s.summary = %q{WatirCraft is a framework for testing web apps.}
 
   if s.respond_to? :specification_version then
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 2
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<watir>, [">= 1.6.2"])
       s.add_runtime_dependency(%q<taglob>, [">= 1.1.1"])
       s.add_runtime_dependency(%q<rake>, [">= 0.8.3"])
       s.add_runtime_dependency(%q<mocha>, [">= 0.9.3"])
@@ -33,7 +33,6 @@ Gem::Specification.new do |s|
       s.add_runtime_dependency(%q<rspec>, ["= 1.1.12"])
       s.add_runtime_dependency(%q<cucumber>, ["= 0.1.16"])
     else
-      s.add_dependency(%q<watir>, [">= 1.6.2"])
       s.add_dependency(%q<taglob>, [">= 1.1.1"])
       s.add_dependency(%q<rake>, [">= 0.8.3"])
       s.add_dependency(%q<mocha>, [">= 0.9.3"])
@@ -42,7 +41,6 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<cucumber>, ["= 0.1.16"])
     end
   else
-    s.add_dependency(%q<watir>, [">= 1.6.2"])
     s.add_dependency(%q<taglob>, [">= 1.1.1"])
     s.add_dependency(%q<rake>, [">= 0.8.3"])
     s.add_dependency(%q<mocha>, [">= 0.9.3"])

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: bret-watircraft
 version: !ruby/object:Gem::Version 
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors: 
 - Bret Pettichord
@@ -12,19 +12,9 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-03-24 00:00:00 -07:00
+date: 2009-03-31 00:00:00 -07:00
 default_executable: watircraft
 dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: watir
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.6.2
-    version: 
 - !ruby/object:Gem::Dependency 
   name: taglob
   type: :runtime
@@ -85,7 +75,7 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 0.1.16
     version: 
-description: WatirCraft is a framework for web testing.
+description: WatirCraft is a framework for testing web apps.
 email: bret@pettichord.com
 executables: 
 - watircraft
@@ -196,7 +186,7 @@ files:
 - watircraft_generators/steps/templates/steps.rb.erb
 - watircraft_generators/steps/USAGE
 has_rdoc: true
-homepage: 
+homepage: http://github.com/bret/watircraft/tree/master
 post_install_message: 
 rdoc_options: 
 - --main
@@ -221,6 +211,6 @@ rubyforge_project: watir
 rubygems_version: 1.2.0
 signing_key: 
 specification_version: 2
-summary: WatirCraft is a framework for web testing.
+summary: WatirCraft is a framework for testing web apps.
 test_files: []