atspi 0.8.2 → 0.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 098653bbb4fcf2ebee3ccb274d9a1b5d7bf73035
-  data.tar.gz: fbf3a9680dc2a95dd6ead1803b23ae6bcffd7f93
+  metadata.gz: 477e6b15eb78929735b6381e44736750f9486126
+  data.tar.gz: 1f1a1713e6a298d250ffb7b1b110c681b1b68273
 SHA512:
-  metadata.gz: 1f609ffa1b51a3e0e8bf4373ad5ca187995cd5a917a7a7c928ccfeaf3430ad5f59b0cf8f6848e50721fc80f987645daf1af65898accd0c31200b5a4052710a25
-  data.tar.gz: 807b5aa658a532c1d61f55d18c0c1c5aae78a94bab9f27f2f1a1ec7c72992e780624ecf28b2c84d3d2c4991d1e9bdca65d8d975d4a1763d9f369afe3fd83e387
+  metadata.gz: dca8e742c4e33109704dc5f75c3db4fe32fbb057b2fe817090c358d8fdf163820de2e0c9f40a4b9ed55dfb0c35e9b1219f3aadeb9de037f7611de1efc5d2e089
+  data.tar.gz: 71f344c322ae3df19f83adbc52da8b2d0bb41b324eb5f2f06f3d5eb56906de7e323f41af92359406ebcd73d0cd51ebc1d061de11875ba6ad64fa81763c6d29a3

data/lib/atspi/accessible.rb

@@ -34,6 +34,8 @@ module ATSPI
         when :frame then Window.new(native)
         else nil
         end
+      rescue
+        ErrorAccessible.new(native)
       end
     end
 
@@ -157,7 +159,7 @@ module ATSPI
       end
     end
 
-    # @return [Accessible] its descendant found at the given path
+    # @return [Accessible,nil] its descendant found at the given path
     #
     # @overload descendant_by_path(path)
     #   @param path [Array] a path as returned by {#path}
@@ -258,7 +260,7 @@ module ATSPI
       end
     end
 
-    # @return [Value, nil] its image. It will be nil if it does not
+    # @return [Value, nil] its value. It will be nil if it does not
     #   implement the {https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-value value interface}.
     #
     # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-value atspi_accessible_get_value_iface

data/lib/atspi/error_accessible.rb

@@ -0,0 +1,178 @@
+module ATSPI
+  # The {ErrorAccessible} is used for accessibles that cannot be instantiated
+  # due to errors. It responds to the interface of {Accessible} and returns
+  # dummy values.
+  class ErrorAccessible
+    include Accessible::Extents
+    def extends?
+      false
+    end
+
+    include Accessible::Selectable
+    def selectable?
+      false
+    end
+
+    # @api private
+    def initialize(native)
+      @native = native
+    end
+
+    attr_reader :native
+    private :native
+
+  # @!group Identification
+    # @return [nil] no desktop
+    def desktop
+      nil
+    end
+
+    # @return [nil] no application
+    def application
+      nil
+    end
+
+    # @return [nil] no window
+    def window
+      nil
+    end
+
+    # @return [-1] an invalid index
+    def index_in_parent
+      -1
+    end
+    alias_method :index, :index_in_parent
+
+    # @return [{}] an empty path
+    def path
+      []
+    end
+  # @!endgroup
+
+  # @!group Attributes & States
+    # @return [String] its inspection
+    def name
+      inspect
+    end
+
+    # @return [String] its inspection
+    def description
+      inspect
+    end
+
+    # @return [:invalid]
+    def role
+      :invalid
+    end
+
+    # @return ['Invalid']
+    def role_name
+      'Invalid'
+    end
+
+    # @return ['Invalid']
+    def localized_role_name
+      'Invalid'
+    end
+
+    # @return [''] an empty string
+    def toolkit_name
+      ''
+    end
+
+    # @return [''] an empty string
+    def toolkit_version
+      ''
+    end
+
+    # @return [StateSet] an empty state set
+    def states
+      StateSet.new
+    end
+
+    # @return [{}] an empty hash
+    def attributes
+      {}
+    end
+
+    # @return [[]] no interfaces
+    def interfaces
+      []
+    end
+  # @!endgroup
+
+  # @!group Tree & Traversal
+    # @return [nil] no parent
+    def parent
+      nil
+    end
+
+    # @return [[]] no children
+    def children
+      []
+    end
+
+    # @return [[]] no descendants
+    def descendants
+      []
+    end
+
+    # @return [nil]
+    def descendant_by_path(*path)
+      nil
+    end
+
+    # @return [{}] no relations
+    def relations
+      {}
+    end
+  # @!endgroup
+
+  # @!group Actions
+    # @return [[]] it supports no actions
+    def actions
+      []
+    end
+  # @!endgroup
+
+  # @!group Representative for
+    # @return [nil] no document
+    def document
+      nil
+    end
+
+    # @return [nil] no text
+    def text
+      nil
+    end
+
+    # @return [nil] no hyperlink
+    def hyperlink
+      nil
+    end
+    alias_method :link, :hyperlink
+
+    # @return [nil] no image
+    def image
+      nil
+    end
+
+    # @return [nil] no value
+    def value
+      nil
+    end
+
+    # @return [nil] no table
+    def table
+      nil
+    end
+  # @!endgroup
+
+  # @!group Representations
+    # @return [String] itself as an inspectable string
+    def inspect
+      "#<#{self.class.name}:0x#{'%x14' % __id__}>"
+    end
+  # @!endgroup
+  end
+end

data/lib/atspi/requires.rb

@@ -73,4 +73,5 @@ require 'atspi/accessible/value'
 # Specific accessibles
 require 'atspi/desktop'
 require 'atspi/application'
-require 'atspi/window'
+require 'atspi/window'
+require 'atspi/error_accessible'

data/lib/atspi/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atspi
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.8.3
 platform: ruby
 authors:
 - Christopher Aue
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-04-28 00:00:00.000000000 Z
+date: 2016-04-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gir_ffi
@@ -96,6 +96,7 @@ files:
 - lib/atspi/application.rb
 - lib/atspi/collection.rb
 - lib/atspi/desktop.rb
+- lib/atspi/error_accessible.rb
 - lib/atspi/extents.rb
 - lib/atspi/libatspi.rb
 - lib/atspi/requires.rb