atspi_app_driver 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 509b787e88981adcc2bf586c981e47c7d2739584
+  data.tar.gz: 392fe1910cac1d8726bd770205a3328af8a9691b
+SHA512:
+  metadata.gz: b283db9f341667f37781ed06e5e0a85dd080fa286adc6735d05ec333e5be4d4412c63ba44aabcd5f77c2945cddc6487a10b7364900b983e8fda1f5d00c4c3f0f
+  data.tar.gz: c3b2d4150d7a2fede09ead523846335454415512f38ca7416d7a2d61f39a1d1d2e2c0954344040987e0a89b25a119b8a23c035b55f516b4802d402e0181ae74c

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2015 Matijs van Zuijlen
+
+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,92 @@
+# Atspi App Driver
+
+Test driver for the Atspi-enabled applications. Takes care of boot and
+shutdown, and provides a handle on the GUI's main UI frame.
+
+## Usage
+
+This driver assumes your application lives in `bin/` and uses additional ruby
+code in `lib/`.
+
+Say, your application is called `foo`. Then, in your tests, do something like this:
+
+    require 'atspi_app_driver'
+
+    describe 'The application' do
+      before do
+        @driver = AtspiAppDriver.new('foo')
+
+        # This will boot `ruby -Ilib bin/foo`, wait for its main window to appear,
+        # and focus it.
+        @driver.boot
+      end
+
+      it 'does stuff' do
+        # Fetch the main window's atspi object
+        frame = @driver.frame
+
+        # You can now interact with the window's objects
+
+        # Select item matching /bar/ from combo box:
+        box = frame.find_role :combo_box
+        item = box.find_role :menu_item, /bar/
+        box.get_action_name(0).must_equal 'press'
+        box.do_action 0
+        item.get_action_name(0).must_equal 'click'
+        item.do_action 0
+
+        # Fetch contents of a text box
+        textbox = frame.find_role :text
+        textbox.get_text(0, 100).must_equal 'Foo bar baz'
+
+        # Quit application
+        @driver.press_ctrl_q
+
+        # Check exit status
+        status = @driver.cleanup
+        status.exitstatus.must_equal 0
+      end
+
+      after do
+        # Ensure application is cleaned up
+        @driver.cleanup
+      end
+    end
+
+## Installation
+
+    gem install atspi_app_driver
+
+## Dependencies
+
+Atspi App Driver needs atspi's GIR data, and needs to be able to interact with
+the application via atspi and atk. The below are suggested packages to install.
+Corrections are welcome, of course.
+
+### Debian
+
+This should work on Debian unstable.
+
+    sudo apt-get install dbus
+    sudo apt-get install libgirepository1.0-dev gobject-introspection
+    sudo apt-get install gir1.2-atspi-2.0 libatk-adaptor
+
+### Ubuntu
+
+Please try the instructions for Debian. This will probably not work on Ubuntu
+12.04. Again, corrections and additions are welcome.
+
+### Other OS
+
+To be determined. Please contribute back your experience in getting Atspi App
+Driver working on your favorite operation system.
+
+## Contributing
+
+Contributions are welcome! Please feel free to create issues or pull requests
+on GitHub.
+
+## License
+
+Copyright © 2015 [Matijs van Zuijlen](http://www.matijs.net).
+See LICENSE for details.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'rake/clean'
+require 'bundler/gem_tasks'

data/gems.rb

@@ -0,0 +1,3 @@
+source 'http://rubygems.org'
+
+gemspec

data/lib/atspi_app_driver.rb

@@ -0,0 +1,132 @@
+require 'gir_ffi'
+
+GirFFI.setup :Atspi
+Atspi.load_class :Accessible
+
+# Utility monkey-patches for the Atspi::Accessible class
+module AtspiAccessiblePatches
+  def each_child
+    child_count.times do |i|
+      child = get_child_at_index i
+      yield child if child
+    end
+  end
+
+  def find_role role, regex = //
+    return self if role == self.role && name =~ regex
+    each_child do |child|
+      result = child.find_role role, regex
+      return result if result
+    end
+    nil
+  end
+
+  def inspect_recursive level = 0, maxlevel = 4
+    each_child do |child|
+      puts "#{'  ' * level} > name: #{child.name}; role: #{child.role}"
+      child.inspect_recursive(level + 1) unless level >= maxlevel
+    end
+  end
+end
+
+Atspi::Accessible.include AtspiAccessiblePatches
+
+# Test driver for the Atspi-enabled applications. Takes care of boot and
+# shutdown, and provides a handle on the GUI's main UI frame.
+class AtspiAppDriver
+  def initialize app_name, verbose: false
+    @app_file = "bin/#{app_name}"
+    @lib_dir = 'lib'
+    @app_name = app_name
+    @pid = nil
+    @verbose = verbose
+    @frame = nil
+  end
+
+  attr_reader :frame
+
+  def boot test_timeout: 30, exit_timeout: 10, arguments: []
+    raise 'Already booted' if @pid
+
+    spawn_process(arguments)
+
+    @cleanup = false
+
+    @frame = find_and_focus_frame
+
+    @thread = Thread.new do
+      wait_for('test to be done', test_timeout) { @cleanup }
+      wait_for('pid to go away', exit_timeout) { !@pid }
+      kill_process if @pid
+    end
+  end
+
+  def spawn_process arguments
+    command = "ruby -I#{@lib_dir} #{@app_file} #{arguments.join(' ')}"
+    log "About to spawn: `#{command}`"
+    @pid = Process.spawn command
+  end
+
+  def press_ctrl_q
+    Atspi.generate_keyboard_event(37, nil, :press)
+    Atspi.generate_keyboard_event(24, nil, :pressrelease)
+    Atspi.generate_keyboard_event(37, nil, :release)
+  end
+
+  def cleanup
+    status = exit_status
+    @pid = nil
+    @thread.join if @thread
+    status
+  end
+
+  private
+
+  def find_and_focus_frame
+    acc = wait_for('app to appear', 10) { find_app }
+    raise 'App not found' unless acc
+
+    frame = acc.get_child_at_index 0
+    frame.role.must_equal :frame
+    frame.grab_focus
+
+    frame
+  end
+
+  def kill_process
+    log "About to kill child process #{@pid}"
+    Process.kill 'KILL', @pid
+  end
+
+  def log message
+    warn message if @verbose
+  end
+
+  def find_app
+    desktop = Atspi.get_desktop(0)
+    desktop.each_child do |child|
+      return child if child.name == @app_name
+    end
+    nil
+  end
+
+  # TODO: User timeout
+  def wait_for description, _timeout
+    start = Time.now
+    # Try for 0.01 * 50 * (50 + 1) / 2 = 12.75 seconds
+    value = 50.times.each do |num|
+      result = yield
+      break result if result
+      sleep 0.01 * (num + 1)
+    end
+    log "Waited #{Time.now - start} seconds for #{description}"
+    value
+  end
+
+  def exit_status
+    return unless @pid
+    @cleanup = true
+    _, status = Process.wait2 @pid
+    status
+  end
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: atspi_app_driver
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Matijs van Zuijlen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gir_ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.9
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+description: 
+email:
+- matijs@matijs.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- gems.rb
+- lib/atspi_app_driver.rb
+homepage: http://www.github.com/mvz/atspi_app_driver
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Test GNOME applications using Atspi
+test_files: []