appium_lib_core 13.1.3 → 13.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a3e07bd8b81e3b5ff0429d7d3c786373bcaaa89c88c141561079357e0cd30c4
-  data.tar.gz: 1f1867c731d2a84f9d4853f48c2c9e9e1cb7e2c8e5e262a1e4f4230dfbe31e7e
+  metadata.gz: 5f58df4e5db1afd7bdaf68fdcb87493c51d2c0807bbcaa91b031c15bcefdc509
+  data.tar.gz: c597388ecf32f065053c5098f52ddf91cad376af02d9996518d31c1962d41c76
 SHA512:
-  metadata.gz: 1addf77654cbd05b97054d930104d8635c32718cb7841682fd011910887cc1a31adae15d81cc20d8282e1b7babdad1a0c3bbd82d6e6cf5772465988c715b68c5
-  data.tar.gz: '0190a838d93f05ef1bad95db3166f8a47731155465031ddd4dba8635761bbe518c6aba08da049c7f5163c25b5585b21f20ab3230d39b663ab2d201365d2804ed'
+  metadata.gz: 7f8afcd5b9d81aae9e7ea0ca51d5a98e184534b906793a358823956512a39e32caa1c24983c2ded9ba1ecccb2e16f6971974bec0f5541887a0bac0f25225be24
+  data.tar.gz: f82582b27f5520d4992565cac86a86e2b1b8d465f30f8867646e090e2f4588786e5bb869bf83cc1d7df28710e3c03eb59a1cb6a8a41b99998d63b9600e38584d

data/CHANGELOG.md

@@ -2,6 +2,20 @@
 All notable changes to this project will be documented in this file.
 New entries are generated by Release Please. Historical commit-level details through 13.1.0 remain in `release_notes.md`.
 
