temporalio 1.4.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d8a5c63465067a03ec252a3550f4048d63f93bde9dda135e1495b4d3e6dc8db
-  data.tar.gz: 71721d0517ac5db6ef9b6be9c2f102a95268b29d1979caec619ade7b96e01671
+  metadata.gz: f9ab77e9e3a462220ab99a1eb7814e4e7e6c7f9485487344cda2e12b8f983147
+  data.tar.gz: d3d2f0a9026ec2033de2a367735d9ddffec50ced84c5bd99f049f481ea534b89
 SHA512:
-  metadata.gz: 74dbf0015f65ef25c709873993ea75a7eebe963a29baf27cea261056d2e4f2b666a6bace656d257e60557f2d8cbc3f1674f4cb4f690f458522ce4a070d47986f
-  data.tar.gz: 1879fe1df4a34f98b6c12602387d18a02bdf174dfec6995fbef901999d74fd71263837aa8079c69bf2d87580eb15c7c3bd7c0a948a1aaeda704b4355f3b93147
+  metadata.gz: 436ef0cdcbf32fe0c88c719a409dc1707e141df0e8bccb5f024c181f5c41ab7f03a2ccf83e445cf9c1b98e208ef618ad8dcf2715ce767d46b99e903e766eb9c5
+  data.tar.gz: 780131e186208f905023064c38d6298d94f4218909e34ff381261167ea38e7d13754a157a33ff0db2b8de79551827d3dd449dabcd0db66bbfdfc16bcb5c8cd38

data/README.md

@@ -86,7 +86,7 @@ Also see:
 
 ### Installation
 
-The Ruby SDK works with Ruby 3.3, 3.4, and 4.0.
+The Ruby SDK works with Ruby 3.3, 3.4, and 4.0. (If using Fibers, Ruby 3.3.2+ is recommended due to problems with fibers in previous versions.)
 
 Can require in a Gemfile like:
 
@@ -1265,7 +1265,7 @@ work with Ractors.
 ### Platform Support
 
 This SDK is backed by a Ruby C extension written in Rust leveraging the
-[Temporal Rust Core](https://github.com/temporalio/sdk-core). Gems are currently published for the following platforms:
+[Temporal Rust Core](https://github.com/temporalio/sdk-rust). Gems are currently published for the following platforms:
 
 * `aarch64-linux`
 * `aarch64-linux-musl`

data/lib/temporalio/client/connection.rb

@@ -24,7 +24,8 @@ module Temporalio
         :keep_alive,
         :http_connect_proxy,
         :runtime,
-        :lazy_connect
+        :lazy_connect,
+        :dns_load_balancing
       )
 
       # Options as returned from {options} for +**to_h+ splat use in {initialize}. See {initialize} for details.
@@ -132,6 +133,22 @@ module Temporalio
       #   @return [String, nil] Pass for HTTP basic auth for the proxy, must be combined with {basic_auth_user}.
       class HTTPConnectProxyOptions; end # rubocop:disable Lint/EmptyClass
 
+      DnsLoadBalancingOptions = Data.define(
+        :resolution_interval
+      )
+
+      # DNS load balancing options for client connections. When set, Core periodically re-resolves the target host's
+      # DNS records and round-robins requests across the resolved addresses. Mutually exclusive with
+      # {HTTPConnectProxyOptions} -- DNS load balancing is silently disabled when an HTTP CONNECT proxy is configured.
+      #
+      # @!attribute resolution_interval
+      #   @return [Float] How often to re-resolve DNS, in seconds. Default 30.0.
+      class DnsLoadBalancingOptions
+        def initialize(resolution_interval: 30.0)
+          super
+        end
+      end
+
       # @return [Options] Frozen options for this client which has the same attributes as {initialize}. Note that if
       #   {api_key=} or {rpc_metadata=} are updated, the options object is replaced with those changes (it is not
       #   mutated in place).
@@ -169,6 +186,8 @@ module Temporalio
       # @param lazy_connect [Boolean] If true, there is no connection until the first call is attempted or a worker
       #   is created with it. Clients from lazy connections cannot be used for workers if they have not performed a
       #   connection.
+      # @param dns_load_balancing [DnsLoadBalancingOptions, nil] DNS load balancing options for this connection. Default
+      #   is +nil+ (disabled). Silently disabled when +http_connect_proxy+ is set, since the two are mutually exclusive.
       # @param around_connect [Proc, nil] If present, this proc accepts two values: options and a block. The block must
       #   be yielded to only once with the options. The block does not return a meaningful value, nor should
       #   around_connect.
@@ -185,6 +204,7 @@ module Temporalio
         http_connect_proxy: nil,
         runtime: Runtime.default,
         lazy_connect: false,
+        dns_load_balancing: nil,
         around_connect: nil
       )
         @options = Options.new(
@@ -197,7 +217,8 @@ module Temporalio
           keep_alive:,
           http_connect_proxy:,
           runtime:,
-          lazy_connect:
+          lazy_connect:,
+          dns_load_balancing:
         ).freeze
         @core_client_mutex = Mutex.new
         # Create core client now if not lazy, applying around_connect if present
