fino-solid 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd4440e5b282bcef8d8aeb2a56b98b75e31b2b34ff05dc57eb2d8b85a076f055
-  data.tar.gz: fff6817b7f553c1a9482f31343f61b84b6e3fd60b6280cd558484f1281d11877
+  metadata.gz: d001f6bb38d131992464c9cdeab1e5927fd5a16623759459c7020b1c35d6664a
+  data.tar.gz: 339ab6d35c8dc40ecd553f835f536eb74a6978375ed29943cf5c8905c9c812e2
 SHA512:
-  metadata.gz: 0f330e1353876cc19afafdea23beab7fedb48146a4a82e1b1feb86472164e27fd87408e3a325b6e192e6d14b318fb13bdf39d2f7205f5acd3464a765b5e138fa
-  data.tar.gz: 42bdf1a8d7b5c102a8d8c846c372073318b2c90a25d4938913b87209c7d149f990cdce5588908a5a384ac9e401207adc76c9888e1fa8905238a32ba403dc664e
+  metadata.gz: 6f81641ee84473e0fb6262bfa41d6beefd0e2051eb8caf6fc15364198385324f162f395a959d6658791dd70b9dbc28de46259a561a7c08b7df90f7d04f7c0f54
+  data.tar.gz: 53eef4644ef38aaa358cf40d9f2cbf5ed587800a5acb0e47b94cf09b8f51371d5cb5a34678385f691a524d2beda08ed5814e029ebbf0180cf63a6055299585c8

data/README.md

@@ -83,6 +83,126 @@ Fino.disable(:maintenance_mode, for: "qa")
 Fino.enabled?(:maintenance_mode, for: "qa") #=> false
 ```
 
+### Select setting
+
+The simplest way to define select setting in fino is the following
+
+```ruby
+Fino.configure do
+  # ...
+  section :storefront, label: "Storefront" do
+    setting :purchase_button_color,
+            :select,
+            options: [
+              Fino::Settings::Select::Option.new(label: "Red", value: "red"),
+              Fino::Settings::Select::Option.new(label: "Blue", value: "blue")
+            ],
+            default: "red",
+            description: "Color of the purchase button"
+  end
+  # ...
+end
+```
+
+Options must be an array of `Fino::Settings::Select::Option` instances
+
+Then you can interact with the setting like that
+
+```ruby
+# Read selected option
+selected_option = Fino.value(:purchase_button_color, at: :storefront)
+# => #<Fino::Settings::Select::Option:0x0000000124fecd90 @label="Red", @metadata={}, @value="red">
+
+# Read setting value
+selected_option.value
+# => "red"
+
+# Read options
+Fino.setting(:purchase_button_color, at: :storefront).options
+# => [#<Fino::Settings::Select::Option:0x0000000124fecd90 @label="Red", @metadata={}, @value="red">,
+      #<Fino::Settings::Select::Option:0x0000000124fecca0 @label="Blue", @metadata={}, @value="blue">]
+```
+
+#### Dynamic option
+
+Options can also be defined dynamically using any callable object. Let's take a look at dynamic options in an example
+of LLM model setting using [RubyLLM](https://github.com/crmne/ruby_llm) by @crmne
+
+To define dynamic select options, use `:select` as setting type and provide a callable to `options`. Your object's
+`call` method might be called with `refresh` option which is true only when user initiates options refresh manually.
+This is useful for updating models list in RubyLLM for example
+
+```ruby
+section :llm, label: "LLM" do
+  setting :model,
+          :select,
+          options: proc { |refresh:|
+            RubyLLM.models.refresh! if refresh
+            models = RubyLLM.models.chat_models
+
+            openai_models = models.by_provider(:openai)
+            anthropic_models = models.by_provider(:anthropic)
+
+            build_pricing_label = proc do |model|
+              text_pricing = model.pricing&.text_tokens
+              next unless text_pricing && text_pricing.input && text_pricing.output
+
+              "$#{text_pricing.input} / $#{text_pricing.output} per 1M tokens"
+            end
+
+            [*openai_models, *anthropic_models].map do |model|
+              Fino::Settings::Select::Option.new(
+                label: model.name,
+                value: model.id,
+                metadata: {
+                  provider: model.provider_class.name,
+                  pricing: build_pricing_label.call(model)
+                }.compact
+              )
+            end
+          },
+          default: "gpt-5",
+          description: "Chat model for AI-powered features"
+  end
+end
+```
+
+```ruby
+# Read selected option
+selected_option = Fino.setting(:model, at: :llm).value
+# => #<Fino::Settings::Select::Option:0x0000000126257728
+#     @label="GPT-4",
+#     @metadata={provider: "OpenAI", pricing: "$30 / $60 per 1M tokens"},
+#     @value="gpt-4">
+
+# Read setting value
+selected_option.value
+# => "gpt-4"
+
+# Read options
+Fino.setting(:model, at: :llm).options
+# => [#<Fino::Settings::Select::Option:0x000000012629e448
+#      @label="GPT-5.3 Codex Spark",
+#      @metadata={provider: "OpenAI", pricing: "$1.75 / $14 per 1M tokens"},
+#      @value="gpt-5.3-codex-spark">,
+#     #<Fino::Settings::Select::Option:0x000000012629e1c8
+#      @label="GPT-5.4",
+#      @metadata={provider: "OpenAI", pricing: "$2.5 / $15 per 1M tokens"},
+#      @value="gpt-5.4">, ...]
+
+# Refresh options
+Fino.setting(:model, at: :llm).refresh!
+# I, [2026-03-22T18:23:13.615270 #67293]  INFO -- RubyLLM: Fetching models from providers:
+# I, [2026-03-22T18:23:13.615934 #67293]  INFO -- RubyLLM: Fetching models from models.dev API...
+```
+
+#### Use with RubyLLM
+
+```ruby
+chat = RubyLLM.chat(model: Fino.setting(:model, at: :llm).value)
+chat.ask "Why Ruby?"
+```
+
 ### Overrides
 
 ```ruby
@@ -116,6 +236,44 @@ Fino.value(:model, at: :openai, for: "user_1") #=> "gpt-6"
 Fino.value(:model, at: :openai, for: "user_2") #=> "gpt-5"
 ```
 
+#### Experiment analysis
+
+Some Fino adapters support A/B testing analysis, e.g built-in Redis adapter
+
+When you run an A/B test for a setting, fino automatically calculates variant based on a stable identifier you pass as
+a `for` option
+
+```ruby
+Fino.set(model: "gpt-5", at: :openai, variants: { 20.0 => "gpt-6" })
+
+Fino.value(:model, at: :openai, for: "user_1") #=> "gpt-6"
+Fino.value(:model, at: :openai, for: "user_1") #=> "gpt-6"
+
+Fino.value(:model, at: :openai, for: "user_2") #=> "gpt-5"
+```
+
+Later in your code, when user performs a "desired" action, simply call
+
+```ruby
+Fino.convert!(:model, at: :openai, for: "user_2")
+```
+
+to record a "convertion" for `user_2`. As Fino knows the right variant for `user_2`, conversion will be counted
+todards it. Thanks to that later you'll be able to call
+
+```ruby
+Fino.analyse(:model, at: :openai)
+```
+
+to receive a detailed report over variants performance. Also bar charts comparing all variants and a chart displaying
+amount of conversions over time per variant will be accessible on UI with `fino-rails`
+
+To reset analysis data for an experiment:
+
+```ruby
+Fino.reset_analysis!(:model, at: :openai)
+```
+
 ### Unit conversion
 
 Fino is able to convert numeric settings into various units

data/lib/fino/solid/adapter.rb

@@ -21,7 +21,7 @@ module Fino
       end
 
       def write(setting_definition, value, overrides, variants)
-        serialize_value = ->(raw_value) { setting_definition.type_class.serialize(raw_value) }
+        serialize_value = ->(raw_value) { setting_definition.serialize(raw_value) }
 
         data = { VALUE_KEY => serialize_value.call(value) }
 

data/lib/fino/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Fino
-  VERSION = "1.9.0"
+  VERSION = "1.10.0"
   REQUIRED_RUBY_VERSION = ">= 3.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fino-solid
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Egor Iskrenkov
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.0
+        version: 1.10.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.0
+        version: 1.10.0
 - !ruby/object:Gem::Dependency
   name: mysql2
   requirement: !ruby/object:Gem::Requirement