swamp 0.0.1

data/spec/swamp/input_buttons_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+module Swamp
+  describe InputButtons do
+    let(:input_buttons) { Swamp::InputButtons.new }
+
+    it "delegates to capybara the responsibility to get the submit elements" do
+      element = {'value' => "Log In", 'id' => "u_0_b"}
+      element.stub(:visible?).and_return(true)
+      input_buttons.page.should_receive(:all).with('input[type="submit"]').and_return([element])
+      input_buttons.get
+    end
+
+    context "when the element is visible" do
+      context "when the submit element has value and id" do
+        let(:element) { {'value' => "Log In", 'id' => "u_0_b"} }
+
+        before(:each) do
+          element.stub(:visible?).and_return(true)
+          input_buttons.page.stub(:all).with('input[type="submit"]').and_return([element])
+        end
+
+        it "returns the element in the array using the value as the name" do
+          input_buttons.get.should have(1).input_submit
+          input_buttons.get.first.name.should == "Log In"
+        end
+
+        it "returns the element in the array using the id as the selector" do
+          input_buttons.get.should have(1).input_submit
+          input_buttons.get.first.selector.should == "#u_0_b"
+        end
+      end
+
+      context "when the submit element has value but has no id" do
+        let(:element) { {'value' => "Log In", 'class' => "btn without id"} }
+
+        before(:each) do
+          element.stub(:visible?).and_return(true)
+          input_buttons.page.stub(:all).with('input[type="submit"]').and_return([element])
+        end
+
+        it "returns the element in the array using the value as the name" do
+          input_buttons.get.should have(1).input_submit
+          input_buttons.get.first.name.should == "Log In"
+        end
+
+        it "returns the element in the array using the class concatenated with the value as the selector" do
+          input_buttons.get.should have(1).input_submit
+          input_buttons.get.first.selector.should == "input.btn.without.id[value='Log In']"
+        end
+      end
+    end
+
+    context "when the element is not visible" do
+      it "returns an empty array" do
+        element = {'value' => "Log In", 'id' => "u_0_b"}
+        element.stub(:visible?).and_return(false)
+        input_buttons.page.stub(:all).with('input[type="submit"]').and_return([element])
+        input_buttons.get.should == []
+      end
+    end
+  end
+end

data/spec/swamp/interface_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+module Swamp
+  describe Interface do
+    let(:output) { output = double('output').as_null_object }
+    let(:wrapper) { wrapper = double('wrapper').as_null_object }
+    let(:interface) { interface = Swamp::Interface.new(output, wrapper) }
+
+    describe "#run" do
+      it "prompts for the url" do
+        output.should_receive(:puts).with("Enter the url for the page to be scanned:")
+        interface.run
+      end
+    end
+
+    describe "#scan" do
+      it "delegates the responsibility to fire up the browser to the wrapper class" do
+        wrapper.should_receive(:explore)
+        interface.scan("http://www.fakepage.com")
+      end
+
+      it "delegates the page parsing to the wrapper class" do
+        wrapper.should_receive(:scan).and_return(["code_snippet"])
+        interface.scan("http://www.fakepage.com")
+      end
+
+      context "when it scans a valid url" do
+        it "sends the code snippets of the scanned page to the output" do
+          wrapper.stub(:scan).and_return(["code_snippet"])
+          output.should_receive(:puts).with("code_snippet")
+          interface.scan("http://www.fakepage.com")
+        end
+      end
+
+      context "when it scans an invalid url" do
+        it "sends a warning message to the output" do
+          output.should_receive(:puts).with("Please enter a valid url!")
+          interface.scan("abc123")
+        end
+      end
+
+      context "when it receives an enter keystroke" do
+        context "when no page was scanned yet" do
+          it "sends a warning message to the output" do
+            wrapper.stub(:page_visited).and_return(false)
+            output.should_receive(:puts).with("Please enter a valid url!")
+            interface.scan("\n")
+          end
+        end
+
+        context "when a page was already scanned" do
+          it "scans the current page and sends the code snippets to the output" do
+            wrapper.stub(:page_visited).and_return(true)
+            wrapper.stub(:scan).and_return(["code_snippet"])
+            output.should_receive(:puts).with("code_snippet")
+            interface.scan("\n")
+          end
+        end
+      end
+
+    end
+  end
+end

