rautomation 2.0.1-x86-mingw32

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d8c326b3fdb48e487d3729957fb28e521a7d5d7e4390e1217937f5fc121fa95c
+  data.tar.gz: 678161c7a4adf3cb6d729ffa939f4d98044f9a3c9aba742937e9446f99b8fef6
+SHA512:
+  metadata.gz: 97ee462a55acfb4732813f47cca9b0132648ac1a4874973724cbe7f6d296d39e53567399c72323cf07497264417e68f05a1d74467f2722610846c8be23f13544
+  data.tar.gz: b6b54d63b44484daafc090ff99baf1bcbc90e9b0e5e4aee9c344d323dfa7f9436f0a96c34b762547590630fb6051a1962c68ff9575ae7d944d01fe51186c975d

data/.document

@@ -0,0 +1,5 @@
+README.md
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

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

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.yardopts

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

data/CHANGES.md

@@ -0,0 +1,276 @@
+## 2.0.1 / 2023-03-25
+
+* Gem platform attribute value change.
+
+## 2.0.0 / 2023-03-25
+
+* Add support for 64bit Ruby for the Win32 adapter. PR #136
+
+## 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

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+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
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,142 @@
+# 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
+
+64bit Ruby platform is **only supported for Win32 adapter**.
+Other adapters can be used only on a 32bit Ruby!
+
+## 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

@@ -0,0 +1,73 @@
+require 'rubygems'
+require 'bundler'
+require 'rspec/core/rake_task'
+
+Bundler::GemHelper.install_tasks
+
+def ext_dependencies(name)
+  FileList["ext/#{name}/**/*"].reject { |file| file =~ /(Release|Debug)/ }
+end
+
+def ms_build(name)
+  name = File.basename(name, File.extname(name))
+  cmd = "msbuild /p:Configuration=Release ext\\#{name}\\#{name}.sln"
+  cmd += " && #{cmd} /p:Platform=x64" unless name == 'WindowsForms'
+  sh(cmd)
+end
+
+namespace :build do
+  build_tasks = [
+    {:name => :uia_dll, :path => "UiaDll", :ext => "dll"},
+    {:name => :i_accessible_dll, :path => "IAccessibleDLL", :ext => "dll"},
+    {:name => :windows_forms, :path => "WindowsForms", :ext => "exe"}
+  ]
+
+  build_tasks.each do |build_task|
+    full_ext_path = "ext/#{build_task[:path]}/Release/#{build_task[:path]}.#{build_task[:ext]}"
+
+    %w[x86Release x64Release].each do |output_dir|
+      full_ext_path = full_ext_path.gsub(/(?<!x86|x64)Release/, output_dir) unless build_task[:name] == :windows_forms
+
+      file full_ext_path => ext_dependencies(build_task[:path]) do |t|
+        ms_build(t.name)
+      end
+    end
+
+    desc "Build #{build_task[:path]}"
+    task build_task[:name] => full_ext_path
+  end
+
+  desc "Build all external dependencies"
+  task :all => build_tasks.map { |t| "build:#{t[:name]}"}
+end
+
+task :build => "build:all"
+
+namespace :spec do
+  adapters = %w[win_32]
+  adapters << "ms_uia" if Platform.is_x86?
+
+  adapters.each do |adapter|
+    desc "Run RSpec code examples against #{adapter} adapter"
+    RSpec::Core::RakeTask.new(adapter) do |_task|
+      ENV["RAUTOMATION_ADAPTER"] = adapter
+      puts "Running specs for adapter: #{adapter}"
+    end
+  end
+
+  desc "Run RSpec code examples against all adapters"
+  task :all => adapters.map {|a| "spec:#{a}"}
+end
+
+task :spec => "spec:all"
+
+RSpec::Core::RakeTask.new(:rcov) { |spec| spec.rcov = true }
+
+require 'yard'
+YARD::Rake::YardocTask.new
+
+task :default => "spec:all"
+
+task "release:source_control_push" => :spec
+
+task :install => :build

data/ext/IAccessibleDLL/IAccessibleDLL/IAccessibleDLL.cpp

@@ -0,0 +1,30 @@
+// IAccessibleDLL.cpp : Defines the exported functions for the DLL application.
+//
+
+#include "stdafx.h"
+
+extern "C"
+__declspec( dllexport ) long get_button_state(HWND buttonHwnd) {
+	IAccessible		*pIAccessible ;
+	VARIANT			varState;
+	VARIANT			varChildId;
+	BOOL			checked = FALSE ;
+	HRESULT hr ;
+	HMODULE hModule ;
+	LPFNACCESSIBLEOBJECTFROMWINDOW lpfnAccessibleObjectFromWindow ;
+
+	hModule = LoadLibraryA("oleacc.dll");
+	lpfnAccessibleObjectFromWindow = (LPFNACCESSIBLEOBJECTFROMWINDOW)GetProcAddress(hModule, "AccessibleObjectFromWindow");
+
+	hr = lpfnAccessibleObjectFromWindow(buttonHwnd, OBJID_CLIENT, IID_IAccessible, (void**)&pIAccessible) ;
+
+	VariantInit(&varChildId);
+	varChildId.vt = VT_I4;
+	varChildId.lVal = CHILDID_SELF ;
+
+	pIAccessible->get_accState(varChildId, &varState);
+	
+	return varState.lVal ;
+}
+
+