rautomation 0.17.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 95d5dfeb95290e7944534c9a7ff4e042ae9d9b25
-  data.tar.gz: 2f8c65032f68cd5fdb6d79a50d3887827597d7d7
+SHA256:
+  metadata.gz: 679fa528ec456a61c7e523c9f4ca135c8470bda5e9dc7c03be47849b8a4b5201
+  data.tar.gz: 297761f686c7edfb418c453649ac7d162f8cc05f159cbbcdbdf34e5fbd9d763b
 SHA512:
-  metadata.gz: 389fd8e7b1bdd288e1d5514d384d1b957c26ab3b657bcffbc519ae7136e986faac6b88ad96949d1be1fea9c61cb1263555d3067a7eb29110d03c0b9c48866784
-  data.tar.gz: 2201aaf9897b898f2c5b474c85c1a759fd0e110808a62cc965e5029bce5707433cf9385592211d7394dc1c15a0f15f57013512ac36a0773c3b8fca8451edd1bf
+  metadata.gz: eb20e6ce9ec63d7ddc1165486a58a24b2f9c6ee8adce789cc15ceb82927067ccd1fd4e380bfce870d54c7eb3a1dce378e5e1ea2c0ab6c51eb148487a21eaac45
+  data.tar.gz: 4719e76346090b28ba6340044dbbeb0af9aa87228aae826bc5200b7c734056b13dfba8d2b4c67e3bae10f359e2e32bbdccb0730c98a5263f3abb57bd1f6daa53

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,264 @@
+## 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,15 +1,17 @@
 PATH
   remote: .
   specs:
-    rautomation (0.17.0)
-      ffi (~> 1.9.0)
+    rautomation (1.0.0)
+      ffi (~> 1.11.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
     diff-lcs (1.2.4)
-    ffi (1.9.5-x86-mingw32)
+    ffi (1.11.3-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)
@@ -18,13 +20,19 @@ GEM
     rspec-expectations (2.14.3)
       diff-lcs (>= 1.1.3, < 2.0)
     rspec-mocks (2.14.4)
-    yard (0.8.6.1)
+    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.