temporalio 0.0.2 → 0.1.0

data/lib/temporalio/connection/retry_config.rb

@@ -0,0 +1,44 @@
+module Temporalio
+  class Connection
+    class RetryConfig
+      # Initial backoff interval.
+      # @default 100
+      attr_reader :initial_interval_millis
+
+      # Randomization jitter to add.
+      # @default 0.2
+      attr_reader :randomization_factor
+
+      # Backoff multiplier.
+      # @default 1.5
+      attr_reader :multiplier
+
+      # Maximum backoff interval.
+      # @default 5000
+      attr_reader :max_interval_millis
+
+      # Maximum total time (optional).
+      attr_reader :max_elapsed_time_millis
+
+      # Maximum number of retries.
+      # @default 10
+      attr_reader :max_retries
+
+      def initialize(
+        initial_interval_millis: nil,
+        randomization_factor: nil,
+        multiplier: nil,
+        max_interval_millis: nil,
+        max_elapsed_time_millis: nil,
+        max_retries: nil
+      )
+        @initial_interval_millis = initial_interval_millis || 100
+        @randomization_factor = randomization_factor || 0.2
+        @multiplier = multiplier || 1.5
+        @max_interval_millis = max_interval_millis || 5_000
+        @max_elapsed_time_millis = max_elapsed_time_millis
+        @max_retries = max_retries || 10
+      end
+    end
+  end
+end

data/lib/temporalio/connection/service.rb

@@ -0,0 +1,20 @@
+module Temporalio
+  class Connection
+    # @abstract A superclass for defining services to interact with the Temporal API
+    class Service
+      # @api private
+      def initialize(core_connection, service)
+        @core_connection = core_connection
+        @service = service
+      end
+
+      private
+
+      attr_reader :core_connection, :service
+
+      def call(rpc, bytes, metadata, timeout)
+        core_connection.call(rpc, service, bytes, metadata, timeout)
+      end
+    end
+  end
+end

data/lib/temporalio/connection/test_service.rb

@@ -0,0 +1,92 @@
+require 'temporal/api/testservice/v1/request_response_pb'
+require 'temporalio/connection/service'
+
+module Temporalio
+  class Connection
+    # A class for making TestService RPCs
+    #
+    # This is normally accessed via {Temoralio::Connection#test_service}.
+    class TestService < Service
+      # @api private
+      def initialize(core_connection)
+        super(core_connection, :test_service)
+      end
+
+      # @param request [Temporalio::Api::TestService::V1::LockTimeSkippingRequest]
+      # @param metadata [Hash<String, String>] Headers used on the RPC call.
+      #   Keys here override client-level RPC metadata keys.
+      # @param timeout [Integer] Optional RPC deadline to set for each RPC call.
+      #
+      # @return [Temporalio::Api::TestService::V1::LockTimeSkippingResponse]
+      def lock_time_skipping(request, metadata: {}, timeout: nil)
+        encoded = Temporalio::Api::TestService::V1::LockTimeSkippingRequest.encode(request)
+        response = call(:lock_time_skipping, encoded, metadata, timeout)
+
+        Temporalio::Api::TestService::V1::LockTimeSkippingResponse.decode(response)
+      end
+
+      # @param request [Temporalio::Api::TestService::V1::UnlockTimeSkippingRequest]
+      # @param metadata [Hash<String, String>] Headers used on the RPC call.
+      #   Keys here override client-level RPC metadata keys.
+      # @param timeout [Integer] Optional RPC deadline to set for each RPC call.
+      #
+      # @return [Temporalio::Api::TestService::V1::UnlockTimeSkippingResponse]
+      def unlock_time_skipping(request, metadata: {}, timeout: nil)
+        encoded = Temporalio::Api::TestService::V1::UnlockTimeSkippingRequest.encode(request)
+        response = call(:unlock_time_skipping, encoded, metadata, timeout)
+
+        Temporalio::Api::TestService::V1::UnlockTimeSkippingResponse.decode(response)
+      end
+
+      # @param request [Temporalio::Api::TestService::V1::SleepRequest]
+      # @param metadata [Hash<String, String>] Headers used on the RPC call.
+      #   Keys here override client-level RPC metadata keys.
+      # @param timeout [Integer] Optional RPC deadline to set for each RPC call.
+      #
+      # @return [Temporalio::Api::TestService::V1::SleepResponse]
+      def sleep(request, metadata: {}, timeout: nil)
+        encoded = Temporalio::Api::TestService::V1::SleepRequest.encode(request)
+        response = call(:sleep, encoded, metadata, timeout)
+
+        Temporalio::Api::TestService::V1::SleepResponse.decode(response)
+      end
+
+      # @param request [Temporalio::Api::TestService::V1::SleepUntilRequest]
+      # @param metadata [Hash<String, String>] Headers used on the RPC call.
+      #   Keys here override client-level RPC metadata keys.
+      # @param timeout [Integer] Optional RPC deadline to set for each RPC call.
+      #
+      # @return [Temporalio::Api::TestService::V1::SleepResponse]
+      def sleep_until(request, metadata: {}, timeout: nil)
+        encoded = Temporalio::Api::TestService::V1::SleepUntilRequest.encode(request)
+        response = call(:sleep_until, encoded, metadata, timeout)
+
+        Temporalio::Api::TestService::V1::SleepResponse.decode(response)
+      end
+
+      # @param request [Temporalio::Api::TestService::V1::SleepRequest]
+      # @param metadata [Hash<String, String>] Headers used on the RPC call.
+      #   Keys here override client-level RPC metadata keys.
+      # @param timeout [Integer] Optional RPC deadline to set for each RPC call.
+      #
+      # @return [Temporalio::Api::TestService::V1::SleepResponse]
+      def unlock_time_skipping_with_sleep(request, metadata: {}, timeout: nil)
+        encoded = Temporalio::Api::TestService::V1::SleepRequest.encode(request)
+        response = call(:unlock_time_skipping_with_sleep, encoded, metadata, timeout)
+
+        Temporalio::Api::TestService::V1::SleepResponse.decode(response)
+      end
+
+      # @param metadata [Hash<String, String>] Headers used on the RPC call.
+      #   Keys here override client-level RPC metadata keys.
+      # @param timeout [Integer] Optional RPC deadline to set for each RPC call.
+      #
+      # @return [Temporalio::Api::TestService::V1::GetCurrentTimeResponse]
+      def get_current_time(metadata: {}, timeout: nil)
+        response = call(:get_current_time, '', metadata, timeout)
+
+        Temporalio::Api::TestService::V1::GetCurrentTimeResponse.decode(response)
+      end
+    end
+  end
+end

