taza 0.8.0 → 0.8.2

data/History.txt

@@ -1,3 +1,10 @@
+=== 0.8.2 / 2009-01-11
+
+* Added Partials
+* Added Preliminary Fixture Support
+* Fixed horrible infinite loop bug in Filters
+* Added Configurability to a Taza projects Rakefile
+
 === 0.8.0 / 2008-11-23
 
 Taza is a web application testing framework meant to be used with browsed-based testing libraries like WATIR or Selenium

data/Manifest.txt

@@ -8,6 +8,8 @@ generators/flow/templates/flow.rb.erb
 generators/page/page_generator.rb
 generators/page/templates/functional_page_spec.rb.erb
 generators/page/templates/page.rb.erb
+generators/partial/partial_generator.rb
+generators/partial/templates/partial.rb.erb
 generators/site/site_generator.rb
 generators/site/templates/site.rb.erb
 generators/site/templates/site.yml.erb
@@ -15,7 +17,13 @@ lib/app_generators/taza/taza_generator.rb
 lib/app_generators/taza/templates/config.yml.erb
 lib/app_generators/taza/templates/rakefile.rb.erb
 lib/app_generators/taza/templates/spec_helper.rb.erb
+lib/extensions/object.rb
+lib/extensions/string.rb
+lib/extensions/hash.rb
+lib/extensions/array.rb
 lib/taza.rb
+lib/taza/fixture.rb
+lib/taza/entity.rb
 lib/taza/browser.rb
 lib/taza/browsers/ie_watir.rb
 lib/taza/browsers/safari_watir.rb
@@ -25,9 +33,14 @@ lib/taza/settings.rb
 lib/taza/site.rb
 lib/taza/tasks.rb
 spec/browser_spec.rb
+spec/entity_spec.rb
 spec/flow_generator_spec.rb
+spec/fixture_spec.rb
+spec/fixtures_spec.rb
+spec/object_spec.rb
 spec/page_generator_spec.rb
 spec/page_spec.rb
+spec/partial_generator_spec.rb
 spec/platform/osx/browser_spec.rb
 spec/platform/windows/browser_spec.rb
 spec/project_generator_spec.rb
@@ -37,6 +50,7 @@ spec/sandbox/config/site_name.yml
 spec/sandbox/flows/batman.rb
 spec/sandbox/flows/robin.rb
 spec/sandbox/pages/foo/bar.rb
+spec/sandbox/pages/foo/partials/partial_the_reckoning.rb
 spec/settings_spec.rb
 spec/site_generator_spec.rb
 spec/site_spec.rb

data/README.textile

@@ -0,0 +1 @@
+"Taza Wiki":http://github.com/scudco/taza/wikis

data/VERSION.yml

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

data/generators/flow/templates/flow.rb.erb

@@ -1,11 +1,8 @@
 require 'rubygems'
-require 'taza/flow'
 
 module <%= site_name.camelize %>
-  class <%= name.camelize %> < ::Taza::Flow
-    alias :<%= site_name.underscore %> :site
-
-    def run(params={})
+  class <%= site_name.camelize %> < ::Taza::Site
+    def <%= name.underscore %>_flow(params={})
       
     end
   end

data/generators/page/templates/functional_page_spec.rb.erb

@@ -1,7 +1,7 @@
 require 'spec/spec_helper'
 require '<%= site_name.underscore %>'
 
-describe "<%= name.camelize %>" do
+describe "<%= name.camelize %>Page" do
   it "should fail because you haven't written any tests yet" do
     false.should be_true
   end

data/generators/partial/partial_generator.rb