@@ -329,6 +350,11 @@ module Temporalio
             basic_auth_pass: @options.http_connect_proxy.basic_auth_pass
           )
         end
+        if (dns_load_balancing = @options.dns_load_balancing)
+          options.dns_load_balancing = Internal::Bridge::Client::DnsLoadBalancingOptions.new(
+            resolution_interval: dns_load_balancing.resolution_interval
+          )
+        end
         Internal::Bridge::Client.new(@options.runtime._core_runtime, options)
       end
     end

data/lib/temporalio/client/schedule.rb

@@ -3,6 +3,7 @@
 require 'temporalio/api'
 require 'temporalio/converters'
 require 'temporalio/internal/proto_utils'
+require 'temporalio/priority'
 require 'temporalio/retry_policy'
 require 'temporalio/search_attributes'
 
@@ -175,6 +176,7 @@ module Temporalio
           :retry_policy,
           :memo,
           :search_attributes,
+          :priority,
           :arg_hints,
           :headers
         )
@@ -209,6 +211,8 @@ module Temporalio
         #   @return [Hash<String, Object>, nil] Memo for the workflow.
         # @!attribute search_attributes
         #   @return [SearchAttributes, nil] Search attributes for the workflow.
+        # @!attribute priority
+        #   @return [Priority] Priority of the workflow. This is currently experimental.
         # @!attribute arg_hints
         #   @return [Array<Object>, nil] Converter hints for workflow arguments. This is only user-set (e.g. on create)
         #     and is not persisted and therefore will not be set when describing a workflow.
@@ -239,6 +243,7 @@ module Temporalio
             # @param retry_policy [RetryPolicy, nil] Retry policy for the workflow.
             # @param memo [Hash<String, Object>, nil] Memo for the workflow.
             # @param search_attributes [SearchAttributes, nil] Search attributes for the workflow.
+            # @param priority [Priority] Priority of the workflow. This is currently experimental.
             # @param headers [Hash<String, Object>, nil] Headers for the workflow.
             def new(
               workflow,
@@ -253,6 +258,7 @@ module Temporalio
               retry_policy: nil,
               memo: nil,
               search_attributes: nil,
+              priority: Priority.default,
               arg_hints: nil,
               headers: nil
             )
@@ -271,6 +277,7 @@ module Temporalio
                 retry_policy:,
                 memo:,
                 search_attributes:,
+                priority:,
                 arg_hints: arg_hints || defn_arg_hints,
                 headers:
               )
@@ -293,6 +300,7 @@ module Temporalio
               retry_policy: raw_info.retry_policy ? RetryPolicy._from_proto(raw_info.retry_policy) : nil,
               memo: Internal::ProtoUtils.memo_from_proto(raw_info.memo, data_converter),
               search_attributes: SearchAttributes._from_proto(raw_info.search_attributes),
+              priority: Priority._from_proto(raw_info.priority),
               headers: Internal::ProtoUtils.headers_from_proto(raw_info.header, data_converter)
             )
           end
@@ -312,6 +320,7 @@ module Temporalio
                 memo: Internal::ProtoUtils.memo_to_proto(memo, data_converter),
                 search_attributes: search_attributes&._to_proto,
                 header: Internal::ProtoUtils.headers_to_proto(headers, data_converter),
+                priority: priority._to_proto,
                 user_metadata: Internal::ProtoUtils.to_user_metadata(static_summary, static_details, data_converter)
               )
             )

data/lib/temporalio/client.rb

@@ -95,6 +95,9 @@ module Temporalio
     # @param runtime [Runtime] Runtime for this client.
     # @param lazy_connect [Boolean] If true, the client will not connect until the first call is attempted or a worker
     #   is created with it. Lazy clients cannot be used for workers if they have not performed a connection.
