rutl 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21fa6d406b33dee3134e1cf6da770e4f51434664d55d109b19858290ec5f0776
-  data.tar.gz: ab14d6f097caa9bbdc888ca8409c711fed65da87129bbcb03f96fa265aa5df34
+  metadata.gz: f18aec216e23b12e55da96c52395e8da7521920cf48ab5090038192a034e991b
+  data.tar.gz: 7b3bc290be5e444a4c19952230b2ea1544efda3ab5e76cb16266a952c2f036a4
 SHA512:
-  metadata.gz: 5c81506c59bc5224d50928351455241d83123cfb7d2ff3a8383b0aad7e0914ede6f20128e5dbe34d87743c0575ac33972b517a2506f51292a32dad64b29abc03
-  data.tar.gz: 2e99c3d93ae8cd9af232ffc26d214866f649cd2d295a553818e835e6e7b0ee3abd4f805741fefbfd85a910251451358309435fe3c6bd4bdc4419868cc667203c
+  metadata.gz: afbebeca0867745a569a658753409a46146d982f859f7967c8d8aa524407dd9534ab3ddcf54b5233002a8cedc33c6501efb813b60f99c38af8647583422cd467
+  data.tar.gz: 2b8cf8f0fc9d31d1caf7ff6bb964be78396a7d127c5268f818018d709470b23e4c10a91619a2f22ec13f6ba5495d5e41b89c7cfd51ec936ae375a50394dfcfcb

data/.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_PATH: "vendor/bundle"

data/.gitignore

@@ -1,4 +1,3 @@
-/.bundle/
 /*.gem
 /.yardoc
 /debug.log
@@ -9,3 +8,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+/vendor/

data/.rubocop.yml

@@ -33,7 +33,7 @@ Metrics/MethodLength:
 # But should think about this first.
 Style/BracesAroundHashParameters:
   Exclude:
-    - 'spec/pages/**/*'
+    - 'spec/views/**/*'
 
 # NullDriverPageElement plays dirty tricks with @@variables to simulate
 # longer-lived data sources.

data/.rubocop_todo.yml

@@ -1,28 +1,48 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2018-06-07 20:55:18 -0700 using RuboCop version 0.56.0.
+# on 2018-07-02 00:08:22 -0700 using RuboCop version 0.56.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
+# Offense count: 2
+Lint/EmptyWhen:
+  Exclude:
+    - 'spec/web_browser_spec.rb'
+
 # Offense count: 1
+Metrics/AbcSize:
+  Max: 22
+
+# Offense count: 2
 # Configuration parameters: CountComments.
 Metrics/MethodLength:
-  Max: 11
+  Max: 13
 
-# Offense count: 2
-Style/ClassVars:
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/BlockComments:
+  Exclude:
+    - 'spec/windows_spec.rb'
+
+# Offense count: 9
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: braces, no_braces, context_dependent
+Style/BracesAroundHashParameters:
   Exclude:
-    - 'lib/rutl/driver/null_driver_page_element.rb'
-    - 'lib/rutl/base_page.rb'
-    - 'lib/rutl/null_driver/null_element.rb'
+    - 'spec/pages/**/*'
+    - 'spec/views/notepad/notepad.rb'
+    - 'spec/views/web/internet_login_error_view.rb'
+    - 'spec/views/web/internet_login_view.rb'
+    - 'spec/views/web/view1.rb'
 
 # Offense count: 4
 # Configuration parameters: AllowedVariables.
 Style/GlobalVars:
   Exclude:
-    - 'lib/rutl/browser.rb'
+    - 'lib/rutl/application.rb'
     - 'lib/rutl/element/element.rb'
     - 'lib/rutl/element/element_context.rb'
     - 'lib/rutl/interface/null.rb'
@@ -30,7 +50,14 @@ Style/GlobalVars:
 # Offense count: 4
 Style/MethodMissingSuper:
   Exclude:
-    - 'lib/rutl/browser.rb'
+    - 'lib/rutl/application.rb'
     - 'lib/rutl/element/element.rb'
     - 'lib/rutl/interface/base.rb'
-    - 'lib/rutl/page.rb'
+    - 'lib/rutl/view.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: AllowAsExpressionSeparator.
+Style/Semicolon:
+  Exclude:
+    - 'spec/hello.rb'

data/.travis.yml

@@ -1,6 +1,7 @@
 sudo: required
 addons:
   chrome: stable
