ferris_watir 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e3144b5948fc00256b3135d0d1c0f61f1497fa67
+  data.tar.gz: a63d82bc5af9f8377c1656590d8be5b24f27e189
+SHA512:
+  metadata.gz: 6800843dbcd76f05a19662550c01e534f6282ba884979db15adc191b4812c0c17756932495b09496c87a64fcc2515d11dd92e1b13462addc8f222e9ea2a9a4e2
+  data.tar.gz: 48297a6ceb0877bcdd5ff9cb7c8b918601b8d375b3b428d12770d507c6810ff97b0590e85f39b722134ef019e42b1f96739992745a31ed0b491ad4a4ce7d7c9e

data/CHANGES.md

@@ -0,0 +1,3 @@
+### 0.1.0 (2017-01-17)
+
+* initial commit

data/README.md

@@ -0,0 +1,6 @@
+# Ferris
+
+## Synopsis
+
+An un-opinionated testing framework built on top of WATIR which provides massive power with minimal DSL. 
+

data/lib/ferris.rb

@@ -0,0 +1,2 @@
+require 'watir'
+require 'ferris/core'

data/lib/ferris/core.rb

@@ -0,0 +1,153 @@
+module Ferris
+  module Browser
+    class << self
+      attr_accessor :browser
+    end
+
+    def browser
+      Browser.browser
+    end
+  end
+
+  module Region
+    def base_url(url = nil)
+      @base_url ||= url
+    end
+
+    def region(name, class_name, &blk)
+      define_method("#{name}_region_object") do
+        class_name.base_url = self.class.base_url
+        class_name.new.tap do |region|
+          if block_given?
+            root = self.instance_exec(&blk)
+            return root.map {|root| class_name.new.tap {|region| region.root = root} } if root.respond_to?(:to_a)
+            region.root = root
+          end
+        end
+      end
+      self.instance_eval { private "#{name}_region_object" }
+
+      define_method("#{name}!") { self.class.region_list["@_#{name}"] ||= send("#{name}_region_object") }
+      define_method(name)  { self.class.region_list["@_#{name}"] = send("#{name}_region_object") }
+
+      # TODO: Convert to .present? use
+      define_method("#{name}_present?") { [send(name)].flatten.map(&:root).map(&:present?).all? }
+    end
+    alias_method :page, :region
+
+    def region_list
+      @regions ||= {}
+    end
+  end
+
+  class Core
+    extend Region
+    include Watir::Waitable
+
+    attr_reader   :browser, :base_url
+    attr_accessor :root
+
+    def initialize(browser = Browser.browser)
+      @browser = browser
+      @base_url = self.class.base_url || ''
+    end
+
+    def inspect
+      '#<%s url=%s title=%s>' % [self.class, url.inspect, title.inspect]
+    end
+    alias selector_string inspect
+
+    def present?
+      raise 'No root element set.' unless root
+      root.present?
+    end
+
+    def visit(*args)
+      browser.goto page_url(*args)
+      exception = Selenium::WebDriver::Error::WebDriverError
+      message = "Expected to be on #{self.class}, but conditions not met"
+      raise exception, message if verifiable? && !loaded?
+      self
+    end
+
+    def verifiable?
+      self.class.require_url || self.respond_to?(:page_title) || self.class.required_element_list.any?
+    end
+
+    def loaded?
+      raise Selenium::WebDriver::Error::WebDriverError, 'Cannot verify a page/region without requirements' unless page_verifiable?
+      [!self.class.require_url || check_url, !respond_to?(:page_title) || check_title, !self.class.required_element_list.any? || check_required_elements].all?
+    end
+
+    def check_url
+      page_url[%r{^#{URI.parse(page_url).scheme}://(.*?)/?$}, 1] == browser.url[%r{^#{URI.parse(browser.url).scheme}://(.*?)/?$}, 1]
+    end
+
+    def check_title
+      browser.title == page_title
+    end
+
+    def check_required_elements
+      browser.wait_until { |_b| self.class.required_element_list.all? { |e| send(e).present? } }
+    rescue Watir::Wait::TimeoutError
+      false
+    end
+
+    class << self
+      attr_writer   :required_element_list
+      attr_reader   :require_url
+      attr_accessor :base_url
+
+      def page_url(required: false)
+        @require_url = required
+        define_method('page_url') {|*args| base_url + yield(*args) }
+      end
+      alias_method :partial_url, :page_url
+
+      def page_title
+        define_method('page_title') {|*args| yield(*args) }
+      end
+
+      def required_element_list
+        @required_element_list ||= []
+      end
+
+      def inherited(subclass)
+        subclass.required_element_list = required_element_list.dup
+      end
+
+      def element(name, required: false, &block)
+        define_method(name) {|*args| self.instance_exec(*args, &block) }
+        required_element_list << name.to_sym if required
+      end
+    end
+  end
+
+  module SiteObject
+    def self.configure(&blk)
+      raise 'Must provide block with defined regions' unless block_given?
+      last_defined_class = defined_classes.last
+      last_defined_class.include Browser
+      last_defined_class.extend Region
+      last_defined_class.instance_exec(&blk)
+    end
+
+    def self.defined_classes
+      self.constants.select {|k| self.const_get(k).is_a? Class }.map {|class_name| Object.const_get("#{self.to_s}::#{class_name.to_s}") }
+    end
+
+    def self.included(_kls)
+      @@defined_classes = defined_classes
+    end
+
+    def method_missing(name, *arg, &blk)
+      @@defined_classes.each {|class_name| return class_name.new.send(name, *arg, &blk)  if class_name.new.respond_to?(name) }
+      super
+    end
+
+    def respond_to_missing?(method_name, _include_private = false)
+      @@defined_classes.each {|class_name| return true if class_name.new.respond_to?(method_name)}
+      super
+    end
+  end
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification
+name: ferris_watir
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Automation Wizards
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-02-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: watir
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.0.2
+- !ruby/object:Gem::Dependency
+  name: watir_model
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+description: 'An un-opinionated testing framework built on top of WATIR which provides
+  massive power with minimal DSL. '
+email:
+- Justin.Commu@loblaw.ca
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGES.md
+- README.md
+- lib/ferris.rb
+- lib/ferris/core.rb
+homepage: https://loblawdigital.ca
+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.6.7
+signing_key: 
+specification_version: 4
+summary: Next level web testing framework
+test_files: []