rutl 0.6.0 → 0.8.0

data/lib/rutl/interface/browser/browser.rb

@@ -0,0 +1,22 @@
+require 'selenium-webdriver'
+require 'rutl/interface/base'
+
+module RUTL
+  module Interface
+    #
+    # Small interface for Chrome browser.
+    #
+    class Browser < Base
+      def initialize
+        super
+      end
+
+      def current_view
+        url = @driver.current_url
+        view = find_view(url)
+        raise "NOT FOUND: #{url}, VIEWS: #{@views}" unless view
+        view
+      end
+    end
+  end
+end

data/lib/rutl/interface/{chrome.rb → browser/chrome.rb}

@@ -1,12 +1,12 @@
 require 'selenium-webdriver'
-require 'rutl/interface/base'
+require 'rutl/interface/browser/browser'
 
 module RUTL
   module Interface
     #
     # Small interface for Chrome browser.
     #
-    class Chrome < Base
+    class Chrome < Browser
       # rubocop:disable Metrics/MethodLength
       def initialize
         @logged_in = true
@@ -15,7 +15,7 @@ module RUTL
         options.add_argument('--disable-popup-blocking')
         options.add_argument('--disable-translate')
         # Run headless on TravisCI
-        if ENV['TRAVIS'] == 'true'
+        if ENV['TRAVIS']
           options.add_argument('--disable-gpu')
           options.add_argument('--headless ')
           options.add_argument('--no-sandbox')
@@ -24,13 +24,6 @@ module RUTL
         super
       end
       # rubocop:enable Metrics/MethodLength
-
-      def current_page
-        url = @driver.current_url
-        page = find_page(url)
-        raise "PAGE NOT FOUND: #{url}, PAGES: #{@pages}" unless page
-        page
-      end
     end
   end
 end

data/lib/rutl/interface/{firefox.rb → browser/firefox.rb}

@@ -1,29 +1,22 @@
 require 'selenium-webdriver'
-require 'rutl/interface/base'
+require 'rutl/interface/browser/browser'
 
 module RUTL
   module Interface
     #
     # Small interface for Chrome browser.
     #
-    class Firefox < Base
+    class Firefox < Browser
       def initialize
         @logged_in = true
         options = Selenium::WebDriver::Firefox::Options.new
         options.add_argument('--ignore-certificate-errors')
         options.add_argument('--disable-popup-blocking')
         options.add_argument('--disable-translate')
-        options.add_argument('--headless') if ENV['TRAVIS'] == 'true'
+        options.add_argument('--headless') if ENV['TRAVIS'] || ENV['CIRCLECI']
         @driver = Selenium::WebDriver.for :firefox, options: options
         super
       end
-
-      def current_page
-        url = @driver.current_url
-        page = find_page(url)
-        raise "PAGE NOT FOUND: #{url}, PAGES: #{@pages}" unless page
-        page
-      end
     end
   end
 end

data/lib/rutl/interface/browser/internet_explorer.rb

@@ -0,0 +1,23 @@
+require 'selenium-webdriver'
+require 'rutl/interface/browser/browser'
+
+module RUTL
+  module Interface
+    #
+    # Small interface for Chrome browser.
+    #
+    class InternetExplorer < Browser
+      def initialize
+        @logged_in = true
+        options = Selenium::WebDriver::IE::Options.new
+        options.add_argument('--ignore-certificate-errors')
+        options.add_argument('--disable-popup-blocking')
+        options.add_argument('--disable-translate')
+        options.ignore_zoom_level = true
+        options.initial_browser_url = 'https://www.google.com/'
+        @driver = Selenium::WebDriver.for :internet_explorer, options: options
+        super
+      end
+    end
+  end
+end

data/lib/rutl/interface/browser/null.rb

@@ -0,0 +1,36 @@
+require 'rutl/interface/browser/browser'
+
+module RUTL
+  module Interface
+    #
+    # Interface-level code for fake application.
+    #
+    class Null < Browser
+      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_view
+
+      def current_view
+        # Default to @view.first if not set?
+        # An application can always check its current URL but
+        # the null driver can't.
+        @current_view ||= @views.first
+      end
+
+      def wait_for_transition(destinations)
+        # TODO: Setting @current view didn't do it beacause that set
+        # context.interface.current_view and we wanted this in the application.
+        @current_view = destinations.first.new(self)
+        $application.current_view = @current_view
+      end
+    end
+  end
+end

data/lib/rutl/interface/windows/hello.rb

