elasticgraph-support 0.19.1.1 → 0.19.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5011690a4632f61ad8385954fdd40dc642910f857639c0ecd9b18ab92cd3ac5
-  data.tar.gz: 74ff3c94eb4c6b4d118a9894e62d8c901cead6eda46468d34e453db5a4bd5b21
+  metadata.gz: a14d36c34bf951d94568e37cf2a8152d264214b13e23e4fd0bd718dbf95ca4fa
+  data.tar.gz: 61845392dc210469ccf00672d91d683094a1cdbe9abf5db98c26ee8cb25629c2
 SHA512:
-  metadata.gz: 0c31e5517580458e1ce45a410f865e11c79e2105dc36e4d1b76579c4b401f6a0b95a5f9e6ffc39dadfc4b60c38b24e43f9d98bf84f215d6dfdd14d76b5295104
-  data.tar.gz: 2985360c094becc9b0c5984b2974273f876e09ecc65656e54e32cbac761a9d2d3326bb28d43ec0653491969ca7cef144f51be3a067307ec53f51e160c7ce9f71
+  metadata.gz: c31b4a29ba0c9d7db0ebd0e150f4a6bde49edb721329fd1669bf1cb9b3b88bfbc5672b3e2e2fbd1f9b6ee4bbc9e1957edd4d2bd7622dc3e1ac99ececba2761c6
+  data.tar.gz: 929da040de365779c80cd0d04e7a9f4c5c6d6e7833f399193e4045b671c66895cf5261f99e9d6ec76233c18ec3911d65d9f8b4cb7034f24afa5bb1a0e04d2403

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2024 Block, Inc.
+Copyright (c) 2024 - 2025 Block, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/lib/elastic_graph/constants.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/errors.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at
@@ -27,6 +27,9 @@ module ElasticGraph
     class CountUnavailableError < Error
     end
 
+    class AggregationsUnavailableError < Error
+    end
+
     class InvalidArgumentValueError < Error
     end
 

data/lib/elastic_graph/support/faraday_middleware/msearch_using_get_instead_of_post.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/support/faraday_middleware/support_timeouts.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/support/from_yaml_file.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/support/graphql_formatter.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/support/hash_util.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at
@@ -50,9 +50,7 @@ module ElasticGraph
       # Recursively transforms any hash keys in the given object to string keys, without
       # mutating the provided argument.
       def self.stringify_keys(object)
-        recursively_transform(object) do |key, value, hash|
-          hash[key.to_s] = value
-        end
+        transform_keys(object, :to_s)
       end
 
       # Recursively transforms any hash keys in the given object to symbol keys, without
@@ -61,9 +59,7 @@ module ElasticGraph
       # Important note: this should never be used on untrusted input. Symbols are not GCd in
       # Ruby in the same way as strings.
       def self.symbolize_keys(object)
-        recursively_transform(object) do |key, value, hash|
-          hash[key.to_sym] = value
-        end
+        transform_keys(object, :to_sym)
       end
 
       # Recursively prunes nil values from the hash, at any level of its structure, without
@@ -114,37 +110,72 @@ module ElasticGraph
       end
 
       # Fetches a list of (potentially) nested value from a hash. The `key_path` is expected
-      # to be a string with dots between the nesting levels (e.g. `foo.bar`). Returns `[]` if
-      # the value at any parent key is `nil`. Returns a flat array of values if the structure
-      # at any level is an array.
+      # to be an array of path parts. Returns `[]` if the value at any parent key is `nil`.
+      # Returns a flat array of values if the structure at any level is an array.
       #
       # Raises an error if the key is not found unless a default block is provided.
       # Raises an error if any parent value is not a hash as expected.
       # Raises an error if the provided path is not a full path to a leaf in the nested structure.
       def self.fetch_leaf_values_at_path(hash, key_path, &default)
-        do_fetch_leaf_values_at_path(hash, key_path.split("."), 0, &default)
+        do_fetch_leaf_values_at_path(hash, key_path, 0, &default)
       end
 
-      # Fetches a single value from the hash at the given path. The `key_path` is expected
-      # to be a string with dots between the nesting levels (e.g. `foo.bar`).
+      # Fetches a single value from the hash at the given path. The `path_parts` is expected to be an array.
       #
       # If any parent value is not a hash as expected, raises an error.
       # If the key at any level is not found, yields to the provided block (which can provide a default value)
       # or raises an error if no block is provided.
