atspi 0.8.0

data/lib/atspi/accessible/text/range.rb

@@ -0,0 +1,66 @@
+module ATSPI
+  class Accessible::Text
+    # Represents a range in a {Text}.
+    class Range
+      extend Forwardable
+
+      # @api private
+      def initialize(text_native, range_native)
+        @text_native = text_native
+        @range_native = range_native
+      end
+
+    # @!group Attributes
+      # @return [Offset] its start offset
+      #
+      # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#AtspiRange-struct struct AtspiRange
+      def start
+        Offset.new(@text_native, @range_native.start_offset)
+      end
+
+      # @return [Offset] its end offset
+      #
+      # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#AtspiRange-struct struct AtspiRange
+      def end
+        Offset.new(@text_native, @range_native.end_offset)
+      end
+
+      # @return [Integer] its length
+      def length
+        self.end.to_i - start.to_i
+      end
+
+      # @param relative_to [Symbol] coordinate system derived from
+      #   libatspi's {https://developer.gnome.org/libatspi/stable/libatspi-atspi-constants.html#AtspiCoordType AtspiCoordType enum}
+      #   by removing the prefix +ATSPI_COORD_TYPE+ and making it lowercase
+      #
+      # @return [Extents] its extents
+      #
+      # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#atspi-text-get-range-extents atspi_text_get_range_extents
+      def extents(relative_to:)
+        Extents.new(@text_native.range_extents(start.to_i, self.end.to_i, relative_to))
+      end
+    # @!endgroup
+
+    # @!group Representations
+      # @return [String] its string representation
+      #
+      # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#AtspiTextRange-struct struct AtspiTextRange
+      def to_s
+        if @range_native.respond_to? :content
+          @range_native.content
+        else
+          @text_native.text(start.to_i, self.end.to_i)
+        end
+      end
+
+      # @return [String] itself as an inspectable string
+      def inspect
+        text_s = to_s[0..20] << (length > 20 ? '…' : '')
+        "#<#{self.class.name}:0x#{'%x14' % __id__} @to_s=#{text_s.inspect} @length=#{length} " <<
+          "@start=#{start} @end=#{self.end} @extents=#{extents(relative_to: :screen).inspect}>"
+      end
+    # @!endgroup
+    end
+  end
+end

data/lib/atspi/accessible/text/selection.rb

@@ -0,0 +1,48 @@
+module ATSPI
+  class Accessible::Text
+    # Represents a selected range in a {Text}.
+    class Selection < Range
+      extend Forwardable
+
+      # @api private
+      def initialize(text_native, idx)
+        @text_native = text_native
+        @idx = idx
+        @range_native = @text_native.selection(idx)
+      end
+
+    # @!group Actions
+      # Deselects itself.
+      #
+      # @return [true,false] indicating success
+      #
+      # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#atspi-text-remove-selection atspi_text_remove_selection
+      def deselect
+        @text_native.remove_selection(@idx)
+      end
+
+      # Moves its start to the given offset.
+      #
+      # @param new_start_offset [responds to #to_i]
+      #
+      # @return [true,false] indicating success
+      #
+      # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#atspi-text-set-selection atspi_text_set_selection
+      def move_start_to(new_start_offset)
+        @text_native.set_selection(@idx, new_start_offset.to_i, self.end)
+      end
+
+      # Moves its end to the given offset.
+      #
+      # @param new_end_offset [responds to #to_i]
+      #
+      # @return [true,false] indicating success
+      #
+      # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#atspi-text-set-selection atspi_text_set_selection
+      def move_end_to(new_end_offset)
+        @text_native.set_selection(@idx, start, new_end_offset.to_i)
+      end
+    # @!endgroup
+    end
+  end
+end

data/lib/atspi/accessible/text.rb

