pyrite 0.5.0 → 0.5.1

data/README.rdoc

@@ -0,0 +1,48 @@
+= Pyrite - Easy Peasy Browser Testing
+
+- http://mintdigital.github.com/pyrite
+- http://github.com/mintdigital/pyrite
+
+== Description
+
+Pyrite is a lightweight DSL around the Selenium browser testing framework.
+
+We found Cucumber to be awesome, but no one was reading the features. We found
+Webrat to be fantastic, but way too complex for what we wanted. So, we made
+Pyrite - a few selenium-client methods wrapped up in a readable way.
+
+== Example
+
+  require 'pyrite_helper'
+  class BasicTest < Pyrite::PyriteTest
+    test "it works" do
+      visit root_path
+      follow "next page"
+      wait_for :page_load
+      assert_text "some text you should see"
+    end
+  end
+
+== Dependencies
+
+Pyrite has no dependencies that you should have to install manually. Gem
+installation should pull in the necessary selenium libraries.
+
+You will need an operating system and browser capable of running Selenium
+
+== Install
+
+We recommend you use {bundler}[http://gembundler.com]:
+
+  gem 'pyrite', '0.5.0', :require => false
+
+Installing as a Rails plugin should also work:
+
+  script/plugin install git://github.com/mintdigital/pyrite.git
+
+== License
+
+Copyright (c) 2010 Mint Digital Ltd.
+
+Released under the terms of the MIT License.
+See the MIT-LICENSE file in this directory.

data/lib/pyrite/dsl.rb

@@ -48,11 +48,7 @@ module Pyrite
 
     # Click anything else
     def click(locator)
-      browser.click(locator)
-    end
-    
-    def attach(field, file)
-      browser.attach(field, "http://test.rodreegez.com/#{file}")
+      browser.click("css=#{locator}")
     end
 
     # Pick an option from a select element
@@ -63,9 +59,9 @@ module Pyrite
     # Wait for a specific element or the page to load
     def wait_for(element)
       if element == :page_load
-        browser.wait_for_page_to_load
+        browser.wait_for_page_to_load :page
       else
-        browser.wait_for_element(element)
+        browser.wait_for :element => "#{element}"
       end
     end
 
@@ -76,9 +72,9 @@ module Pyrite
 
     # Excecute commands within an iframe, then switch back to the parent frame
     # i.e.
-    # inside_frame(iframe) do
-    #   click "Submit"
-    # end
+    #    inside_frame(iframe) do
+    #      click "Submit"
+    #    end
     def inside_iframe(frame)
       wait_for frame
       browser.select_frame(frame)
@@ -89,28 +85,37 @@ module Pyrite
 
     # Use this to consume JS alerts
     # i.e.
-    # follow 'delete'
-    # get_confirmation
-    # !assert_element "h2:contains('user1')"
+    #    follow 'delete'
+    #    get_confirmation
+    #    !assert_element "h2:contains('user1')"
     def get_confirmation
       browser.get_confirmation
     end
 
     # drag an css selector to the center pixel of another, e.g. 
-    # `drag_and_drop(:from => "li#element_#{my_oject.id}", :to => "div#trash")
+    #    `drag_and_drop(:from => "li#element_#{my_oject.id}", :to => "div#trash")
     # ProTip: if you have a list of elements you wish to re-order, drag the top element down.
     def drag_and_drop(opts={})
       browser.drag_and_drop_to_object("css=#{opts[:from]}", "css=#{opts[:to]}")
     end
 
     # Capture the page and try to open it
-    # (probably only works on os x)
+    # (probably only works on OS X)
     def show_me
       image = "#{Rails.root.join('tmp')}/pyrite-#{Time.now.to_i}.png"
       browser.capture_entire_page_screenshot(image, '')
       puts `open #{image}`
     end
+    
+    # Write the HTML of a page to a file and open it.
+    # (probably only works on OS X)
+    def code_me
+      html = browser.get_html_source
+      filename = "#{Rails.root.join('tmp')}/pyrite-#{Time.now.to_i}.html"
+      code = File.open(filename, 'w') { |f| f.write(html) }
+      puts `open #{code}`
+    end
 
   end
 
-end
+end

data/lib/pyrite/helpers.rb

@@ -1,7 +1,7 @@
 module Pyrite
   module Helpers
 
-    # Easily get the path to a fixture file
+    # Easily get the path to a fixture file from Rails.root/test/fixtures/<filename>
     def fixture(filename)
       File.join(Rails.root,'test','fixtures', filename)
     end

data/lib/pyrite/pyrite_test.rb

@@ -2,7 +2,7 @@ require 'pyrite/dsl'
 require 'pyrite/assertions'
 require 'pyrite/helpers'
 
-module Pyrite
+module Pyrite 
   class PyriteTest < ActionController::IntegrationTest
     include Dsl
     include Assertions
@@ -10,7 +10,7 @@ module Pyrite
 
     self.use_transactional_fixtures = false
 
-    def browser
+    def browser #:nodoc: 
       $browser ||= Selenium::Client::Driver.new(
         :host => Pyrite.rc_host,
         :port => 4444,
@@ -20,13 +20,13 @@ module Pyrite
       )
     end
 
-    def setup
+    def setup #:nodoc:
       DatabaseCleaner.clean
       browser.start_new_browser_session
       super
     end
 
-    def teardown
+    def teardown #:nodoc:
       super
       browser.close_current_browser_session
     end

data/lib/pyrite/tasks/pyrite.rb

@@ -9,7 +9,7 @@ namespace :pyrite do
 
   desc "Startup Selenium RC and the server for browser testing"
   task :start => 'selenium:start' do
-    puts `thin start -e pyrite -p 2222 -d`
+    puts `./script/server -e pyrite -p 2222 -d`
   end
 
   desc "Shutdown Selenium RC and the server for browser testing"

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 5
-  - 0
-  version: 0.5.0
+  - 1
+  version: 0.5.1
 platform: ruby
 authors: 
 - Adam Rogers
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-26 00:00:00 -04:00
+date: 2010-04-13 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -73,14 +73,15 @@ files:
 - lib/pyrite/dsl.rb
 - lib/pyrite/helpers.rb
 - lib/pyrite/pyrite_test.rb
-- lib/pyrite/tasks.rb
 - lib/pyrite/tasks/pyrite.rb
 - lib/pyrite/tasks/selenium.rb
+- lib/pyrite/tasks.rb
 - lib/pyrite.rb
-- MIT-LICENSE
 - tasks/pyrite.rake
+- MIT-LICENSE
+- README.rdoc
 has_rdoc: true
-homepage: http://github.com/mintdigital/pyrite
+homepage: http://mintdigital.github.com/pyrite
 licenses: []
 
 post_install_message: