ez-settings 0.2.4 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec5f2fa00686e7a7d220ff1944d4c0c481ccfb47b3a282285858ccc1c90468f0
-  data.tar.gz: 8d5037d087086a8c045ef18ec9ce5c917892587f14a7bc567a47a623d7f0a711
+  metadata.gz: b0e61f349026e3e8e7f1d6c73f3dac27b1cf94759aaf0bd95804f3adc6ffb384
+  data.tar.gz: 3c8169673fabafc9c60da04029f33d9f5336b6607e4a3e7f82522aa9db56480f
 SHA512:
-  metadata.gz: 4c5d9592cd289a2acd0683154eea446b3d8330adf9e0effca9dbe68129cd76312c8ccf34d8d60a6c1fbb109ad7f5aae223f0e8d3dd850369c18be991c1dbff4b
-  data.tar.gz: 87773d528bcc1f72c362aa3d77c568591c8311e6db673feb84bf004ce443731c3a2a182e2c0667b28c2332aa5ac828101c6025b654e4b5bd10149f214119fc24
+  metadata.gz: b75bf279db5b2d01e2c0c3d349f8e8f431487934dbf379e381b1ff034e134bc9802979b33b3cf55e95bfc469782372762419f62afb9cfe16836243afde07ac07
+  data.tar.gz: d04873ffd18224f1ced6e1914fda9d0e836340e1b1d8e9672ac915494e89a6309297c3aa353fcaccf099fdc10d346710a2c2757857f1e2161ae047f796dc9251

data/README.md

