rautomation 0.15.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 3c6d6a52e58f96779bd37c86b30ba8f392dd0191
-  data.tar.gz: fbc26ee037eef080677cf8997aeb924f02bd1360
+SHA256:
+  metadata.gz: 53dcc9c7fb0ad6599fc38219e071f7708d25efcc734d0e59b460597291bd3cd3
+  data.tar.gz: c8653b31a06ea43617985b3722750f30005670ed8b468a9bdd22df4b3b46cd9a
 SHA512:
-  metadata.gz: 652ed3ab3c3624056af6166a4a2c4569f0a0e3c02201d69a3bfba9d3f82be7b73f255f6c7fa7188b6c98c43e6f496b2fab78d562637cac2ccfc086a9b8ecc2d2
-  data.tar.gz: 1d10710a01cdebfed601261cdb34bd5a3e3e79cfb979f2ad4be6e797c1aad1804a9f8dfab43359e8267f86378021f71ccd96b453bdacc4974792e58e9543daa5
+  metadata.gz: 2e069e4ec814e18538c3f73414c3745092707522bad5f1f83867fb0f76bdb6fb79a3ad5ac58e6a4db45e2f13d3bac3e3e248bcbfd6fb3afe422e0350ea3c380b
+  data.tar.gz: c1219736522287e6c680a31edbc7fdf992029c53df7c0cdb10670c41863cd16daeadad1a53a13c4d57a3c6b2b6a36839f925f21d05a54a5357fbf1666068c436

data/.document

@@ -1,4 +1,4 @@
-README.rdoc
+README.md
 lib/**/*.rb
 bin/*
 features/**/*.feature

data/.gitignore

@@ -1,36 +1,37 @@
-## MAC OS
-.DS_Store
-
-## TEXTMATE
-*.tmproj
-tmtags
-
-## EMACS
-*~
-\#*
-.\#*
-
-## VIM
-*.swp
-
-## PROJECT::GENERAL
-/coverage
-/rdoc
-/pkg
-
-## PROJECT::SPECIFIC
-/.idea/*
-
-/.yardoc/
-/doc/
-
-## VisualStudio
-Debug
-Release
-ipch
-*.sdf
-*.suo
-*.user
-*.opensdf
-_ReSharper*/
-packages/
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+/coverage
+/rdoc
+/pkg
+
+## PROJECT::SPECIFIC
+/.idea/*
+
+/.yardoc/
+/doc/
+
+## VisualStudio
+Debug
+Release
+ipch
+*.sdf
+*.suo
+*.user
+*.opensdf
+_ReSharper*/
+packages/
+.vs/

data/.yardopts

@@ -1,6 +1,8 @@
---readme README.rdoc
+--readme README.md
 --no-private
 --hide-void-return
 --title "RAutomation"
---files History.rdoc,LICENSE
+--files CHANGES.md,LICENSE
 --default-return ""
+--markup-provider redcarpet
+--markup markdown

data/CHANGES.md

@@ -0,0 +1,268 @@
+## 1.1.0 / 2021-12-03
+
+* Update ffi dependency to ~> 1.15.0. PR #132
+
+## 1.0.0 / 2019-12-11
+
+* Update ffi dependency to ~> 1.11.0.
+* Use Visual Studio 2019 Build Tools for running tests.
+
+## 0.17.0 / 2014-09-29
+
+### Win32 adapter
+
+* Fix searching locators by hwnd. See more at issue #96.
+
+## 0.16.0 / 2014-09-29
+
+* Loosen up ffi dependency due to fixed segfault problem. See more at issue #81.
+
+## 0.15.0 / 2014-06-01
+
+* Fixes #send_keys with special characters. Issue #92.
+
+## 0.14.1 / 2014-02-05
+
+* Set ffi 1.9.0 as a dependency for now because newer versions are broken. See more at issue #81.
+
+## 0.14.0 / 2014-02-05
+
+### MsUia adapter
+
+* Add SelectList#select and SelectList#clear.
+* Add Table#select and Table#clear.
+* Add Table#selected_rows.
+* Improve performance of table Row lookups.
+* SelectList#options accepts :index and :text (Regexp or String).
+* Window#child in ms_uia works for popup windows as well.
+
+## 0.13.0
+
+### MsUia adapter
+
+* Added #select and #clear into SelectList::SelectListOption for multi-select support
+* Removed SelectList#select and SelectList#set
+* Added #select, #selected? and #clear to Table::Row for multi-select support
+* Removed Table#select and Table#selected?
+* Fixed an issue with selecting ListBox items that our outside of the viewable area
+
+## 0.12.0 / 2013-09-05
+
+### MsUia adapter
+
+* Add Control#help_text to relay ToolTip information
+
+## 0.11.0 / 2013-08-10
+
+### MsUia adapter
+
+* Add support for Window#spinner
+
+## 0.10.0 / 2013-07-26
+
+### MsUia adapter
+
+* Fixed an issue with trying to interact with a button after it goes away
+* Add support for Window#tab_control
+
+## 0.9.4 / 2013-07-23
+
+* Add license part of gemspec. Closes #70.
+
+## 0.9.3 / 2013-07-23
+
+### MsUia adapter
+
+* Added the ability to limit the scope to children only when looking for a control
+* Fixed issues with ListBox controls not firing index change events
+
+## 0.9.2 / 2013-05-19
+
+### Win32 adapter
+
+* Window#send_keys supports now :dash, :slash and :backslash. Closes #64.
+
+### MsUia adapter
+
+* Ability to get and set the text of a multi-line text control that only supports the TextPattern.
+* Add some caching to speed up locating controls.
+* Fix issue #67 that happens when clicking on controls.
+
+### AutoIt adapter
+
+* Add deprecation warning.
+
+## 0.9.1 / 2013-04-26
+
+### MsUia adapter
+
+* Ability to interact with controls that do not have native window handles (for example WPF applications).
+
+## 0.9.0 / 2013-04-22
+
+### MsUia adapter
+
+* Add support for :name locator.
+* Add support for Window#value_control.
+* Add Table#headers.
+* Add Table#values.
+* Control#exists? uses now uia code.
+* ControlType.Document is also considered as a TextField.
+* Table#select and Table#selected? use 0-based indexing.
+* Table#select supports value too. 
+
+### Win32 adapter
+
+* Add support for "[", "]" and "'" characters when using Window#send_keys. Fixes #61.
+
+## 0.8.0 / 2012-12-26
+
+### MsUia adapter
+
+* Add Control#collapse for collapsing values in collapsable items.
+* Add Control#expand for expanding values in expandable items.
+* Add Row#cell(s).
+* Add Table#cell(s).
+* Add Table#row(s).
+* Add Window#menu for selecting menu items.
+* Fire change events when SelectList selections have been changed.
+* Window#child instantiates MsUia adapter Window.
+
+## 0.7.3 / 2012-10-31
+
+### Win32 adapter
+
+* Add support for PasswordField.
+
+### AutoIt adapter
+
+* Show error message when registration of AutoIt dll fails.
+
+## 0.7.2 / 2012-03-18
+
+### Win32 adapter
+
+* add mouse API with Window#mouse method
+* add Mouse#move, #position, #click, #press and #release methods
+
+### AutoIt adapter
+
+* support the same mouse API as Win32 adapter
+
+## 0.7.1 / 2012-02-26
+
+### Win32 adapter
+
+* add Window#dimensions to get coordinates of the window
+* add Window#move to move/resize the window
+* fix Window#child not to raise any exceptions for cases where window isn't technically a child
+
+## Version 0.7.0 / 2012-02-23
+
+### All adapters
+
+* renamed WinFfi adapter to Win32 adapter
+* added experimental MsUia adapter
+* added support for JRuby
+* Window.windows accepts locators too
+* added Window#class_names for retrieving internal class names of the window and it's controls
+* default locator is :index => 0 when nothing else specified
+
+### Win32 adapter
+
+* Window#send_keys has now syntax similar to WatirSpec (https://github.com/watir/watirspec/blob/master/element_spec.rb#L206-249)
+* added TextField#send_keys
+
+### AutoIt adapter
+
+* added Window#mouse_move, #mouse_click, #mouse_position, #press_mouse and #release_mouse methods for AutoIt adapter
+
+## Version 0.6.3 / 2011-07-16
+
+* use current window's handle (hwnd) in WinFfi::Window#child method
+
+## Version 0.6.2 / 2011-07-07
+
+### WinFFI adapter
+
+* loading lazily oleacc.dll
+* loading lazily uia_dll.rb due to problems on certain Windows XP machines
+
+## Version 0.6.1 / 2011-07-05
+
+### WinFFI adapter
+
+* Fixed it for Ruby 1.9.2.
+
+## Version 0.6.0 / 2011-07-03
+
+### WinFFI adapter
+
+* Window#send_keys now accepts only String argument similar to AutoIt's Send function.
+* added Table#strings, #select, #selected? methods.
+* added Label element support with #value method.
+* added #has_focus? and #set_focus methods to controls.
+* added possibility to search controls by automation id as :id.
+* added #enabled? and #disabled? methods for controls.
+* added Window#control and #controls methods for accessing controls generally.
+* added SelectList#option method.
+* added ListBox element support with #count, #items, #exist?, #selected? and #select methods.
+
+## Version 0.5.1 / 2011-01-30
+
+### All adapters
+
+* added Window.windows, #windows, #buttons and #text_fields methods to retrieve collection of elements and use them with Enumerable/Array methods.
+
+### WinFFI adapter
+
+* added Window#child method for searching child windows and popups
+* added initial support for Radio, Checkbox, SelectList and Table
+
+### AutoIt adapter
+
+* allow to search windows by PID
+
+## Version 0.4.0 / 2010-12-23
+
+* allow to search windows without text (like empty Notepad window for example).
+* added possibility to use block for #click to specify successful clicking condition.
+* renamed :ffi adapter to :win_ffi because FFI may be used on other platforms too.
+
+## Version 0.3.0 / 2010-12-18
+
+* added Ffi adapter specific method Window#child which searches for child windows and popups
+
+## Version 0.2.1 / 2010-12-17
+
+* added yard options for documentation
+
+## Version 0.2.0 / 2010-12-17
+
+* added Window#pid method
+
+## Version 0.1.0 / 2010-12-14
+
+* added new default adapter for Windows: FFI
+* changes for AutoIt adapter:
+  - added 0-based :index locator for window locators to search for windows with the same criteria.
+  - renamed text_field and button locator :instance to :index instead.
+  - :class_name locator is not allowed anymore. Use :class and :index together instead.
+  - use :value for button locator instead of :text
+
+## Version 0.0.4 / 2010-10-27
+
+* most Window, Button and TextField methods wait until the object exists. Use RAutomation::Window.wait_timeout= to set timeout before failing. Default is 60 seconds.
+
+## Version 0.0.3 / 2010-10-15
+
+* RAutomation didn't load AutoIt correctly if it wasn't installed before
+
+## Version 0.0.2 / 2010-10-14
+
+* using :value locator for buttons instead of :text
+* searching only visible windows with some text on them
+
+## Version 0.0.1 / 2010-10-13
+
+* Initial release

