browsercuke 0.1.3 → 0.1.4

data/History.txt

@@ -1,3 +1,8 @@
+=== 0.1.4 / 2010-01-08
+
+* Removed OSX-specific dependencies, instead requiring the user to install these manually.
+* Updated installation instructions, particularly those for Windows.
+
 === 0.1.3 / 2010-01-07
 
 * Changing copyright notice

data/README.md

@@ -2,7 +2,7 @@
 
 http://github.com/sminnee/browsercuke
 
-## DESCRIPTION:
+## DESCRIPTION
 
 BrowserCuke is a layer of browser-based testing on top of Cucumber.  It provides an intuitive way of
 writing business-readable tests for your web applications, that use real web browsers to test.  Your
@@ -37,20 +37,53 @@ Roadmap:
  * Add tests for colour and image changes
  * Get the FireWatir and SafariWatir monkey patches submitted to those upstream projects.
 
-## INSTALL:
+## INSTALL
 
-BrowserCuke is packaged as a gem, so the easiest way of installing BrowserCuke is by running this
-command:
+BrowserCuke is packaged as a Ruby gem.  There are also a few platform-specific steps that you need
+to perform.  Platform-specific installation instructions are as follows.
 
-    $ gem install browsercuke
+### Windows
 
-You will also need to make some changes on your system to get the browser
+On Windows, we recommend that you use Ruby 1.8.6 and not a more recent version.  If you use a
+different version of Ruby, you will also need to install build tools to compile native extensions.
 
- * Safari: Go to System Prefences -> Universal Access and check the box labelled 'Enable access for assistive devices'
- * Firefox: Install the JSSH extension.  You can download it here:
-   * [OS X + FF 3.5](http://wiki.openqa.org/download/attachments/13893658/jssh-3.5.x-Darwin-param.xpi)
+[You can download the one-click installer here](http://rubyforge.org/frs/download.php/29263/ruby186-26.exe)
 
-## SYNOPSIS:
+You will then need to update RubyGems.  [Download from here](http://gemcutter-production.s3.amazonaws.com/rubygems/rubygems-1.3.5.zip), extract, and run
+this command from a command-line prompt within the rubygems-1.3.5 directory that it contains:
+
+    $ ruby setup.rb
+
+Now, run this command:
+
+    $ gem install browsercuke watir
+
+Finally, install the Firefox extension, JSSH.  You can download it here:
+
+ * [Firefox 2.0/Win](http://wiki.openqa.org/download/attachments/13893658/jssh-WINNT-2.x.xpi)
+ * [Firefox 3.0/Win](http://wiki.openqa.org/download/attachments/13893658/jssh-20080708-WINNT.xpi)
+ * [Firefox 3.5/Win](http://wiki.openqa.org/download/attachments/13893658/jssh-3.5.x-WINNT.xpi)
+
+You are now set up to run browsercuke tests on IE and Firefox.
+
+### OS X
+
+If you have Leopard or Snow Leopard, then you should have Ruby all set up.  Open Terminal and
+run this command:
+
+    $ gem install browsercuke safariwatir rb-appscript
+
+Go to System Prefences -> Universal Access and check the box labelled 'Enable access for assistive devices'.
+
+Finally, install the Firefox extension, JSSH.  You can download it here:
+
+ * [Firefox 2.0/OS X](http://wiki.openqa.org/download/attachments/13893658/jssh-darwin-0.94.xpi?version=1)
+ * [Firefox 3.0/OS X](http://wiki.openqa.org/download/attachments/13893658/jssh-20080924-Darwin.xpi)
+ * [Firefox 3.5/OS X](ttp://wiki.openqa.org/download/attachments/13893658/jssh-3.5.x-Darwin-param.xpi)
+
+You are now set up to run browsercuke tests on Safari an Firefox.
+
+## SYNOPSIS
 
 Now it's time to create your first test.  As an example, we will test Google's search.  Create a
 file called `google-search.feature` and put this content into it.
@@ -209,7 +242,7 @@ Misc
 
 ### I put "(text)" in pop-ups
 
-## REQUIREMENTS:
+## REQUIREMENTS
 
 Currently browsercuke works with the following browsers.
 
@@ -218,7 +251,7 @@ Currently browsercuke works with the following browsers.
 
 It has been tested on OS X only; Windows and IE support coming soon!
 
-## DEVELOPERS:
+## DEVELOPERS
 
 After checking out the source, run:
 
@@ -242,7 +275,7 @@ To create a new release of the gem, to the following:
 
          rake publish
 
-## LICENSE:
+## LICENSE
 
 Browsercuke is licensed under the BSD license
 

data/Rakefile

@@ -10,6 +10,9 @@ Hoe.spec 'browsercuke' do
   
   extra_deps << ['cucumber', '>= 0.4.4']
   extra_deps << ['firewatir', '>= 1.6.5']
-  extra_deps << ['safariwatir', '>= 0.3.7']
-  extra_deps << ['rb-appscript', '>= 0.5.3']
+  
+# We don't include these dependencies because they are OSX only.  If these are included, then you
+# can't install the Gem on Windows.  Creating a browsercuke-osx gem might be a solution. 
+#  extra_deps << ['safariwatir', '>= 0.3.7']
+#  extra_deps << ['rb-appscript', '>= 0.5.3']
 end

data/lib/browsercuke.rb

@@ -2,6 +2,6 @@
 # In time, the non-Watir ruby code that the step definitions make use of can be moved into this.
 module BrowserCuke
   class BrowserCuke
-    VERSION = "0.1.3"
+    VERSION = "0.1.4"
   end
-end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: browsercuke
 version: !ruby/object:Gem::Version 
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors: 
 - "Sam Minn\xC3\xA9e"
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-07 00:00:00 +13:00
+date: 2010-01-08 00:00:00 +13:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -32,26 +32,6 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 1.6.5
     version: 
-- !ruby/object:Gem::Dependency 
-  name: safariwatir
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.3.7
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: rb-appscript
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.5.3
-    version: 
 - !ruby/object:Gem::Dependency 
   name: hoe
   type: :development