data/lib/temporalio/connection/tls_options.rb

@@ -0,0 +1,51 @@
+module Temporalio
+  class Connection
+    class TlsOptions
+      # Root CA certificate used by the server. If not set, the server's certificate will be
+      # validated against the operating system's root certificates.
+      #
+      # Leave unset for Temporal Cloud.
+      attr_reader :server_root_ca_cert
+
+      # Client certificate used to authenticate with the server. If set, a corresponding
+      # `client_private_key` must be provided.
+      #
+      # @default do not use client side authentication.
+      attr_reader :client_cert
+
+      # Client private key used to authenticate with the server. Required if `client_cert` is set.
+      attr_reader :client_private_key
+
+      # Overrides the target name used for validation of the server SSL certificate. If not
+      # specified, the server certificate will be checked against the host part of the connection
+      # target address. This _should_ be used for testing only.
+      #
+      # Leave unset for Temporal Cloud.
+      #
+      # @default Validate the server certificate against the host part of the connection target address.
+      attr_reader :server_name_override
+
+      # @param [String?] server_root_ca_cert Root CA certificate used by the server.
+      # @param [String?] client_cert Client certificate used to authenticate with the server.
+      # @param [String?] client_private_key Client private key used to authenticate with the server.
+      # @param [String?] server_name_override Overrides the target name used for validation of the
+      #                  server SSL certificate.
+      # @raise [ArgumentError] if `client_cert` and `client_private_key` are not both set or both unset
+      def initialize(
+        server_root_ca_cert: nil,
+        client_cert: nil,
+        client_private_key: nil,
+        server_name_override: nil
+      )
+        if (client_cert && !client_private_key) || (!client_cert && client_private_key)
+          raise ArgumentError, 'client_cert and client_private_key must be either both set or both unset'
+        end
+
+        @server_root_ca_cert = server_root_ca_cert
+        @client_cert = client_cert
+        @client_private_key = client_private_key
+        @server_name_override = server_name_override
+      end
+    end
+  end
+end