@@ -0,0 +1,57 @@
+require 'rubygems'
+require 'rubigen'
+require 'activesupport'
+
+class PartialGenerator < RubiGen::Base
+  default_options :author => nil
+  attr_reader :site_name,:name
+
+  def initialize(runtime_args, runtime_options = {})
+    super
+    usage if args.size != 2
+    @name = args.shift
+    @site_name=args.shift
+    check_if_site_exists
+    extract_options
+  end
+
+  def check_if_site_exists
+    unless File.directory?(File.join(destination_root,'lib','sites',site_name.underscore))
+      $stderr.puts "******No such site #{site_name} exists.******"
+      usage
+    end
+  end
+
+  def manifest
+    record do |m|
+      m.template "partial.rb.erb", File.join('lib','sites', site_name.underscore, "pages", "partials",  "#{name.underscore}.rb")
+    end
+  end
+
+  protected
+  def banner
+    <<-EOS
+    Creates a taza partial for a given taza site, site you are making a partial for must exist first.
+
+    USAGE: #{$0} #{spec.name} partial_name site_name
+    EOS
+  end
+
+  def add_options!(opts)
+    # opts.separator ''
+    # opts.separator 'Options:'
+    # For each option below, place the default
+    # at the top of the file next to "default_options"
+    # opts.on("-a", "--author=\"Your Name\"", String,
+    #         "Some comment about this option",
+    #         "Default: none") { |options[:author]| }
+    # opts.on("-v", "--version", "Show the #{File.basename($0)} version number and quit.")
+  end
+
+  def extract_options
+    # for each option, extract it into a local variable (and create an "attr_reader :author" at the top)
+    # Templates can access these value via the attr_reader-generated methods, but not the
+    # raw instance variable value.
+    # @author = options[:author]
+  end
+end

data/generators/partial/templates/partial.rb.erb

@@ -0,0 +1,7 @@
+require 'rubygems'
+
+module <%= site_name.camelize %>
+  class <%= name.camelize %> < ::Taza::Page
+    
+  end
+end

data/generators/site/site_generator.rb

@@ -20,6 +20,7 @@ class SiteGenerator < RubiGen::Base
       m.directory File.join(site_path,"#{name.underscore}")
       m.directory File.join(site_path,("#{name.underscore}"),"flows")
       m.directory File.join(site_path,("#{name.underscore}"),"pages")
+      m.directory File.join(site_path,("#{name.underscore}"),"pages","partials")
       m.directory File.join('spec','functional',name.underscore)
       m.template "site.yml.erb", File.join('config',"#{name.underscore}.yml")
     end

data/lib/app_generators/taza/taza_generator.rb

@@ -17,29 +17,25 @@ class TazaGenerator < RubiGen::Base
   end
 
   def manifest
-    record do |m|
-      # Ensure appropriate folder(s) exists
-      
-      BASEDIRS.each { |path| m.directory path }
-      m.directory File.join('lib','sites')
-      m.directory File.join('lib','flows')
-      m.directory File.join('spec','functional')
-      m.directory File.join('spec','integration')
-      
+    record do |m|    
+      create_directories(m)
       m.template "rakefile.rb.erb", "rakefile"
       m.template "config.yml.erb", File.join("config","config.yml")
       m.template "spec_helper.rb.erb", File.join("spec","spec_helper.rb")
-      
-      # Create stubs
-      # m.template_copy_each ["template.rb", "template2.rb"]
-      # m.file     "file",         "some_file_copied"
-      # m.file_copy_each ["path/to/file", "path/to/file2"]
-
       m.dependency "install_rubigen_scripts", [destination_root, 'taza'],
         :shebang => options[:shebang], :collision => :force
     end
   end
 
+  def create_directories(m)
+    BASEDIRS.each { |path| m.directory path }
+    m.directory File.join('lib','sites')
+    m.directory File.join('lib','flows')
+    m.directory File.join('spec','functional')
+    m.directory File.join('spec','integration')
+    m.directory File.join('spec','story')
+  end
+  
   protected
     def banner
       <<-EOS
@@ -73,4 +69,4 @@ EOS
       script
       spec
     )
-end
+end

data/lib/app_generators/taza/templates/rakefile.rb.erb

@@ -1,3 +1,10 @@
 <%= "#Generated at #{Time.now}" %>
 require 'rubygems'
 require 'taza/tasks'
