ripl-watir 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in ripl-watir.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,119 @@
+== Description
+
+Experimental ripl shell for incremental development of an automation
+testing infrastructure for a web site.  Manual testing of the site
+may then be performed with bionic superpowers.
+
+== Installation
+
+    gem install ripl_watir
+
+== Demonstration
+
+Hopefully this serves as some kind of demonstration:
+
+    cd /tmp
+    mkdir lib
+    ripl watir
+
+... opens a browser session (firefox by default) and enters a
+ripl console shell.
+
+    $: << 'lib'
+
+... add the 'lib' directory to the load path
+
+Now create a file 'lib/ripl_watir/github.rb' containing the following:
+
+    require 'watir-page-helper'
+
+    module RiplWatir::Github
+      extend WatirPageHelper::ClassMethods
+
+      direct_url 'github.com'
+      link :login, text: 'Login'
+
+      def logged_in?
+        browser.div(id: 'user').exists?
+      end
+    end
+
+... and now be amazed:
+
+    >> p = visit_page :github
+
+... this creates an instance of the RiplWatir::Page class, requires 'ripl_watir/github' (from whereever it happens to be on the load
+path), mixes RiplWatir::Github into the page class and calls the
+goto method (which tells the browser to goto github.com).
+
+    >> p.login
+
+... calls the login method on the page (which clicks the login button).
+
+Now create a file 'lib/ripl_watir/github/login.rb' containing the following:
+
+    require 'watir-page-helper'
+
+    module RiplWatir::Github::Login
+      extend WatirPageHelper::ClassMethods
+
+      text_field :email, id: 'login_field'
+      text_field :password, id: 'password'
+      button :submit, value: 'Log in'
+
+      def login email, password
+        self.email = email
+        self.password = password
+        self.submit
+      end
+    end
+
+... and be further amazed:
+
+    >> on_page(:github, :login) do |login_page|
+    |    login_page.login 'me@my.mail.com', 'password'
+    |  end
+
+... creates another instance of the RiplWatir::Page class, requires
+'ripl_watir/github/home' (from whereever it happens to be on the load
+path), mixes RiplWatir::Github::Login into it and yields to the block.
+
+The main purpose of all this is to be able to modify/define page mixins,
+and reload them all without having to restart the console or create a
+new browser session.
+
+If for example, you added a new page mixin or a new method to an already instantiated one, you can simply reload the class and should find the new method is available.
+
+    >> load 'ripl_watir/github/login'
+
+If the page mixin you've created has not been loaded already, this step
+is not necessary since the page mixins are only required on first use.
+
+If you just want to tell the browser to do something, it is directly
+available as 'browser' without needing a page object.
+
+    >> browser.goto 'google.com'
+
+== Page Objects
+
+At this time, the page objects are always a RiplWatir::Page instance
+(which is a delegate of Watir::Browser) with a specified mixin.
+
+This mixin can add methods specifically for interacting with that page.
+The watir-page-helper mixin may be used as in the github examples in this gem but is not mandatory.  You can just define methods
+against the @browser instance varaible or delegate to the page itself.
+
+These page mixins will be loaded from anywhere on the load path.
+
+== Cucumber
+
+To use page mixins defined in this way with cucumber, define your
+page objects in a 'lib' (make sure this directory is on the load path)
+and mix the commands into the cucumber 'world' in env.rb:
+
+    require 'ripl_watir/'
+    World RiplWatir::Commands
+
+As long as your page mixins are in a 'ripl_watir' directory on the path
+and are constants defined (at any depth) under the RiplWatir module, they
+should be located.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/ripl-watir

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+$: << File.dirname(__FILE__)+'/../lib'
+require 'ripl'
+require 'ripl_watir'
+Ripl::Commands.include RiplWatir::Commands
+browser = RiplWatir.browser = ::Watir::Browser.new
+Ripl.start :binding => binding

data/lib/ripl_watir/page.rb

@@ -0,0 +1,10 @@
+require 'delegate'
+
+module RiplWatir
+  class Page < DelegateClass Watir::Browser
+    def initialize browser
+      @browser = browser
+      super browser
+    end
+  end
+end

data/lib/ripl_watir/version.rb

@@ -0,0 +1,3 @@
+module RiplWatir
+  VERSION = "0.0.1"
+end

data/lib/ripl_watir.rb

@@ -0,0 +1,44 @@
+require 'watir-webdriver'
+require 'ripl_watir/page'
+
+module RiplWatir
+  class << self
+    attr_accessor :browser
+  end
+
+  module Array
+    def classify
+      self.map(&:classify).join('::')
+    end
+  end
+
+  module Commands
+    def classify s
+      s.to_s.split('_').map(&:capitalize).join
+    end
+
+    def page_class *args
+      page = Page.new RiplWatir.browser
+      require "ripl_watir/#{args.join '/'}"
+      mod = RiplWatir
+      args.each do |name|
+        mod = mod.const_get classify name
+      end
+      page.extend mod
+      page
+    end
+
+    def on_page *args
+      page_class(*args).tap do |p|
+        yield p if block_given?
+      end
+    end
+
+    def visit_page *args
+      on_page(*args) do |p|
+        p.goto
+        yield p if block_given?
+      end
+    end
+  end
+end

data/ripl-watir.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ripl_watir/version"
+
+Gem::Specification.new do |s|
+  s.name        = "ripl-watir"
+  s.version     = RiplWatir::VERSION
+  s.authors     = ["Mark Ryall"]
+  s.email       = ["mark@ryall.name"]
+  s.homepage    = "https://github.com/markryall/ripl_watir"
+  s.summary     = %q{watir repl for efficiently creating page objects}
+  s.description = <<EOF
+A ripl plugin to provide an interactive shell for creating page objects
+to build an automated testing infrastructure for a site.
+EOF
+
+  s.rubyforge_project = "ripl-watir"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency "ripl"
+  s.add_runtime_dependency "watir-page-helper"
+
+  s.add_development_dependency "rspec"
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: ripl-watir
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Mark Ryall
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ripl
+  requirement: &70117511154860 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70117511154860
+- !ruby/object:Gem::Dependency
+  name: watir-page-helper
+  requirement: &70117511154400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70117511154400
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70117511153920 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70117511153920
+description: ! 'A ripl plugin to provide an interactive shell for creating page objects
+
+  to build an automated testing infrastructure for a site.
+
+'
+email:
+- mark@ryall.name
+executables:
+- ripl-watir
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- bin/ripl-watir
+- lib/ripl_watir.rb
+- lib/ripl_watir/page.rb
+- lib/ripl_watir/version.rb
+- ripl-watir.gemspec
+homepage: https://github.com/markryall/ripl_watir
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 749351036081304174
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 749351036081304174
+requirements: []
+rubyforge_project: ripl-watir
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: watir repl for efficiently creating page objects
+test_files: []