kameleon 0.0.1.pre

data/LICENCE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Michał Czyż <http://linkd.in/michalczyz> @cs3b
+
+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/lib/kameleon.rb

@@ -0,0 +1,7 @@
+require 'kameleon/session/capybara'
+require 'kameleon/dsl/see'
+require 'kameleon/dsl/act'
+
+require 'kameleon/user/abstract'
+require 'kameleon/user/base'
+require 'kameleon/user/guest'

data/lib/kameleon/dsl/act.rb

@@ -0,0 +1,27 @@
+module Kameleon
+  module Dsl
+    module Act
+
+      def click(*links)
+        links.each do |link|
+          session.click_on(link)
+        end
+      end
+
+      #      def click(link_text, options={:within => DEFAULT_AREA})
+      #  yield if block_given?
+      #  rspec_world.within(options[:within]) do
+      #    begin
+      #      rspec_world.click_on(self_or_translation_for(link_text))
+      #    rescue Capybara::ElementNotFound => e
+      #      attr_value, attr_type = within_value_and_type(options[:within])
+      #      xpath = attr_type ? "//*[@#{attr_type}='#{attr_value}']//*[*='%s']/*" : "//*[#{attr_type}]//*[*='%s']/*"
+      #      rspec_world.find(:xpath, xpath % self_or_translation_for(link_text)).click
+      #    end
+      #  end
+      #end
+
+
+    end
+  end
+end

data/lib/kameleon/dsl/see.rb

@@ -0,0 +1,43 @@
+module Kameleon
+  module Dsl
+    module See
+           def see(*content)
+        options = extract_options(content)
+
+        case options.class.name
+          when 'String'
+            session.should rspec_world.have_content(options)
+          when 'Array'
+            options.each do |content_part|
+              session.should rspec_world.have_content(content_part)
+            end
+          when 'Hash'
+            options.each_pair do |value, locator|
+              session.should rspec_world.have_field(locator, :with => value)
+            end
+          else
+            raise "Not Implemented Structure #{options} :: #{options.class}"
+        end
+      end
+
+      def not_see(*content)
+        options = extract_options(content)
+
+        case options.class.name
+          when 'String'
+            session.should_not rspec_world.have_content(options)
+          when 'Array'
+            options.each do |content_part|
+              session.should_not rspec_world.have_content(content_part)
+            end
+          when 'Hash'
+            options.each_pair do |value, locator|
+              session.should_not rspec_world.have_field(locator, :with => value)
+            end
+          else
+            raise "Not Implemented Structure #{options} :: #{options.class}"
+        end
+      end
+    end
+  end
+end

data/lib/kameleon/session/capybara.rb

@@ -0,0 +1,45 @@
+module Kameleon
+  module Session
+    module Capybara
+
+      attr_accessor :session_name
+      attr_accessor :driver_name
+
+      def set_session
+        @session = find_or_create_session ||
+            current_session
+      end
+
+      private
+
+      def find_or_create_session
+        find_session ||
+            create_session
+      end
+
+      #! in future we should print notice when selected drive is different then session that have been chosen
+      def find_session
+        session_pool[session_name]
+      end
+
+      def create_session
+        ::Capybara::Session.new(current_driver, ::Capybara.app).tap do |session|
+          session_pool[session_name] = session
+        end if session_name
+      end
+
+      def session_pool
+        ::Capybara.send(:session_pool)
+      end
+
+      def current_session
+        ::Capybara.current_session
+      end
+
+      def current_driver
+        driver_name ||
+            ::Capybara.current_driver
+      end
+    end
+  end
+end

data/lib/kameleon/user/abstract.rb

@@ -0,0 +1,35 @@
+module Kameleon
+  module User
+    class Abstract
+      attr_accessor :options
+      attr_accessor :rspec_world
+      attr_accessor :session
+
+      include Kameleon::Session::Capybara
+      include Kameleon::Dsl::See
+      include Kameleon::Dsl::Act
+
+      def visit(page)
+        session.visit(page)
+      end
+
+      def will(&block)
+        instance_eval(&block)
+      end
+
+      private
+
+      def load_homepage?
+        !options[:skip_page_autoload]
+      end
+
+      def extract_options(opts)
+        if opts.size == 1
+          opts.first
+        else
+          opts
+        end
+      end
+    end
+  end
+end

data/lib/kameleon/user/base.rb

@@ -0,0 +1,7 @@
+module Kameleon
+  module User
+    class Base < Abstract
+
+    end
+  end
+end

data/lib/kameleon/user/guest.rb

@@ -0,0 +1,14 @@
+module Kameleon
+  module User
+    class Guest < Abstract
+      def initialize(rspec_world, options={})
+        @rspec_world = rspec_world
+        @driver_name = options.delete(:driver)
+        @session_name = options.delete(:session_name)
+        @options = options
+        set_session
+        session.visit('/') if load_homepage?
+      end
+    end
+  end
+end

data/spec/sample_rack_app/hey.rb

