Class: LaunchDarkly::Integrations::TestDataV2

Inherits:
Object
  • Object
show all
Defined in:
lib/ldclient-rb/integrations/test_data_v2.rb,
lib/ldclient-rb/integrations/test_data_v2/flag_builder_v2.rb

Overview

A mechanism for providing dynamically updatable feature flag state in a simplified form to an SDK client in test scenarios using the FDv2 protocol.

Unlike FileData, this mechanism does not use any external resources. It provides only the data that the application has put into it using the #update method.

The above example uses a simple boolean flag, but more complex configurations are possible using the methods of the FlagBuilderV2 that is returned by #flag. FlagBuilderV2 supports many of the ways a flag can be configured on the LaunchDarkly dashboard, but does not currently support 1. rule operators other than “in” and “not in”, or 2. percentage rollouts.

If the same ‘TestDataV2` instance is used to configure multiple `LDClient` instances, any changes made to the data will propagate to all of the `LDClient` instances.

Examples:

require 'ldclient-rb/integrations/test_data_v2'

td = LaunchDarkly::Integrations::TestDataV2.data_source
td.update(td.flag('flag-key-1').variation_for_all(true))

# Configure the data system with TestDataV2 as both initializer and synchronizer
# Note: This example assumes FDv2 data system configuration is available
# data_config = LaunchDarkly::Impl::DataSystem::Config.custom
# data_config.initializers([td.method(:build_initializer)])
# data_config.synchronizers(td.method(:build_synchronizer))

# config = LaunchDarkly::Config.new(
#   sdk_key,
#   data_system_config: data_config.build
# )

# flags can be updated at any time:
td.update(td.flag('flag-key-1')
    .variation_for_user('some-user-key', true)
    .fallthrough_variation(false))

Defined Under Namespace

Classes: FlagBuilderV2, FlagRuleBuilderV2

Constant Summary collapse

TRUE_VARIATION_INDEX =

Constants for boolean flag variation indices

0
FALSE_VARIATION_INDEX = 
1

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ TestDataV2

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of TestDataV2.



54
55
56
57
58
59
60
61
 
# File 'lib/ldclient-rb/integrations/test_data_v2.rb', line 54

def initialize
  @flag_builders = Hash.new
  @current_flags = Hash.new
  @current_segments = Hash.new
  @lock = Concurrent::ReadWriteLock.new
  @instances = Array.new
  @version = 0
end

Class Method Details

.data_source ⇒ TestDataV2

Creates a new instance of the test data source.

Returns:

  • (TestDataV2) —

    a new configurable test data source



49
50
51
 
# File 'lib/ldclient-rb/integrations/test_data_v2.rb', line 49

def self.data_source
  self.new
end

.variation_for_boolean(variation) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



13
14
15
 
# File 'lib/ldclient-rb/integrations/test_data_v2/flag_builder_v2.rb', line 13

def self.variation_for_boolean(variation)
  variation ? TRUE_VARIATION_INDEX : FALSE_VARIATION_INDEX
end

Instance Method Details

#add_instance(instance) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Parameters:



163
164
165
166
167
 
# File 'lib/ldclient-rb/integrations/test_data_v2.rb', line 163

def add_instance(instance)
  @lock.with_write_lock do
    @instances.push(instance)
  end
end

#closed_instance(instance) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Parameters:



155
156
157
158
159
 
# File 'lib/ldclient-rb/integrations/test_data_v2.rb', line 155

def closed_instance(instance)
  @lock.with_write_lock do
    @instances.delete(instance) if @instances.include?(instance)
  end
end

#flag(key) ⇒ FlagBuilderV2

Creates or copies a FlagBuilderV2 for building a test flag configuration.

If this flag key has already been defined in this ‘TestDataV2` instance, then the builder starts with the same configuration that was last provided for this flag.