+## [13.2.0](https://github.com/appium/ruby_lib_core/compare/v13.1.4...v13.2.0) (2026-10-26)
+
+
+### Features
+
+* Implement Cached Element for shouldUseCompactResponses and elementResponseAttributes ([#727](https://github.com/appium/ruby_lib_core/issues/727)) ([a0b22c5](https://github.com/appium/ruby_lib_core/commit/a0b22c5d8d757b787b44ba0468e6a216a7c46725))
+
+## [13.1.4](https://github.com/appium/ruby_lib_core/compare/v13.1.3...v13.1.4) (2026-10-03)
+
+
+### Bug Fixes
+
+* add missing RBS for direct connect DNS constants ([#718](https://github.com/appium/ruby_lib_core/issues/718)) ([f288cf2](https://github.com/appium/ruby_lib_core/commit/f288cf23de843bef7af97562d37d01a356ee0a3e))
+
 ## [13.1.3](https://github.com/appium/ruby_lib_core/compare/v13.1.2...v13.1.3) (2026-09-13)
 
 

data/README.md

@@ -151,6 +151,31 @@ assert attached_driver.session_id == @driver.session_id
 attached_driver.page_source
 ```
 
+### Element response attributes
+
+When the server is configured with `shouldUseCompactResponses: false` and
+`elementResponseAttributes`, returned attributes are available through `element.cached`:
+
+```ruby
+element = @driver.find_element(:accessibility_id, 'some accessibility')
+element.cached.text                    # text returned with this element
+element.cached['content-desc']          # also accepts attribute/content-desc
+element.cached.attributes              # returned attributes, excluding element IDs
+element.text                           # fetches current text; does not update cached
+```
+
+`cached` only reads the response snapshot. It cannot find elements or send commands.
+Standard boolean fields (`enabled`, `displayed`, `selected`) normalize `"true"` and
+`"false"` to booleans. `cached.rect`, `cached.location`, and `cached.size` return
+Selenium Rectangle, Point, and Dimension objects; `cached.tag_name` reads `name`.
+These conversions also apply to `cached[name]`. Explicit `cached['attribute/...']`
+lookups and custom attributes retain their server types. `cached.attributes`
+exposes the original server values.
+Use `cached[name]` for optional attributes; it returns `nil` when absent. Dynamic
+methods such as `cached.text` are available only for attributes in the response.
+Standard accessors such as `cached.enabled?` and `cached.rect` return `nil` when
+their data is absent.
+
 ### Capabilities
 
 Read [Appium/Core/Driver](https://rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Driver) to catch up with available capabilities.

data/lib/appium_lib_core/common/base/bridge.rb

@@ -148,6 +148,13 @@ module Appium
 
         private
 
+        # Preserve the response until Element initialization, including for script results.
+        # Selenium calls this immediately before constructing an element. Keep nil for
+        # non-element hashes so ordinary script results and shadow roots stay intact.
+        def element_id_from(response)
+          response if super
+        end
+
         def selenium_bridge_accepts_url?
           ::Selenium::WebDriver::Remote::Bridge.instance_method(:initialize).parameters.any? do |_, name|
             name == :url

data/lib/appium_lib_core/driver.rb

@@ -134,7 +134,7 @@ module Appium
         return [normalized_host] if ip_literal?(normalized_host)
 
         Timeout.timeout(DNS_RESOLVE_TIMEOUT_SECONDS) do
-          Socket.getaddrinfo(normalized_host, nil).map { |entry| entry[3] }.uniq
+          Socket.getaddrinfo(normalized_host, nil).map { |entry| entry[3].to_s }.uniq
         end
       rescue Timeout::Error
         ::Appium::Logger.warn("DNS resolution for '#{host}' timed out after #{DNS_RESOLVE_TIMEOUT_SECONDS}s")

data/lib/appium_lib_core/element.rb

@@ -17,6 +17,86 @@ module Appium
     # Implement useful features for element.
     # Patch for Selenium Webdriver.
     class Element < ::Selenium::WebDriver::Element
+      # Attributes returned with an element response. This object has no bridge:
+      # reading it never sends a command or refreshes the returned values.
+      class Cache
+        attr_reader :attributes
+
+        def initialize(attributes = {})
+          @attributes = attributes.dup.freeze
+        end
+
+        # Normalize standard response fields; arbitrary attribute/... values stay raw.
+        # Missing attributes return nil. The original values remain in attributes.
+        def attribute(name)
+          key = attribute_key(name)
+          value = @attributes[key]
+          case name.to_s
+          when 'enabled', 'displayed', 'selected'
+            return true if value == 'true'
+            return false if value == 'false'
+          when 'rect'
+            return ::Selenium::WebDriver::Rectangle.new(value['x'], value['y'], value['width'], value['height']) if value.is_a?(Hash)
+          end
+          value
+        end
+
+        alias [] attribute
+
+        def enabled?
+          attribute('enabled')
+        end
+
+        alias enabled enabled?
+
+        def displayed?
+          attribute('displayed')
+        end
+
+        alias displayed displayed?
+
+        def selected?
+          attribute('selected')
+        end
+
+        alias selected selected?
+
+        def rect
+          attribute('rect')
+        end
+
+        def location
+          rectangle = rect
+          ::Selenium::WebDriver::Point.new(rectangle.x, rectangle.y) if rectangle
+        end
+
+        def size
+          rectangle = rect
+          ::Selenium::WebDriver::Dimension.new(rectangle.width, rectangle.height) if rectangle
+        end
+
+        def tag_name
+          attribute('name')
+        end
+
+        def method_missing(name, *args, &block)
+          return super unless args.empty? && block.nil? && respond_to_missing?(name)
+
+          attribute(name.to_s.delete_suffix('?').tr('_', '-'))
+        end
+
+        def respond_to_missing?(name, include_private = false)
+          @attributes.key?(attribute_key(name.to_s.delete_suffix('?').tr('_', '-'))) || super
+        end
+
+        private
+
+        def attribute_key(name)
+          key = name.to_s
+          @attributes.key?("attribute/#{key}") ? "attribute/#{key}" : key
+        end
+      end
+
       include ::Appium::Core::Base::TakesScreenshot
 
       # steep:ignore:start
@@ -32,6 +112,24 @@ module Appium
       #
       attr_reader :id
 
+      def initialize(bridge, id, cached = nil)
+        if id.is_a?(Hash)
+          # Preserve any extra attributes included in the element response.
+          cached = Cache.new(id.except('ELEMENT', ELEMENT_KEY))
+          id = id['ELEMENT'] || id[ELEMENT_KEY]
+        end
+        super(bridge, id)
+        @cached = cached
+      end
+
+      # Snapshot from elementResponseAttributes with shouldUseCompactResponses=false.
+      # Normal element calls still query the server and do not update this snapshot.
+      # Standard fields use Element API types; cached.attributes holds server values.
+      # @return [Appium::Core::Element::Cache]
+      def cached
+        @cached ||= Cache.new
+      end
+
       # Returns the value of attributes like below. Read each platform to know more details.
       #
       # uiautomator2: https://github.com/appium/appium-uiautomator2-server/blob/203cc7e57ce477f3cff5d95b135d1b3450a6033a/app/src/main/java/io/appium/uiautomator2/utils/Attribute.java#L19

data/lib/appium_lib_core/support/event_firing_bridge.rb

@@ -29,7 +29,7 @@ module Appium
           @delegate.find_element_by how, what, parent
         end
 
-        ::Appium::Core::Element.new self, e.ref.last
+        ::Appium::Core::Element.new self, e.ref.last, e.cached
       end
 
       def find_elements_by(how, what, parent = nil)
@@ -37,7 +37,7 @@ module Appium
           @delegate.find_elements_by(how, what, parent)
         end
 
-        es.map { |e| ::Appium::Core::Element.new self, e.ref.last }
+        es.map { |e| ::Appium::Core::Element.new self, e.ref.last, e.cached }
       end
 
       private

data/lib/appium_lib_core/version.rb

@@ -14,7 +14,7 @@
 
 module Appium
   module Core
-    VERSION = '13.1.3' unless defined? ::Appium::Core::VERSION
-    DATE    = '2026-09-13' unless defined? ::Appium::Core::DATE # x-release-please-date
+    VERSION = '13.2.0' unless defined? ::Appium::Core::VERSION
+    DATE    = '2026-10-26' unless defined? ::Appium::Core::DATE # x-release-please-date
   end
 end

data/sig/gems/selenium/common/element.rbs

@@ -3,6 +3,8 @@ module Selenium
     class Element
       ELEMENT_KEY: ::String
 
+      def initialize: (untyped bridge, untyped id) -> void
+
       def inspect: () -> untyped
 
       def ==: (untyped other) -> bool

data/sig/lib/appium_lib_core/common/base/bridge.rbs

@@ -105,6 +105,8 @@ module Appium
 
         private
 
+        def element_id_from: (untyped response) -> untyped
+
         def selenium_bridge_accepts_url?: () -> bool
 
         def camel_case: (untyped str_or_sym) -> untyped

data/sig/lib/appium_lib_core/driver.rbs

@@ -70,6 +70,18 @@ module Appium
 
       W3C_KEYS: Hash[String | Symbol, String]
 
+      DNS_RESOLVE_TIMEOUT_SECONDS: Integer
+
+      LOOPBACK_RANGES: Array[IPAddr]
+
+      LINK_LOCAL_RANGES: Array[IPAddr]
+
+      UNSPECIFIED_RANGES: Array[IPAddr]
+
+      MULTICAST_RANGES: Array[IPAddr]
+
+      DISALLOWED_RANGES: Array[IPAddr]
+
       attr_reader protocol: String
 
       attr_reader host: String

data/sig/lib/appium_lib_core/element.rbs

@@ -2,9 +2,37 @@ module Appium
   module Core
     # Element class inheriting from Selenium::WebDriver::Element
     class Element < ::Selenium::WebDriver::Element
+      class Cache
+        attr_reader attributes: Hash[String, untyped]
+
+        def initialize: (?Hash[String, untyped] attributes) -> void
+        def attribute: (String | Symbol name) -> untyped
+        alias [] attribute
+        def enabled?: () -> bool?
+        alias enabled enabled?
+        def displayed?: () -> bool?
+        alias displayed displayed?
+        def selected?: () -> bool?
+        alias selected selected?
+        def rect: () -> untyped
+        def location: () -> untyped
+        def size: () -> untyped
+        def tag_name: () -> String?
+        def method_missing: (Symbol name, *untyped args) ?{ (?) -> untyped } -> untyped
+        def respond_to_missing?: (Symbol name, ?bool include_private) -> bool
+
+        private
+
+        def attribute_key: (String | Symbol name) -> String
+      end
+
       include ::Appium::Core::Base::TakesScreenshot
 
-      def initialize: (untyped bridge, untyped id) -> void
+      @cached: Cache?
+
+      def initialize: (untyped bridge, untyped id, ?Cache? cached) -> void
+
+      def cached: () -> Cache
 
       attr_reader id: Array[untyped]
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib_core
 version: !ruby/object:Gem::Version
-  version: 13.1.3
+  version: 13.2.0
 platform: ruby
 authors:
 - Kazuaki MATSUO
@@ -251,7 +251,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Minimal Ruby library for Appium.
 test_files: []