@@ -0,0 +1,10 @@
+class Hey
+
+  def initialize(body)
+    @body = body
+  end
+
+  def call(env)
+    [200, {"Content-Type" => "text/plain"}, [@body]]
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'kameleon'
+require 'capybara/dsl'
+
+require 'sample_rack_app/hey'

data/spec/unit/act_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe "Act" do
+  include ::Capybara::DSL
+
+  before(:all) do
+    Capybara.app = Hey.new(%q{
+    <h1>This is simple app</h1>
+    <a href="next_page.html">Load Next Page</a>
+    <form>
+
+    <input type="submit" value="Save changes" class="btn primary">
+    <button class="btn" type="reset">Cancel</button>
+
+    </form>
+
+    })
+    @user = Kameleon::User::Guest.new(self)
+  end
+
+  it "clicks on link" do
+    @user.click "Load Next Page"
+  end
+
+  it "clicks on buttons" do
+    @user.click "Save changes"
+  end
+
+  it "allow to chain many clicks - with success" do
+    @user.click "Save changes", "Load Next Page", "Save changes"
+  end
+
+  it "allow to chain many clicks - raise error, if at least one of them not found" do
+    lambda {
+    @user.click "Save changes", "Load Next Page", "Submit", "Load Next Page"
+    }.should raise_error(Capybara::ElementNotFound)
+  end
+end

data/spec/unit/guest_spec.rb

@@ -0,0 +1,63 @@
+require 'spec_helper'
+
+describe "Kameleon::User::Guest" do
+  include ::Capybara::DSL
+
+  before(:all) do
+    Capybara.app = Hey.new("Hello You :-)")
+  end
+
+
+  context "guest user" do
+    before(:all) do
+      @guest = Kameleon::User::Guest.new(self, {:session_name => :see_world})
+      @another_guest = Kameleon::User::Guest.new(self)
+    end
+
+    context "sessions" do
+      it "by default user should get current session" do
+        @another_guest.session.should == Capybara.current_session
+      end
+
+      it "guests should have separate session if param :session_name defined" do
+        @guest.session.should_not == Capybara.current_session
+      end
+    end
+
+    context "driver" do
+      it "will not change if not defined in params" do
+        @guest.session.driver.should be_a Capybara.current_session.driver.class
+      end
+
+      context "selecting custom driver" do
+        before(:all) do
+          @selenium = Kameleon::User::Guest.new(self, {:session_name => :new_world, :driver => :selenium, :skip_page_autoload => true})
+        end
+        it "should set Selenium if params :driver => :selenium" do
+          @selenium.session.driver.should be_a Capybara::Selenium::Driver
+        end
+        it "shouldn't change drivers for other users'" do
+          [@guest, @another_guest].each do |user|
+            user.session.driver.should be_a Capybara::RackTest::Driver
+          end
+        end
+      end
+    end
+  end
+
+  context "perform request" do
+    before(:all) do
+      @user = Kameleon::User::Guest.new(self)
+    end
+
+    it "should be able to see response" do
+      @user.see("Hello")
+    end
+
+    it "using will block" do
+      @user.will do
+        see "Hello"
+      end
+    end
+  end
+end

data/spec/unit/see_spec.rb

