aws-sdk-sagemakeredgemanager 1.12.0 → 1.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 15848b8d352cd9bebb4ba8e70042f999210879d003c2ae5fac2e4de544a0bdec
-  data.tar.gz: faf5ef00946a3546842b7b30ae3e96cc05f64c2bab201e55fed3e1a77355aa38
+  metadata.gz: 5873a996990a37aa7606067f562c73a13631d285e00c9e2fa6228773c036d08a
+  data.tar.gz: ff39d5c64ae3f41809fddcef84caa7be5e6275d75dfb2a64863de2b32450f948
 SHA512:
-  metadata.gz: 7c653ab20d3fe04f4d095fcd70dfd3ef79c34a375de920a9649d5356e25752b9a2596e78fc99dc7ccf7188caac851f3dc2bb0a600ee64226596ad7c34a2e7883
-  data.tar.gz: af770a736979aba0a8ff4e99874055be12bf101c567c9d3fcfa36aa854e9c3f79a88b62990969afbce358872ad2d588dcfe0d084b18769f1859d5adfe7689d7b
+  metadata.gz: 37e79d928d9b8881d4545f2fd1f09e5fd3d840b020b03c38b90ff7d558645e42842f54ad7cb80686be521595a1b80d588264b3c8eeb00309ba7ac549ac3d3047
+  data.tar.gz: 52baecb904b41de848d584cb93d003a373059165df8495ee2e3721ccb08e35d73691f44a49a496cda7c69afa2e7bb1dce3ea4686e34d881ca3727daa85e567a4

data/CHANGELOG.md

@@ -1,6 +1,18 @@
 Unreleased Changes
 ------------------
 
+1.14.0 (2023-01-18)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+* Issue - Replace runtime endpoint resolution approach with generated ruby code.
+
+1.13.0 (2022-10-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.12.0 (2022-07-19)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.12.0
+1.14.0

data/lib/aws-sdk-sagemakeredgemanager/client.rb

@@ -30,7 +30,7 @@ require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
-require 'aws-sdk-core/plugins/signature_v4.rb'
+require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
 Aws::Plugins::GlobalConfiguration.add_identifier(:sagemakeredgemanager)
@@ -79,8 +79,9 @@ module Aws::SagemakerEdgeManager
     add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
-    add_plugin(Aws::Plugins::SignatureV4)
+    add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::RestJson)
+    add_plugin(Aws::SagemakerEdgeManager::Plugins::Endpoints)
 
     # @overload initialize(options)
     #   @param [Hash] options
@@ -287,6 +288,19 @@ module Aws::SagemakerEdgeManager
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Aws::TokenProvider] :token_provider
+    #     A Bearer Token Provider. This can be an instance of any one of the
+    #     following classes:
+    #
+    #     * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
+    #       tokens.
+    #
+    #     * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
+    #     will be used to search for tokens configured for your profile in shared configuration files.
+    #
     #   @option options [Boolean] :use_dualstack_endpoint
     #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
     #     will be used if available.
@@ -300,6 +314,9 @@ module Aws::SagemakerEdgeManager
     #     When `true`, request parameters are validated before
     #     sending the request.
     #
+    #   @option options [Aws::SagemakerEdgeManager::EndpointProvider] :endpoint_provider
+    #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::SagemakerEdgeManager::EndpointParameters`
+    #
     #   @option options [URI::HTTP,String] :http_proxy A proxy to send
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
@@ -525,7 +542,7 @@ module Aws::SagemakerEdgeManager
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-sagemakeredgemanager'
-      context[:gem_version] = '1.12.0'
+      context[:gem_version] = '1.14.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-sagemakeredgemanager/endpoint_parameters.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws::SagemakerEdgeManager
+  # Endpoint parameters used to influence endpoints per request.
+  #
+  # @!attribute region
+  #   The AWS region used to dispatch the request.
+  #
+  #   @return [String]
+  #
+  # @!attribute use_dual_stack
+  #   When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
+  #
+  #   @return [Boolean]
+  #
+  # @!attribute use_fips
+  #   When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.
+  #
+  #   @return [Boolean]
+  #
+  # @!attribute endpoint
+  #   Override the endpoint used to send this request
+  #
+  #   @return [String]
+  #
+  EndpointParameters = Struct.new(
+    :region,
+    :use_dual_stack,
+    :use_fips,
+    :endpoint,
+  ) do
+    include Aws::Structure
+
+    # @api private
+    class << self
+      PARAM_MAP = {
+        'Region' => :region,
+        'UseDualStack' => :use_dual_stack,
+        'UseFIPS' => :use_fips,
+        'Endpoint' => :endpoint,
+      }.freeze
+    end
+
+    def initialize(options = {})
+      self[:region] = options[:region]
+      self[:use_dual_stack] = options[:use_dual_stack]
+      self[:use_dual_stack] = false if self[:use_dual_stack].nil?
+      if self[:use_dual_stack].nil?
+        raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
+      end
+      self[:use_fips] = options[:use_fips]
+      self[:use_fips] = false if self[:use_fips].nil?
+      if self[:use_fips].nil?
+        raise ArgumentError, "Missing required EndpointParameter: :use_fips"
+      end
+      self[:endpoint] = options[:endpoint]
+    end
+  end
+end