data/spec/swamp/links_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+module Swamp
+  describe Links do
+    let(:links) { Swamp::Links.new }
+
+    it "delegates to capybara the responsibility to get the links" do
+      element = {'id' => "forgot-password", 'href' => "https://somewhere.com"}
+      element.stub(:visible?).and_return(true)
+      links.page.should_receive(:all).with('a[href]').and_return([element])
+      links.get
+    end
+
+    context "when the element is visible" do
+      context "when the link has id" do
+        let(:element) { {'id' => "forgot-password", 'href' => "https://somewhere.com"} }
+
+        before(:each) do
+          element.stub(:visible?).and_return(true)
+          links.page.stub(:all).with('a[href]').and_return([element])
+        end
+
+        it "returns the element in the array using the id as the name" do
+          links.get.should have(1).link
+          links.get.first.name.should == "forgot-password"
+        end
+
+        it "returns the element in the array using the id as the selector" do
+          links.get.should have(1).select_box
+          links.get.first.selector.should == "forgot-password"
+        end
+      end
+    end
+  end
+end

data/spec/swamp/select_boxes_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+module Swamp
+  describe SelectBoxes do
+    let(:select_boxes) { Swamp::SelectBoxes.new }
+
+    it "delegates to capybara the responsibility to get the select box elements" do
+      element = {'id' => "month", 'name' => "birthday_month"}
+      element.stub(:visible?).and_return(true)
+      select_boxes.page.should_receive(:all).with('select').and_return([element])
+      select_boxes.get
+    end
+
+    context "when the element is visible" do
+      context "when the select box has id" do
+        let(:element) { {'id' => "month", 'name' => "birthday_month"} }
+
+        before(:each) do
+          element.stub(:visible?).and_return(true)
+          select_boxes.page.stub(:all).with('select').and_return([element])
+        end
+
+        it "returns the element in the array using the id as the name" do
+          select_boxes.get.should have(1).select_box
+          select_boxes.get.first.name.should == "month"
+        end
+
+        it "returns the element in the array using the id as the selector" do
+          select_boxes.get.should have(1).select_box
+          select_boxes.get.first.selector.should == "month"
+        end
+      end
+
+      context "when the select element has name but no id" do
+        let(:element) { {'name' => "birthday_month"} }
+
+        before(:each) do
+          element.stub(:visible?).and_return(true)
+          select_boxes.page.stub(:all).with('select').and_return([element])
+        end
+
+        it "returns the element in the array using the name as the name" do
+          select_boxes.get.should have(1).select_box
+          select_boxes.get.first.name.should == "birthday_month"
+        end
+
+        it "returns the element in the array using the name as the selector" do
+          select_boxes.get.should have(1).select_box
+          select_boxes.get.first.selector.should == "birthday_month"
+        end
+      end
+    end
+  end
+end

data/spec/swamp/wrapper_spec.rb

