fino 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8fea3206069816874011b9d072929f796ad38c3c5645689fa75daf68638a0226
-  data.tar.gz: e8f72e2779da8c910539001ff7c0f91b0d23d44a8b2f8975c984506d8023796e
+  metadata.gz: c5692873000111c2c668cdf3dd509fb4bdd9d2f3935b467158686739e8e9cc9f
+  data.tar.gz: 8416e04110ddf6ef6dd4e110e32806ca3b711dd2a13fa13c7bc18cbece91443d
 SHA512:
-  metadata.gz: bb7428b18c55226ed0c21f5de8d6cbfc219424a6986fd4ab208ae8ee4cd33fcb961fa3c112872c06b9c35a21d1148aafe1ff005e963d6c68facbf4eb4a5a5129
-  data.tar.gz: fbbce319a638b28bf322f65683e998f83090d159c56b62861f9a3d0df4fce3cead018864fec4bb2c81f0a8de3313fd75747cbc2bcfa8316c707266952ddb1975
+  metadata.gz: 99dd798252bd649378504426f0b7c13857a3258501642244b5b110428c0bcfa9abce3266c698be1993722f9643e5897e8e2548fe501d9694fc6f0c205321de12
+  data.tar.gz: 9c2f6594f6453f818121e5e273ecc9ed91ff2c85a37c7eedbe82fdd6e2646e36b27f2074b16c5759e6a523003c880aea394785d3c26b599e8178dfd04ad9a57b

data/lib/fino/library.rb

@@ -34,21 +34,35 @@ class Fino::Library
     pipeline.read_multi(setting_definitions)
   end
 
-  def set(**setting_names_to_values)
-    at = setting_names_to_values.delete(:at)
+  def variant(setting_name, at: nil, for:)
+    setting(setting_name, at: at).variant(
+      for: binding.local_variable_get(:for)
+    )
+  end
 
-    scope = setting_names_to_values.delete(:scope)
-    context = { scope: scope }.compact
+  def set(**data)
+    at = data.delete(:at)
+    raw_overrides = data.delete(:overrides) || {}
+    raw_variants = data.delete(:variants) || {}
 
-    setting_names_to_values.each do |setting_name, value|
-      setting_definition = build_setting_definition(setting_name, at: at)
+    setting_name, raw_value = data.first
+    setting_definition = build_setting_definition(setting_name, at: at)
+    value = setting_definition.type_class.deserialize(raw_value)
 
-      pipeline.write(
-        setting_definition,
-        setting_definition.type_class.deserialize(value),
-        **context
-      )
+    variants = raw_variants.map do |percentage, value|
+      Fino::Variant.new(percentage, setting_definition.type_class.deserialize(value))
     end
+
+    variants.prepend(
+      Fino::Variant.new(100.0 - variants.sum(&:percentage), Fino::Variant::CONTROL)
+    )
+
+    pipeline.write(
+      setting_definition,
+      value,
+      raw_overrides.transform_values { |v| setting_definition.type_class.deserialize(v) },
+      variants
+    )
   end
 
   def slice(**mapping)
@@ -61,6 +75,11 @@ class Fino::Library
     pipeline.read_multi(setting_definitions)
   end
 
+  def set_variants(setting_name, at: nil, variants:)
+    setting_definition = build_setting_definition(setting_name, at: at)
+    pipeline.write_variants(setting_definition, variants)
+  end
+
   private
 
   attr_reader :configuration

data/lib/fino/pipe/storage.rb

@@ -17,8 +17,8 @@ class Fino::Pipe::Storage
     end
   end
 
-  def write(setting_definition, value, **context)
-    adapter.write(setting_definition, value, **context)
+  def write(setting_definition, value, overrides, variants)
+    adapter.write(setting_definition, value, overrides, variants)
   end
 
   private
@@ -28,11 +28,13 @@ class Fino::Pipe::Storage
   def to_setting(setting_definition, raw_adapter_data)
     raw_value = adapter.fetch_value_from(raw_adapter_data)
     scoped_raw_values = adapter.fetch_scoped_values_from(raw_adapter_data)
+    raw_variants = adapter.fetch_raw_variants_from(raw_adapter_data)
 
     setting_definition.type_class.build(
       setting_definition,
       raw_value,
-      scoped_raw_values
+      scoped_raw_values,
+      raw_variants
     )
   end
 end

data/lib/fino/pipe.rb

@@ -13,7 +13,7 @@ module Fino::Pipe
     raise NotImplementedError
   end
 
