rdp-rautomation 0.6.3.1

data/.document

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

data/.rspec

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

data/.yardopts

@@ -0,0 +1,6 @@
+--readme README.rdoc
+--no-private
+--hide-void-return
+--title "RAutomation"
+--files History.rdoc,LICENSE
+--default-return ""

data/History.rdoc

@@ -0,0 +1,103 @@
+== 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/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010-2011 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.rdoc

@@ -0,0 +1,114 @@
+= RAutomation
+
+* Web: http://www.github.com/jarmo/RAutomation
+* Author: Jarmo Pertman (mailto:jarmo.p[at]gmail.com)
+
+== DESCRIPTION
+
+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 {|window| window.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
+
+1. gem install rautomation
+2. create script and run it
+
+Available adapters:
+* :ffi - uses Windows API directly with FFI (default)
+* :autoit - uses AutoIt for automation
+
+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
+
+* Stephan Schwab to WinFfi adapter - http://github.com/snscaimito
+
+== 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-2011 Jarmo Pertman. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,43 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "rdp-rautomation"
+    gem.summary = %Q{Automate windows and their controls through user-friendly API with Ruby}
+    gem.description = %Q{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}
+    gem.email = "jarmo.p@gmail.com"
+    gem.homepage = "http://github.com/jarmo/RAutomation"
+    gem.authors = ["Jarmo Pertman"]
+    gem.add_development_dependency "rspec", "~>2.3"
+
+    ignored_files = []
+    ignored_files << ".gitignore" << ".gemspec" << "features" << "IAccessibleDLL.sdf"
+    gem.files = `git ls-files`.strip.split($/).delete_if {|f| f =~ Regexp.union(*ignored_files)}
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.6.3.1

data/ext/IAccessibleDLL/IAccessibleDLL.sln

@@ -0,0 +1,20 @@
+
+Microsoft Visual Studio Solution File, Format Version 11.00
+# Visual Studio 2010
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "IAccessibleDLL", "IAccessibleDLL\IAccessibleDLL.vcxproj", "{CCE6C620-932C-4B59-A2DA-E11E279F4D9A}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Win32 = Debug|Win32
+		Release|Win32 = Release|Win32
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{CCE6C620-932C-4B59-A2DA-E11E279F4D9A}.Debug|Win32.ActiveCfg = Debug|Win32
+		{CCE6C620-932C-4B59-A2DA-E11E279F4D9A}.Debug|Win32.Build.0 = Debug|Win32
+		{CCE6C620-932C-4B59-A2DA-E11E279F4D9A}.Release|Win32.ActiveCfg = Release|Win32
+		{CCE6C620-932C-4B59-A2DA-E11E279F4D9A}.Release|Win32.Build.0 = Release|Win32
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+EndGlobal

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 ;
+}
+
+

data/ext/IAccessibleDLL/IAccessibleDLL/IAccessibleDLL.vcxproj

@@ -0,0 +1,102 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <ItemGroup Label="ProjectConfigurations">
+    <ProjectConfiguration Include="Debug|Win32">
+      <Configuration>Debug</Configuration>
+      <Platform>Win32</Platform>
+    </ProjectConfiguration>
+    <ProjectConfiguration Include="Release|Win32">
+      <Configuration>Release</Configuration>
+      <Platform>Win32</Platform>
+    </ProjectConfiguration>
+  </ItemGroup>
+  <PropertyGroup Label="Globals">
+    <ProjectGuid>{CCE6C620-932C-4B59-A2DA-E11E279F4D9A}</ProjectGuid>
+    <Keyword>Win32Proj</Keyword>
+    <RootNamespace>IAccessibleDLL</RootNamespace>
+  </PropertyGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" Label="Configuration">
+    <ConfigurationType>DynamicLibrary</ConfigurationType>
+    <UseDebugLibraries>true</UseDebugLibraries>
+    <CharacterSet>Unicode</CharacterSet>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" Label="Configuration">
+    <ConfigurationType>DynamicLibrary</ConfigurationType>
+    <UseDebugLibraries>false</UseDebugLibraries>
+    <WholeProgramOptimization>true</WholeProgramOptimization>
+    <CharacterSet>Unicode</CharacterSet>
+  </PropertyGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
+  <ImportGroup Label="ExtensionSettings">
+  </ImportGroup>
+  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
+    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
+  </ImportGroup>
+  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
+    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
+  </ImportGroup>
+  <PropertyGroup Label="UserMacros" />
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
+    <LinkIncremental>true</LinkIncremental>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
+    <LinkIncremental>false</LinkIncremental>
+  </PropertyGroup>
+  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
+    <ClCompile>
+      <PrecompiledHeader>Use</PrecompiledHeader>
+      <WarningLevel>Level3</WarningLevel>
+      <Optimization>Disabled</Optimization>
+      <PreprocessorDefinitions>WIN32;_DEBUG;_WINDOWS;_USRDLL;IACCESSIBLEDLL_EXPORTS;%(PreprocessorDefinitions)</PreprocessorDefinitions>
+    </ClCompile>
+    <Link>
+      <SubSystem>Windows</SubSystem>
+      <GenerateDebugInformation>true</GenerateDebugInformation>
+    </Link>
+  </ItemDefinitionGroup>
+  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
+    <ClCompile>
+      <WarningLevel>Level3</WarningLevel>
+      <PrecompiledHeader>Use</PrecompiledHeader>
+      <Optimization>MaxSpeed</Optimization>
+      <FunctionLevelLinking>true</FunctionLevelLinking>
+      <IntrinsicFunctions>true</IntrinsicFunctions>
+      <PreprocessorDefinitions>WIN32;NDEBUG;_WINDOWS;_USRDLL;IACCESSIBLEDLL_EXPORTS;%(PreprocessorDefinitions)</PreprocessorDefinitions>
+      <RuntimeLibrary>MultiThreaded</RuntimeLibrary>
+    </ClCompile>
+    <Link>
+      <SubSystem>Windows</SubSystem>
+      <GenerateDebugInformation>true</GenerateDebugInformation>
+      <EnableCOMDATFolding>true</EnableCOMDATFolding>
+      <OptimizeReferences>true</OptimizeReferences>
+      <AdditionalDependencies>oleacc.lib;comsuppw.lib;kernel32.lib;user32.lib;gdi32.lib;winspool.lib;comdlg32.lib;advapi32.lib;shell32.lib;ole32.lib;oleaut32.lib;uuid.lib;odbc32.lib;odbccp32.lib;%(AdditionalDependencies)</AdditionalDependencies>
+    </Link>
+  </ItemDefinitionGroup>
+  <ItemGroup>
+    <None Include="ReadMe.txt" />
+  </ItemGroup>
+  <ItemGroup>
+    <ClInclude Include="stdafx.h" />
+    <ClInclude Include="targetver.h" />
+  </ItemGroup>
+  <ItemGroup>
+    <ClCompile Include="dllmain.cpp">
+      <CompileAsManaged Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">false</CompileAsManaged>
+      <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
+      </PrecompiledHeader>
+      <CompileAsManaged Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">false</CompileAsManaged>
+      <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
+      </PrecompiledHeader>
+    </ClCompile>
+    <ClCompile Include="IAccessibleDLL.cpp" />
+    <ClCompile Include="stdafx.cpp">
+      <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">Create</PrecompiledHeader>
+      <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">Create</PrecompiledHeader>
+    </ClCompile>
+    <ClCompile Include="table_support.cpp" />
+  </ItemGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
+  <ImportGroup Label="ExtensionTargets">
+  </ImportGroup>
+</Project>