Class: Temporalio::EnvConfig::ClientConfigProfile

Inherits:
Data
  • Object
show all
Defined in:
lib/temporalio/env_config.rb,
lib/temporalio/env_config.rb

Overview

A client configuration profile loaded from environment and files.

This class represents a complete client configuration profile that can be loaded from TOML files and environment variables, and converted to client connection options.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(address: nil, namespace: nil, api_key: nil, tls: nil, grpc_meta: {}) ⇒ ClientConfigProfile

Create a ClientConfigProfile instance with defaults



190
191
192
 
# File 'lib/temporalio/env_config.rb', line 190

def initialize(address: nil, namespace: nil, api_key: nil, tls: nil, grpc_meta: {})
  super
end

Instance Attribute Details

#address ⇒ Object (readonly)

Returns the value of attribute address

Returns:

  • (Object) —

    the current value of address



141
 
# File 'lib/temporalio/env_config.rb', line 141

ClientConfigProfile = Data.define(:address, :namespace, :api_key, :tls, :grpc_meta)

#api_key ⇒ Object (readonly)

Returns the value of attribute api_key

Returns:

  • (Object) —

    the current value of api_key



141
 
# File 'lib/temporalio/env_config.rb', line 141

ClientConfigProfile = Data.define(:address, :namespace, :api_key, :tls, :grpc_meta)

#grpc_meta ⇒ Object (readonly)

Returns the value of attribute grpc_meta

Returns:

  • (Object) —

    the current value of grpc_meta



141
 
# File 'lib/temporalio/env_config.rb', line 141

ClientConfigProfile = Data.define(:address, :namespace, :api_key, :tls, :grpc_meta)

#namespace ⇒ Object (readonly)

Returns the value of attribute namespace

Returns:

  • (Object) —

    the current value of namespace



141
 
# File 'lib/temporalio/env_config.rb', line 141

ClientConfigProfile = Data.define(:address, :namespace, :api_key, :tls, :grpc_meta)

#tls ⇒ Object (readonly)

Returns the value of attribute tls

Returns:

  • (Object) —

    the current value of tls



141
 
# File 'lib/temporalio/env_config.rb', line 141

ClientConfigProfile = Data.define(:address, :namespace, :api_key, :tls, :grpc_meta)

Class Method Details

.from_h(hash) ⇒ ClientConfigProfile

Create a ClientConfigProfile from a hash

Parameters:

  • hash (Hash) —

    Hash representation

Returns:



152
153
154
155
156
157
158
159
160
 
# File 'lib/temporalio/env_config.rb', line 152

def self.from_h(hash)
  new(
    address: hash[:address],
    namespace: hash[:namespace],
    api_key: hash[:api_key],
    tls: ClientConfigTLS.from_h(hash[:tls]),
    grpc_meta: hash[:grpc_meta] || {}
  )
end

.load(profile: nil, config_source: nil, disable_file: false, disable_env: false, config_file_strict: false, override_env_vars: nil) ⇒ ClientConfigProfile

Load a single client profile from given sources, applying env overrides.

Parameters:

  • profile (String, nil) (defaults to: nil) —

    Profile to load from the config

  • config_source (Pathname, String, nil) (defaults to: nil) —

    Configuration source - Pathname for file path, String for TOML content

  • disable_file (Boolean) (defaults to: false) —

    If true, file loading is disabled

  • disable_env (Boolean) (defaults to: false) —

    If true, environment variable loading and overriding is disabled

  • config_file_strict (Boolean) (defaults to: false) —

    If true, will error on unrecognized keys

  • override_env_vars (Hash, nil) (defaults to: nil) —

    Environment variables to use for loading and overrides

Returns:



172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
 
# File 'lib/temporalio/env_config.rb', line 172

def self.load(
  profile: nil,
  config_source: nil,
  disable_file: false,
  disable_env: false,
  config_file_strict: false,
  override_env_vars: nil
)
  path, data = EnvConfig._source_to_path_and_data(config_source)

  raw_profile = Internal::Bridge::EnvConfig.load_client_connect_config(
    profile, path, data, disable_file, disable_env, config_file_strict, override_env_vars
  )

  from_h(raw_profile)
end

Instance Method Details

#to_client_connect_options ⇒ Array

Create a client connect config from this profile

Returns:

  • (Array) —

    Tuple of [positional_args, keyword_args] that can be splatted to Client.connect



208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
 
# File 'lib/temporalio/env_config.rb', line 208

def to_client_connect_options
  positional_args = [address, namespace]
  tls_value = false
  if tls
    tls_value = tls.to_client_tls_options
  elsif api_key
    tls_value = true
  end

  keyword_args = {
    api_key: api_key,
    rpc_metadata: (grpc_meta if grpc_meta && !grpc_meta.empty?),
    tls: tls_value
  }.compact

  [positional_args, keyword_args]
end

#to_h ⇒ Hash

Convert to a hash that can be used for TOML serialization

Returns:

  • (Hash) —

    Dictionary representation



196
197
198
199
200
201
202
203
204
 
# File 'lib/temporalio/env_config.rb', line 196

def to_h
  {
    address: address,
    namespace: namespace,
    api_key: api_key,
    tls: tls&.to_h&.then { |tls_hash| tls_hash.empty? ? nil : tls_hash }, # steep:ignore
    grpc_meta: grpc_meta && grpc_meta.empty? ? nil : grpc_meta
  }.compact
end