test-factory 0.1.5 → 0.1.6

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    test-factory (0.1.5)
+    test-factory (0.1.6)
       watir-webdriver (>= 0.6.1)
 
 GEM

data/lib/test-factory/foundry.rb

@@ -20,7 +20,7 @@ module Foundry
     block.call @current_page if block
     @current_page
   end
-  alias on_page on
+  alias_method :on_page, :on
 
   # Use this for making a data object in your test steps
   #
@@ -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/lib/test-factory/gem_ext.rb

@@ -14,17 +14,89 @@
 # Proper use of the #fit method requires following a particular coding
 # pattern, however:
 #
-# 1) In your Page Classes, define your radio buttons and checkboxes
-#    directly. Do not define #set and/or #clear actions there.
-# 2) Your data object's instance variables for radio buttons and
-#    checkboxes should have the values of :set or :clear. If they NEED to be
-#    something else, then define a Hash transform method to easily
-#    convert the custom values back to :set or :clear, then pass that
-#    transform to the #fit method.
-# 3) Always remember to end your #edit methods with the #set_options()
-#    method, from the DataFactory module. It automatically takes care
-#    of updating your data object's instance variables with any
-#    new values.
+# 1. In your Page Classes, define your radio buttons and checkboxes
+# directly. Do not define #set and/or #clear actions there.
+# 2. Your data object's instance variables for radio buttons and
+# checkboxes should have the values of +:set+ or +:clear+. If they *need* to be
+# something else, then define a Hash transform method to easily
+# convert the custom values back to +:set+ or +:clear+, then pass that
+# transform to the #fit method.
+# 3. Always remember to end your #edit methods with the #set_options()
+# method, from the DataFactory module. It automatically takes care
+# of updating your data object's instance variables with any
+# new values.
+#
+# ==Example
+#
+# Let's take a look at how the proper use of #fit in your code can significantly
+# clean things up.
+#
+# First, here's some code written without using #fit, and using
+# actions for the checkbox page objects, and a Data Object
+# instance variable that is either "YES" or "NO"...
+#
+#   class MyPage < BasePage
+#     # ...
+#     action(:check_checkbox) { |b| b.checkbox(id: "checkbox").set }
+#     action(:clear_checkbox) { |b| b.checkbox(id: "checkbox").clear }
+#     # ...
+#   end
+#
+#   class DataObject
+#     # ...
+#     def edit opts={}
+#       # ...
+#       if opts[:option] != @option
+#         on MyPage do |page|
+#           if opts[:option] == "NO"
+#             page.clear_checkbox
+#           else
+#             page.check_checkbox
+#           end
+#         end
+#         @option = opts[:option]
+#       end
+#       # ...
+#     end
+#     # ...
+#   end
+#
+# Now, let's take that same code, but this time use the #fit method, set up
+# the data object's instance variable correctly as +:set+ or +:clear+, and
+# end the #edit with #set_options ...
+#
+#   class MyPage < BasePage
+#     # ...
+#     element(:checkbox) { |b| b.checkbox(id: "checkbox") }
+#     # ...
+#   end
+#
+#   class DataObject
+#     # ...
+#     def edit opts={}
+#       # ...
+#       on MyPage do |page|
+#         # ...
+#         page.checkbox.fit opts[:option]
+#         # ...
+#       end
+#       # ...
+#       update_options opts
+#     end
+#     # ...
+#   end
+#
+# If you absolutely _must_ have your data object's instance variable be something
+# other than +:set+ or +:clear+, then consider writing private a "transform" method
+# in your data object class, like this:
+#
+#   def checkbox_trans
+#     { "YES" => :set, "NO" => :clear }
+#   end
+#
+# Then use that transform with your #fit method, like this:
+#
+#   page.checkbox.fit checkbox_trans[opts[:option]]
 #
 module Watir
   module UserEditable

data/test-factory.gemspec

@@ -1,6 +1,6 @@
 spec = Gem::Specification.new do |s|
   s.name = 'test-factory'
-  s.version = '0.1.5'
+  s.version = '0.1.6'
   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.5
+  version: 0.1.6
   prerelease: 
 platform: ruby
 authors: