watirloo 0.0.7 → 0.0.8

data/.gitignore

@@ -20,3 +20,4 @@ spec/reports
 pkg
 
 ## PROJECT::SPECIFIC
+_irb_history

data/Rakefile

@@ -31,9 +31,9 @@ Spec::Rake::SpecTask.new do |spec|
     "--color",
     "--require spec/spec_helper_runner.rb", # slow execution expected. closes all browsers on desktop before :all
     "--format specdoc",
-    "--format specdoc:spec/spec_results.txt",
-    "--format failing_examples:spec/spec_results_failed.txt",
-    "--format html:spec/spec_results.html",
+    "--format specdoc:spec/results/ie.txt",
+    "--format failing_examples:spec/results/ie-failed.txt",
+    "--format html:spec/results/ie.html",
     #"--diff",
     "--loadby mtime",
     #"--dry-run", # will overwrite any previous spec_results
@@ -41,21 +41,6 @@ Spec::Rake::SpecTask.new do |spec|
   ]
 end
 
-# FIXME fix the spec FileList to only include those that execut for firefox. use taglog lib
-desc "spec with ff browser"
-Spec::Rake::SpecTask.new(:spec_ff) do |t|
-  t.spec_files = FileList['spec/*_spec.rb']
-  t.spec_opts = [
-    "--color",
-    "--require spec/spec_helper_ff.rb",
-    "--format specdoc",
-    "--format specdoc:spec/firewatir/spec_results.txt",
-    "--format failing_examples:spec/firewatir/spec_results_failed.txt",
-    "--format html:spec/firewatir/spec_results.html",
-    "--loadby mtime" ]
-end
-
-#task :default => :spec
 
 require 'rake/rdoctask'
 Rake::RDocTask.new do |rdoc|
@@ -65,4 +50,44 @@ Rake::RDocTask.new do |rdoc|
   rdoc.title = "watirloo #{version}"
   rdoc.rdoc_files.include('README*')
   rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+# FireFox
+namespace :ff do
+ 
+  # FIXME fix the spec FileList to only include those that execut for firefox. use taglog lib
+  desc "spec with ff browser"
+  Spec::Rake::SpecTask.new do |spec|
+    spec.spec_files = ['spec/page_spec.rb']
+    #FIXME bug in SpecTask? when [] or spec_files omitted then it reads the default **/*_spec.rb list of files
+    #if I include at least one spec files above the rest of the files are added from spec.opts
+    spec.spec_opts = ["--options spec/ff.opts"]
+  end
+
+  desc "tasklist firefox.exe"
+  task :tasklist do
+    sh "tasklist /FI \"IMAGENAME eq firefox.exe\""
+  end
+
+  desc "taskkill firefox.exe tree"
+  task :taskkill do
+    sh "taskkill /f /t /im firefox.exe"
+  end
+
+  desc "start firefox with jssh"
+  task :start do
+    require 'firewatir'
+    FireWatir::Firefox.new
+  end
+end
+
+desc "start irb and load current lib/watirloo"
+task :console do
+  puts "START IRB for current project"
+  this_dir = File.expand_path(File.join(File.dirname(__FILE__)))
+  this_irbrc = File.join(this_dir, '_irbrc')
+  this_lib = File.join(this_dir, 'lib')
+  sh "set IRBRC=#{this_irbrc} && irb -I #{this_lib}"
+  # do not read ~/.irbrc for other defaults
+  # see ./_irbrc for what's loaded into irb and modify to your liking
 end

data/VERSION

@@ -1 +1 @@
-0.0.7
+0.0.8

data/_irbrc

@@ -0,0 +1,37 @@
+# WINDOWS XP
+puts "LOADING custom IRB console for current watirloo project"
+require 'irb/completion'
+require 'pp'
+require 'irb/ext/save-history'
+
+IRB.conf[:SAVE_HISTORY]=1000
+IRB.conf[:HISTORY_FILE]="./_irb_history"
+IRB.conf[:AUTO_INDENT]=true
+IRB.conf[:PROMPT_MODE]=:SIMPLE
+IRB.conf[:USE_READLINE]=true
+
+class Object
+  # Return a list of methods defined locally for a particular object.  Useful
+  # for seeing what it does whilst losing all the guff that's implemented
+  # by its parents (eg Object).
+  def local_methods(obj = self)
+    (obj.methods - obj.class.superclass.instance_methods).sort
+  end
+  def lm
+	local_methods
+  end
+end
+
+alias x exit
+
+require 'watirloo' #should load the one in lib in current project
+
+def _ie
+  Watirloo::Browsers.target=:ie
+  Watirloo::browser
+end
+
+def _ff
+  Watirloo::Browsers.target = :firefox
+  Watirloo::browser
+end

data/lib/watirloo.rb

@@ -10,7 +10,6 @@ require 'watirloo/locker'
 require 'watirloo/page'
 
 module Watirloo
-  VERSION = '0.0.6' # Jul2009
-
+  VERSION = File.exist?('VERSION') ? (File.read('VERSION')).strip : "VERSION undefined"
 end
 

data/lib/watirloo/browsers.rb

@@ -53,20 +53,24 @@ module Watirloo
           ie = Watir::IE.start
           sleep 3
           Locker.add(ie, key)
-          ie #return newly created browser for the test session and store it for laterusage
+          ie #return newly created browser for the test session and store it for later usage
         end
       end
 
       def ff
-        require 'watirloo/firewatir_ducktape'
+        require 'watirloo/extension/firewatir_ducktape'
         # this is a cruch for quick work with pages.
         # in reality you want to create a browser and pass it as argument to initialize Page class
+        floc = FireLocker.instance
         begin
-          FireWatir::Firefox.attach #this attach is a crutch
+          floc.browser.url
+          floc.browser
         rescue
-          puts 'got to start browser ff dude'
+          floc.clear
+          ::FireWatir::Firefox.new
+          sleep 2
+          floc.browser
         end
-
       end
     end
   end

data/lib/watirloo/extension/firewatir_ducktape.rb

@@ -1,80 +1,12 @@
-gem 'firewatir', '>=1.6.2' # dependency
 require 'firewatir'
 
 module FireWatir
-  
-  # duck punch and ducktape Firefox for Watirloo needs
-  # some of it is cosmetic surgery and some new methods with intention of
-  # sending a patch to Watir maintainers
-  class Firefox
-    
-    # attach to the existing Firefox that was already started with JSSH option.
-    # this is a hack for Watirloo. it only attaches to the latest firefox.
-    # it assumes there is only one instance of FF window open on the desktop
-    def self.attach
-      Firefox.new :attach => true
-    end
-    
-    # add option key :attach as a hack
-    # :attach => true to attach to topmost window in getWindows().lenght-1
-    # split up initialize to conditionally start FireFox
-    def initialize(options = {})
-      _start_firefox(options) unless options[:attach]
-      set_defaults()
-      get_window_number()
-      set_browser_document()
-    end
-    
-    # refactor initialize method to move all starting of FF into its own method
-    def _start_firefox(options)
-      if(options.kind_of?(Integer))
-        options = {:waitTime => options}
-      end
-      
-      if(options[:profile])
-        profile_opt = "-no-remote -P #{options[:profile]}"
-      else
-        profile_opt = ""
-      end
-      
-      waitTime = options[:waitTime] || 2
-      
-      case RUBY_PLATFORM 
-      when /mswin/
-        # Get the path to Firefox.exe using Registry.
-        require 'win32/registry.rb'
-        path_to_bin = ""
-        Win32::Registry::HKEY_LOCAL_MACHINE.open('SOFTWARE\Mozilla\Mozilla Firefox') do |reg|
-          keys = reg.keys
-          reg1 = Win32::Registry::HKEY_LOCAL_MACHINE.open("SOFTWARE\\Mozilla\\Mozilla Firefox\\#{keys[0]}\\Main")
-          reg1.each do |subkey, type, data|
-            if(subkey =~ /pathtoexe/i)
-              path_to_bin = data
-            end
-          end
-        end
-        
-      when /linux/i
-        path_to_bin = `which firefox`.strip
-      when /darwin/i
-        path_to_bin = '/Applications/Firefox.app/Contents/MacOS/firefox'
-      when /java/
-        raise "Not implemented: Create a browser finder in JRuby"
-      end
-      
-      @t = Thread.new { system("#{path_to_bin} -jssh #{profile_opt}")}   
-      sleep waitTime
-      
-    end
-    private :_start_firefox
-
-  end
-
+    
   class SelectList
     
     include Watir::SelectListCommonWatir