@@ -0,0 +1,104 @@
+require 'spec_helper'
+module Swamp
+  describe Wrapper do
+    describe "#explore" do
+      it "fires up the browser to a given url" do
+        url = "www.fakepage.com"
+        meta_collection = []
+        wrapper = Swamp::Wrapper.new(meta_collection)
+        wrapper.should_receive(:visit).with(url).and_return("")
+        wrapper.explore(url)
+      end
+    end
+
+    describe "#scan" do
+      let(:fields) { double('fields').as_null_object }
+      let(:buttons) { double('buttons').as_null_object }
+      let(:input_buttons) { double('input_buttons').as_null_object }
+      let(:select_boxes) { double('select_boxes').as_null_object }
+      let(:links) { double('links').as_null_object }
+      let(:generic_element_collection) { double('generic_element_collection').as_null_object }
+
+      it "delegates the responsibility of getting the elements for each element collection object" do
+        meta_collection = [generic_element_collection]
+        wrapper = Swamp::Wrapper.new(meta_collection)
+        meta_collection.each { |element_collection| element_collection.should_receive(:get).and_return([]) }
+        wrapper.scan
+      end
+
+      context "when field elements were found" do
+        let(:field) { Swamp::Field.new("username", "username") }
+
+        it "returns an array of formatted code snippets for fields" do
+          fields.stub(:get).and_return([field])
+
+          meta_collection = [fields]
+          wrapper = Swamp::Wrapper.new(meta_collection)
+          wrapper.scan.should == ["def type_username(input)\n  source.fill_in(\"username\", with: input)\nend"]
+        end
+      end
+
+      context "when button elements were found" do
+        let(:button) { Swamp::Button.new("log_in", "log_in") }
+
+        it "returns an array of formatted code snippets for buttons" do
+          buttons.stub(:get).and_return([button])
+
+          meta_collection = [buttons]
+          wrapper = Swamp::Wrapper.new(meta_collection)
+          wrapper.scan.should == ["def log_in\n  source.click_button(\"log_in\")\nend"]
+        end
+      end
+
+      context "when input button elements were found" do
+        let(:input_button) { Swamp::InputButton.new("Log In", "input#u_0_b") }
+
+        it "returns an array of formatted code snippets for input buttons" do
+          input_buttons.stub(:get).and_return([input_button])
+
+          meta_collection = [input_buttons]
+          wrapper = Swamp::Wrapper.new(meta_collection)
+          wrapper.scan.should == ["def log_in\n  source.find(:css, \"input#u_0_b\").click\nend"]
+        end
+      end
+
+      context "when select box elements were found" do
+        let(:select_box) { Swamp::SelectBox.new("month", "month") }
+
+        it "returns an array of formatted code snippets for select boxes" do
+          select_boxes.stub(:get).and_return([select_box])
+
+          meta_collection = [select_boxes]
+          wrapper = Swamp::Wrapper.new(meta_collection)
+          wrapper.scan.should == ["def select_month(option)\n  source.select(option, :from => \"month\")\nend"]
+        end
+      end
+
+      context "when links were found" do
+        let(:link) { Swamp::Link.new("forgot-password", "forgot-password") }
+
+        it "returns an array of formatted code snippets for links" do
+          links.stub(:get).and_return([link])
+
+          meta_collection = [links]
+          wrapper = Swamp::Wrapper.new(meta_collection)
+          wrapper.scan.should == ["def forgot_password\n  source.click_link(\"forgot-password\")\nend"]
+        end
+      end
+
+      context "when no elements were found" do
+        it "returns an empty array" do
+          fields.stub(:get).and_return([])
+          buttons.stub(:get).and_return([])
+          input_buttons.stub(:get).and_return([])
+          select_boxes.stub(:get).and_return([])
+          links.stub(:get).and_return([])
+
+          meta_collection = [fields, buttons, input_buttons, select_boxes]
+          wrapper = Swamp::Wrapper.new(meta_collection)
+          wrapper.scan.should == []
+        end
+      end
+    end
+  end
+end

data/swamp.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'swamp/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "swamp"
+  spec.version       = Swamp::VERSION
+  spec.authors       = ["Juraci de Lima Vieira Neto"]
+  spec.email         = ["juraci.vieira@gmail.com"]
+  spec.description   = "Automatically generates the methods and selectors to help on faster page-object creation using capybara"
+  spec.summary       = "Swamp, where capybaras belong"
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "capybara"
+  spec.add_dependency "selenium-webdriver"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "cucumber"
+  spec.add_development_dependency "json"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "pry-nav"
+end

metadata