@@ -0,0 +1,36 @@
+require 'selenium-webdriver'
+require 'rutl/interface/windows/windows_app'
+
+module RUTL
+  module Interface
+    #
+    # The hello world app with an exit button.
+    #
+    class Hello < WindowsApp
+      def file_name
+        File.expand_path('../../../../spec/hello.rb', __dir__)
+      end
+
+      def initialize
+        @app = WindowsTestApp.new(name: "ruby #{file_name}",
+                                  title: /hello world/i)
+        @app.start
+        driver_opts = base_opts
+        # Have to start app then attach winappdriver because these both fail:
+        # 1. passing hello.rb path as [:caps][:app]
+        # 2. passing ruby.exe path as [:caps][:app] and passing hello.rb
+        #    path as [:caps][:appArguments]
+        driver_opts[:caps][:appTopLevelWindow] = @app.window_handle_string
+        @driver = Appium::Driver.new(driver_opts, false)
+        @driver.start
+        super
+      end
+
+      def current_view
+        # This only works because I only have one view.
+        # Should I? What about dialogs?
+        @views.first
+      end
+    end
+  end
+end

data/lib/rutl/interface/windows/notepad.rb

@@ -0,0 +1,26 @@
+require 'selenium-webdriver'
+require 'rutl/interface/windows/windows_app'
+
+module RUTL
+  module Interface
+    #
+    # Notepad.
+    #
+    class Notepad < WindowsApp
+      def initialize
+        @app_name = 'notepad.exe'
+        driver_opts = base_opts
+        driver_opts[:caps][:app] = 'C:\Windows\System32\notepad.exe'
+        @driver = Appium::Driver.new(driver_opts, false)
+        @driver.start
+        super
+      end
+
+      def current_view
+        # This only works because I only have one view.
+        # Should I? What about dialogs?
+        @views.first
+      end
+    end
+  end
+end

data/lib/rutl/interface/windows/windows_app.rb

@@ -0,0 +1,35 @@
+require 'selenium-webdriver'
+require 'rutl/interface/base'
+
+module RUTL
+  module Interface
+    #
+    # Parent class for all Windows apps.
+    #
+    class WindowsApp < Base
+      def base_opts
+        { caps: { platformName: 'WINDOWS',
+                  platform: 'WINDOWS',
+                  deviceName: 'WindowsPC' },
+          appium_lib: { wait_timeout: 2,
+                        wait_interval: 0.01 } }
+      end
+
+      def kill
+        system "taskkill /f /im #{@app_name} /t 1>nul 2>&1"
+      end
+
+      def open?
+        @driver.find_elements(:id, 0)
+        true
+      rescue Selenium::WebDriver::Error::NoSuchWindowError
+        false
+      end
+
+      def quit
+        @driver.driver_quit
+        kill
+      end
+    end
+  end
+end

data/lib/rutl/null_driver/null_driver.rb

@@ -2,7 +2,7 @@ require 'rutl/null_driver/null_element'
 
 module RUTL
   #
-  # This is at a peer level to the webdrivers but it's for a fake brwoser.
+  # This is at a peer level to the webdrivers but it's for a fake application.
   #
   class NullDriver
     attr_accessor :context
@@ -19,7 +19,7 @@ module RUTL
       RUTL::Element::NullElement.new(context, type, location)
     end
 
-    # Cheap way to handle browser.navigate.to(url)
+    # Cheap way to handle application.navigate.to(url)
     # TODO: Until I care about the url and then I should ????
     def navigate
       context = RUTL::Element::ElementContext.new(interface: @context.interface)
@@ -28,8 +28,8 @@ module RUTL
 
     # Cheap second part to naviate.to(url) calls to look like real drivers.
     def to(url)
-      result = @context.interface.find_page(url)
-      @context.interface.current_page = result
+      result = @context.interface.find_view(url)
+      @context.interface.current_view = result
       result.url
     end
 

data/lib/rutl/null_driver/null_element.rb

@@ -3,7 +3,7 @@ require 'rutl/element/element_context'
 module RUTL
   module Element
     #
-    # This fakes all page elements when used with the null driver.
+    # This fakes all view elements when used with the null driver.
     # It's a dirty way to avoid modeling all of what a driver talks to.
     #
     class NullElement
@@ -21,8 +21,8 @@ module RUTL
 
       # @@string is a class variable because this framework creates new
       # instances of each element every time it accesses them. This is good
-      # behavior by default because pages could change underneath us.
-      # For text fields in the null browser, though, we want to preserve the
+      # behavior by default because views could change underneath us.
+      # For text fields in the null application, though, we want to preserve the
       # values across calls, letting us write and then read.
       def send_keys(string)
         init = @@variables[@location] || ''
@@ -42,7 +42,7 @@ module RUTL
         @@variables[@location] = ''
       end
 
-      def this_css
+      def find_element
         self
       end
 

data/lib/rutl/version.rb

@@ -1,3 +1,3 @@
 module RUTL
-  VERSION = '0.6.0'.freeze
+  VERSION = '0.8.0'.freeze
 end