@@ -0,0 +1,120 @@
+class ATSPI::Accessible
+  # Wraps libatspi's {https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html text interface},
+  # {https://developer.gnome.org/libatspi/stable/libatspi-atspi-editabletext.html editable_text interface} and
+  # {https://developer.gnome.org/libatspi/stable/libatspi-atspi-hypertext.html hypertext interface}.
+  class Text
+    extend Forwardable
+    include Editable
+    include Hypertext
+
+    # @api private
+    def initialize(native)
+      @native = native
+    end
+
+  # @!group Attributes & States
+    # @return [Integer] its length
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#atspi-text-get-character-count atspi_text_get_character_count
+    def length
+      @native.character_count
+    end
+
+    # @return [Caret] its caret/cursor
+    def caret
+      Caret.new(@native)
+    end
+    alias_method :cursor, :caret
+
+    # @return [Array<Selection>] its selected text ranges
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#atspi-text-get-n-selections atspi_text_get_n_selections
+    def selections
+      @native.n_selections.times.map do |idx|
+        Selection.new(@native, idx)
+      end
+    end
+  # @!endgroup
+
+  # @!group Geometric Access
+    # @param x [Integer]
+    # @param y [Integer]
+    # @param relative_to [Symbol] coordinate system derived from
+    #   libatspi's {https://developer.gnome.org/libatspi/stable/libatspi-atspi-constants.html#AtspiCoordType AtspiCoordType enum}
+    #   by removing the prefix +ATSPI_COORD_TYPE+ and making it lowercase
+    #
+    # @return [Offset] the offset at the given point
+    #
+    # @example
+    #   text.offset_at(1243, 323, relative_to: :screen) # => #<ATSPI::Accessible::Text::Offset:0x112779814 … >
+    #
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#atspi-text-get-offset-at-point atspi_text_get_offset_at_point
+    def offset_at(x, y, relative_to:)
+      Offset.new(@native, @native.offset_at_point(x, y, relative_to))
+    end
+
+    # @param x [Integer] x position of the rectangle
+    # @param y [Integer] y position of the rectangle
+    # @param width [Integer] width of the rectangle
+    # @param height [Integer] height of the rectangle
+    # @param relative_to [Symbol] coordinate system derived from
+    #   libatspi's {https://developer.gnome.org/libatspi/stable/libatspi-atspi-constants.html#AtspiCoordType AtspiCoordType enum}
+    #   by removing the prefix +ATSPI_COORD_TYPE+ and making it lowercase
+    # @param clip_x [Symbol] how to treat characters intersecting the
+    #   rectangle in x direction. derived from libatspi's
+    #   {https://developer.gnome.org/libatspi/stable/libatspi-atspi-constants.html#AtspiTextClipType AtspiTextClipType enum}
+    #   by removing the prefix +ATSPI_TEXT_CLIP_+ and making it lowercase
+    #
+    # @return [Array<Range>] the ranges inside the given rectangle
+    #
+    # @example
+    #   ranges_in(200, 300, 543, 322, relative_to: :window, clip_x: :both, clip_y: :min) # => [#<ATSPI::Accessible::Text::Range:0xea30bc14 … >, …]
+    #
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#atspi-text-get-bounded-ranges atspi_text_get_bounded_ranges
+    def ranges_in(x, y, width, height, relative_to:, clip_x: :none, clip_y: :none)
+      @native.bounded_ranges(x, y, width, height, relative_to, clip_x, clip_y).map do |range|
+        Range.new(@native, range)
+      end
+    end
+  # @!endgroup
+
+  # @!group Actions
+    # Selects the text between the given offsets.
+    #
+    # @param from [responds to #to_i] start offset
+    # @param to [responds to #to_i] end offset
+    #
+    # @return [true,false] indicating success
+    #
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#atspi-text-add-selection atspi_text_add_selection
+    def select(from: 0, to: length)
+      @native.add_selection(from.to_i, to.to_i)
+    end
+
+    # Deselects the entire text.
+    #
+    # To deselect a single selection do it via {Selection#deselect}.
+    #
+    # @return [true,false] indicating success
+    def deselect
+      selections.reverse.map(&:deselect).all?
+    end
+  # @!endgroup
+
+  # @!group Representations
+    # @param from [responds to #to_i] start offset
+    # @param to [responds to #to_i] end offset
+    #
+    # @return [String] its string representation
+    #
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-text.html#atspi-text-get-text atspi_text_get_text
+    def to_s(from: 0, to: length)
+      @native.text(from.to_i, to.to_i)
+    end
+
+    # @return [String] itself as an inspectable string
+    def inspect
+      text_s = to_s(from: 0, to: 20) << (length > 20 ? '…' : '')
+      "#<#{self.class.name}:0x#{'%x14' % __id__} @to_s=#{text_s.inspect} @length=#{length}>"
+    end
+  # @!endgroup
+  end
+end

