rutl 0.6.0 → 0.8.0

data/lib/utilities/string.rb

@@ -0,0 +1,12 @@
+#
+# Extend string class to PascalCase* snake_cased_strings.
+# Monkey patching that's only needed in this file so far.
+# Move it to utilitiies? Other?
+#
+# * It's Pascal case, not camel case. It starts with a capital.
+#
+class String
+  def pascal_case
+    split('_').map(&:capitalize).join
+  end
+end

data/lib/utilities/waiter.rb

@@ -0,0 +1,23 @@
+#
+# The waiter waits.
+#
+module Waiter
+  require 'timeout'
+
+  POLL_SLEEP_TIME = 0.01
+  DEFAULT_TIMEOUT = 5
+
+  # The lambda passed to await should return false if thing not found
+  # and something truthy if found
+  def await(lamb, timeout = DEFAULT_TIMEOUT, poll_sleep_time = POLL_SLEEP_TIME)
+    Timeout.timeout(timeout) do
+      loop do
+        result = lamb.call
+        return result if result
+        # rubocop:disable Style/SleepCop
+        sleep poll_sleep_time
+        # rubocop:enable Style/SleepCop
+      end
+    end
+  end
+end

data/rutl.gemspec

@@ -38,6 +38,19 @@ Gem::Specification.new do |spec|
   # Works locally and with Travis.
   spec.add_dependency 'webdrivers', '~> 3.0'
 
+  # everything but browsers
+  spec.add_dependency 'appium_lib', '~> 9.14'
+  # need eventmachine for Appium
+  spec.add_dependency 'eventmachine', '~> 1.2'
+  # using this to talk HTTP to the Appium server
+  spec.add_dependency 'faraday', '~> 0.15'
+  if ENV['OS'] == 'Windows_NT'
+    # to get native window handles on Windows
+    spec.add_dependency 'win32-window', '~> 0.2.0.pre'
+    # my test app uses this
+    spec.add_dependency 'tk', '~> 0.2'
+  end
+
   # Dependencies for development only.
   spec.add_development_dependency 'bundler', '~> 1.15'
   spec.add_development_dependency 'gem-release', '~> 1.0'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rutl
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Drew Cooper
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-06-08 00:00:00.000000000 Z
+date: 2018-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -38,6 +38,76 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: appium_lib
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.14'
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: win32-window
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0.pre
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0.pre
+- !ruby/object:Gem::Dependency
+  name: tk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -171,6 +241,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".bundle/config"
 - ".circleci/config.yml"
 - ".coveralls.yml"
 - ".gitignore"
@@ -182,12 +253,18 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- appveyor.yml
 - bin/console
+- bin/ie.reg
 - bin/setup
-- lib/rspec/default_rspec_to_browser.rb
+- bin/window_data.rb
+- lib/rspec/default_method_object_to_app.rb
 - lib/rspec/rutl_matchers.rb
 - lib/rutl.rb
-- lib/rutl/browser.rb
+- lib/rutl/appium/appium_extension.rb
+- lib/rutl/appium/appium_server.rb
+- lib/rutl/appium/windows_test_app_wrapper.rb
+- lib/rutl/application.rb
 - lib/rutl/camera.rb
 - lib/rutl/element.rb
 - lib/rutl/element/button.rb
@@ -199,14 +276,21 @@ files:
 - lib/rutl/element/string_reader_writer_mixin.rb
 - lib/rutl/element/text.rb
 - lib/rutl/interface/base.rb
-- lib/rutl/interface/chrome.rb
-- lib/rutl/interface/firefox.rb
-- lib/rutl/interface/null.rb
+- lib/rutl/interface/browser/browser.rb
+- lib/rutl/interface/browser/chrome.rb
+- lib/rutl/interface/browser/firefox.rb
+- lib/rutl/interface/browser/internet_explorer.rb
+- lib/rutl/interface/browser/null.rb
+- lib/rutl/interface/windows/hello.rb
+- lib/rutl/interface/windows/notepad.rb
+- lib/rutl/interface/windows/windows_app.rb
 - lib/rutl/null_driver/null_driver.rb
 - lib/rutl/null_driver/null_element.rb
-- lib/rutl/page.rb
 - lib/rutl/version.rb
-- lib/utilities.rb
+- lib/rutl/view.rb
+- lib/utilities/check_view.rb
+- lib/utilities/string.rb
+- lib/utilities/waiter.rb
 - rutl.gemspec
 homepage: https://github.com/drewcoo/rutl
 licenses:
@@ -229,7 +313,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: Ruby Ui Test Library

data/lib/rspec/default_rspec_to_browser.rb