data/lib/rutl/{page.rb → view.rb}

@@ -3,13 +3,16 @@ require 'rutl/null_driver/null_driver'
 
 module RUTL
   #
-  # Base page class. It's used to call the magical method_messing
-  # stuff to parse the page object files into actual objects.
+  # Base view class. It's used to call the magical method_messing
+  # stuff to parse the view object files into actual objects.
   #
-  class Page
+  class View
+    #
+    # BUGBUG #1: Some view in a generic app should not have URL.
+    #
     # BUGBUG: Kludgy. What do I really want to do here?
-    # Make it easy to define a page's default url and
-    # also matchers for page urls for pages with variable urls?
+    # Make it easy to define a view's default url and
+    # also matchers for view urls for views with variable urls?
     # rubocop:disable Style/TrivialAccessors
     def self.url
       @url
@@ -20,34 +23,40 @@ module RUTL
     end
     # rubocop:enable Style/TrivialAccessors
 
-    # Intentially use a class variable to hald pages. Once they're all loaded
-    # they are all loaded for everyone.
+    def go_to_here
+      # Ovveride this in base view to have something more
+      # complicated than this.
+      @interface.driver.navigate.to(url)
+    end
+
+    def loaded?
+      # Default to only checking url to see if view loaded.
+      url == @interface.driver.current_url
+    end
+
+    # Intentionally use a class variable to hald views. Once they're
+    # all loaded they are all loaded for everyone.
     # rubocop:disable Style/ClassVars
-    @@loaded_pages = []
+    @@loaded_views = []
     # rubocop:enable Style/ClassVars
 
     def initialize(interface)
       @interface = interface
-      # Dirty trick because we're loading all of page classes from files and
+      # Dirty trick because we're loading all of view classes from files and
       # then initializing them, calling their layout methods to do magic.
-      # The Page class knows what pages are loaded.
-      return if @@loaded_pages.include?(self.class)
+      # The view class knows what views are loaded.
+      return if @@loaded_views.include?(self.class)
       layout
-      @@loaded_pages << self.class
+      @@loaded_views << self.class
     end
 
-    def go_to_here
-      # Ovveride this in base page to have something more
-      # complicated than this.
-      @interface.driver.navigate.to(url)
-    end
-
-    # Written by Browser and only used internally.
+    # Written by Application and only used internally.
     attr_writer :interface
 
-    def loaded?
-      url == @interface.driver.current_url
-    end
+    # def loaded?
+    #   # In case I try calling this without defining it first.
+    #   raise 'No #loaded? method defined.'
+    # end
 
     # Dynamically add a method, :<name> (or :<name>= if setter)
     # to the current class where that method creates an instance
@@ -57,7 +66,7 @@ module RUTL
     # As it is, this seems silly to break into pieces for Rubocop.
     # rubocop:disable Metrics/MethodLength
     def add_method(context:, klass:, name:, setter: false)
-      name = "#{name}_#{klass.downcase}"
+      name = "#{name}_#{klass.downcase}" if RUTL::HUNGARIAN
       constant = Module.const_get("RUTL::Element::#{klass.capitalize}")
       self.class.class_exec do
         if setter
@@ -77,7 +86,7 @@ module RUTL
     # This creates a new element instance whenever it's called.
     # Because of that we can't keep state in any element objects.
     # That seems like a good thing, actually.
-    # Called by layout method on pages.
+    # Called by layout method on views.
     #
     # Hard to make shorter.
     # rubocop:disable Metrics/MethodLength
@@ -103,15 +112,15 @@ module RUTL
       # Is this right at all???
       case args[0].to_s
       when /button/, /checkbox/, /element/, /link/, /text/,
-           'driver', 'url', 'children', 'loaded?'
+           'driver', 'children', 'loaded?'
         true
       when 'ok_link'
-        raise 'OK LINK WAY DOWN HERE IN BASE PAGE!!!'
+        raise 'OK LINK WAY DOWN HERE IN BASE VIEW!!!'
       else
         # I think it's good to raise but change the message.
         raise 'TODO: BETTER ERROR MESSAGE, PLEASE. I AM SHOUTING!!!\n' \
-              'Drew, you hit this most often when checking current page ' \
-              "rather than current page class:\n\n #{args}"
+              'Drew, you hit this most often when checking current view ' \
+              "rather than current view class:\n\n #{args}"
         # I think I want to raise instead of returningn false.
       end
     end

data/lib/utilities/check_view.rb

@@ -0,0 +1,12 @@
+#
+# #view? is used in interface/base.rb and in rspec/rutl_matchers.rb
+# so the method lives over in this lonely place.
+#
+module CheckView
+  def view?(checkme)
+    checkme.ancestors.include?(RUTL::View)
+  rescue NoMethodError
+    false
+  end
+  alias page? view?
+end