data/lib/atspi/accessible/value.rb

@@ -0,0 +1,47 @@
+module ATSPI
+  # Wraps libatspi's AtspiValue[https://developer.gnome.org/libatspi/stable/libatspi-atspi-value.html]
+  class Accessible::Value
+    extend Forwardable
+
+    # @api private
+    def initialize(native)
+      @native = native
+    end
+
+    # @return [Float] its minimum
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-value.html#atspi-value-get-minimum-value atspi_value_get_minimum_value
+    def minimum
+      @native.minimum_value
+    end
+
+    # @return [Float] its maximum
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-value.html#atspi-value-get-maximum-value atspi_value_get_maximum_value
+    def maximum
+      @native.maximum_value
+    end
+
+    # @return [Float] its current value
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-value.html#atspi-value-get-current-value atspi_value_get_current_value
+    def current
+      @native.current_value
+    end
+
+    # Sets its value to the given one.
+    # @return [true,false] indicating success
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-value.html#atspi-value-set-current-value atspi_value_set_current_value
+    def set_to(value)
+      @native.set_current_value(value)
+    end
+
+    # @return [Float] its minimum increment
+    # @see https://developer.gnome.org/libatspi/stable/libatspi-atspi-value.html#atspi-value-get-minimum-increment atspi_value_get_minimum_increment
+    def step
+      @native.minimum_increment
+    end
+
+    # @return [String] itself as an inspectable string
+    def inspect
+      "#<#{self.class.name}:0x#{'%x14' % __id__} @min=#{min} @cur=#{cur} @max=#{max} @incr=#{incr}>"
+    end
+  end
+end

data/lib/atspi/accessible.rb

