fino 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 923a928e308816fef20053f1f35fff93f8fbc43e48dcc80e7ef83eab6a69a3bd
-  data.tar.gz: ff5af3d11e4184cb45fa06039514722596b2237be3c42e00be1b87fee3c401d1
+  metadata.gz: 0ea92e4e21cba886bae18fabe82c582e65a506ee44f653d467635520ffacdc15
+  data.tar.gz: d3379c18421c4ec140abcf624261ec87f984657dbf02e86b06aabeccd36a52d8
 SHA512:
-  metadata.gz: 02ebcf4c01d917a775909b9d9bfcca9f7840aa0941a9339f885b491fa91337e9367f3692de7cc0f6ba75a27ce9cfebed221014aa50fd1079eb1cdbe97508353d
-  data.tar.gz: 308a664811806d793796208a7d0dfe736c1d20f8e4ba3bda8d2bebb65e420872669127cd05c214e877026df855cba6c0d9d7189b317f70b3b9599d7996054cc8
+  metadata.gz: 27b6ebe4a3be8162db96951a9261d9299f75afdf9881db8d47c21eeff7e586cb13f3a2601a1c15ab2ccc2bc1527e0612cbea8eba95b25f6da9123539b668bb3e
+  data.tar.gz: c99f75e5a0a7f9c53b84c00fc37a8db131ad40cda3ea3e34627c4e51cb1ebb8cd48ebca5e996fabc5c4164a21d9921edb382923652a2447ed862c389fcfdb646

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/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
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.2
 platform: ruby
 authors:
 - Egor Iskrenkov
@@ -34,7 +34,6 @@ files:
 - lib/fino-ui.rb
 - lib/fino.rb
 - lib/fino/adapter.rb
-- lib/fino/adapter/memory.rb
 - lib/fino/cache.rb
 - lib/fino/cache/memory.rb
 - lib/fino/cache/null.rb

data/lib/fino/adapter/memory.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-class Fino::Adapters::Memory
-  include Fino::Adapter
-end