@@ -0,0 +1,177 @@
+require 'spec_helper'
+
+describe "See" do
+  include ::Capybara::DSL
+
+  before(:all) do
+    Capybara.app = Hey.new(%q{
+    <h1>This is simple app</h1>
+    <p>and there is many lines</p>
+    <p>i that app</p>
+
+      <form>
+        <fieldset>
+          <legend>Example form legend</legend>
+            <label for="xlInput">X-Large input</label>
+              <input type="text" size="30" name="xlInput" id="xlInput" value="this is great value" class="xlarge">
+
+            <label for="normalSelect">Select</label>
+              <select id="normalSelect" name="normalSelect">
+                <option>1</option>
+                <option>2</option>
+                <option>3</option>
+                <option>4</option>
+                <option>5</option>
+              </select>
+
+            <label for="mediumSelect">Select</label>
+              <select id="mediumSelect" name="mediumSelect" class="medium">
+                <option>1</option>
+                <option>2</option>
+                <option>3</option>
+                <option>4</option>
+                <option>5</option>
+              </select>
+            <label for="multiSelect">Multiple select</label>
+              <select id="multiSelect" name="multiSelect" multiple="multiple" size="5" class="medium">
+                <option>1</option>
+                <option>2</option>
+                <option>3</option>
+                <option>4</option>
+                <option>5</option>
+              </select>
+
+            <label for="disabledInput">Disabled input</label>
+              <input type="text" disabled="" placeholder="Disabled input here carry on." size="30" name="disabledInput" id="disabledInput" class="xlarge disabled">
+
+            <label for="disabledInput">Disabled textarea</label>
+              <textarea disabled="" rows="3" id="textarea" name="textarea" class="xxlarge"></textarea>
+        </fieldset>
+
+        <fieldset>
+            <label for="prependedInput">Prepended text</label>
+                <input type="text" size="16" name="prependedInput" id="prependedInput" class="medium">
+
+            <label for="prependedInput2">Prepended checkbox</label>
+                <label class="add-on"><input type="checkbox" value="" id="" name=""></label>
+                <input type="text" size="16" name="prependedInput2" id="prependedInput2" class="mini">
+
+            <label for="appendedInput">Appended checkbox</label>
+                <input type="text" size="16" name="appendedInput" id="appendedInput" class="mini">
+                <label class="add-on active"><input type="checkbox" checked="checked" value="" id="" name=""></label>
+
+            <label for="fileInput">File input</label>
+              <input type="file" name="fileInput" id="fileInput" class="input-file">
+        </fieldset>
+
+        <fieldset>
+            <label id="optionsCheckboxes">List of options</label>
+
+                  <label>
+                    <input type="checkbox" value="option1" name="optionsCheckboxes">
+                    <span>Option one is this and that&mdash;be sure to include why it's great</span>
+                  </label>
+
+                  <label>
+                    <input type="checkbox" value="option2" name="optionsCheckboxes">
+                    <span>Option two can also be checked and included in form results</span>
+                  </label>
+
+                  <label>
+                    <input type="checkbox" value="option2" name="optionsCheckboxes">
+                    <span>Option three can&mdash;yes, you guessed it&mdash;also be checked and included in form results. Let's make it super long so that everyone can see how it wraps, too.</span>
+                  </label>
+
+                  <label class="disabled">
+                    <input type="checkbox" disabled="" value="option2" name="optionsCheckboxes">
+                    <span>Option four cannot be checked as it is disabled.</span>
+                  </label>
+
+            <label>Date range</label>
+              <div class="inline-inputs">
+                <input type="text" value="May 1, 2011" class="small">
+                <input type="text" value="12:00am" class="mini">
+                to
+                <input type="text" value="May 8, 2011" class="small">
+                <input type="text" value="11:59pm" class="mini">
+                <span class="help-block">All times are shown as Pacific Standard Time (GMT -08:00).</span>
+              </div>
+
+            <label for="textarea">Textarea</label>
+              <textarea rows="3" name="textarea2" id="textarea2" class="xxlarge"></textarea>
+
+            <label id="optionsRadio">List of options</label>
+            <div class="input">
+                  <label>
+                    <input type="radio" value="option1" name="optionsRadios" checked="">
+                    <span>Option one is this and that&mdash;be sure to include why it's great</span>
+                  </label>
+
+                  <label>
+                    <input type="radio" value="option2" name="optionsRadios">
+                    <span>Option two can is something else and selecting it will deselect options 1</span>
+                  </label>
+            </div>
+
+            <input type="submit" value="Save changes" class="btn primary">&nbsp;<button class="btn" type="reset">Cancel</button>
+
+        </fieldset>
+      </form>
+                           })
+    @user = Kameleon::User::Guest.new(self)
+  end
+
+  context "and can judge that there is no text on site" do
+    it "with single param" do
+      @user.not_see "cool rails app"
+    end
+
+    it "with multiple params at once" do
+      @user.not_see "sinatra app",
+                    "padrino app"
+    end
+
+    it "it will fail if at least one text is visibile" do
+      lambda {
+        @user.not_see "sinatra app",
+                      "This is simple app"
+      }.should raise_error(RSpec::Expectations::ExpectationNotMetError)
+    end
+  end
+
+  context "text in site" do
+    it "when single parameter" do
+      @user.see "This is simple app"
+    end
+
+    it "when many strings" do
+      @user.see "This is simple app",
+                "and there is many lines",
+                "i that app"
+    end
+
+    it "when many strings should fail if there is at least one missing" do
+      lambda {
+        @user.see("sinatra app",
+                  "and there is many lines",
+                  "i that app")
+      }.should raise_error(RSpec::Expectations::ExpectationNotMetError)
+    end
+
+    context "that are value for form" do
+      it "by input id" do
+        @user.see 'this is great value' => 'xlInput'
+      end
+
+      it "by input label" do
+        @user.see 'this is great value' => 'X-Large input'
+      end
+    end
+
+    context "that are not value for form" do
+      it "by input id" do
+        @user.not_see 'this is not such a great value' => 'xlInput'
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: kameleon
+version: !ruby/object:Gem::Version
+  version: 0.0.1.pre
+  prerelease: 6
+platform: ruby
+authors:
+- Michał Czyż [@cs3b]
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name:
+  - capybara
+  - rspec
+  requirement: &20156160 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *20156160
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &20155400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *20155400
+description: kameleon - it's a polish word for chameleon
+email: michalczyz@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/kameleon/user/base.rb
+- lib/kameleon/user/guest.rb
+- lib/kameleon/user/abstract.rb
+- lib/kameleon/session/capybara.rb
+- lib/kameleon/dsl/act.rb
+- lib/kameleon/dsl/see.rb
+- lib/kameleon.rb
+- spec/unit/guest_spec.rb
+- spec/unit/see_spec.rb
+- spec/unit/act_spec.rb
+- spec/sample_rack_app/hey.rb
+- spec/spec_helper.rb
+- LICENCE
+homepage: http://kameleon.cs3b.com
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: high abstraction dsl for end user perspective tests
+test_files: []