@@ -0,0 +1,267 @@
+Libatspi.load_class :Accessible
+
+module ATSPI
+  # Wraps libatspi's AtspiAccessible[https://developer.gnome.org/libatspi/stable/AtspiAccessible.html]
+  #
+  # The entry point to get ATSPI::Accessibles or one of it sub types are
+  # {ATSPI.desktops ATSPI.desktops} and {ATSPI.applications ATSPI.applications}.
+  # From there, accessibles are gotten via Tree & Traversal methods like
+  # {#parent}, {#children} or {#descendants}.
+  #
+  # Most methods correspond directly to the method in libatspi. Some have an
+  # extended or beautified interface that is documented here.
+  class Accessible
+    extend Forwardable
+    include Extents
+    include Selectable
+
+    class << self
+      # @api private
+      def new(native)
+        if self == Accessible
+          native and (new_mapped(native) or super)
+        else
+          super
+        end
+      end
+
+      private
+
+      def new_mapped(native)
+        case native.role
+        when :desktop_frame then Desktop.new(native)
+        when :application then Application.new(native)
+        when :frame then Window.new(native)
+        else nil
+        end
+      end
+    end
+
+    # @api private
+    def initialize(native)
+      @native = native
+    end
+
+    attr_reader :native
+    private :native
+
+  # @!group Identification
+    # @return [Desktop] its desktop. That is the {#parent} of its {#application}.
+    delegate :desktop => :application
+
+    # @return [Application] its application
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-application atspi_accessible_get_application
+    def application
+      Application.new(@native.application)
+    end
+
+    # @return [Window] its top level window. It is a {#children child} of its {#application} and has
+    #   the {#role} :frame.
+    delegate :window => :parent
+
+    # @return [Integer] the index in the collection of its {#parent} {#children}
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-index-in-parent atspi_accessible_get_index_in_parent
+    delegate :index_in_parent => :@native
+    alias_method :index, :index_in_parent
+
+    # @return [Array<Integer>] the list of {#index_in_parent} of all its
+    #   ancestors until reaching its {#window}, exclusive.
+    def path
+      parent.path + [*index_in_parent]
+    end
+  # @!endgroup
+
+  # @!group Attributes & States
+    # @return [String] its name
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-name atspi_accessible_get_name
+    delegate :name => :@native
+
+    # @return [String] its description
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-description atspi_accessible_get_description
+    delegate :description => :@native
+
+    # @return [Symbol] its role derived from libatspi's {AtspiRole enum}[https://developer.gnome.org/libatspi/stable/libatspi-atspi-constants.html#AtspiRole]
+    #   by removing the prefix +ATSPI_ROLE_+ and making it lowercase.
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-role atspi_accessible_get_role
+    delegate :role => :@native
+
+    # @return [String] its role as string
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-role-name atspi_accessible_get_role_name
+    delegate :role_name => :@native
+
+    # @return [String] its role as a localized string
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-localized-role-name atspi_accessible_get_localized_role_name
+    delegate :localized_role_name => :@native
+
+    # @return [String] its toolkit's name
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-toolkit-name atspi_accessible_get_toolkit_name
+    delegate :toolkit_name => :@native
+
+    # @return [String] its toolkit's version
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-toolkit-version atspi_accessible_get_toolkit_version
+    delegate :toolkit_version => :@native
+
+    # @return [StateSet] its states
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-state-set atspi_accessible_get_state_set
+    def states
+      StateSet.new_from_native(@native.state_set)
+    end
+
+    # @return [Hash<String => String>] its attributes
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-attributes atspi_accessible_get_attributes
+    def attributes
+      @native.attributes.to_h
+    end
+
+    # @return [Array<String>] the interfaces it implements
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-interfaces atspi_accessible_get_interfaces
+    def interfaces
+      @native.interfaces.to_a
+    end
+  # @!endgroup
+
+  # @!group Tree & Traversal
+    # @return [Accessible] its parent
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-parent atspi_accessible_get_parent
+    def parent
+      Accessible.new(@native.get_parent)
+    end
+
+    # @return [Children] its children
+    def children
+      Children.new(@native)
+    end
+
+    # @return [Descendants, []] its descendants. It will be an empty array it
+    #   does not implement the {https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-collection collection interface}
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-collection atspi_accessible_get_collection
+    def descendants
+      if @native.collection_iface
+        Descendants.new(@native)
+      else
+        []
+      end
+    end
+
+    # @return [Hash<Symbol => Array<Accessible>>] its relations to other
+    #   accessibles. Keys name the relation type and values are relation
+    #   targets.
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-relation-set atspi_accessible_get_relation_set
+    # @see https://developer.gnome.org/libatspi/stable/AtspiRelation.html atspi-relation
+    def relations
+      @native.relation_set.to_a.inject({}) do |relations, relation|
+        type = relation.relation_type
+        targets = relation.n_targets.times.map{ |idx| Accessible.new(relation.target(idx)) }
+        relations.merge!(type => targets)
+      end
+    end
+  # @!endgroup
+
+  # @!group Actions
+    # @return [Array<Action>] the actions it supports. The array will be empty
+    #   if it does not implement the {https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-action action interface}.
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-action atspi_accessible_get_action_iface
+    def actions
+      if @native.action_iface
+        @native.n_actions.times.map{ |idx| Action.new(@native, idx) }
+      else
+        []
+      end
+    end
+  # @!endgroup
+
+  # @!group Representative for
+    # @return [Document, nil] its document. It will be nil if it does not
+    #   implement the {https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-document document interface}.
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-document atspi_accessible_get_document_iface
+    def document
+      if @native.document_iface
+        Document.new(@native)
+      end
+    end
+
+    # @return [Text, nil] its text. It will be nil if it does not
+    #   implement the {https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-text text interface}.
+    #
+    # @note The {https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-editable-text editable_text interface}
+    #   and {https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-hypertext hypertext interface} are
+    #   available through {Text}, too.
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-text atspi_accessible_get_text_iface
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-editable-text atspi_accessible_get_editable_text_iface
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-hypertext atspi_accessible_get_hypertext_iface
+    def text
+      if @native.text_iface
+        Text.new(@native)
+      end
+    end
+
+    # @return [Hyperlink, nil] its hyperlink. It will be nil if it does not
+    #   have a {https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-hyperlink hyperlink}.
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-hyperlink atspi_accessible_get_hyperlink
+    def hyperlink
+      if hyperlink = @native.hyperlink
+        Hyperlink.new(hyperlink)
+      end
+    end
+    alias_method :link, :hyperlink
+
+    # @return [Image, nil] its image. It will be nil if it does not
+    #   implement the {https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-image image interface}.
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-image atspi_accessible_get_image_iface
+    def image
+      if @native.image_iface
+        Image.new(@native)
+      end
+    end
+
+    # @return [Value, nil] its image. 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
+    def value
+      if @native.value_iface
+        Value.new(@native)
+      end
+    end
+
+    # @return [Table, nil] its table. It will be nil if it does not
+    #   implement the {https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-table table interface}.
+    #
+    # @see https://developer.gnome.org/libatspi/stable/AtspiAccessible.html#atspi-accessible-get-table atspi_accessible_get_table_iface
+    def table
+      if @native.table_iface
+        Table.new(@native)
+      end
+    end
+  # @!endgroup
+
+  # @!group Representations
+    # @return [String] itself as an inspectable string
+    def inspect
+      "#<#{self.class.name}:0x#{'%x14' % __id__} @desktop=#{desktop.index} " <<
+        "@application=#{application.name} @window=#{window.name} @path=#{path.join('/')} " <<
+        "@name=#{name.inspect} @role=#{role.inspect} @extents=#{extents(relative_to: :screen).inspect}>"
+    end
+  # @!endgroup
+  end
+end