+
+Taza::Rake::Tasks.new do |t|
+  file_hole = "artifacts/#{Time.now.to_i}"
+  t.spec_opts = ["--format html:#{file_hole}/index.html",
+                  "--format p",
+                  "--format failing_examples:#{file_hole}/failing_examples.txt"]
+end

data/lib/extensions/array.rb

@@ -0,0 +1,10 @@
+class Array
+  # Returns true if the two arrays elements are equal ignoring order
+  # Example:
+  #  [1,2].equivalent([2,1])    # => true
+  #  [1,2,3].equivalent([2,1])  # => false
+  def equivalent?(other_array)
+    merged_array = self & other_array
+    merged_array.size == self.size && merged_array.size == other_array.size
+  end
+end

data/lib/extensions/hash.rb

@@ -0,0 +1,5 @@
+class Hash
+  def convert_hash_keys_to_methods(fixture) # :nodoc:
+    Taza::Entity.new(self,fixture)
+  end
+end

data/lib/extensions/object.rb

@@ -0,0 +1,24 @@
+# instance_exec comes with >1.8.7 thankfully
+if VERSION <= '1.8.6'
+  class Object
+    module InstanceExecHelper; end
+    include InstanceExecHelper
+    # instance_exec method evaluates a block of code relative to the specified object, with parameters whom come from outside the object.
+    def instance_exec(*args, &block)
+      begin
+        old_critical, Thread.critical = Thread.critical, true
+        n = 0
+        n += 1 while respond_to?(mname="__instance_exec#{n}")
+        InstanceExecHelper.module_eval{ define_method(mname, &block) }
+      ensure
+        Thread.critical = old_critical
+      end
+      begin
+        ret = send(mname, *args)
+      ensure
+        InstanceExecHelper.module_eval{ remove_method(mname) } rescue nil
+      end
+      ret
+    end
+  end
+end

data/lib/extensions/string.rb

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'activesupport'
+
+class String
+  # pluralizes a string and turns it into a symbol
+  # Example:
+  #  "apple".pluralize_to_sym    # => :apples
+  def pluralize_to_sym
+    self.pluralize.to_sym
+  end
+end

data/lib/taza.rb

@@ -3,9 +3,15 @@ require 'taza/site'
 require 'taza/browser'
 require 'taza/settings'
 require 'taza/flow'
+require 'taza/entity'
+require 'taza/fixture'
+require 'extensions/object'
+require 'extensions/string'
+require 'extensions/hash'
+require 'extensions/array'
 
 module Taza
-  VERSION = '0.8.0'
+  VERSION = '0.8.1'
 
   def self.windows?
     PLATFORM.include?("mswin")  
@@ -27,26 +33,3 @@ module ForwardInitialization
   end
 end
 
-# instance_exec comes with >1.8.7 thankfully
-if VERSION <= '1.8.6'
-  class Object
-    module InstanceExecHelper; end
-    include InstanceExecHelper
-    def instance_exec(*args, &block)
-      begin
-        old_critical, Thread.critical = Thread.critical, true
-        n = 0
-        n += 1 while respond_to?(mname="__instance_exec#{n}")
-        InstanceExecHelper.module_eval{ define_method(mname, &block) }
-      ensure
-        Thread.critical = old_critical
-      end
-      begin
-        ret = send(mname, *args)
-      ensure
-        InstanceExecHelper.module_eval{ remove_method(mname) } rescue nil
-      end
-      ret
-    end
-  end
-end

data/lib/taza/browser.rb

@@ -1,6 +1,3 @@
-require 'taza/browsers/ie_watir'
-require 'taza/browsers/safari_watir'
-
 module Taza
   class Browser
     
@@ -12,29 +9,25 @@ module Taza
     def self.create(params={})
       self.send("create_#{params[:driver]}".to_sym,params)
     end
-
+    
+    def self.browser_class(params)
+      self.send("#{params[:driver]}_#{params[:browser]}".to_sym)
+    end
 
     private    
 
     def self.create_watir(params)
