fino 1.8.3 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92ab588981e1a3a7114f23e7c5fc19cd2821477bc8060170646d6366e1ccb300
-  data.tar.gz: cea52b769341254d49f214ad44577203580ede4c35e9fbfd00454510d6f1a6b8
+  metadata.gz: 3acbc23a5c705d61f9d9a3f9f570e262fe96b940b523aa10a9edc0dbc3738545
+  data.tar.gz: 02bba82e7d24a7939f1e54e4e17610920a18d5efa6244cdd689bc74ef1fac15b
 SHA512:
-  metadata.gz: ad589f2f78feca10e4d5fedbc0947806e1d9f6f333288b7bc8b1996624db5480e052d00d4dbdb9cd70b7e0cff64fbbabbcc2b7cd8e65eec2ca86a512bbf657fc
-  data.tar.gz: c9a16f21aa25f339bf158dc7fd33b1513cc9e877f2c561c4ac7e7a0c261ac4e2e3e3a469da3bb9aa75bc0f50defda70aca80f7c750b62cda943d874cd8c9e8bb
+  metadata.gz: 3554875390236803ebc23b16ff603bcca22a6061c8c3579b99dd678c7b74c938196e26713214707372d5dc25a6d3348c4e872960fc844a9b59810e43554113e4
+  data.tar.gz: 16287e6c8bb34a13190352eecfe8ece1b3749afcee996bedd1a8d8e797a5e9aa45fb852677fe379faf48e44eed8edb0dc007dc1d2500eb2c110976f201d16cec

data/README.md

@@ -1,8 +1,10 @@
 # Fino
 
-⚠️ Fino in active development phase at wasn't properly battle tested in production just yet. Give us a star and stay tuned for Production test results and new features
+Fino is plug & play distributed settings engine for Ruby and Rails
 
-Fino is a dynamic settings engine for Ruby and Rails
+- Blazing fast reads with multiple adapers (Redis, Active Record)
+- Out of the box UI
+- A/B test and override settings on the go
 
 ## Usage
 
@@ -139,6 +141,31 @@ 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
 ```
 
+### Callbacks
+
+Fino provides callbacks configuration that will be called once some particular action is triggered:
+
+- `after_write` - yields `setting_definition`, `value`, `overrides` and `variants`, is triggered when setting is updated
+
+```ruby
+Fino.configure do
+  # ...
+
+  after_write do |setting_definition, value, overrides, variants|
+    next unless setting_definition.tags.include?(:monitor)
+
+    Monitor.track_changes("Set #{setting_definition.key} to #{value}")
+  end
+
+  settings do
+    setting :maintenance_mode, :boolean, default: false
+
+    setting :http_read_timeout, :integer, unit: :ms, default: 200, tags: %i[monitor]
+    setting :http_open_timeout, :integer, unit: :ms, default: 500, tags: %i[monitor]
+  end
+end
+```
+
 ## Rails integration
 
 Fino easily integrates with Rails. Just add the gem to your Gemfile:

data/lib/fino/cache.rb

@@ -13,11 +13,11 @@ module Fino::Cache
     raise NotImplementedError
   end
 
-  def fetch(key, &block)
+  def fetch(key, &)
     raise NotImplementedError
   end
 
-  def fetch_multi(*keys, &block)
+  def fetch_multi(*keys, &)
     raise NotImplementedError
   end
 

data/lib/fino/configuration.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 class Fino::Configuration
-  attr_reader :registry, :pipeline_builder_block
+  attr_reader :registry, :pipeline_builder_block, :after_write_block
 
   def initialize(registry)
     @registry = registry
@@ -37,7 +37,11 @@ class Fino::Configuration
     @pipeline_builder_block = block
   end
 
-  def settings(&block)
-    Fino::Registry::DSL.new(registry).instance_eval(&block)
+  def after_write(&block)
+    @after_write_block = block
+  end
+
+  def settings(&)
+    Fino::Registry::DSL.new(registry).instance_eval(&)
   end
 end

data/lib/fino/definition/setting.rb

@@ -35,6 +35,10 @@ class Fino::Definition::Setting
     defined?(@description) ? @description : @description = options[:description]
   end
 
+  def tags
+    defined?(@tags) ? @tags : @tags = options[:tags] || []
+  end
+
   def path
     @path ||= [setting_name, section_definition&.name].compact
   end

data/lib/fino/library.rb

@@ -124,7 +124,7 @@ class Fino::Library
   end
 
   def storage
-    Fino::Pipe::Storage.new(adapter)
+    Fino::Pipe::Storage.new(adapter, configuration)
   end
 
   def adapter

data/lib/fino/metadata.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "./version"
+require_relative "version"
 
 module Fino
   module_function

data/lib/fino/pipe/storage.rb

@@ -3,8 +3,9 @@
 class Fino::Pipe::Storage
   include Fino::Pipe
 
-  def initialize(adapter)
+  def initialize(adapter, configuration)
     @adapter = adapter
+    @configuration = configuration
   end
 
   def read(setting_definition)
@@ -18,12 +19,14 @@ class Fino::Pipe::Storage
   end
 
   def write(setting_definition, value, overrides, variants)
-    adapter.write(setting_definition, value, overrides, variants)
+    adapter.write(setting_definition, value, overrides, variants).tap do
+      configuration.after_write_block&.call(setting_definition, value, overrides, variants)
+    end
   end
 
   private
 
-  attr_reader :adapter
+  attr_reader :adapter, :configuration
 
   def to_setting(setting_definition, raw_adapter_data)
     raw_value = adapter.fetch_value_from(raw_adapter_data)

data/lib/fino/registry.rb

@@ -37,7 +37,7 @@ class Fino::Registry
       )
     end
 
-    def section(section_name, options = {}, &block)
+    def section(section_name, options = {}, &)
       section_definition = Fino::Definition::Section.new(
         name: section_name,
         **options
@@ -45,7 +45,7 @@ class Fino::Registry
 
       @registry.register_section(section_definition)
 
-      SectionDSL.new(section_definition, @registry).instance_eval(&block)
+      SectionDSL.new(section_definition, @registry).instance_eval(&)
     end
   end
 

data/lib/fino/version.rb

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

data/lib/fino.rb

@@ -5,8 +5,8 @@ require "zeitwerk"
 
 module Fino
   module Stateful
-    def configure(&block)
-      configuration.instance_eval(&block)
+    def configure(&)
+      configuration.instance_eval(&)
     end
 
     def reset!
@@ -15,9 +15,9 @@ module Fino
       @configuration = nil
     end
 
-    def reconfigure(&block)
+    def reconfigure(&)
       reset!
-      configure(&block)
+      configure(&)
     end
 
     def library
@@ -68,7 +68,7 @@ module Fino
       Logger.new($stdout).tap do |l|
         l.progname = name
         l.level = ENV.fetch("FINO_LOG_LEVEL", "info")
-        l.formatter = proc do |severity, datetime, progname, msg|
+        l.formatter = proc do |severity, _datetime, progname, msg|
           "[#{progname}] #{severity}: #{msg}\n"
         end
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fino
 version: !ruby/object:Gem::Version
-  version: 1.8.3
+  version: 1.9.0
 platform: ruby
 authors:
 - Egor Iskrenkov
@@ -83,7 +83,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -92,5 +92,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Elegant & performant settings engine for Ruby and Rails
+summary: Plug & play distributed settings engine for Ruby and Rails
 test_files: []