test-factory 0.1.11 → 0.2.0

data/README.md

@@ -206,7 +206,7 @@ follow them probably [smells](http://en.wikipedia.org/wiki/Code_smell), and shou
 
 ```
 
-*  Updates to a data object's instance variables is handled *only* by the `set_options` method, *not* explicitly.
+*  Updates to a data object's instance variables are handled *only* by the `set_options` method, *not* explicitly.
 
 ```ruby
 # This is good

data/lib/test-factory/data_factory.rb

@@ -39,21 +39,44 @@ module DataFactory
 
   # Use this method in your data object class for select list boxes that will have
   # default values you may be interested in. The method will either set the select
-  # box to the value specified, or, if no value exists for the given variable in your
+  # box to the value specified, or, if no value exists for the given instance variable in your
   # data object, it will get the value from the UI and set the data object's
   # variable to that value. Note that this only supports select lists that allow
   # a single selection.
-  # @param var [instance variable] The instance variable that will either be set or be used to update the page
+  # @param inst_var_sym [Symbol] A Symbol that _must_ match the instance variable that will either be set or be used to update the page
   # @param select_list [Watir::Select] The relevant select list element on the page
   #
   # @example
   #
-  #   @num_resubmissions = get_or_set(@num_resubmissions, page.num_resubmissions)
-  def get_or_select(var, select_list)
-    if var==nil
+  #   get_or_select! :@num_resubmissions, page.num_resubmissions
+  def get_or_select!(inst_var_sym, select_list)
+    value = instance_variable_get inst_var_sym
+    if value==nil
+      instance_variable_set inst_var_sym, select_list.selected_options[0].text
+    else
+      select_list.select value
+    end
+  end
+
+  # This method accomplishes the same thing as #get_or_select! but
+  # is used specifically when the instance variable being used/updated
+  # is a Hash. Pay close attention to the syntax differences between
+  # this method and @get_or_select!
+  #
+  # First, note that the returned value of this method must be
+  # passed to the relevant key in the Hash. Note also that unlike
+  # #get_or_select!, this method does not take a symbol representation
+  # of the instance variable.
+  #
+  # @example
+  #
+  #   @open[:day] = get_or_select(@open[:day], page.open_day)
+  def get_or_select(hash_inst_var, select_list)
+    if hash_inst_var==nil
       select_list.selected_options[0].text
     else
-      select_list.select var
+      select_list.select hash_inst_var
+      hash_inst_var
     end
   end
 

data/lib/test-factory/foundry.rb

@@ -36,7 +36,7 @@ module Foundry
   # requires that your data object classes properly follow the design
   # pattern and have a #create method available.
   def create data_object_class, opts={}
-    data_object = make data_object_class, opts={}
+    data_object = make data_object_class, opts
     data_object.create
     data_object
   end

data/test-factory.gemspec

@@ -1,6 +1,6 @@
 spec = Gem::Specification.new do |s|
   s.name = 'test-factory'
-  s.version = '0.1.11'
+  s.version = '0.2.0'
   s.summary = %q{rSmart's framework for creating automated testing scripts}
   s.description = %q{This gem provides a set of modules and methods to help quickly and DRYly create a test automation framework using Ruby and Watir (or watir-webdriver).}
   s.files = Dir.glob("**/**/**")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: test-factory
 version: !ruby/object:Gem::Version
-  version: 0.1.11
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-29 00:00:00.000000000 Z
+date: 2013-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
@@ -47,6 +47,7 @@ files:
 - lib/test-factory/string_factory.rb
 - lib/test-factory.rb
 - README.md
+- test-factory-0.1.11.gem
 - test-factory.gemspec
 homepage: https://github.com/rSmart
 licenses: []