scudco-scudco-spec_ui 0.2.6

data/History.txt

@@ -0,0 +1,6 @@
+=== 0.5.0 / 2008-10-03
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,47 @@
+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/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/taza.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/flow_generator_spec.rb
+spec/page_generator_spec.rb
+spec/page_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/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.txt

@@ -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/Rakefile

@@ -0,0 +1,125 @@
+# -*- ruby -*-
+$:.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+require 'rubygems'
+require 'config/vendorized_gems'
+require 'hoe'
+require 'taza'
+require 'rbconfig'
+require 'spec/rake/spectask'
+require 'spec/rake/verify_rcov'
+require 'rake/rdoctask'
+
+private
+def spec_files
+  return FileList['spec/**/*_spec.rb'].exclude(/spec\/platform\/(?!osx)/) if Taza.osx?
+  return FileList['spec/**/*_spec.rb'].exclude(/spec\/platform\/(?!windows)/) if Taza.windows?
+  return FileList['spec/**/*_spec.rb'].exclude('spec/platform/*')
+end
+public
+
+Hoe.new('taza', Taza::VERSION) do |p|
+  p.rubyforge_name = 'taza' # if different than lowercase project name
+  p.developer('Adam Anderson', 'adamandersonis@gmail.com')
+  p.remote_rdoc_dir = ''
+  p.extra_deps << ['taglob','>= 1.0.0']
+  p.extra_deps << ['rake']
+  p.extra_deps << ['hoe']
+  p.extra_deps << ['mocha','>= 0.9.0']
+  p.extra_deps << ['rspec']
+  p.extra_deps << ['rubigen']
+end
+
+Rake::RDocTask.new do |rdoc|
+  files = ['README.txt', 'History.txt',
+           'lib/**/*.rb', 'doc/**/*.rdoc']
+  rdoc.rdoc_files.add(files)
+  rdoc.main = 'README.txt'
+  rdoc.title = 'Taza RDoc'
+  rdoc.template = './vendor/gems/gems/allison-2.0.3/lib/allison.rb'
+  rdoc.rdoc_dir = 'doc'
+  rdoc.options << '--line-numbers' << '--inline-source'
+end
+
+Spec::Rake::SpecTask.new do |t|
+  t.libs << File.join(File.dirname(__FILE__), 'lib')
+  t.spec_files = spec_files
+end
+
+desc "Run all examples with RCov"
+Spec::Rake::SpecTask.new('rcov') do |t|
+  t.spec_files = spec_files
+  t.libs << File.join(File.dirname(__FILE__), 'lib')
+  t.rcov = true
+  t.rcov_dir = 'artifacts'
+  if Taza.windows?
+    t.rcov_opts = ['--exclude', 'spec,lib/taza/browsers/ie_watir.rb']
+  elsif Taza.osx?
+    t.rcov_opts = ['--exclude', 'spec,lib/taza/browsers/safari_watir.rb']
+  else
+    t.rcov_opts = ['--exclude', 'spec,lib/taza/browsers']
+  end
+end
+
+desc "Generate html reports for specs"
+Spec::Rake::SpecTask.new(:reports) do |t|
+  t.spec_files=FileList['spec/**/*_spec.rb']
+  FileUtils.mkdir('artifacts') unless File.directory?('artifacts')
+  t.spec_opts=["--format html:artifacts/rspec.html"]
+end
+
+desc "Verify Code Coverage is at 99.4%"
+RCov::VerifyTask.new(:verify_rcov => :rcov) do |t|
+  t.threshold = 99.6
+  t.index_html = 'artifacts/index.html'
+end
+
+desc "Run flog against all the files in the lib"
+task :flog do
+  require "flog"
+  flogger = Flog.new
+  flogger.flog_files Dir["lib/**/*.rb"]
+  FileUtils.mkdir('artifacts') unless File.directory?('artifacts')
+  File.open("artifacts/flogreport.txt","w") do |file|
+    flogger.report file
+  end
+end
+ 
+desc "Verify Flog Score is under threshold"
+task :verify_flog => :flog do |t|
+  flog_score_threshold = 40.0
+  messages = []
+  File.readlines("artifacts/flogreport.txt").each do |line|
+    line =~ /^(.*): \((\d+\.\d+)\)/
+    if $2.to_f > flog_score_threshold
+      messages << "Flog score is too high for #{$1}(#{$2})"
+    end
+  end
+  unless messages.empty?
+    puts messages
+    raise "Your Flog score is too high and you ought to think about the children who will have to maintain your code."
+  end
+end
+
+desc "Run saikuro cyclo complexity against the lib"
+task :saikuro do
+  #we can specify options like ignore filters and set warning or error thresholds
+  system "ruby vendor/gems/gems/Saikuro-1.1.0/bin/saikuro -c -t -i lib -y 0 -o artifacts"
+end
+
+namespace :gem do
+  desc "install a gem into vendor/gems"
+  task :install do
+    if ENV["name"].nil?
+      STDERR.puts "Usage: rake gem:install name=the_gem_name"; exit 1
+    end
+    gem = Taza.windows? ? "gem.bat" : "gem"
+    system "#{gem} install #{ENV['name']} --install-dir=vendor/gems  --no-rdoc --no-ri -p ""http://10.8.77.100:8080"""
+  end
+end
+
+desc "Should you check-in?"
+task :quick_build => [:verify_rcov, :verify_flog]
+
+#define a task which uses flog
+# vim: syntax=ruby

