atspi 0.8.1 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4c9a8989642ebeaed237d1a6a7303c658c21118a
-  data.tar.gz: 9dcbccead68aaa7f03028ebb29dd1927eb31a92e
+  metadata.gz: 098653bbb4fcf2ebee3ccb274d9a1b5d7bf73035
+  data.tar.gz: fbf3a9680dc2a95dd6ead1803b23ae6bcffd7f93
 SHA512:
-  metadata.gz: b649ff610b5943803b27962c89b3073b2456a17ac5a9df21eb691f512ae5d54c0766f3cc12102cc9840f179d2094e7aad2496f4d5218e6e525cd1fd4e81d6ab5
-  data.tar.gz: 859022e872dd60a0422be635957334fc5c3f05c3d8aebb3f75ad66a5fd86ba5669cb2347b2d23aff7495263acfb349f4b8ac554d9ad756abf800fbd781f283fd
+  metadata.gz: 1f609ffa1b51a3e0e8bf4373ad5ca187995cd5a917a7a7c928ccfeaf3430ad5f59b0cf8f6848e50721fc80f987645daf1af65898accd0c31200b5a4052710a25
+  data.tar.gz: 807b5aa658a532c1d61f55d18c0c1c5aae78a94bab9f27f2f1a1ec7c72992e780624ecf28b2c84d3d2c4991d1e9bdca65d8d975d4a1763d9f369afe3fd83e387

data/lib/atspi/accessible.rb

@@ -157,6 +157,30 @@ module ATSPI
       end
     end
 
+    # @return [Accessible] its descendant found at the given path
+    #
+    # @overload descendant_by_path(path)
+    #   @param path [Array] a path as returned by {#path}
+    #
+    #   @example
+    #     descendant        # => #<ATSPI::Accessible:0xc1f18814 … @path=0/0/2/1 … >
+    #     descendant.path   # => [0, 0, 2, 1]
+    #     accessible.descendant_by_path(descendant.path) # => #<ATSPI::Accessible:0xc1f18814 … @path=0/0/2/1 … >
+    #
+    # @overload descendant_by_path(child_idx, grand_child_idx, *further_indices)
+    #   @param child_idx [Integer] the child's {#index_in_parent}
+    #   @param grand_child_idx [Integer] the grand child's {#index_in_parent}
+    #   @param further_indices [Integer] additional {#index_in_parent}s of further descendants
+    #
+    #   @example
+    #     accessible.descendant_by_path(0, 0, 2, 1) # => #<ATSPI::Accessible:0xc1f18814 … @path=0/0/2/1 … >
+    def descendant_by_path(*path)
+      path = path.flatten
+      child = children[path.shift]
+      found = child.nil? || path.empty?
+      found ? child : child.descendant_by_path(path)
+    end
+
     # @return [Hash<Symbol => Array<Accessible>>] its relations to other
     #   accessibles. Keys name the relation type and values are relation
     #   targets.

data/lib/atspi/accessible/table/cells.rb

@@ -23,7 +23,7 @@ class ATSPI::Accessible
       end
 
       # @param row [Integer]
-      # @param colum [Integer]
+      # @param column [Integer]
       #
       # @return [Cell] the cell at (+row+,+column+)
       #

data/lib/atspi/application.rb

@@ -34,6 +34,13 @@ module ATSPI
     def windows
       children
     end
+
+    # It cannot get descendants by path since the path begins not until
+    # reaching the children of windows.
+    # @return [nil]
+    def descendant_by_path(*path)
+      nil
+    end
   # @!endgroup
 
   # @!group Representations

data/lib/atspi/desktop.rb

@@ -40,6 +40,13 @@ module ATSPI
     def applications
       children
     end
+
+    # It cannot get descendants by path since the path begins not until
+    # reaching the children of windows.
+    # @return [nil]
+    def descendant_by_path(*path)
+      nil
+    end
   # @!endgroup
 
   # @!group Representations

data/lib/atspi/version.rb

@@ -1,4 +1,4 @@
 module ATSPI
   # this library's version
-  VERSION = "0.8.1"
+  VERSION = "0.8.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atspi
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.8.2
 platform: ruby
 authors:
 - Christopher Aue
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-04-26 00:00:00.000000000 Z
+date: 2016-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gir_ffi