@@ -9,10 +9,6 @@
 - Convetion over configuration principles.
 - Depends on [ez-core](https://github.com/ez-engines/ez-core)
 
-If you are boring to read all this stuff maybe this video motivates you:
-
-[YouTube demonstrates how easy we integrated ez-settings for our pivorak-web-app only by ±50 lines of code](https://www.youtube.com/watch?v=TiX0QDHEaKA&feature=youtu.be)
-
 ## Installation
 Add this line to your application's Gemfile:
 
@@ -38,7 +34,7 @@ and `bundle install`
 
 Generates initializer config file and I18n yaml file with english keys
 
-`config/ez_settings.rb`
+`config/initializers/ez_settings.rb`
 ```ruby
 # By default engine try to inherit from ApplicationController, but you could change this:
 # Ez::Settings.config.base_controller = 'Admin::BaseController'
@@ -82,11 +78,18 @@ end
 # After defining settings interface groups/keys you need to configure it:
 app.configure do |config|
   # Backend adapter to store all settings
-  config.backend = Ez::Settings::Backend::FileSystem.new(Rails.root.join('config', 'settings.yml'))
-  # Redis is also supported:
-  # config.backend = Ez::Settings::Backend::Redis.new('config')
+  config.backend = Ez::Settings::Backend::ActiveRecord.new
+  # and DB table name that you can change as well
+  # config.active_record_table_name = :ez_settings_store
+
+  # YAML filesystem
+  # config.backend = Ez::Settings::Backend::FileSystem.new(Rails.root.join('config', 'settings.yml'))
 
-  # Default path for redirect in controller
+  # Redis
+  # require 'redis'
+  # config.backend = Ez::Settings::Backend::Redis.new(Redis.current, namespace: 'myapp')
+
+  # Default path for redirect in the settings controller
   config.default_path = '/admin/settings'
 
   # Pass your custom css classes through css_map config
@@ -139,6 +142,19 @@ Ez::Registry.in(:settings_interfaces, by: 'YourAppName') do |registry|
 end
 ```
 
+
+### Database storage as backend (ActiveRecord)
+
+You can use migrations generator
+
+`rails generate ez:settings:active_record_migrations`
+
+Generates migration for `ez_settings_store` table.
+
+`rails db:migrate`
+
+
+
 ### Routes
 `config/routes.rb`
 
@@ -229,10 +245,13 @@ If you need, create locale file with this structure:
           groups:
             general:
               label: General
+              description: General settings of your application
             admin:
               label: Admin
+              description: Admin area settings
             showcase:
               label: Showcase
+              description: Just an example of possible settings UI elements
               keys:
                 string:
                   label: String
@@ -250,14 +269,16 @@ If you need, create locale file with this structure:
 
 ## TODO
 This features will be implemented in upcoming 0.2 and 0.3 releases:
-- JSON API endpoints and `ez_settings_api_for` routes helper
-- Scoped settings (`:scope_id`, `:scope_type`)
-- controller before actions as configured callbacks (for external usage)
-- Interface description (and show at UI)
-- Groups description (and show at UI)
-- Keys description (and show at UI)
-- Database storage as backend (ActiveRecord)
-- UI frameworks adapters: bootsrap3, bootstrap4, foundation, semantic, etc.
+- [] JSON API endpoints and `ez_settings_api_for` routes helper
+- [] Scoped settings (`:scope_id`, `:scope_type`)
+- [] Controller before actions as configured callbacks (for external usage)
+- [] Interface description (and show at UI)
+- [] Groups description (and show at UI)
+- [] Keys description (and show at UI)
+- [] Database storage as backend (ActiveRecord)
+- [] Backend#read method should receive app, group & key attributes and avoid loading all in case of SQL adapter
+- [] UI frameworks adapters: bootsrap3, bootstrap4, foundation, semantic, etc.
+- [X] Bug: Read only defaul values if ActiveRecord do not ready yet (migrations)
 
 ## Contributing
 Fork => Fix => MR warmly welcomed!

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 begin
   require 'bundler/setup'
 rescue LoadError
@@ -14,15 +16,15 @@ RDoc::Task.new(:rdoc) do |rdoc|
   rdoc.rdoc_files.include('lib/**/*.rb')
 end
 
-APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+APP_RAKEFILE = File.expand_path('spec/dummy/Rakefile', __dir__)
 load 'rails/tasks/engine.rake'
 
 load 'rails/tasks/statistics.rake'
 
 require 'bundler/gem_tasks'
 
-require "rspec/core/rake_task"
+require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task default: :spec

data/app/cells/ez/settings/base_cell.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez::Settings
   class BaseCell < Cell::ViewModel
     include RequestDispatcher
@@ -8,14 +10,15 @@ module Ez::Settings
     delegate :params, :request, to: :controller
     delegate :dynamic_css_map,  to: :'interface.config'
 
-    SCOPE      = 'ez_settings'
-    LABEL      = 'label'
-    INTERFACES = 'interfaces'
-    GROUPS     = 'groups'
-    KEYS       = 'keys'
-    ACTIONS    = 'actions'
-    SAVE       = 'save'
-    CANCEL     = 'cancel'
+    SCOPE       = 'ez_settings'
+    LABEL       = 'label'
+    DESCRIPTION = 'description'
+    INTERFACES  = 'interfaces'
+    GROUPS      = 'groups'
+    KEYS        = 'keys'
+    ACTIONS     = 'actions'
+    SAVE        = 'save'
+    CANCEL      = 'cancel'
 
     def self.form
       include ActionView::Helpers::FormHelper
@@ -43,27 +46,27 @@ module Ez::Settings
 
     def css_map
       {
-        nav_label:                           'ez-settings-nav-label',
-        nav_menu:                            'ez-settings-nav-menu',
-        nav_menu_item:                       'ez-settings-nav-menu-item',
-        overview_page_wrapper:               'ez-settings-overview',
-        overview_page_section:               'ez-settings-overview-section',
-        overview_page_section_header:        'ez-settings-overview-section-header',
-        overview_page_section_content:       'ez-settings-overview-section-content',
-        overview_page_section_content_key:   'ez-settings-overview-section-content-key',
+        nav_label: 'ez-settings-nav-label',
+        nav_menu: 'ez-settings-nav-menu',
+        nav_menu_item: 'ez-settings-nav-menu-item',
+        overview_page_wrapper: 'ez-settings-overview',
+        overview_page_section: 'ez-settings-overview-section',
+        overview_page_section_header: 'ez-settings-overview-section-header',
+        overview_page_section_content: 'ez-settings-overview-section-content',
+        overview_page_section_content_key: 'ez-settings-overview-section-content-key',
         overview_page_section_content_value: 'ez-settings-overview-section-content-value',
-        group_page_wrapper:                  'ez-settings-group-wrapper',
-        group_page_inner_wrapper:            'ez-settings-group-inner-wrapper',
-        group_page_header:                   'ez-settings-group-header',
-        group_page_form_wrapper:             'ez-settings-group-form-wrapper',
-        group_page_form_inner:               'ez-settings-group-form-inner',
-        group_page_form_field_row:           'ez-settings-group-form-field-row',
-        group_page_form_string_wrapper:      'ez-settings-group-form-string-wrapper',
-        group_page_form_boolean_wrapper:     'ez-settings-group-form-boolean-wrapper',
-        group_page_form_select_wrapper:      'ez-settings-group-form-select-wrapper',
-        group_page_actions_wrapper:          'ez-settings-group-actions-wrapper',
-        group_page_actions_save_button:      'ez-settings-group-actions-save-btn',
-        group_page_actions_cancel_link:      'ez-settings-group-actions-cancel-link'
+        group_page_wrapper: 'ez-settings-group-wrapper',
+        group_page_inner_wrapper: 'ez-settings-group-inner-wrapper',
+        group_page_header: 'ez-settings-group-header',
+        group_page_form_wrapper: 'ez-settings-group-form-wrapper',
+        group_page_form_inner: 'ez-settings-group-form-inner',
+        group_page_form_field_row: 'ez-settings-group-form-field-row',
+        group_page_form_string_wrapper: 'ez-settings-group-form-string-wrapper',
+        group_page_form_boolean_wrapper: 'ez-settings-group-form-boolean-wrapper',
+        group_page_form_select_wrapper: 'ez-settings-group-form-select-wrapper',
+        group_page_actions_wrapper: 'ez-settings-group-actions-wrapper',
+        group_page_actions_save_button: 'ez-settings-group-actions-save-btn',
+        group_page_actions_cancel_link: 'ez-settings-group-actions-cancel-link'
       }.merge(interface.config.custom_css_map)
     end
 
@@ -71,10 +74,10 @@ module Ez::Settings
       context[:controller]
     end
 
-    def group_link(group, options = {})
+    def group_link(group, _options = {})
       link_to i18n_group_label(group),
-        group_path(group),
-        class: css_for(:nav_menu_item, dynamic: "settings/#{group.name}")
+              group_path(group),
+              class: css_for(:nav_menu_item, dynamic: "settings/#{group.name}")
     end
 
     def group_path(group)
@@ -82,12 +85,17 @@ module Ez::Settings
     end
 
     def i18n_group_label(group)
-      t(LABEL, scope:   [SCOPE, INTERFACES, group.interface, GROUPS, group.name],
+      t(LABEL, scope: [SCOPE, INTERFACES, group.interface, GROUPS, group.name],
                default: group.name.to_s.humanize)
     end
 
+    def i18n_group_description(group)
+      t(DESCRIPTION, scope: [SCOPE, INTERFACES, group.interface, GROUPS, group.name],
+                     default: group.name.to_s.humanize)
+    end
+
     def i18n_key_label(key)
-      t(LABEL, scope:   [SCOPE, INTERFACES, key.interface, GROUPS, key.group, KEYS, key.name],
+      t(LABEL, scope: [SCOPE, INTERFACES, key.interface, GROUPS, key.group, KEYS, key.name],
                default: key.name.to_s.humanize)
     end
   end

data/app/cells/ez/settings/group/show.slim

@@ -5,6 +5,7 @@
     div class=(css_for :group_page_inner_wrapper)
       div class=(css_for :group_page_header)
         = i18n_group_label(group)
+      p = i18n_group_description(group)
 
       div class=(css_for :group_page_form_wrapper)
         = simple_form_for store, as: :settings, url: form_url, method: :put do |f|

data/app/cells/ez/settings/group_cell.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez::Settings
   class GroupCell < BaseCell
     form
@@ -11,16 +13,16 @@ module Ez::Settings
 
     def save_button(form)
       form.button :submit,
-        t(LABEL, scope:   [SCOPE, INTERFACES, model.interface, ACTIONS, SAVE],
-                 default: 'Save'),
-        class: css_for(:group_page_actions_save_button)
+                  t(LABEL, scope: [SCOPE, INTERFACES, model.interface, ACTIONS, SAVE],
+                           default: 'Save'),
+                  class: css_for(:group_page_actions_save_button)
     end
 
     def cancel_link
-      link_to t(LABEL, scope:   [SCOPE, INTERFACES, model.interface, ACTIONS,CANCEL],
+      link_to t(LABEL, scope: [SCOPE, INTERFACES, model.interface, ACTIONS, CANCEL],
                        default: 'Cancel'),
-        interface.config.default_path,
-        class: css_for(:group_page_actions_cancel_link)
+              interface.config.default_path,
+              class: css_for(:group_page_actions_cancel_link)
     end
   end
 end

data/app/cells/ez/settings/index_cell.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez::Settings
   class IndexCell < BaseCell
   end

data/app/cells/ez/settings/key_cell.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez::Settings
   class KeyCell < BaseCell
     form
@@ -8,15 +10,15 @@ module Ez::Settings
 
     def html_options
       {
-        label:           i18n_key_label(model),
-        as:              model.type,
-        collection:      model.collection,
-        include_blank:   model.default.present?,
-        required:        model.required?,
-        checked_value:   true.to_s,
+        label: i18n_key_label(model),
+        as: model.type,
+        collection: model.collection,
+        include_blank: model.default.present?,
+        required: model.required?,
+        checked_value: true.to_s,
         unchecked_value: false.to_s,
-        wrapper:         model.wrapper,
-        right_label:     model.suffix,
+        wrapper: model.wrapper,
+        right_label: model.suffix,
         input_html: {
           min: model.min
         }

data/app/cells/ez/settings/nav_cell.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez::Settings
   class NavCell < BaseCell
     def nav_label
@@ -6,8 +8,8 @@ module Ez::Settings
 
     def settings_link
       link_to nav_label,
-        interface.config.default_path,
-        class: css_for(:nav_menu_item, dynamic: 'settings/')
+              interface.config.default_path,
+              class: css_for(:nav_menu_item, dynamic: 'settings/')
     end
   end
 end

data/app/controllers/ez/settings/application_controller.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez
   module Settings
     class ApplicationController < Ez::Settings.config.base_controller.constantize

data/app/controllers/ez/settings/settings_controller.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez
   module Settings
     class SettingsController < Ez::Settings::ApplicationController

data/app/helpers/ez/settings/application_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez
   module Settings
     module ApplicationHelper

data/app/models/ez/settings/active_record_store.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Ez
+  module Settings
+    class ActiveRecordStore < Ez::Settings::ApplicationRecord
+      self.table_name = Ez::Settings.config.active_record_table_name || :ez_settings
+
+      validates :key, uniqueness: { scope: :group }
+    end
+  end
+end

data/app/models/ez/settings/application_record.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez
   module Settings
     class ApplicationRecord < ActiveRecord::Base

data/config/routes.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Ez::Settings::Engine.routes.draw do
   scope module: 'ez/settings' do
     root to: 'settings#index'

data/lib/ez/settings.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'ez/settings/engine'
 
 require 'ez/registry'

data/lib/ez/settings/accessors.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez::Settings
   NotRegistredInterfaceError = Class.new(StandardError)
   NotRegistredGroupError     = Class.new(StandardError)

data/lib/ez/settings/backend/active_record.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'active_record'
+
+module Ez::Settings
+  module Backend
+    class ActiveRecord
+      def read
+        return {} unless try_db_connection && check_settings_table
+
+        ActiveRecordStore.all.each_with_object({}) do |settings, hsh|
+          hsh[settings.group] ||= {}
+          hsh[settings.group][settings.key] = settings.value
+        end.deep_symbolize_keys
+      end
+
+      def write(data)
+        return unless try_db_connection && check_settings_table
+
+        group = data.keys[0]
+        pairs = data.values[0]
+        existing_settings = ActiveRecordStore.where(group: group, key: pairs.keys)
+        pairs.map do |key, value|
+          record(existing_settings, key, value) || ActiveRecordStore.new(group: group, key: key, value: value)
+        end.each(&:save!)
+      end
+
+      private
+
+      def record(existing_settings, key, value)
+        record = existing_settings.find { |r| r.key == key.to_s }
+
+        return unless record
+
+        record.tap { |r| r.value = value }
+      end
+
+      def try_db_connection
+        ::ActiveRecord::Base.connection
+      rescue ::ActiveRecord::NoDatabaseError
+        message('Database does not exist')
+        false
+      end
+
+      def check_settings_table
+        settings_table = Ez::Settings.config.active_record_table_name || :ez_settings
+        if ::ActiveRecord::Base.connection.data_source_exists?(settings_table)
+          return true
+        end
+
+        message("Table #{settings_table} does not exists. Please, check migrations")
+        false
+      end
+
+      def message(txt, level = 'WARN')
+        STDOUT.puts("[#{level}] Ez::Settings: #{txt}")
+      end
+    end
+  end
+end

data/lib/ez/settings/backend/file_system.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'yaml'
 require 'active_support/hash_with_indifferent_access'
 

data/lib/ez/settings/backend/redis.rb

@@ -1,37 +1,36 @@
+# frozen_string_literal: true
+
 require 'json'
-require 'redis'
 require 'active_support/hash_with_indifferent_access'
 
 module Ez::Settings
   module Backend
     class Redis
       PREFIX = 'ez:settings'
+      NAMESPACE = 'config'
+
+      attr_reader :connection, :namespace
 
-      def initialize(namespace)
+      def initialize(connection, namespace: NAMESPACE)
+        @connection = connection
         @namespace = namespace
       end
 
       def read
-        value = client.get(key)
+        value = connection.get(key)
         value.nil? ? {} : JSON.parse(value).deep_symbolize_keys
       end
 
       def write(data)
         new_data = read.merge(data)
-        client.set(key, JSON.generate(new_data))
+        connection.set(key, JSON.generate(new_data))
       end
 
       private
 
-      attr_reader :namespace
-
       def key
         @key ||= "#{PREFIX}:#{namespace}"
       end
-
-      def client
-        @client ||= ::Redis.current
-      end
     end
   end
 end

data/lib/ez/settings/config.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'ez/configurator'
 
 module Ez::Settings

data/lib/ez/settings/engine.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'cells-rails'
 require 'cells-slim'
 require 'simple_form'

data/lib/ez/settings/interface.rb

@@ -1,9 +1,12 @@
+# frozen_string_literal: true
+
 require_relative 'interface/group'
 require_relative 'interface/key'
 require_relative 'store'
 
 require 'ez/configurator'
 require 'ez/settings/backend/file_system'
+require 'ez/settings/backend/active_record'
 
 module Ez::Settings
   class Interface
@@ -29,11 +32,12 @@ module Ez::Settings
 
     def initialize(name)
       @name = name
-      @keys, @groups = [], []
+      @keys = []
+      @groups = []
     end
 
     def define(&block)
-      self.instance_eval(&block)
+      instance_eval(&block)
     end
 
     def group(name, options = {}, &block)

data/lib/ez/settings/interface/group.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'key'
 require_relative '../store'
 

data/lib/ez/settings/interface/key.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez::Settings
   class Interface
     class Key
@@ -21,8 +23,8 @@ module Ez::Settings
       end
 
       # Alias all boolean-like options to predicates methods, please
-      alias_method :ui?,       :ui
-      alias_method :required?, :required
+      alias ui? ui
+      alias required? required
     end
   end
 end

data/lib/ez/settings/request_dispatcher.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Ez
   module Settings
     module RequestDispatcher
@@ -8,7 +10,7 @@ module Ez
 
         # TODO: add raise exception in nil
         Ez::Registry.data(:settings_interfaces).find do |interface|
-          interface.name ==  params[:ez_settings_interface].to_sym
+          interface.name == params[:ez_settings_interface].to_sym
         end
       end
 

data/lib/ez/settings/routes.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class ActionDispatch::Routing::Mapper
   def ez_settings_for(interface)
     defaults ez_settings_interface: interface do

data/lib/ez/settings/store.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'active_model'
 
 require 'ez/settings/config'
@@ -23,7 +25,7 @@ module Ez::Settings
       @errors = ActiveModel::Errors.new(self)
 
       group.keys.select(&:required?).each do |key|
-        errors.add(key.name, "can't be blank") if self.send(key.name).blank?
+        errors.add(key.name, "can't be blank") if send(key.name).blank?
       end
     end
 
@@ -36,12 +38,12 @@ module Ez::Settings
     end
 
     def update(params)
-      params.each { |key, value| self.public_send("#{key}=", value) }
+      params.each { |key, value| public_send("#{key}=", value) }
 
       validate
       return self unless errors.empty?
 
-      on_change.call(changes(params)) if on_change
+      on_change&.call(changes(params))
 
       backend.write(schema)
 

data/lib/ez/settings/version.rb

@@ -1,5 +1,7 @@
+# frozen_string_literal: true
+
 module Ez
   module Settings
-    VERSION = '0.2.4'
+    VERSION = '0.4.0'
   end
 end

data/lib/generators/ez/settings/active_record_migrations_generator.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Ez::Settings
+  class ActiveRecordMigrationsGenerator < Rails::Generators::Base
+    def create_migration
+      create_file "db/migrate/#{Time.now.strftime('%Y%m%d%H%M%S')}_create_ez_settings.rb",
+                  "class CreateEzSettings < ActiveRecord::Migration[5.0]
+  def change
+    create_table :ez_settings do |t|
+      t.string :group, null: false
+      t.string :key, null: false
+      t.string :value, null: false
+
+      t.timestamps
+    end
+
+    add_index :ez_settings, :key
+    add_index :ez_settings, :group
+    add_index :ez_settings, [:key, :group], unique: true
+  end
+end
+"
+    end
+  end
+end

data/lib/generators/ez/settings/install_generator.rb

@@ -1,8 +1,10 @@
+# frozen_string_literal: true
+
 module Ez::Settings
   class InstallGenerator < Rails::Generators::Base
     def create_initializer_file
-      create_file "config/initializers/ez_settings.rb",
-        "# By default engine try to inherit from ApplicationController, but you could change this:
+      create_file 'config/initializers/ez_settings.rb',
+                  "# By default engine try to inherit from ApplicationController, but you could change this:
 # Ez::Settings.config.base_controller = 'Admin::BaseController'
 #
 # Then you should define settings interfaces (you can create as much as you need)
@@ -94,8 +96,8 @@ end"
     end
 
     def create_locale_file
-      create_file "config/locales/ez_settings.en.yml",
-        "en:
+      create_file 'config/locales/ez_settings.en.yml',
+                  "en:
   ez_settings:
     label: Ez Settings
     interfaces:
@@ -103,16 +105,19 @@ end"
         label: App Settings
         actions:
           save:
-            label: Save Settings
+            label: Update
           cancel:
-            label: Cancel Settings
+            label: Cancel
         groups:
           general:
             label: General
+            description: General settings of your application
           admin:
             label: Admin
+            description: Admin area settings
           showcase:
             label: Showcase
+            description: Just an example of possible settings UI elements
             keys:
               string:
                 label: String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ez-settings
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.4.0
 platform: ruby
 authors:
 - Volodya Sveredyuk
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-02 00:00:00.000000000 Z
+date: 2019-12-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ez-core
@@ -16,86 +16,78 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
-- !ruby/object:Gem::Dependency
-  name: rails
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 5.0.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 5.0.0
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: cells-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.8
+        version: 0.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.8
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: cells-slim
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.5
+        version: 0.0.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.5
+        version: 0.0.6
 - !ruby/object:Gem::Dependency
-  name: redis
+  name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.0
+    - - "<="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: 7.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: 5.0.0
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
 - !ruby/object:Gem::Dependency
   name: simple_form
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.5.0
+        version: 5.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.5.0
+        version: 5.0.1
 - !ruby/object:Gem::Dependency
-  name: sqlite3
+  name: capybara
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -109,7 +101,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec-rails
+  name: faker
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -123,7 +115,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: pry-rails
+  name: fakeredis
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -137,7 +129,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: generator_spec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -151,7 +143,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: capybara
+  name: guard-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -179,7 +171,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: faker
+  name: pry-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -193,7 +185,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: guard-rspec
+  name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -207,7 +199,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: generator_spec
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -221,7 +213,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: fakeredis
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -259,10 +251,12 @@ files:
 - app/controllers/ez/settings/application_controller.rb
 - app/controllers/ez/settings/settings_controller.rb
 - app/helpers/ez/settings/application_helper.rb
+- app/models/ez/settings/active_record_store.rb
 - app/models/ez/settings/application_record.rb
 - config/routes.rb
 - lib/ez/settings.rb
 - lib/ez/settings/accessors.rb
+- lib/ez/settings/backend/active_record.rb
 - lib/ez/settings/backend/file_system.rb
 - lib/ez/settings/backend/redis.rb
 - lib/ez/settings/config.rb
@@ -274,6 +268,7 @@ files:
 - lib/ez/settings/routes.rb
 - lib/ez/settings/store.rb
 - lib/ez/settings/version.rb
+- lib/generators/ez/settings/active_record_migrations_generator.rb
 - lib/generators/ez/settings/install_generator.rb
 homepage: https://github.com/ez-engines
 licenses:
@@ -294,8 +289,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: Easy settings engine for Rails app.