rautomation 0.17.0 → 1.0.0

data/History.rdoc

@@ -1,273 +0,0 @@
-== 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/README.rdoc

@@ -1,120 +0,0 @@
-= RAutomation
-{<img src="https://badge.fury.io/rb/rautomation.png" alt="Gem Version" />}[http://badge.fury.io/rb/rautomation]
-
-* Web: http://www.github.com/jarmo/RAutomation
-* Author: Jarmo Pertman (mailto:jarmo.p[at]gmail.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 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?"
-
-== 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) 2010-2013 Jarmo Pertman. See LICENSE for details.