fino-ui 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54c10c469d72a79814e32a94385b0a252e5fcfba83392c29364b1f5834d51861
-  data.tar.gz: 040f6018d78d5ce57d13d12c3be69db3f0388c3869494de73ba6e96b1bc7721e
+  metadata.gz: 56f2dc8df6a5d3159fd6bdca44d8fedf88c20c710a66bef3f60f3bfaca8a8c8b
+  data.tar.gz: cd1c3055ccbd39d4af1a54daeaa3601e1fb08796d4b5bd83c00e741c0d675c5f
 SHA512:
-  metadata.gz: ad2c824c708cd4551e396a61c1c7477da1db868c2c170efdb08728f21fed77380d68ac651534b407d63a2ee42c0fb304ab649b2ccc846f3d90ea7ceab6424fd3
-  data.tar.gz: 4d1436a40e58e9910c0eb45ef68437b1ba2b8a82f3aadc36d8e95edb8c48909987b9cfad76313d48b022252ab0a472af84e4a2393278e35a6b87d66711095890
+  metadata.gz: 5c117e03fa6cfea27ebdc9d96ec66eb9cf77e866b2374c1846aee543780ee7adc236a8ec6a6fa2dbc9356b2bdbb316ae8d088de2de062f9d3cae294b77700c7b
+  data.tar.gz: 4f1e71ba3fa4eac98c60bd07c4f66127a08ca48eff626fe85ec69d39bf6750ea34f5e286e3c94c4bd6bc305a0076995a57167b01eadd0494e98af819a993db9c

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/ui/app/views/fino/ui/settings/edit.html.erb

@@ -144,7 +144,7 @@
         <% end %>
 
         <% case @setting.class.name.demodulize.downcase %>
-        <% when 'booleansetting' %>
+        <% when 'boolean' %>
           <%= f.select :value,
                       options_for_select([
                         ['True', 'true'],
@@ -152,12 +152,12 @@
                       ], @setting.value.to_s),
                       {},
                       { class: "form-select" } %>
-        <% when 'integersetting' %>
+        <% when 'integer' %>
           <%= f.number_field :value,
                             value: @setting.value,
                             class: "form-input",
                             step: 1 %>
-        <% when 'floatsetting' %>
+        <% when 'float' %>
           <%= f.number_field :value,
                             value: @setting.value,
                             class: "form-input",

data/lib/fino/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fino-ui
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.2
 platform: ruby
 authors:
 - Egor Iskrenkov
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 1.0.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 1.0.2
 email:
 - egor@iskrenkov.me
 executables: []