Otherwise, it starts with a new default configuration in which the flag has ‘true` and `false` variations, is `true` for all contexts when targeting is turned on and `false` otherwise, and currently has targeting turned on. You can change any of those properties, and provide more complex behavior, using the FlagBuilderV2 methods.

Once you have set the desired configuration, pass the builder to #update.

Parameters:

  • key (String) —

    the flag key

Returns:



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
 
# File 'lib/ldclient-rb/integrations/test_data_v2.rb', line 79

def flag(key)
  existing_builder = @lock.with_read_lock do
    if @flag_builders.key?(key) && !@flag_builders[key].nil?
      @flag_builders[key]
    else
      nil
    end
  end

  if existing_builder.nil?
    LaunchDarkly::Integrations::TestDataV2::FlagBuilderV2.new(key).boolean_flag
  else
    existing_builder.clone
  end
end

#get_version ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



145
146
147
148
149
150
151
 
# File 'lib/ldclient-rb/integrations/test_data_v2.rb', line 145

def get_version
  @lock.with_write_lock do
    version = @version
    @version += 1
    version
  end
end

#make_init_data ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



135
136
137
138
139
140
141
142
 
# File 'lib/ldclient-rb/integrations/test_data_v2.rb', line 135

def make_init_data
  @lock.with_read_lock do
    {
      flags: @current_flags.dup,
      segments: @current_segments.dup,
    }
  end
end

#test_data_ds_builder ⇒ TestDataV2Builder

Returns a builder for creating a data source that can be used with the FDv2 data system as either an initializer or synchronizer.

Returns:



225
226
227
 
# File 'lib/ldclient-rb/integrations/test_data_v2.rb', line 225

def test_data_ds_builder
  TestDataV2Builder.new(self)
end

#update(flag_builder) ⇒ TestDataV2

Updates the test data with the specified flag configuration.

This has the same effect as if a flag were added or modified on the LaunchDarkly dashboard. It immediately propagates the flag change to any ‘LDClient` instance(s) that you have already configured to use this `TestDataV2`. If no `LDClient` has been started yet, it simply adds this flag to the test data which will be provided to any `LDClient` that you subsequently configure.

Any subsequent changes to this FlagBuilderV2 instance do not affect the test data, unless you call #update again.

Parameters:

Returns:



110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
 
# File 'lib/ldclient-rb/integrations/test_data_v2.rb', line 110

def update(flag_builder)
  instances_copy = []
  new_flag = nil
  @lock.with_write_lock do
    flag_key = flag_builder._key.to_sym
    old_flag = @current_flags[flag_key]
    old_version = old_flag ? old_flag[:version] : 0

    new_flag = flag_builder.build(old_version + 1)

    @current_flags[flag_key] = new_flag
    @flag_builders[flag_builder._key] = flag_builder.clone

    # Create a copy of instances while holding the lock to avoid race conditions
    instances_copy = @instances.dup
  end

  instances_copy.each do |instance|
    instance.upsert_flag(new_flag)
  end

  self
end

#use_preconfigured_segment(segment) ⇒ TestDataV2

Copies a full segment data model object into the test data.

It immediately propagates the change to any ‘LDClient` instance(s) that you have already configured to use this `TestDataV2`. If no `LDClient` has been started yet, it simply adds this segment to the test data which will be provided to any LDClient that you subsequently configure.

This method is currently the only way to inject segment data, since there is no builder API for segments. It is mainly intended for the SDK’s own tests of segment functionality, since application tests that need to produce a desired evaluation state could do so more easily by just setting flag values.

Parameters:

Returns:



186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
 
# File 'lib/ldclient-rb/integrations/test_data_v2.rb', line 186

def use_preconfigured_segment(segment)
  instances_copy = []
  segment_key = nil
  updated_segment = nil

  @lock.with_write_lock do
    # Convert to hash and normalize keys to symbols
    segment_hash = if segment.is_a?(Hash)
      segment.transform_keys(&:to_sym)
    else
      segment.as_json
    end
    segment_key = segment_hash[:key].to_sym

    old_segment = @current_segments[segment_key]
    old_version = old_segment ? old_segment[:version] : 0

    updated_segment = segment_hash.dup
    updated_segment[:version] = old_version + 1

    @current_segments[segment_key] = updated_segment

    # Create a copy of instances while holding the lock to avoid race conditions
    instances_copy = @instances.dup
  end

  instances_copy.each do |instance|
    instance.upsert_segment(updated_segment)
  end

  self
end