-      method = "create_watir_#{params[:browser]}"
-      raise BrowserUnsupportedError unless self.respond_to?(method)
-      watir = self.send(method)
-      watir
+      require 'watir'
+      Watir::Browser.default = params[:browser].to_s
+      Watir::Browser.new
     end
 
     def self.create_selenium(params)
       require 'selenium'
       Selenium::SeleniumDriver.new(params[:server_ip],params[:server_port],'*' + params[:browser].to_s,params[:timeout])
     end
-    
-    def self.create_watir_firefox
-      require 'firewatir'
-      FireWatir::Firefox.new()
-    end
-        
+
   end
+  
 end
 
-class BrowserUnsupportedError < StandardError
-end

data/lib/taza/entity.rb

@@ -0,0 +1,34 @@
+module Taza
+  class Entity
+    #Creates a entity, pass in a hash to be methodized and the fixture to look up other fixtures (not entirely happy with this abstraction)
+    def initialize(hash,fixture)
+      @hash = hash
+      @fixture = fixture
+      define_methods_for_hash_keys
+    end
+    
+    #This method converts hash keys into methods onto the entity
+    def define_methods_for_hash_keys
+      @hash.keys.each do |key|
+        create_method(key) do
+          get_value_for_entry(key)
+        end
+      end
+    end
+
+    #This method will lookup another fixture if a pluralized fixture exists otherwise return the value in the hash
+    def get_value_for_entry(key) # :nodoc:
+      if @fixture.pluralized_fixture_exists?(key)
+        @fixture.get_fixture_entity(key.pluralize_to_sym,@hash[key])
+      else
+        @hash[key]
+      end
+    end
+
+    private
+    def create_method(name, &block) # :nodoc:
+      self.class.send(:define_method, name, &block)
+    end
+
+  end
+end

data/lib/taza/fixture.rb

@@ -0,0 +1,66 @@
+module Taza
+  class Fixture # :nodoc:
+
+    def initialize # :nodoc:
+      @fixtures = {}
+    end
+
+    def load_all # :nodoc:
+      Dir.glob(fixtures_pattern) do |file|
+        entitized_fixture = {}
+        YAML.load_file(file).each do |key, value|
+          entitized_fixture[key] = value.convert_hash_keys_to_methods(self)
+        end
+        @fixtures[File.basename(file,'.yml').to_sym] = entitized_fixture
+      end
+    end
+    
+    def fixture_names # :nodoc:
+      @fixtures.keys
+    end
+    
+    def get_fixture_entity(fixture_file_key,entity_key) # :nodoc:
+      @fixtures[fixture_file_key][entity_key]
+    end
+
+    def pluralized_fixture_exists?(singularized_fixture_name) # :nodoc:
+      fixture_names.include?(singularized_fixture_name.pluralize_to_sym)
+    end
+
+    def fixtures_pattern # :nodoc:
+      File.join(base_path, 'fixtures','*.yml')
+    end
+
+    def base_path # :nodoc:
+      File.join('.','spec')
+    end
+  end
+  
+  # The module that will mixin methods based on the fixture files in your 'spec/fixtures'
+  # 
+  # Example:
+  #   describe "something" do
+  #     it "should test something" do
+  #       users(:jane_smith).first_name.should eql("jane")
+  #     end
+  #   end
+  # 
+  #  where there is a spec/fixtures/users.yml file containing a entry of:
+  # jane_smith:
+  #   first_name: jane
+  #   last_name: smith
+  module Fixtures
+    def Fixtures.included(other_module) # :nodoc:
+      fixture = Fixture.new
+      fixture.load_all
+      fixture.fixture_names.each do |fixture_name|
+        self.class_eval do
+          define_method(fixture_name) do |entity_key|
+            fixture.get_fixture_entity(fixture_name,entity_key.to_s)
+          end
+        end
+      end
+    end
+  end
+
+end