@@ -1,22 +0,0 @@
-#
-# Currently not in use.
-# Should go in its own file, too.
-#
-module DefaultRspecToBrowser
-  # rubocop:disable Style/MethodMissingSuper
-  def method_missing(method, *args, &block)
-    if args.empty?
-      browser.send(method)
-    else
-      browser.send(method, *args, &block)
-    end
-  rescue ArgumentError
-    browser.send(method)
-  end
-  # rubocop:enable Style/MethodMissingSuper
-
-  def respond_to_missing?(method, _include_private = false)
-    return false if method =~ /browser/
-    browser.respond_to?(method)
-  end
-end

data/lib/rutl/browser.rb

@@ -1,70 +0,0 @@
-require 'utilities'
-require 'rutl/page'
-
-module RUTL
-  #
-  # Currently called Browser, this top-level class controls a browser and
-  # a fake browser. It will soon call into apps, at which point I need to
-  # rethink this naming convention.
-  #
-  class Browser
-    include Utilities
-
-    attr_reader :interface
-
-    def initialize(type:, rutl_pages: RUTL::PAGES || ENV['RUTL_PAGES'])
-      if rutl_pages.nil? || rutl_pages.empty?
-        raise "Set RUTL::PAGES or ENV['RUTL_PAGES'] or pass dir as rutl_pages:"
-      end
-      # This is kind of evil. Figure out how to ditch the $ variable.
-      $browser = self
-      @interface = nil # TODO: Why this line? Do I need to do this?
-      @interface = load_interface(type)
-      @interface.pages = load_pages(dir: rutl_pages)
-    end
-
-    def method_missing(method, *args, &block)
-      if args.empty?
-        @interface.send(method)
-      else
-        @interface.send(method, *args, &block)
-      end
-    end
-
-    def respond_to_missing?(*args)
-      @interface.respond_to?(*args)
-    end
-
-    private
-
-    def load_interface(type)
-      require "rutl/interface/#{type}"
-      klass = "RUTL::Interface::#{type.to_s.capitalize}"
-      Object.const_get(klass).new
-    end
-
-    def load_pages(*)
-      pages = []
-      require_pages.each do |klass|
-        # Don't have @interface set yet.
-        # That would have been the param to new, :interface.
-        pages << Object.const_get(klass).new(@interface)
-      end
-      pages
-    end
-
-    # Ugly. Requires files for page objects.
-    # Returns array of class names to load.
-    def require_pages(dir: 'spec/pages')
-      names = []
-      Dir["#{dir}/*"].each do |file|
-        require "rutl/../../#{file}"
-        File.open(file).each do |line|
-          bingo = line.match(/class (.*) < RUTL::Page/)
-          names << bingo[1] if bingo && bingo[1]
-        end
-      end
-      names
-    end
-  end
-end

data/lib/rutl/interface/null.rb

@@ -1,35 +0,0 @@
-require 'rutl/interface/base'
-
-module RUTL
-  module Interface
-    #
-    # Interface-level code for fake browser.
-    #
-    class Null < Base
-      def initialize
-        context = RUTL::Element::ElementContext.new(destinations: nil,
-                                                    interface: self,
-                                                    selectors: [])
-        @driver = NullDriver.new(context)
-        super
-      end
-
-      # The null driver needs to talk to the null interface.
-      # Other driver/interface relations are not like this.
-      attr_writer :current_page
-
-      def current_page
-        # Default to @pages.first if not set?
-        # A browser can always check its current URL but the null driver can't.
-        @current_page ||= @pages.first
-      end
-
-      def wait_for_transition(destinations)
-        # TODO: Setting @current page didn't do it beacause that set
-        # context.interface.current_page and we wanted this in the browser.
-        @current_page = destinations.first.new(self)
-        $browser.current_page = @current_page
-      end
-    end
-  end
-end

data/lib/utilities.rb

@@ -1,41 +0,0 @@
-#
-# A catch-all bag for stuff I don't have elsewhere yet.
-#
-module Utilities
-  require 'timeout'
-
-  POLL_SLEEP_TIME = 0.01
-  DEFAULT_TIMEOUT = 5
-
-  # The lambda passed to await should return false if thing not found
-  # and something truthy if found
-  def await(lamb, timeout = DEFAULT_TIMEOUT, poll_sleep_time = POLL_SLEEP_TIME)
-    Timeout.timeout(timeout) do
-      loop do
-        result = lamb.call
-        return result if result
-        # rubocop:disable Style/SleepCop
-        sleep poll_sleep_time
-        # rubocop:enable Style/SleepCop
-      end
-    end
-  end
-
-  def class_info(object)
-    result = "CLASS: #{object.class}"
-    result += "\nmethods: #{(object.methods - Class.methods).sort}\n"
-    result
-  end
-
-  # Just call "caller" with no args for stack trace.
-  def location
-    caller(1..1).first
-  end
-
-  def page?(checkme)
-    checkme.ancestors.include?(RUTL::Page)
-  rescue NoMethodError
-    # This isn't a even a class. It's no page!
-    false
-  end
-end