page_magic 0.8.8

data/spec/page_magic_spec.rb

@@ -0,0 +1,143 @@
+require 'spec_helper'
+
+describe 'page magic' do
+
+  describe 'class level' do
+    context 'session' do
+      it 'should setup a session using the specified browser' do
+        Capybara::Session.should_receive(:new).with(:chrome, nil).and_return(:chrome_session)
+
+        session = PageMagic.session(:chrome)
+        Capybara.drivers[:chrome].call(nil).should == Capybara::Selenium::Driver.new(nil, browser: :chrome)
+
+        session.browser.should == :chrome_session
+      end
+
+      it 'should use the Capybara default browser if non is specified' do
+        Capybara.default_driver = :rack_test
+        session = PageMagic.session
+        session.browser.mode.should == :rack_test
+      end
+    end
+  end
+
+  describe 'instances' do
+
+    include_context :webapp
+
+    let(:my_page_class) do
+      Class.new do
+        include PageMagic
+        url '/page1'
+        link(:next, :text => "next page")
+      end
+    end
+
+    let(:another_page_class) do
+      Class.new do
+        include PageMagic
+        url '/another_page1'
+      end
+    end
+
+    before :each do
+      @page = my_page_class.new
+    end
+
+
+    describe 'browser integration' do
+      it "should use capybara's default session if a one is not supplied" do
+        Capybara.default_driver = :rack_test
+        my_page_class.new.browser.mode.should == :rack_test
+      end
+    end
+
+
+    describe 'parent pages' do
+      before :all do
+        module ParentPage
+          include PageMagic
+          link(:next, :text => "next page")
+        end
+
+        class ChildPage
+          include ParentPage
+          url '/page1'
+        end
+      end
+
+      context 'children' do
+        it 'override parents url' do
+          ChildPage.url.should == '/page1'
+        end
+
+        it 'inherit elements' do
+          child_page = ChildPage.new
+          child_page.visit
+          child_page.element_definitions.should include(:next)
+        end
+
+        it 'are added to PageMagic.pages list' do
+          PageMagic.pages.find_all { |page| page == ChildPage }.size.should == 1
+        end
+      end
+
+      context 'parent' do
+        it 'is not registered as Page' do
+          PageMagic.pages.should_not include(ParentPage)
+        end
+
+        it 'cannot be instantiated' do
+          expect { ParentPage.new }.to raise_error("You can only instantiate child pages")
+        end
+      end
+    end
+
+    describe 'visit' do
+      it 'should go to the page' do
+        @page.visit
+        @page.current_path.should == '/page1'
+      end
+    end
+
+    describe 'text_on_page' do
+      it 'should return true' do
+        @page.visit
+        @page.text_on_page?('next page').should be_true
+      end
+
+      it 'should return false' do
+        @page.visit
+        @page.text_on_page?('billy bob').should be_false
+      end
+
+    end
+
+
+    it 'can have fields' do
+      @page.element_definitions[:next].call(@page).should == PageMagic::PageElement.new(:next, @page, :button, :text => "next")
+    end
+
+    it 'should copy fields on to element' do
+      new_page = my_page_class.new
+      @page.element_definitions[:next].call(@page).should_not equal(new_page.element_definitions[:next].call(new_page))
+    end
+
+    it 'gives access to the page text' do
+      @page.visit.text.should == 'next page'
+    end
+
+    it 'should access a field' do
+      @page.visit
+      @page.click_next
+      @page.text.should == 'page 2 content'
+    end
+
+    it 'are registered at class level' do
+      PageMagic.instance_variable_set(:@pages, nil)
+
+      page = Class.new { include PageMagic }
+      PageMagic.pages.should == [page]
+    end
+  end
+end

data/spec/page_section_spec.rb

@@ -0,0 +1,101 @@
+require 'spec_helper'
+
+describe PageMagic::PageSection do
+
+  include_context :webapp
+
+  before :each do
+    @elements_page = elements_page.new
+    @elements_page.visit
+  end
+
+  let!(:elements_page) do
+
+    Class.new do
+      include PageMagic
+      url '/elements'
+      section :form_by_css do
+        selector css: '.form'
+        link(:link_in_form, text: 'a in a form')
+      end
+
+      section :form_by_id do
+        selector id: 'form'
+        link(:link_in_form, text: 'a in a form')
+      end
+    end
+  end
+
+  context 'class level' do
+    let(:section) do
+      Class.new do
+        extend PageMagic::PageSection
+      end
+    end
+
+    describe 'selector' do
+      before do
+        section.parent_browser_element = @elements_page.browser
+      end
+
+      it 'should find by id' do
+        section.selector id: 'form'
+        section.browser_element[:id].should == 'form'
+      end
+
+      it 'should find by css' do
+        section.selector css: '.form'
+        section.browser_element[:id].should == 'form'
+      end
+    end
+  end
+
+  describe 'method_missing' do
+    it 'should delegate to capybara' do
+      @elements_page.form_by_css.visible?.should be(true)
+    end
+
+    it 'should throw default exception if the method does not exist on the capybara object' do
+      expect { @elements_page.form_by_css.bobbins }.to raise_exception NoMethodError
+    end
+  end
+
+  it 'can have elements' do
+    @elements_page.form_by_css.link_in_form.visible?.should be_true
+  end
+
+
+  describe 'construction' do
+
+    let(:page_section_class) do
+      page_section_class = Class.new do
+        extend PageMagic::PageSection
+      end
+      page_section_class.stub(:name).and_return('PageSection')
+      page_section_class
+    end
+
+    let(:selector) { {css: '.class_name'} }
+
+    let!(:browser) { double('browser', find: :browser_element) }
+    let!(:parent_page_element){ double('parent_page_element', browser_element: browser)}
+
+    context 'selector' do
+      it 'should use the class defined selector if one is not given to the constructor' do
+        page_section_class.selector selector
+        page_section_class.new(parent_page_element).selector.should == selector
+      end
+
+      it 'should raise an error if a class selector is not defined and one is not given to the constructor' do
+        expect { page_section_class.new(parent_page_element) }.to raise_error(PageMagic::PageSection::UndefinedSelectorException)
+      end
+    end
+
+    context 'name' do
+      it 'should default to the name of the class if one is not supplied' do
+        page_section_class.selector selector
+        page_section_class.new(parent_page_element).name.should == :page_section
+      end
+    end
+  end
+end

data/spec/session_spec.rb

@@ -0,0 +1,64 @@
+require 'spec_helper'
+
+describe PageMagic::Session do
+
+  let(:page) do
+    Class.new do
+      include PageMagic
+      url :url
+
+      def my_method
+        :called
+      end
+    end
+  end
+
+  let(:another_page_class) do
+    Class.new do
+      include PageMagic
+      url '/another_page1'
+    end
+  end
+
+  let(:browser) { double('browser') }
+
+  it 'should visit the given url' do
+    browser.should_receive(:visit).with(page.url)
+    session = PageMagic::Session.new(browser).visit(page)
+    session.current_page.should be_a(page)
+  end
+
+  context 'method_missing' do
+    it 'should delegate to current page' do
+      browser.stub(:visit)
+      session = PageMagic::Session.new(browser).visit(page)
+      session.my_method.should be(:called)
+    end
+  end
+
+  context 'move_to moves the session object to another page' do
+    it 'can take a class' do
+      page_magic_session = PageMagic::Session.new(double(:browser, current_url: '/another_page1'))
+      page_magic_session.move_to(another_page_class)
+      page_magic_session.current_page.should be_a(another_page_class)
+    end
+
+    it 'can take the name of the class as a string' do
+      class ThePage
+        include PageMagic
+        url '/the_page'
+      end
+
+      page_magic_session = PageMagic::Session.new(double(:browser, current_url: '/the_page'))
+      page_magic_session.move_to("ThePage")
+      page_magic_session.current_page.should be_a(ThePage)
+    end
+
+    it 'should wait until the browser url has changed' do
+      mock_browser = double(:browser, current_url: 'a')
+      page_magic_session = PageMagic::Session.new(mock_browser)
+
+      expect { page_magic_session.move_to(another_page_class) }.to raise_error(Wait::ResultInvalid)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,45 @@
+Bundler.require
+$LOAD_PATH.unshift("#{File.dirname(__FILE__)}/lib")
+require 'page_magic'
+require 'helpers'
+
+RSpec.configure do
+
+  shared_context :webapp do
+    require 'sinatra/base'
+
+    rack_app = Class.new(Sinatra::Base) do
+      get '/page1' do
+        "<a href='/page2'>next page</a>"
+      end
+
+      get '/page2' do
+        'page 2 content'
+      end
+
+      get '/elements' do
+        <<-ELEMENTS
+          <a href='#'>a link</a>
+          <input type='submit' value='a button'/>
+
+          <div id='form' class="form">
+            <a href='#'>a in a form</a>
+          </form>
+        ELEMENTS
+
+      end
+    end
+
+
+    before :each do
+      Capybara.app = rack_app
+    end
+
+    after do
+      Capybara.reset!
+    end
+  end
+
+end
+
+

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification
+name: page_magic
+version: !ruby/object:Gem::Version
+  version: 0.8.8
+  prerelease: 
+platform: ruby
+authors:
+- Leon Davis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-11-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: watir-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: wait
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+- !ruby/object:Gem::Dependency
+  name: watir-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Framework for modeling and interacting with webpages which wraps capybara
+email: info@lad-tech.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- .ruby-gemset
+- .ruby-version
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- VERSION
+- lib/page_magic.rb
+- lib/page_magic/ajax_support.rb
+- lib/page_magic/browser.rb
+- lib/page_magic/element_context.rb
+- lib/page_magic/page_element.rb
+- lib/page_magic/page_elements.rb
+- lib/page_magic/page_magic.rb
+- lib/page_magic/page_section.rb
+- lib/page_magic/session.rb
+- lib/page_magic/wait.rb
+- page_magic.gemspec
+- spec/browser_spec.rb
+- spec/element_context_spec.rb
+- spec/helpers.rb
+- spec/helpers/capybara.rb
+- spec/member_methods_spec.rb
+- spec/page_element_spec.rb
+- spec/page_elements_spec.rb
+- spec/page_magic_spec.rb
+- spec/page_section_spec.rb
+- spec/session_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/ladtech/page_magic
+licenses:
+- ruby
+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: 4130538887016609819
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Framework for modeling and interacting with webpages
+test_files: []