scudco-taza 0.8.1

data/History.txt

@@ -0,0 +1,44 @@
+=== 0.8.1 / 2008-12-20
+
+* Added Partials
+* Added Preliminary Fixture Support
+
+=== 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
+
+Not all web applications can be written in Ruby, unfortunately. When you aren't testing an application that was written with testing in mind Taza can provide a structured and opionated way to do browser-based testing.
+
+* Sites have Pages
+* Sites have Flows that move through Pages
+* Pages have elements and filters to define simple ways of interacting with them
+* Pages have tests/specs that help chip away at the dreaded 0% Coverage Beast™
+
+* Features
+  * Generate a Taza project easily
+  * Generate Sites, Pages, and Flows using a familiar format(./script/generate)
+  * Automatically generate specs when generating a site to push you
+  * Easily switch browser and/or driver
+  * Automatic opening and cleanup of browser
+  * Included rake spec commands generated for sites and pages
+  * Rake spec commands will create an RSpec HTML report by default
+  * Easily tie-in special functionality like getting a DOM dump of each browser before it closes
+
+* Todo
+  0.8.x
+    * Add a taza_example to easily generate a fully-functional example of how a taza project might look
+    * Provide more documentation
+  0.9
+    * Add more thorough Selenium support
+    * Easily allow overwriting of spec options for included rake tasks
+    * Provide better conventions around cross-site testing
+  1.0
+    * Using Selenium with WATIR syntax(Easily switch between Selenium and WATIR without having to change any Page code)
+    * Provide more advanced documentation
+
+=== 0.5.0 / 2008-10-03
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,61 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/taza
+generators/flow/flow_generator.rb
+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
+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
+lib/taza/flow.rb
+lib/taza/page.rb
+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
+spec/sandbox/config.yml
+spec/sandbox/config/config.yml
+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
+spec/spec_helper.rb
+spec/taza_bin_spec.rb
+spec/taza_spec.rb
+spec/taza_tasks_spec.rb
+spec/unit_helper_spec.rb

data/README

@@ -0,0 +1,79 @@
+= taza
+
+* http://github.com/scudco/taza/tree/master 
+
+== DESCRIPTION:
+
+Taza is meant to make acceptance testing more sane for developers(or QA where applicable) and customers.
+
+== FEATURES:
+
+* Generate a project for browser-based testing
+* Generate pages and sites for different applications
+* Create flows that move through a site
+* Use filters to control which elements are accessible on a page depending on its state
+* Taza automatically creates and cleans up the browser for each site just like a File block
+* Manage tests by tags
+* Cross-site testing
+
+== ISSUES:
+
+* Taza has only been used in the wild with WATIR(Safari/Firefox/IE), but Selenium support is built-in
+* Taza's generators currently generate RSpec specs, Test::Unit and other test framework support is planned
+
+== SYNOPSIS:
+
+Taza is meant to be a refreshing way to look at browser testing. Taza provides a few ways to abstract browser-based testing into three simple ideas.
+  * Sites
+  * Pages
+  * Flows
+
+Sites have Pages.
+Pages have elements and filters.
+Flows are common actions on a site such as logging in or performing a search.
+
+Here's an example for starting a project around the Google sites
+
+  $ taza google
+  $ cd google/
+  $ ./script/generate site google
+  $ ./script/generate page home_page google
+  $ ./script/generate flow search google
+  $ rake spec:functional:google
+
+That will generate an RSpec HTML report at artifacts/functional/google/index.html
+
+
+== REQUIREMENTS:
+
+* taglob 
+
+== INSTALL:
+
+* sudo gem install taza 
+* gem install taza
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Charley Baker
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.textile

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

data/VERSION.yml

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

data/bin/taza

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'rubigen'
+
+if %w(-v --version).include? ARGV.first
+  require 'taza'
+  puts "#{File.basename($0)} #{Taza::VERSION}"
+  exit(0)
+end
+
+require 'rubigen/scripts/generate'
+source = RubiGen::PathSource.new(:application, 
+  File.join(File.dirname(__FILE__), "../lib/app_generators"))
+RubiGen::Base.reset_sources
+RubiGen::Base.append_sources source
+RubiGen::Scripts::Generate.new.run(ARGV, :generator => 'taza')

data/generators/flow/flow_generator.rb

@@ -0,0 +1,57 @@
+require 'rubygems'
+require 'rubigen'
+require 'activesupport'
+
+class FlowGenerator < 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 "flow.rb.erb", File.join('lib','sites', site_name.underscore, "flows",  "#{name.underscore}.rb")
+    end
+  end
+
+  protected
+  def banner
+    <<-EOS
+    Creates a taza flow for a given taza site, site you are making a flow for must exist first.
+
+    USAGE: #{$0} #{spec.name} flow_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/flow/templates/flow.rb.erb

@@ -0,0 +1,9 @@
+require 'rubygems'
+
+module <%= site_name.camelize %>
+  class <%= site_name.camelize %> < ::Taza::Site
+    def <%= name.underscore %>_flow(params={})
+      
+    end
+  end
+end

data/generators/page/page_generator.rb

@@ -0,0 +1,58 @@
+require 'rubygems'
+require 'rubigen'
+require 'activesupport'
+
+class PageGenerator < 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 "page.rb.erb", File.join('lib','sites', site_name.underscore, "pages",  "#{name.underscore}_page.rb")
+      m.template "functional_page_spec.rb.erb", File.join('spec','functional',site_name.underscore,"#{name.underscore}_page_spec.rb")
+    end
+  end
+
+  protected
+  def banner
+    <<-EOS
+    Creates a taza page for a given taza site, site you are making a page for must exist first.
+
+    USAGE: #{$0} #{spec.name} page_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/page/templates/functional_page_spec.rb.erb

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

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

@@ -0,0 +1,8 @@
+require 'rubygems'
+require 'taza/page'
+
+module <%= site_name.camelize %>
+  class <%= name.camelize %>Page < ::Taza::Page
+
+  end
+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

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'rubigen'
+require 'activesupport'
+
+class SiteGenerator < RubiGen::Base
+  default_options :author => nil
+  attr_reader :name
+
+  def initialize(runtime_args, runtime_options = {})
+    super
+    usage if args.empty?
+    @name = args.shift
+    extract_options
+  end
+
+  def manifest
+    record do |m|
+      site_path = File.join('lib','sites')
+      m.template "site.rb.erb", File.join(site_path,"#{name.underscore}.rb")
+      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
+  end
+
+  protected
+  def banner
+    <<-EOS
+    Creates a taza site.
+
+    USAGE: #{$0} #{spec.name} 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