data/Gemfile.lock

@@ -1,30 +1,39 @@
-PATH
-  remote: .
-  specs:
-    rautomation (0.15.0)
-      ffi (= 1.9.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    diff-lcs (1.2.4)
-    ffi (1.9.0-x86-mingw32)
-    rake (0.9.2.2)
-    rspec (2.14.1)
-      rspec-core (~> 2.14.0)
-      rspec-expectations (~> 2.14.0)
-      rspec-mocks (~> 2.14.0)
-    rspec-core (2.14.6)
-    rspec-expectations (2.14.3)
-      diff-lcs (>= 1.1.3, < 2.0)
-    rspec-mocks (2.14.4)
-    yard (0.8.6.1)
-
-PLATFORMS
-  x86-mingw32
-
-DEPENDENCIES
-  rake
-  rautomation!
-  rspec (~> 2.14)
-  yard
+PATH
+  remote: .
+  specs:
+    rautomation (1.1.0)
+      ffi (~> 1.15.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.2.4)
+    ffi (1.15.4)
+    ffi (1.15.4-x86-mingw32)
+    github-markup (3.0.4)
+    rake (0.9.2.2)
+    redcarpet (3.5.0)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.6)
+    rspec-expectations (2.14.3)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.4)
+    yard (0.9.20)
+
+PLATFORMS
+  ruby
+  x86-mingw32
+
+DEPENDENCIES
+  github-markup
+  rake
+  rautomation!
+  redcarpet
+  rspec (~> 2.14)
+  yard
+
+BUNDLED WITH
+   2.0.1

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2010-2013 Jarmo Pertman
+Copyright (c) Jarmo Pertman
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,141 @@
+# RAutomation
+
+[![Gem Version](https://badge.fury.io/rb/rautomation.png)](http://badge.fury.io/rb/rautomation)
+
+*   Web: http://www.github.com/jarmo/RAutomation
+*   Author: Jarmo Pertman [jarmo@jarmopertman.com](mailto:jarmo@jarmopertman.com)
+
+
+RAutomation is a small and easy to use library for helping out to automate
+windows and their controls for automated testing.
+
+RAutomation provides:
+*   Easy to use and user-friendly API (inspired by [Watir](http://www.watir.com))
+*   Cross-platform compatibility
+*   Easy extensibility - with small scripting effort it's possible to add
+    support for not yet  supported platforms or technologies
+
+
+## USAGE
+
+    require "rautomation"
+
+    window = RAutomation::Window.new(:title => /part of the title/i)
+    window.exists? # => true
+
+    window.title # => "blah blah part Of the title blah"
+    window.text # => "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec ultricies..."
+
+    window.text_field(:class => "Edit", :index => 0).set "hello, world!"
+    button = window.button(:value => "&Save")
+    button.exists? # => true
+    button.click
+
+    all_windows = RAutomation::Window.windows
+    all_windows.each {|window| puts window.hwnd}
+
+    window = RAutomation::Window.new(:title => /part of the title/i)
+    windows = window.windows
+    puts windows.size # => 2
+    windows.map &:title # => ["part of the title 1", "part of the title 2"]
+
+    window.windows(:title => /part of other title/i) # => all windows with matching specified title
+
+    window.buttons.each {|button| puts button.value}
+    window.buttons(:value => /some value/i).each {|button| puts button.value}
+
+    window2 = RAutomation::Window.new(:title => "Other Title", :adapter => :autoit) # use AutoIt adapter
+    # use adapter's (in this case AutoIt's) internal methods not part of the public API directly
+    window2.WinClose("[TITLE:Other Title]")
+
+Check out [the documentation](https://rubydoc.info/github/jarmo/RAutomation) for other possible usages!
+
+## INSTALL
+
+### Windows
+
+    gem install rautomation
+
+Available adapters:
+*   :win_32 - uses Windows API directly with FFI (default)
+*   :ms_uia - an experimental adapter
+*   :autoit - uses AutoIt for automation (DEPRECATED)
+
+
+When using AutoIt adapter: You might need administrative privileges if running
+for the first time and you haven't installed AutoIt before!
+
+### Linux
+
+Feel yourself at home on Linux and know how to automate windows and their
+controls? I would be happy if you'd contact me about that matter - or even
+better, follow the instructions at "How to create a new adapter?" 
+
+### OS X
+
+Feel yourself at home on OS X and know how to automate windows and their
+controls? I would be happy if you'd contact me about that matter - or even
+better, follow the instructions at "How to create a new adapter?"
+
+### Others
+
+Feel yourself at home on some operating system not listed in here and know how
+to automate windows and their controls? Does Ruby also work on that operating
+system? I would be happy if you'd contact me about that matter - or even
+better, follow the instructions at "How to create a new adapter?"
+
+## Supported Ruby Platforms
+
+Currently only 32bit Ruby is supported. 64bit versions **do not work** at all!
+
+## How to create a new adapter?
+
+1.  Fork the project.
+2.  Create entry point file to lib/rautomation/adapter which should load all
+    adapter specific files.
+3.  Add `autoload` statement into lib/rautomation/adapter/helper.rb for that
+    file.
+4.  Create a directory for your adapter's specific code into
+    lib/rautomation/adapter
+5.  Copy button.rb, text_field.rb and window.rb from some of the existing
+    adapter's directory.
+6.  Add spec data for your adapter into spec/spec_helper DATA constant.
+7.  Use environment variable *RAUTOMATION_ADAPTER* to point to that adapter.
+8.  Start coding and spec-ing until as much of possible of the public API is
+    satisfied.
+9.  Make me a pull request.
+
+
+Don't forget to fix the documentation for that adapter also!
+
+In case of any problems, feel free to contact me.
+
+## Contributors
+
+*   Levi Wilson - https://github.com/leviwilson
+*   Eric Kessler - https://github.com/enkessler
+*   Stephan Schwab - https://github.com/snscaimito
+
+
+## Libraries Using RAutomation
+
+*   [watir-classic](https://github.com/watir/watir-classic)
+*   [mohawk](https://github.com/leviwilson/mohawk)
+
+
+## Note on Patches/Pull Requests
+
+*   Fork the project.
+*   Make your feature addition or bug fix.
+*   Add tests for it. This is important so I don't break it in a future
+    version unintentionally.
+*   Commit, do not mess with rakefile, version, or history.
+
+    (if you want to have your own version, that is fine but bump version in a
+    commit by itself I can ignore when I pull)
+*   Send me a pull request. Bonus points for topic branches.
+
+
+## Copyright
+
+Copyright (c) Jarmo Pertman. See LICENSE for details.

data/Rakefile

@@ -65,6 +65,6 @@ YARD::Rake::YardocTask.new
 
 task :default => "spec:all"
 
-task :release => "spec:all"
+task "release:source_control_push" => :spec
 
 task :install => :build

data/VERSION

@@ -1 +1 @@
-0.15.0
+1.1.0