fino 1.0.1 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65f3e2cd2a4299e607bbee3cd43139c47370e98226f4d288ac04a777b516f838
-  data.tar.gz: aeb1fc3b2e90dca2ddfde354df0ddcd1330396a25049a9a08d57cd4a1acd4b54
+  metadata.gz: 69285bc3c8b50977e454b0de3c9da140c18260acb43ee1f42f62f8a9288c3183
+  data.tar.gz: 714affd74ca27f673cc0b1d80a2ba66f151f9e2723c7034331d64cb5b667c7ce
 SHA512:
-  metadata.gz: 37a8a656f583fc64ddb0fbb76de6687ea2ab533bad82f2eeef9fac48425204a7ba38cc0cfeff9f52f6a232efb89e60bc7060f0f98f3ac11c47192cb18bb5fc50
-  data.tar.gz: 836350b87eef2005c8686a6eb794409e89d306b0773551baf2d0b3a4658cf8032b788b18de91599a6f7e47af02db059cb6748e88d7171389c39e9f2fe4ba21fb
+  metadata.gz: b1c18ff5d58af075601ee3df575a98d8ce56af98e0148d4d3debd5114f30ad1242786d9d8f37880e8ee4a2a40a880cf688fc807f88d227bc3ba3f40d3af5345d
+  data.tar.gz: 6f4c003666bbce10a3fee68ee17efbdd9c506c8c3654ed6e58e12f7f2fc3804412431fa3934647d806198031fbab9712b8960e874cd795847ebd1f4b6871dd1c

data/README.md

@@ -1,11 +1,83 @@
 # Fino
 
+⚠️ Fino is under active development. API changes are possible ⚠️
+
+Fino is a dynamic settings engine for Ruby and Rails
+
+## Usage
+
+### Define settings via DSL
+
 ```ruby
-Fino.value(:retries_amount)
-Fino.value(:http_read_timeout, :service_a)
+require "fino-redis"
+
+Fino.configure do
+  adapter do
+    Fino::Redis::Adapter.new(
+      Redis.new(**Rails.application.config_for(:redis))
+    )
+  end
+
+  cache { Fino::Cache::Memory.new(expires_in: 3.seconds) }
+
+  settings do
+    setting :maintenance_mode, :boolean, default: false
+
+    section :openai, label: "OpenAI" do
+      setting :model,
+              :string,
+              default: "gpt-4o",
+              description: "OpenAI model"
+
+      setting :temperature,
+              :float,
+              default: 0.7,
+              description: "Model temperature"
+    end
+
+    section :feature_toggles, label: "Feature Toggles" do
+      setting :new_ui, :boolean, default: true
+      setting :beta_functionality, :boolean, default: false
+    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
+    end
+  end
+end
 ```
 
+### Work with settings
+
+```ruby
+Fino.value(:model, :openai) #=> "gpt-4o"
+Fino.value(:temperature, :openai) #=> 0.7
+
+Fino.set("gpt-5", :model, :openai)
+Fino.value(:model, :openai) #=> "gpt-5"
+```
+
+### Manage settings via UI
+
+```ruby
+gem "fino-ui"
+```
+
+Mount Fino UI in your `config/routes.rb`:
+
+```ruby
+Rails.application.routes.draw do
+  mount Fino::UI::Engine, at: "/fino"
+end
+```
+
+<img width="1229" height="641" alt="Screenshot 2025-09-04 at 16 01 51" src="https://github.com/user-attachments/assets/646df84c-c25b-4890-9637-c481e18c9bd4" />
+
 ## TODO
 
+- Preloading settings to be able to fetch all of them in one adapter call
+- Request scoped memoization when integrating with Rails
+- Nicer UI
 - Basic validations (presence, range, numericality)
 - Enum setting type

data/lib/fino/library.rb

@@ -20,7 +20,12 @@ class Fino::Library
   end
 
   def set(value, *setting_path)
-    pipeline.write(value, build_setting_definition(*setting_path))
+    setting_definition = build_setting_definition(*setting_path)
+
+    pipeline.write(
+      setting_definition.type_class.deserialize(value),
+      setting_definition
+    )
   end
 
   private

data/lib/fino/pipeline.rb

@@ -24,6 +24,8 @@ class Fino::Pipeline
     @pipes.each do |pipe|
       pipe.write(setting_definition, value)
     end
+
+    value
   end
 
   private

data/lib/fino/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fino
-  VERSION = "1.0.1"
+  VERSION = "1.0.3"
 end

metadata

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