data/lib/aws-sdk-sagemakeredgemanager/endpoint_provider.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws::SagemakerEdgeManager
+  class EndpointProvider
+    def resolve_endpoint(parameters)
+      region = parameters.region
+      use_dual_stack = parameters.use_dual_stack
+      use_fips = parameters.use_fips
+      endpoint = parameters.endpoint
+      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+        if Aws::Endpoints::Matchers.set?(endpoint) && (url = Aws::Endpoints::Matchers.parse_url(endpoint))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+          end
+          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+        end
+        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+            return Aws::Endpoints::Endpoint.new(url: "https://edge.sagemaker-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          end
+          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+        end
+        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+            return Aws::Endpoints::Endpoint.new(url: "https://edge.sagemaker-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+          end
+          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+        end
+        if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+            return Aws::Endpoints::Endpoint.new(url: "https://edge.sagemaker.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          end
+          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+        end
+        return Aws::Endpoints::Endpoint.new(url: "https://edge.sagemaker.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+      end
+      raise ArgumentError, 'No endpoint could be resolved'
+
+    end
+  end
+end

data/lib/aws-sdk-sagemakeredgemanager/endpoints.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+
+module Aws::SagemakerEdgeManager
+  module Endpoints
+
+    class GetDeployments
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::SagemakerEdgeManager::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
+    class GetDeviceRegistration
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::SagemakerEdgeManager::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
+    class SendHeartbeat
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::SagemakerEdgeManager::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
+  end
+end

data/lib/aws-sdk-sagemakeredgemanager/plugins/endpoints.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+
+module Aws::SagemakerEdgeManager
+  module Plugins
+    class Endpoints < Seahorse::Client::Plugin
+      option(
+        :endpoint_provider,
+        doc_type: 'Aws::SagemakerEdgeManager::EndpointProvider',
+        docstring: 'The endpoint provider used to resolve endpoints. Any '\
+                   'object that responds to `#resolve_endpoint(parameters)` '\
+                   'where `parameters` is a Struct similar to '\
+                   '`Aws::SagemakerEdgeManager::EndpointParameters`'
+      ) do |cfg|
+        Aws::SagemakerEdgeManager::EndpointProvider.new
+      end
+
+      # @api private
+      class Handler < Seahorse::Client::Handler
+        def call(context)
+          # If endpoint was discovered, do not resolve or apply the endpoint.
+          unless context[:discovered_endpoint]
+            params = parameters_for_operation(context)
+            endpoint = context.config.endpoint_provider.resolve_endpoint(params)
+
+            context.http_request.endpoint = endpoint.url
+            apply_endpoint_headers(context, endpoint.headers)
+          end
+
+          context[:endpoint_params] = params
+          context[:auth_scheme] =
+            Aws::Endpoints.resolve_auth_scheme(context, endpoint)
+
+          @handler.call(context)
+        end
+
+        private
+
+        def apply_endpoint_headers(context, headers)
+          headers.each do |key, values|
+            value = values
+              .compact
+              .map { |s| Seahorse::Util.escape_header_list_string(s.to_s) }
+              .join(',')
+
+            context.http_request.headers[key] = value
+          end
+        end
+
+        def parameters_for_operation(context)
+          case context.operation_name
+          when :get_deployments
+            Aws::SagemakerEdgeManager::Endpoints::GetDeployments.build(context)
+          when :get_device_registration
+            Aws::SagemakerEdgeManager::Endpoints::GetDeviceRegistration.build(context)
+          when :send_heartbeat
+            Aws::SagemakerEdgeManager::Endpoints::SendHeartbeat.build(context)
+          end
+        end
+      end
+
+      def add_handlers(handlers, _config)
+        handlers.add(Handler, step: :build, priority: 75)
+      end
+    end
+  end
+end

data/lib/aws-sdk-sagemakeredgemanager/types.rb

@@ -56,20 +56,6 @@ module Aws::SagemakerEdgeManager
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass DeploymentModel
-    #   data as a hash:
-    #
-    #       {
-    #         model_handle: "EntityName",
-    #         model_name: "ModelName",
-    #         model_version: "Version",
-    #         desired_state: "DEPLOY", # accepts DEPLOY, UNDEPLOY
-    #         state: "DEPLOY", # accepts DEPLOY, UNDEPLOY
-    #         status: "SUCCESS", # accepts SUCCESS, FAIL
-    #         status_reason: "String",
-    #         rollback_failure_reason: "String",
-    #       }
-    #
     # @!attribute [rw] model_handle
     #   The unique handle of the model.
     #   @return [String]
@@ -120,29 +106,6 @@ module Aws::SagemakerEdgeManager
     # Information about the result of a deployment on an edge device that is
     # registered with SageMaker Edge Manager.
     #
-    # @note When making an API call, you may pass DeploymentResult
-    #   data as a hash:
-    #
-    #       {
-    #         deployment_name: "EntityName",
-    #         deployment_status: "EntityName",
-    #         deployment_status_message: "String",
-    #         deployment_start_time: Time.now,
-    #         deployment_end_time: Time.now,
-    #         deployment_models: [
-    #           {
-    #             model_handle: "EntityName",
-    #             model_name: "ModelName",
-    #             model_version: "Version",
-    #             desired_state: "DEPLOY", # accepts DEPLOY, UNDEPLOY
-    #             state: "DEPLOY", # accepts DEPLOY, UNDEPLOY
-    #             status: "SUCCESS", # accepts SUCCESS, FAIL
-    #             status_reason: "String",
-    #             rollback_failure_reason: "String",
-    #           },
-    #         ],
-    #       }
-    #
     # @!attribute [rw] deployment_name
     #   The name and unique ID of the deployment.
     #   @return [String]
@@ -214,16 +177,6 @@ module Aws::SagemakerEdgeManager
 
     # Information required for edge device metrics.
     #
-    # @note When making an API call, you may pass EdgeMetric
-    #   data as a hash:
-    #
-    #       {
-    #         dimension: "Dimension",
-    #         metric_name: "Metric",
-    #         value: 1.0,
-    #         timestamp: Time.now,
-    #       }
-    #
     # @!attribute [rw] dimension
     #   The dimension of metrics published.
     #   @return [String]
@@ -251,14 +204,6 @@ module Aws::SagemakerEdgeManager
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetDeploymentsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         device_name: "DeviceName", # required
-    #         device_fleet_name: "DeviceFleetName", # required
-    #       }
-    #
     # @!attribute [rw] device_name
     #   The unique name of the device you want to get the configuration of
     #   active deployments from.
@@ -290,14 +235,6 @@ module Aws::SagemakerEdgeManager
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetDeviceRegistrationRequest
-    #   data as a hash:
-    #
-    #       {
-    #         device_name: "DeviceName", # required
-    #         device_fleet_name: "DeviceFleetName", # required
-    #       }
-    #
     # @!attribute [rw] device_name
     #   The unique name of the device you want to get the registration
     #   status from.
@@ -352,24 +289,6 @@ module Aws::SagemakerEdgeManager
     # Information about a model deployed on an edge device that is
     # registered with SageMaker Edge Manager.
     #
-    # @note When making an API call, you may pass Model
-    #   data as a hash:
-    #
-    #       {
-    #         model_name: "ModelName",
-    #         model_version: "Version",
-    #         latest_sample_time: Time.now,
-    #         latest_inference: Time.now,
-    #         model_metrics: [
-    #           {
-    #             dimension: "Dimension",
-    #             metric_name: "Metric",
-    #             value: 1.0,
-    #             timestamp: Time.now,
-    #           },
-    #         ],
-    #       }
-    #
     # @!attribute [rw] model_name
     #   The name of the model.
     #   @return [String]
@@ -402,58 +321,6 @@ module Aws::SagemakerEdgeManager
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass SendHeartbeatRequest
-    #   data as a hash:
-    #
-    #       {
-    #         agent_metrics: [
-    #           {
-    #             dimension: "Dimension",
-    #             metric_name: "Metric",
-    #             value: 1.0,
-    #             timestamp: Time.now,
-    #           },
-    #         ],
-    #         models: [
-    #           {
-    #             model_name: "ModelName",
-    #             model_version: "Version",
-    #             latest_sample_time: Time.now,
-    #             latest_inference: Time.now,
-    #             model_metrics: [
-    #               {
-    #                 dimension: "Dimension",
-    #                 metric_name: "Metric",
-    #                 value: 1.0,
-    #                 timestamp: Time.now,
-    #               },
-    #             ],
-    #           },
-    #         ],
-    #         agent_version: "Version", # required
-    #         device_name: "DeviceName", # required
-    #         device_fleet_name: "DeviceFleetName", # required
-    #         deployment_result: {
-    #           deployment_name: "EntityName",
-    #           deployment_status: "EntityName",
-    #           deployment_status_message: "String",
-    #           deployment_start_time: Time.now,
-    #           deployment_end_time: Time.now,
-    #           deployment_models: [
-    #             {
-    #               model_handle: "EntityName",
-    #               model_name: "ModelName",
-    #               model_version: "Version",
-    #               desired_state: "DEPLOY", # accepts DEPLOY, UNDEPLOY
-    #               state: "DEPLOY", # accepts DEPLOY, UNDEPLOY
-    #               status: "SUCCESS", # accepts SUCCESS, FAIL
-    #               status_reason: "String",
-    #               rollback_failure_reason: "String",
-    #             },
-    #           ],
-    #         },
-    #       }
-    #
     # @!attribute [rw] agent_metrics
     #   For internal use. Returns a list of SageMaker Edge Manager agent
     #   operating metrics.

data/lib/aws-sdk-sagemakeredgemanager.rb

@@ -13,9 +13,13 @@ require 'aws-sigv4'
 
 require_relative 'aws-sdk-sagemakeredgemanager/types'
 require_relative 'aws-sdk-sagemakeredgemanager/client_api'
+require_relative 'aws-sdk-sagemakeredgemanager/plugins/endpoints.rb'
 require_relative 'aws-sdk-sagemakeredgemanager/client'
 require_relative 'aws-sdk-sagemakeredgemanager/errors'
 require_relative 'aws-sdk-sagemakeredgemanager/resource'
+require_relative 'aws-sdk-sagemakeredgemanager/endpoint_parameters'
+require_relative 'aws-sdk-sagemakeredgemanager/endpoint_provider'
+require_relative 'aws-sdk-sagemakeredgemanager/endpoints'
 require_relative 'aws-sdk-sagemakeredgemanager/customizations'
 
 # This module provides support for Amazon Sagemaker Edge Manager. This module is available in the
@@ -48,6 +52,6 @@ require_relative 'aws-sdk-sagemakeredgemanager/customizations'
 # @!group service
 module Aws::SagemakerEdgeManager
 
-  GEM_VERSION = '1.12.0'
+  GEM_VERSION = '1.14.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sagemakeredgemanager
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.14.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-19 00:00:00.000000000 Z
+date: 2023-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.127.0
+        version: 3.165.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.127.0
+        version: 3.165.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -59,7 +59,11 @@ files:
 - lib/aws-sdk-sagemakeredgemanager/client.rb
 - lib/aws-sdk-sagemakeredgemanager/client_api.rb
 - lib/aws-sdk-sagemakeredgemanager/customizations.rb
+- lib/aws-sdk-sagemakeredgemanager/endpoint_parameters.rb
+- lib/aws-sdk-sagemakeredgemanager/endpoint_provider.rb
+- lib/aws-sdk-sagemakeredgemanager/endpoints.rb
 - lib/aws-sdk-sagemakeredgemanager/errors.rb
+- lib/aws-sdk-sagemakeredgemanager/plugins/endpoints.rb
 - lib/aws-sdk-sagemakeredgemanager/resource.rb
 - lib/aws-sdk-sagemakeredgemanager/types.rb
 homepage: https://github.com/aws/aws-sdk-ruby