data/lib/atspi/application.rb

@@ -0,0 +1,46 @@
+module ATSPI
+  # Applications are Accessibles having a few exceptions.
+  class Application < Accessible
+  # @!group Identification
+    # It has no path.
+    # @return [[]]
+    def path
+      []
+    end
+
+    # Its desktop is its parent
+    # @return [Desktop]
+    def desktop
+      parent
+    end
+
+    # Its application is itself
+    # @return [self]
+    def application
+      self
+    end
+
+    # It belongs to no window
+    # @return nil
+    def window
+      nil
+    end
+  # @!endgroup
+
+  # @!group Tree & Traversal
+    # Its windows are its children.
+    # @param (see Accessible#children)
+    # @return (see Accessible#children)
+    def windows
+      children
+    end
+  # @!endgroup
+
+  # @!group Representations
+  # @return [String] itself as an inspectable string
+    def inspect
+      "#<#{self.class.name}:0x#{'%x14' % __id__} @desktop=#{desktop.index} @name=#{name.inspect}>"
+    end
+  # @!endgroup
+  end
+end

data/lib/atspi/collection.rb

@@ -0,0 +1,60 @@
+module ATSPI
+  # Included in classes representing a collection that can be iterated over.
+  # A Collection is an Enumerable adjusted to the what we can efficiently get
+  # from libatspi. In particular, it provides access to items by index and
+  # from the end of the collection.
+  module Collection
+    include Enumerable
+  # @!group Enumerable interface
+    # prerequisite for Enumerable
+    def each
+      count.times.each do |idx|
+        yield at(idx)
+      end
+    end
+
+    # @param idx [Integer]
+    # @return [Object] item at index +idx+
+    def at(idx)
+      if idx.between?(0, count-1)
+        yield idx
+      elsif idx.between?(-count, -1)
+        yield count+idx
+      else
+        nil
+      end
+    end
+
+    # alias for {#at}
+    def [](idx)
+      at(idx)
+    end
+
+    # @return [0] default size of collection
+    def count
+      0
+    end
+    # alias for {#count}
+    def size; count end
+    # alias for {#count}
+    def length; count end
+
+    # @param n [Integer] number of items to return
+    # @return [Object,Array<Object>] item(s) from the end
+    def last(n = 1)
+      if n > 1
+        [n,count].min.downto(1).map{ |idx| at(-idx) }
+      else
+        at(-1)
+      end
+    end
+  # @!endgroup
+
+  # @!group Representation
+    # @return [String] instance as inspectable string
+    def inspect
+      "#<#{self.class.name}:0x#{'%x14' % __id__} @count=#{count}>"
+    end
+  # @!endgroup
+  end
+end