data/TODO

@@ -0,0 +1,20 @@
+Already spiked:
++ Tagging test's (resolution: taglob)
++ sites and pages (resolution: Taza::Site)
++ generators for rakefile (resolution: uhh we made one?)
++ running tests by tag (resolution: ???)
++ gem server (resolution: taylor spiked this out)
++ build artifact of a video of a test running (resolution: we have two stories around this now) 
++ test framework choices - what are we going to use and why we are using the one we are (resolution: rspec)
++ accessing the actual browser object (who creates it, who tears it down, etc)
++ block teardown of browser if yield is given for site
++ gem dependencies via hoe.(taglob,rake,rspec,mocha)
++ getting settings of a site: ex ECOM.settings delgates to taza::settings.site_file(ecom)
+Not yet spiked:
+
+taza 
+ - mocks
+ - url resolving
+ - ability to change yaml for a site
+ - ability to run integration tests for just a site
+ - clean all the config tests

data/spec/spec_helper.rb

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'spec'
+require 'mocha'
+require 'config/vendorized_gems'
+lib_path = File.expand_path("#{File.dirname(__FILE__)}/../lib")
+$LOAD_PATH.unshift lib_path unless $LOAD_PATH.include?(lib_path)
+TMP_ROOT = File.join(File.dirname(__FILE__),"sandbox","generated")
+PROJECT_NAME = 'example'
+PROJECT_FOLDER = File.join(TMP_ROOT,PROJECT_NAME)
+
+
+Spec::Runner.configure do |config|
+  config.mock_with :mocha
+end
+
+def null_device  
+  Taza.windows? ? 'NUL': '/dev/null'
+end
+
+def generator_sources
+  [RubiGen::PathSource.new(:test, File.join(File.dirname(__FILE__),"..","lib", "app_generators")),
+  RubiGen::PathSource.new(:test, File.join(File.dirname(__FILE__),"..", "generators"))]
+end
+
+module Helpers
+  module Generator
+    def generate_site(site_name)
+      site_name = "#{site_name}#{Time.now.to_i}"
+      run_generator('site', [site_name], generator_sources)
+      site_file_path = File.join(PROJECT_FOLDER,'lib','sites',"#{site_name.underscore}.rb")
+      require site_file_path
+      "::#{site_name.camelize}::#{site_name.camelize}".constantize.any_instance.stubs(:base_path).returns(PROJECT_FOLDER)
+      site_name.camelize.constantize
+    end
+  end
+  
+  module Taza
+    def stub_settings
+      ::Taza::Settings.stubs(:config).returns({})
+    end
+
+    def stub_browser
+      stub_browser = stub()
+      stub_browser.stubs(:goto)
+      stub_browser.stubs(:close)
+      ::Taza::Browser.stubs(:create).returns(stub_browser)
+    end
+  end
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification 
+name: scudco-scudco-spec_ui
+version: !ruby/object:Gem::Version 
+  version: 0.2.6
+platform: ruby
+authors: 
+- Aslak Hellesoy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-11-11 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.8
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.2
+    version: 
+description: Run RSpec with UI testing tools
+email: aslak.hellesoy@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- examples/selenium/README.txt
+- examples/watir/README.txt
+files: 
+- TODO
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- examples/selenium/README.txt
+- examples/selenium/Rakefile
+- examples/selenium/spec/selenium/find_rspecs_homepage_spec.rb
+- examples/selenium/spec/spec_helper.rb
+- examples/watir/README.txt
+- examples/watir/Rakefile
+- examples/watir/spec/spec_helper.rb
+- examples/watir/spec/watir/find_rspecs_homepage_spec.rb
+- lib/spec/ui.rb
+- lib/spec/ui/formatter.rb
+- lib/spec/ui/images/rmagick_not_installed.png
+- lib/spec/ui/images/win32screenshot_not_installed.png
+- lib/spec/ui/images/wrong_win32screenshot.png
+- lib/spec/ui/screenshot_saver.rb
+- lib/spec/ui/selenium.rb
+- lib/spec/ui/selenium/driver_ext.rb
+- lib/spec/ui/version.rb
+- lib/spec/ui/watir.rb
+- lib/spec/ui/watir/browser.rb
+- lib/spec/ui/watir/matchers.rb
+- lib/spec/ui/watir/watir_behaviour.rb
+- spec/spec.opts
+- spec/spec/ui/watir/matchers_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://rspec-ext.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: rspec-ext
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Run RSpec with UI testing tools
+test_files: []
+