-      def self.fetch_value_at_path(hash, key_path)
-        path_parts = key_path.split(".")
-
-        path_parts.each.with_index(1).reduce(hash) do |inner_hash, (key, num_parts)|
-          if inner_hash.is_a?(::Hash)
-            inner_hash.fetch(key) do
-              missing_path = path_parts.first(num_parts).join(".")
-              return yield missing_path if block_given?
-              raise KeyError, "Key not found: #{missing_path.inspect}"
-            end
-          else
-            raise KeyError, "Value at key #{path_parts.first(num_parts - 1).join(".").inspect} is not a `Hash` as expected; " \
-              "instead, was a `#{(_ = inner_hash).class}`"
+      #
+      # Note: this is a somewhat lengthy implementation, but it was chosen based on benchmarking. This method
+      # needs to be fast because it gets used repeatedly when resolving GraphQL queries at all levels of the
+      # response structure.
+      def self.fetch_value_at_path(hash, path_parts)
+        # We expect the most common case to be a single path part. Benchmarks have shown that special casing it
+        # is quite worthwhile, as it is much faster than the general purpose implementation further below.
+        if path_parts.size == 1
+          return hash.fetch(path_parts.first) do
+            return yield path_parts if block_given?
+            raise KeyError, "Key not found: #{path_parts.inspect}"
+          end
+        end
+
+        current = hash
+        i = 0
+
+        while i < path_parts.length
+          key = path_parts[i]
+
+          unless current.is_a?(Hash)
+            raise KeyError, "Value at key #{path_parts.first(i).inspect} is not a `Hash` as expected; " \
+              "instead, was a `#{current.class}`"
+          end
+
+          current = current.fetch(key) do
+            missing_path = path_parts.first(i + 1)
+            return yield missing_path if block_given?
+            raise KeyError, "Key not found: #{missing_path.inspect}"
+          end
+
+          i += 1
+        end
+
+        current
+      end
+
+      # Note: this implementation was chosen based off of a benchmark in
+      # `benchmarks/hash_util/key_transformations.rb`.
+      private_class_method def self.transform_keys(object, method)
+        case object
+        when ::Hash
+          result = {} # : ::Hash[untyped, untyped]
+          object.each do |key, value|
+            result[key.send(method)] = transform_keys(value, method)
           end
+          result
+        when ::Array
+          object.map { |item| transform_keys(item, method) }
+        else
+          object
         end
       end
 
@@ -192,7 +223,7 @@ module ElasticGraph
       private_class_method def self.do_fetch_leaf_values_at_path(object, path_parts, level_index, &default)
         if level_index == path_parts.size
           if object.is_a?(::Hash)
-            raise KeyError, "Key was not a path to a leaf field: #{path_parts.join(".").inspect}"
+            raise KeyError, "Key was not a path to a leaf field: #{path_parts.inspect}"
           else
             return Array(object)
           end
@@ -206,7 +237,7 @@ module ElasticGraph
           if object.key?(key)
             do_fetch_leaf_values_at_path(object.fetch(key), path_parts, level_index + 1, &default)
           else
-            missing_path = path_parts.first(level_index + 1).join(".")
+            missing_path = path_parts.first(level_index + 1)
             if default
               Array(default.call(missing_path))
             else
@@ -220,7 +251,7 @@ module ElasticGraph
         else
           # Note: we intentionally do not put the value (`current_level_hash`) in the
           # error message, as that would risk leaking PII. But the class of the value should be OK.
-          raise KeyError, "Value at key #{path_parts.first(level_index).join(".").inspect} is not a `Hash` as expected; " \
+          raise KeyError, "Value at key #{path_parts.first(level_index).inspect} is not a `Hash` as expected; " \
             "instead, was a `#{object.class}`"
         end
       end

data/lib/elastic_graph/support/logger.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/support/memoizable_data.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/support/monotonic_clock.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/support/threading.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/support/time_set.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/support/time_util.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/support/untyped_encoder.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at

data/lib/elastic_graph/version.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# Copyright 2024 - 2025 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at
@@ -8,7 +8,7 @@
 
 module ElasticGraph
   # The version of all ElasticGraph gems.
-  VERSION = "0.19.1.1"
+  VERSION = "0.19.2.0"
 
   # Steep weirdly expects this here...
   # @dynamic self.define_schema

metadata

@@ -1,16 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: elasticgraph-support
 version: !ruby/object:Gem::Version
-  version: 0.19.1.1
+  version: 0.19.2.0
 platform: ruby
 authors:
 - Myron Marston
 - Ben VandenBos
 - Block Engineering
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-07 00:00:00.000000000 Z
+date: 2025-04-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger
@@ -18,20 +17,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.6.2
+        version: '1.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.6.2
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -39,6 +32,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.12'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.12.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -46,6 +42,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.12'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.12.2
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -53,6 +52,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 13.2.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -60,7 +62,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.2'
-description:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 13.2.1
 email:
 - myron@squareup.com
 executables: []
@@ -89,12 +93,11 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/block/elasticgraph/issues
-  changelog_uri: https://github.com/block/elasticgraph/releases/tag/v0.19.1.1
-  documentation_uri: https://block.github.io/elasticgraph/docs/main/
+  changelog_uri: https://github.com/block/elasticgraph/releases/tag/v0.19.2.0
+  documentation_uri: https://block.github.io/elasticgraph/api-docs/v0.19.2.0/
   homepage_uri: https://block.github.io/elasticgraph/
-  source_code_uri: https://github.com/block/elasticgraph/tree/v0.19.1.1/elasticgraph-support
+  source_code_uri: https://github.com/block/elasticgraph/tree/v0.19.2.0/elasticgraph-support
   gem_category: core
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -112,8 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: ElasticGraph gem providing support utilities to the other ElasticGraph gems.
 test_files: []