-    
-        # accepts one text item or array of text items. if array then sets one after another. 
+
+    # accepts one text item or array of text items. if array then sets one after another. 
     # For single select lists the last item in array wins
     # 
     # examples
@@ -83,15 +15,35 @@ module FireWatir
     #       this is a single select list box it will set each value in turn
     #   select_list set 1 # => set the first option in a list
     #   select_list.set [1,3,5] => set the first, third and fith options
-    def set(item)
+    def select( item )
       _set(:text, item)
     end
 
     # set item by the option value attribute. if array then set one after anohter.
     # see examples in set method
-    def set_value(value)
+    def select_value( value )
       _set(:value, value)
     end
+
+    # set :value or :text
+    def _set(how, what)
+      if what.kind_of? Array
+        what.each { |item| _set(how,item)} # call self with individual item
+      else
+        if what.kind_of? Fixnum # if by position then translate to set by text
+          if (0..items.size).member? what
+            _set :text, items[what-1] #call self with found item
+          else
+            raise ::Watir::Exception::WatirException, "number #{item} is out of range of item count"
+          end
+        else
+          select_items_in_select_list(how, what)  #finally as :value or :text
+        end
+      end
+
+    end
+    alias set select
+    alias set_value select_value
     
     # returns array of value attributes
     # each option usually has a value attribute 
@@ -146,7 +98,11 @@ module FireWatir
         end
       end
     end
-    
+
+    def name
+      @name
+    end
+
     # which values are selected?
     def selected_values
       values = []
@@ -156,7 +112,41 @@ module FireWatir
       return values
     end
   end
-  
+
+  class CheckboxGroups < ElementCollections
+    #   def element_class; CheckboxGroup; end
+
+    def initialize(container)
+      @container = container
+      elements = locate_elements
+      @element_objects = []
+      # for each unique name create a checkbox_group
+      elements.each do |name|
+        @element_objects << CheckboxGroup.new(container, name)
+      end
+    end
+
+    def length
+      @element_objects.size
+    end
+
+    # return array of unique names for checkboxes in container
+    def locate_elements
+      names = []
+      @container.checkboxes.each do |cb|
+        names << cb.name
+      end
+      names.uniq #non repeating names
+    end
+
+
+    # allows access to a specific item in the collection. 1-based index
+    def [](n)
+      @element_objects[n-1]
+    end
+    
+  end
+
   class RadioGroup
     
     include RadioCheckGroup
@@ -190,5 +180,6 @@ module FireWatir
     def checkbox_group(name)
       CheckboxGroup.new(self, name)
     end
+    
   end
 end

data/lib/watirloo/extension/watir_ducktape.rb

@@ -1,4 +1,3 @@
-gem 'watir', '>=1.6.2'
 require 'watir'
 require 'watir/ie'
 

data/lib/watirloo/locker.rb

@@ -1,5 +1,20 @@
+
 module Watirloo
 
+  require 'singleton'
+
+  class FireLocker
+    include Singleton
+    attr_accessor :browser
+    # reuse browser previously attached to.
+    # ISSUE: if browser is closed we are stuck holding reference to non existing browser
+    def browser
+      @firefox ||= ::FireWatir::Firefox.attach(:url, /.*/)
+    end
+    def clear
+      @firefox = nil
+    end
+  end
 
   # manages references to browsers we care about to run tests agains.
   # Saves references to window handles internall to yaml file so we can reuse the browser for tests by reattaching to it between tests.

data/lib/watirloo/screenshot.rb

@@ -0,0 +1,50 @@
+require 'Win32API'
+
+module Watirloo
+
+  module ScreenCapture
+
+    KEYEVENTF_KEYUP = 0x2
+    VK_CONTROL      = 0x11
+    VK_MENU         = 0x12
+    VK_SHIFT        = 0x10
+    VK_SNAPSHOT     = 0x2C
+
+    # send key events Ctrl+PrintScreen using win32 to activate greenshot screencatpure program
+    # http://sourceforge.net/projects/greenshot/
+    # greenshot must be configured beforehand and running (best to just run it at win startup)
+    #   output: save automatically to a location of your choice (best with png, smallest files)
+    #   filepattern: recommended greenshot_%YYYY%-%MM%-%DD%_%hh%-%mm%-%ss%
+    #   turn off open in editor option
+    # For reference see Watir::ScreenCapture.screen_capture method in watir gem
+    # by default it takes a screenshot of the desktop Ctrl+PrintScreen
+    # any other arg snaps the last region Shift+PrintScreen (call with :region arg)
+    def screenshot what=:desktop
+      # WIN32API.new(dllname, func, import, export = "0")
+      keybd_event = Win32API.new("user32", "keybd_event", ['I','I','L','L'], 'V')
+      #keybd_event(bVk, bScan, dwFlags, dwExtraInfo)
+      #Simulate a keyboard event
+      if what == :desktop
+        # Ctrl + PrintScreen keybd event
+        keybd_event.Call(VK_CONTROL, 1, 0, 0)
+        keybd_event.Call(VK_SNAPSHOT, 1, 0, 0)
+        keybd_event.Call(VK_SNAPSHOT, 1, KEYEVENTF_KEYUP, 0)
+        keybd_event.Call(VK_CONTROL, 1, KEYEVENTF_KEYUP, 0)
+      else
+        # Shift + PrintScreen keybd event
+        keybd_event.Call(VK_SHIFT, 1, 0, 0)
+        keybd_event.Call(VK_SNAPSHOT, 1, 0, 0)
+        keybd_event.Call(VK_SNAPSHOT, 1, KEYEVENTF_KEYUP, 0)
+        keybd_event.Call(VK_SHIFT, 1, KEYEVENTF_KEYUP, 0)
+      end
+      sleep 1 #give time to save
+    end
+  end
+end
+
+if $0 == __FILE__
+  # sample usage
+  include Watirloo::ScreenCapture
+  screenshot #takes full screen
+  screenshot :region # last set region. you must set region with PrintScreen first in greenshot
+end

data/spec/checkbox_group_spec.rb

@@ -3,14 +3,14 @@ require File.dirname(__FILE__) + '/spec_helper'
 describe 'browser checkbox_group accesses a group of checkboxes sharing the same name on a page' do
 
   before :each do
-    @browser = Watirloo::browser
+    @browser = Watirloo.browser
     @browser.goto testfile('checkbox_group1.html')
   end
-  
+
   it 'browser responds to checkbox_group' do
     @browser.should respond_to(:checkbox_group)
   end
-  
+
   it 'access by name as default returns CheckboxGroup' do
     if @browser.kind_of?(FireWatir::Firefox)
       @browser.checkbox_group('pets').should be_kind_of(FireWatir::CheckboxGroup)
@@ -20,9 +20,9 @@ describe 'browser checkbox_group accesses a group of checkboxes sharing the same
   end
 
   it 'size retuns checkboxes as items count in a group' do
-    @browser.checkbox_group(:name, 'pets').size.should == 5
+    @browser.checkbox_group('pets').size.should == 5
   end
-  
+
   it 'values returns array of value attributes for each checkbox in a group' do
     @browser.checkbox_group('pets').values.should == ["cat", "dog", "zook", "zebra", "wumpa"]
   end
@@ -32,7 +32,7 @@ end
 describe "checkbox_group values when no checkbox is checked in a group" do
 
   before :each do
-    @browser = Watirloo::browser
+    @browser = Watirloo.browser
     @browser.goto testfile('checkbox_group1.html')
   end
 
@@ -50,13 +50,13 @@ describe "checkbox_group values when no checkbox is checked in a group" do
   it "set? should return false when no checkbox is checked in a group" do
     @browser.checkbox_group("pets").should_not be_set
   end
-    
+
 end
 
 describe "checkbox_group values when set string selecs one item only" do
 
   before :each do
-    @browser = Watirloo::browser
+    @browser = Watirloo.browser
     @browser.goto testfile('checkbox_group1.html')
   end
 
@@ -87,7 +87,7 @@ end
 describe "checkbox_group set array of strings selects multiple values in a group" do
 
   before :each do
-    @browser = Watirloo::browser
+    @browser = Watirloo.browser
     @browser.goto testfile('checkbox_group1.html')
   end