+    # @param dns_load_balancing [Connection::DnsLoadBalancingOptions, nil] DNS load balancing options for the
+    #   connection. Default is +nil+ (disabled). Silently disabled when +http_connect_proxy+ is set, since the two are
+    #   mutually exclusive.
     #
     # @return [Client] Connected client.
     #
@@ -116,7 +119,8 @@ module Temporalio
       keep_alive: Connection::KeepAliveOptions.new, # Set to nil to disable
       http_connect_proxy: nil,
       runtime: Runtime.default,
-      lazy_connect: false
+      lazy_connect: false,
+      dns_load_balancing: nil
     )
       # Prepare connection. The connection var is needed here so it can be used in callback for plugin.
       base_connection = nil
@@ -162,6 +166,7 @@ module Temporalio
         http_connect_proxy:,
         runtime:,
         lazy_connect:,
+        dns_load_balancing:,
         around_connect: # steep:ignore
       )
 

data/lib/temporalio/common_enums.rb

@@ -50,6 +50,22 @@ module Temporalio
     # workflow code.
     AUTO_UPGRADE =
       Api::Enums::V1::ContinueAsNewVersioningBehavior::CONTINUE_AS_NEW_VERSIONING_BEHAVIOR_AUTO_UPGRADE
+    # Use the Ramping Version of the workflow's task queue at start time, regardless of the workflow's
+    # Target Version (according to f(workflow_id, ramp_percentage)). After the first workflow task completes,
+    # the workflow will use whatever Versioning Behavior it is annotated with. If there is no Ramping
+    # Version by the time that the first workflow task is dispatched, it will be sent to the Current Version.
+    #
+    # It is highly discouraged to use this if the workflow is annotated with AutoUpgrade behavior, because
+    # this setting ONLY applies to the first task of the workflow. If, after the first task, the workflow
+    # is AutoUpgrade, it will behave like a normal AutoUpgrade workflow and go to the Target Version, which
+    # may be the Current Version instead of the Ramping Version.
+    #
+    # Note that if the workflow being continued has a Pinned override, that override will be inherited by the
+    # new workflow run regardless of the ContinueAsNewVersioningBehavior specified in the continue-as-new
+    # command. Versioning Override always takes precedence until it's removed manually via
+    # UpdateWorkflowExecutionOptions.
+    USE_RAMPING_VERSION =
+      Api::Enums::V1::ContinueAsNewVersioningBehavior::CONTINUE_AS_NEW_VERSIONING_BEHAVIOR_USE_RAMPING_VERSION
   end
 
   # Specifies why the server suggests continue-as-new. This is currently experimental.

data/lib/temporalio/internal/bridge/client.rb

@@ -16,7 +16,8 @@ module Temporalio
           :tls, # Optional
           :rpc_retry,
           :keep_alive, # Optional
-          :http_connect_proxy # Optional
+          :http_connect_proxy, # Optional
+          :dns_load_balancing # Optional
         )
 
         TLSOptions = Struct.new(
@@ -46,6 +47,10 @@ module Temporalio
           :basic_auth_pass # Optional
         )
 
+        DnsLoadBalancingOptions = Struct.new(
+          :resolution_interval
+        )
+
         def self.new(runtime, options)
           queue = Queue.new
           async_new(runtime, options, queue)

data/lib/temporalio/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Temporalio
-  VERSION = '1.4.0'
+  VERSION = '1.4.1'
 end

data/lib/temporalio/workflow.rb

@@ -672,7 +672,8 @@ module Temporalio
       #   current workflow.
       # @param initial_versioning_behavior [ContinueAsNewVersioningBehavior::enum, nil] Versioning behavior for the
       #   first task of the new run. Set to {ContinueAsNewVersioningBehavior::AUTO_UPGRADE} to upgrade a pinned workflow
-      #   to the latest version on continue-as-new. This is currently experimental.
+      #   to the latest version on continue-as-new or {ContinueAsNewVersioningBehavior::USE_RAMPING_VERSION} to start on
+      #   the task queue's Ramping Version. This is currently experimental.
       def initialize(
         *args,
         workflow: nil,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: temporalio
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.4.1
 platform: ruby
 authors:
 - Temporal Technologies Inc
@@ -280,7 +280,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Temporal.io Ruby SDK
 test_files: []