-  def write(setting_definition, value, **context)
+  def write(setting_definition, value, overrides = {}, variants = {})
     raise NotImplementedError
   end
 

data/lib/fino/setting.rb

@@ -14,24 +14,37 @@ module Fino::Setting
       raise NotImplementedError
     end
 
-    def build(setting_definition, raw_value, scoped_raw_values)
+    def build(setting_definition, raw_value, scoped_raw_values, raw_variants)
       value = raw_value.equal?(Fino::EMPTINESS) ? setting_definition.options[:default] : deserialize(raw_value)
       scoped_values = scoped_raw_values.transform_values { |v| deserialize(v) }
 
+      variants = raw_variants.map do |raw_variant|
+        Fino::Variant.new(
+          raw_variant.fetch(:percentage),
+          deserialize(raw_variant.fetch(:value))
+        )
+      end
+
+      variants.prepend(
+        Fino::Variant.new(percentage: 100.0 - variants.sum(&:percentage), value: Fino::Variant::CONTROL)
+      )
+
       new(
         setting_definition,
         value,
-        scoped_values
+        scoped_values,
+        variants
       )
     end
   end
 
-  attr_reader :definition
+  attr_reader :definition, :variants
 
-  def initialize(definition, value, scoped_values = {})
+  def initialize(definition, value, scoped_values = {}, variants = [])
     @definition = definition
     @value = value
     @scoped_values = scoped_values
+    @variants = variants
   end
 
   def name
@@ -42,8 +55,31 @@ module Fino::Setting
     definition.key
   end
 
-  def value(scope: nil)
-    scope ? scoped_values.fetch(scope.to_s, @value) : @value
+  def value(**context)
+    return @value unless (scope = context[:for])
+
+    scoped_values.fetch(scope.to_s) do
+      return @value if variants.empty?
+
+      variant = variant(for: scope)
+      result = variant_id_to_value.fetch(variant.id, @value)
+
+      return @value if result == Fino::Variant::CONTROL
+
+      result
+    end
+  end
+
+  def variant(for:)
+    Fino::VariantPicker.new(self).call(
+      binding.local_variable_get(:for)
+    )
+  end
+
+  def variant_id_to_value
+    @variant_id_to_value ||= variants.each_with_object({}) do |variant, memo|
+      memo[variant.id] = variant.value
+    end
   end
 
   def overriden_scopes
@@ -83,6 +119,8 @@ module Fino::Setting
       "key=#{key.inspect}",
       "type=#{type_class.inspect}",
       "value=#{value.inspect}",
+      "overrides=#{@scoped_values.inspect}",
+      "variants=#{variants.inspect}",
       "default=#{default.inspect}"
     ]
 

data/lib/fino/variant.rb

@@ -0,0 +1,5 @@
+
+Fino::Variant = Struct.new(:percentage, :value) do
+  def id = @id ||= SecureRandom.uuid
+end
+Fino::Variant::CONTROL = Object.new

data/lib/fino/variant_picker.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+class Fino::VariantPicker
+  SCALING_FACTOR = 1_000
+
+  attr_reader :setting
+
+  def initialize(setting)
+    @setting = setting
+  end
+
+  def call(scope)
+    return nil if setting.variants.empty?
+
+    random = Zlib.crc32("#{setting.key}#{scope}") % (100 * SCALING_FACTOR)
+    cumulative = 0
+
+    picked_variant = setting.variants.sort_by(&:percentage).find do |variant|
+      cumulative += variant.percentage * SCALING_FACTOR
+      random <= cumulative
+    end
+
+    Fino.logger.debug { "Variant picked: #{picked_variant}" }
+
+    picked_variant
+  end
+end

data/lib/fino/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Fino
-  VERSION = "1.2.0"
+  VERSION = "1.3.0"
   REQUIRED_RUBY_VERSION = ">= 3.0.0"
 end

data/lib/fino.rb

@@ -25,7 +25,9 @@ module Fino
                    :setting,
                    :settings,
                    :slice,
-                   :set
+                   :set,
+                   :define_variants,
+                   :variant
 
     module_function
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fino
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Egor Iskrenkov
@@ -54,6 +54,8 @@ files:
 - lib/fino/settings/integer.rb
 - lib/fino/settings/section.rb
 - lib/fino/settings/string.rb
+- lib/fino/variant.rb
+- lib/fino/variant_picker.rb
 - lib/fino/version.rb
 homepage: https://github.com/eiskrenkov/fino
 licenses: