fino 1.6.1 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbf6ae8c4754a465d2ff42bf3f83115ec172f74f70d09206c219a9ca4f3575e1
-  data.tar.gz: 3e5b9ae472067d9b3f056a72c166fc48822bad47ab41d9a432b1b924d6940aa6
+  metadata.gz: 2e033b28ee38e474bbeec0146b678dbcb3f076a510546e7317fe41be05476cf5
+  data.tar.gz: 772f29714cd61978a22b3cf1a4fee9f2570396a57703d5b3f228d005f09536f8
 SHA512:
-  metadata.gz: 6ab577464b46727146b2afbbe2f0e27dbcab41936b45b468a9e1c5200081dde332ee446c0d7bb65692de9dd4ae733e1d32fce8f5cb9c3b1e3567b87e369eef3d
-  data.tar.gz: 6da1a0b383910a58972b95dce2794741fbbb9a6042fc726ac12a4be1c85d199a6b9d0641d578f41fb1f5e0d775e121c500548fd2ed54c54c4e1a01ec3128f893
+  metadata.gz: 53eed6d59234333c47cdb1fe147011198827a10488c40772bd5abc14fffa57f36dafc7b34dd478ca9f218b938411cd37a842d374dbf2abe47e645b60a4c3a52b
+  data.tar.gz: 59bfaa481e797ee8974af6e8402e449266f9fb01c0acb3f81d1faf5d19635d1df00963e54075c8de513ff3662fdc9047786e13b467213cf9d14e79921fea376c

data/README.md

@@ -46,8 +46,8 @@ Fino.configure do
     end
 
     section :my_micro_service, label: "My Micro Service" do
-      setting :http_read_timeout, :integer, default: 200 # in ms
-      setting :http_open_timeout, :integer, default: 100 # in ms
+      setting :http_read_timeout, :integer, unit: :ms, default: 200
+      setting :http_open_timeout, :integer, unit: :ms, default: 100
     end
   end
 end
@@ -65,6 +65,17 @@ Fino.set(model: "gpt-5", at: :openai)
 Fino.value(:model, at: :openai) #=> "gpt-5"
 ```
 
+### Feature toggles
+
+```ruby
+Fino.enabled?(:maintenance_mode) #=> false
+Fino.disabled?(:maintenance_mode) #=> true
+
+Fino.enabled?(:maintenance_mode, for: "qa") #=> false
+Fino.add_override(:maintenance_mode, "qa" => true)
+Fino.enabled?(:maintenance_mode, for: "qa") #=> true
+```
+
 ### Overrides
 
 ```ruby
@@ -76,6 +87,9 @@ Fino.value(:model, at: :openai) #=> "gpt-5"
 Fino.value(:model, at: :openai, for: "qa") #=> "our_local_model_not_to_pay_to_sam_altman"
 
 Fino.setting(:model, at: :openai).overrides #=> { "qa" => "our_local_model_not_to_pay_to_sam_altman" }
+
+Fino.add_override(:model, at: :openai, "admin" => "gpt-2000")
+Fino.setting(:model, at: :openai).overrides #=> { "qa" => "our_local_model_not_to_pay_to_sam_altman", "admin" => "gpt-2000" }
 ```
 
 ### A/B testing
@@ -95,6 +109,31 @@ Fino.value(:model, at: :openai, for: "user_1") #=> "gpt-6"
 Fino.value(:model, at: :openai, for: "user_2") #=> "gpt-5"
 ```
 
+### Unit conversion
+
+Fino is able to convert numeric settings into various units
+
+```ruby
+Fino.configure do
+  # ...
+
+  settings do
+    section :my_micro_service, label: "My Micro Service" do
+      setting :http_read_timeout,
+              :integer,
+              unit: :ms, # When you define setting, specify unit (e.g ms/sec) to later be able to convert it
+              default: 200
+    end
+  end
+end
+
+Fino.value(:http_read_timeout, at: :my_micro_service) #=> 200
+
+# Convert from ms to sec on the fly
+Fino.value(:http_read_timeout, at: :my_micro_service, unit: :sec) #=> 0.2
+Fino.setting(:http_read_timeout, at: :my_micro_service).value(unit: :sec) #=> 0.2
+```
+
 ## Rails integration
 
 Fino easily integrates with Rails. Just add the gem to your Gemfile:

data/lib/fino/library.rb

@@ -48,6 +48,25 @@ class Fino::Library
     pipeline.read_multi(setting_definitions)
   end
 
+  def add_override(setting_name, at: nil, **overrides)
+    setting_definition = build_setting_definition(setting_name, at: at)
+    current_setting = pipeline.read(setting_definition)
+
+    deserialized_overrides = overrides.transform_values { |v| setting_definition.type_class.deserialize(v) }
+    merged_overrides = current_setting.overrides.merge(deserialized_overrides)
+
+    variants = current_setting.experiment&.variants || []
+
+    pipeline.write(
+      setting_definition,
+      current_setting.global_value,
+      merged_overrides,
+      variants
+    )
+
+    true
+  end
+
   def set(**data)
     at = data.delete(:at)
     raw_overrides = data.delete(:overrides) || {}
@@ -74,6 +93,8 @@ class Fino::Library
       overrides,
       experiment.variants
     )
+
+    true
   end
 
   def slice(*settings)

data/lib/fino/version.rb

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

data/lib/fino.rb

@@ -44,7 +44,8 @@ module Fino
                    :setting,
                    :settings,
                    :slice,
-                   :set
+                   :set,
+                   :add_override
 
     def library
       raise NotImplementedError

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fino
 version: !ruby/object:Gem::Version
-  version: 1.6.1
+  version: 1.7.0
 platform: ruby
 authors:
 - Egor Iskrenkov