@@ -0,0 +1,274 @@
+--- !ruby/object:Gem::Specification
+name: swamp
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Juraci de Lima Vieira Neto
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: selenium-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-nav
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Automatically generates the methods and selectors to help on faster page-object
+  creation using capybara
+email:
+- juraci.vieira@gmail.com
+executables:
+- swamp
+extensions: []
+extra_rdoc_files: []
+files:
+- .rspec
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/swamp
+- features/specifications/user_scans_a_page_interactively.feature
+- features/specifications/user_scans_buttons_in_a_page.feature
+- features/specifications/user_scans_fields_in_a_page.feature
+- features/specifications/user_scans_input_buttons_in_a_page.feature
+- features/specifications/user_scans_links_in_a_page.feature
+- features/specifications/user_scans_select_box_elements_in_a_page.feature
+- features/specifications/user_starts_swamp.feature
+- features/step_definitions/swamp_steps.rb
+- features/support/env.rb
+- features/support/page_examples/button.html
+- features/support/page_examples/button.html~
+- features/support/page_examples/button_without_text.html
+- features/support/page_examples/button_without_text_id_and_value.html
+- features/support/page_examples/button_without_text_without_id_with_value.html
+- features/support/page_examples/checkbox.html
+- features/support/page_examples/field.html
+- features/support/page_examples/field_without_id.html
+- features/support/page_examples/input_submit.html
+- features/support/page_examples/input_submit_without_id.html
+- features/support/page_examples/link.html
+- features/support/page_examples/link.html~
+- features/support/page_examples/link_with_id.html
+- features/support/page_examples/radio.html
+- features/support/page_examples/select_box_with_id.html
+- features/support/page_examples/select_box_with_name_only.html
+- features/support/setup.rb
+- lib/swamp.rb
+- lib/swamp/base.rb
+- lib/swamp/builder.rb
+- lib/swamp/button.rb
+- lib/swamp/buttons.rb
+- lib/swamp/element.rb
+- lib/swamp/elements.rb
+- lib/swamp/evaluator.rb
+- lib/swamp/field.rb
+- lib/swamp/fields.rb
+- lib/swamp/formatter.rb
+- lib/swamp/input_button.rb
+- lib/swamp/input_buttons.rb
+- lib/swamp/interface.rb
+- lib/swamp/link.rb
+- lib/swamp/links.rb
+- lib/swamp/select_box.rb
+- lib/swamp/select_boxes.rb
+- lib/swamp/version.rb
+- lib/swamp/wrapper.rb
+- spec/spec_helper.rb
+- spec/swamp/builder_spec.rb
+- spec/swamp/buttons_spec.rb
+- spec/swamp/evaluator_spec.rb
+- spec/swamp/fields_spec.rb
+- spec/swamp/formatter_spec.rb
+- spec/swamp/input_buttons_spec.rb
+- spec/swamp/interface_spec.rb
+- spec/swamp/links_spec.rb
+- spec/swamp/select_boxes_spec.rb
+- spec/swamp/wrapper_spec.rb
+- swamp.gemspec
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Swamp, where capybaras belong
+test_files:
+- features/specifications/user_scans_a_page_interactively.feature
+- features/specifications/user_scans_buttons_in_a_page.feature
+- features/specifications/user_scans_fields_in_a_page.feature
+- features/specifications/user_scans_input_buttons_in_a_page.feature
+- features/specifications/user_scans_links_in_a_page.feature
+- features/specifications/user_scans_select_box_elements_in_a_page.feature
+- features/specifications/user_starts_swamp.feature
+- features/step_definitions/swamp_steps.rb
+- features/support/env.rb
+- features/support/page_examples/button.html
+- features/support/page_examples/button.html~
+- features/support/page_examples/button_without_text.html
+- features/support/page_examples/button_without_text_id_and_value.html
+- features/support/page_examples/button_without_text_without_id_with_value.html
+- features/support/page_examples/checkbox.html
+- features/support/page_examples/field.html
+- features/support/page_examples/field_without_id.html
+- features/support/page_examples/input_submit.html
+- features/support/page_examples/input_submit_without_id.html
+- features/support/page_examples/link.html
+- features/support/page_examples/link.html~
+- features/support/page_examples/link_with_id.html
+- features/support/page_examples/radio.html
+- features/support/page_examples/select_box_with_id.html
+- features/support/page_examples/select_box_with_name_only.html
+- features/support/setup.rb
+- spec/spec_helper.rb
+- spec/swamp/builder_spec.rb
+- spec/swamp/buttons_spec.rb
+- spec/swamp/evaluator_spec.rb
+- spec/swamp/fields_spec.rb
+- spec/swamp/formatter_spec.rb
+- spec/swamp/input_buttons_spec.rb
+- spec/swamp/interface_spec.rb
+- spec/swamp/links_spec.rb
+- spec/swamp/select_boxes_spec.rb
+- spec/swamp/wrapper_spec.rb