+  firefox: latest
 language: ruby
 rvm:
   - 2.3.1

data/README.md

@@ -2,6 +2,7 @@
 
 [![TravisCI](https://api.travis-ci.org/drewcoo/rutl.svg)](https://travis-ci.org/drewcoo/rutl)
 [![CircleCI](https://circleci.com/gh/drewcoo/rutl.svg?style=shield)](https://circleci.com/gh/drewcoo/rutl)
+[![AppVeyor](https://ci.appveyor.com/api/projects/status/09oni14ixl077pr2?svg=true)](https://ci.appveyor.com/project/drewcoo/rutl)
 [![Coverage Status](https://coveralls.io/repos/github/drewcoo/rutl/badge.svg?branch=master)](https://coveralls.io/github/drewcoo/rutl?branch=master)
 [![Gem Version](https://badge.fury.io/rb/rutl.svg)](https://badge.fury.io/rb/rutl)
 [![Codacy Badge](https://api.codacy.com/project/badge/Grade/f95d69f6bdd149e697cf63e842f71600)](https://www.codacy.com/app/drewcoo/rutl?utm_source=github.com&utm_medium=referral&utm_content=drewcoo/rutl&utm_campaign=Badge_Grade)
@@ -22,7 +23,7 @@ Framework goals:
 
 Add this line to your application's Gemfile:
 
-    $ gem 'rutl'
+    $ gem rutl
 
 And then execute:
 
@@ -35,28 +36,30 @@ Or install it yourself as:
 
 ## Usage
 
+
 ### Page Objects
+
 Page objects are a common paradigm in browser testing. This framework uses the
 following convention for page classes:
-* must inherit from Rutl::BasePage (require rutl/base_page)
-* by default, the class should follow the naming convention ending with "Page" (optional?)
-* must have @url defined per page
+* must inherit from `rutl::BasePage` (`require rutl/base_page`)
+* by default, the class should follow the naming convention ending with `Page` (optional?)
+* must have `@url` defined per page
 * must have a layout method such that
- * field types are defined by methods button, checkbox, link, and text (more tbd?)
+ * field types are defined by methods `button`, `checkbox`, `link`, and `text` (more tbd?)
  * field type is followed by name as a symbol (add support for string? tbd)
  * then a comma
  * hash of selectors
-   * key is selector type as symbol (currently only :css)
+   * key is selector type as symbol (currently only `:css`)
    * value is string path
  * optional comma if there are destinations or error conditions
  * optional array of destination page or error condition classes if clicking the element causes transition
 * loaded? method returning boolean to determine when page is loaded
   * defaults to just checking url; overide as needed
-* go_to_here (better name?) method to navigate to the page if we can't just go to the url
+* `go_to_here` (better name?) method to navigate to the page if we can't just go to the url
 * your own methods because it's a plain ol' Ruby class
 
 
- Example:
+Example:
 
 ```ruby
     require 'rutl/base_page'
@@ -97,77 +100,87 @@ The framework loads and manages all the pages. You just have to interact with
 what you can see on whatever page you're on. Let's walk through this.
 * TBD: Does RUTL come with browser drivers? Browsers? What needs to be added?
 * We're using let! because:
-  * it forces instantiation of "browser" every time
-  * we include DefaultRspecToBrowser, defaulting missing methods to "browser"
+  * it forces instantiation of `browser` every time
+  * we `include DefaultRspecToBrowser`, defaulting missing methods to "browser"
   * thus the terse lines that follow
-* We didn't pass named param rutl_pages: to Browser so we must have done one of:
-  * setting environment variable RUTL_PAGES
-  * setting RUTL::PAGES
-* Browser's type: parameter currently supports :chrome, :firefox, and :null.
-* The first call to the browser is goto because it wasn't on a page.
-* Auto-created fields are named "#{friendly_name}_#{field_type}".
-* Getting and setting text fields is as easy as calling a String.
+* We didn't pass named param `rutl_pages:` to `browser` so we must have done one of:
+  * setting environment variable `RUTL_PAGES`
+  * setting `RUTL::PAGES`
+* Browser's `type:` parameter currently supports `:chrome`, `:firefox`, and `:null`.
+* The first call to the browser is `goto` because it wasn't on a page.
+* Auto-created fields are named `#{friendly_name}_#{field_type}`.
+* Getting and setting text fields is as easy as calling a `String`.
 * When we call click, the framework polls for a next state.
 * We verify that the current page is an instance of the intended page.
-  * Also note here that we have a matcher be_page which matches a page class.
+  * Also note here that we have a matcher `be_page` which matches a page class.
+
 
 ### RSpec Goodies
 
 The tests here are in RSpec and use some conventions that may be common if your tests are also RSpec.
 
+
 #### DefaultRspecToBrowser
+
 This is a module that allows us to skip writing `browser.` in front of everything.
 1. We assume that `browser` is defined.
 2. On method_missing, we try to send the method to `browser`.
 
 It lets us turn this:
-```
-    browser.field1_text = 'foo'
+```ruby
+    message = 'foo'
+    browser.field1_text = message
     browser.ok_button.click
-    expect(browser.current_page).to eq(NextPage)
+    expect(browser.current_page).to be_page(NextPage)
 ```
 into this:
-```
-    field1_text = 'foo'
+```ruby
+    message = 'foo'
+    field1_text = message
     ok_button.click
-    expect(current_page).to eq(NextPage)
+    expect(current_page).to be_page(NextPage)
 ```
-which means less boilerplate and it's easier to follow.
+which means less boilerplate.
+Because we insist on adding UI element type as part of the naming convention there's no confusion about which things are UI elements and which aren't. In this case, we don't mistake our variable "message" for a UI element.
 
 To use it:
-```
+```ruby
     require 'rutl/rspec/default_rspec_to_browser'
 ```
 
+
 #### RSpec Matcher
 
 Currently the only has the `be_page` matcher.
 
 It lets us turn this:
-```
+```ruby
     expect(browser.current_page).to be_instance_of(MyPage)
 ```
 into this:
-```
+```ruby
     expect(browser.current_page).to be_page(MyPage)
 ```
 Both are acceptable but the second is more readable.
 
 To use it:
-```
+```ruby
     require 'rutl/rspec/rutl_matchers'
 ```
 
+
 ### Auto-screenshotting
 
-If you have RUTL::SCREENSHOTS or ENV['SCREENSHOTS'] set to a directory, RUTL
+If you have `RUTL::SCREENSHOTS` or `ENV['SCREENSHOTS']` set to a directory, RUTL
 will automatically take screenshots on page transitions.
 If you're using RSpec, they'll be automatically named something based on the
 RSpec description with an auto-incrementing number.
 If you're not using RSpec, that's not terribly useful but you can always have
 your tests screenshot anyway, just less magic.
 
+
 ## Roadmap
+
 Coming up soon in almost no order:
 * Handle other errors. Auto-screenshot on errors. Navigation errors. Unexpected exceptions?
 * A test framework should have better tests.
@@ -175,17 +188,29 @@ Coming up soon in almost no order:
 * Put more info in this readme.
 * Move bugs and would-be features to Github Issues instead of this readme and scattered through the code.
 * Make the framework make it easier to spot bugs in pages. Focus on exception-handling?
-* The webdriver gem should already include InternetExplorerDriver. Maybe run tests on AppVeyor.
-* Other browser drivers? Look at https://github.com/fnando/browser
-* Get this working with Appium:
-  * Make TK app to test on desktops and test it.
+* The webdriver gem should already include [InternetExplorerDriver](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver). Maybe run tests on [AppVeyor](https://www.appveyor.com/).
+* [Other browser drivers](https://github.com/fnando/browser)?
+* Get this working with [Appium](https://appium.io/):
+  * Make [TK app](https://www.tutorialspoint.com/ruby/ruby_tk_guide.htm) to test on desktops and test it.
     * Can Ruby TK create accesible apps? Not in the simple demos.
   * Make Android example app and get this to work.
-    * Corboba?
+    * [Cordova](https://cordova.apache.org/) or [React Native](https://facebook.github.io/react-native/) or maybe even [Flutter](https://flutter.io/)for app?
+    * Choose (default?) emulator. Many choices.
   * Same with iPhone.
-    * Same Cordoba test app?
-* Documentation. RDoc?
+    * Where to build/test? [CircleCI](https://circleci.com/build-environments/#apple-platforms)?
+    * Same test app as Android.
+    * Are there decent alternatives yet to the simulator?
+* Improve documentation.
+* Add these things and treat as plugins?
+  * Security testing. See [OWASP](https://github.com/OWASP) stuff.
+    * Also OWASP mobile security testing guide.
+    * Avoid deeper pen testing. Leave it to other toolkits.
+  * Other toolkits? Accessibility?
+  * Support web proxy and integrate out of the box. Browsermob?
+    * Get HARs here for perf stuff.
+    * Also look at browser events and tie to HARs? (Always wanted to do that.)
 * Auto-screenshot support frameworks other than RSpec.
+  * Or just default them to screenshots at known view changes (links/buttons/other?) or errors.
 * Others?
 * Spidering page object maker. Or selector checker/fixer?
 * Possibly pair the null browser with auto-generated pages for ______?
@@ -210,7 +235,19 @@ Rubocop. I still have to tweak what I want it to complain about.
     bundle exec rubocop
 ```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+To release a new version, update the version number in `version.rb` like so
+```ruby
+    bundle exec gem bump -v [major|minor|patch|pre|release]
+```
+
+and then run
+```ruby
+    bundle exec rake release
+```
+
+which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 
 ## Contributing

data/appveyor.yml

@@ -0,0 +1,48 @@
+version: 1.0.{build}-{branch}
+
+image:
+  # need an image for Win10+ for WinAppDriver
+  - Visual Studio 2017
+
+cache:
+  - C:\Users\appveyor\AppData\Roaming\npm
+  - vendor/bundle
+  # Chocolatey MSIs - out of luck!
+
+install:
+  - set PATH=C:\Ruby25-x64\bin;%PATH%
+  # the bundle has stuff for mulitple profiles mixed together
+  - bundle install
+  # Chome, obviously but calling it out in case I make multiple profiles.
+  - choco install googlechrome
+  # This one's for iedriver.
+  - reg import bin\ie.reg
+  - npm install -g appium
+  # Can't choco install WinAppDriver yet.
+  # Also, am currently hardcoding version number. When there's a new Appium/
+  # WinAppDriver pairing available this may break because the Appium will be
+  # too new.
+  - appveyor DownloadFile https://github.com/Microsoft/WinAppDriver/releases/download/v1.0/WindowsApplicationDriver.msi
+  - msiexec /i WindowsApplicationDriver.msi /quiet /qn /norestart /log install.log
+  # allow developer mode for non-UWP-stuffs including WinAppDriver
+  - reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowDevelopmentWithoutDevLicense" /d "1"
+
+build: off
+
+before_test:
+  - ruby -v
+  - gem -v
+  - bundle -v
+  - bundle info rubocop
+  - npm -v
+  - ver
+  - dir
+
+test_script:
+  - bundle exec rspec
+
+artifacts:
+  - path: install.log
+    name: WAD installer log
+
+  - path: tmp\screenshots

data/bin/window_data.rb

@@ -0,0 +1,27 @@
+# gem install win32-window --pre
+require 'win32/window'
+
+title = ARGV[0]
+this_file = File.basename(__FILE__)
+
+if ARGV.size.zero?
+  STDERR.puts "\n    #{this_file.upcase} <window_title_substring>\n\n"
+  STDERR.puts 'Finds full title, pid, and window handle for windows matching'
+  STDERR.puts 'the title substring. For titles with spaces, wrap in quotes.'
+  exit 1
+end
+
+count = 0
+Win32::Window.find(title: /#{title}/i).each do |window|
+  next if window.title.match(this_file)
+  puts if count > 0
+  puts "title \"#{window.title}\""
+  puts "pid #{window.pid}"
+  puts format('appTopLevelWindow 0x%08x', window.handle)
+  count += 1
+end
+
+if count.zero?
+  STDERR.puts "NO WINDOWS FOUND: \"#{title}\""
+  exit 1
+end

data/lib/rspec/default_method_object_to_app.rb

@@ -0,0 +1,28 @@
+#
+# Tries to send any method to application.method instead.
+#
+# Sadly, Ruby doesn't allow this to work work with naked assignments. So
+#   foo_button.click # turns into application.foo_button.click
+#   bar_text == 'baz' # turns into application.bar_text == 'baz'
+# but
+#   quux = 'quuux' # just stays quux = 'quuux'
+#
+module DefaultMethodObjectToApp
+  # rubocop:disable Style/MethodMissingSuper
+  def method_missing(method, *args, &block)
+    super unless respond_to_missing? method
+    if args.empty?
+      app.send(method)
+    else
+      app.send(method, *args, &block)
+    end
+  rescue ArgumentError
+    app.send(method)
+  end
+  # rubocop:enable Style/MethodMissingSuper
+
+  def respond_to_missing?(method, _include_private = false)
+    return false if method =~ /^app$/
+    app.respond_to?(method)
+  end
+end