qonfig 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0c47867d48b4170e321a53b70e527817db87b4dec1b7a4b464d352590501478
-  data.tar.gz: ddaa44855f051262fac8477a7ff736d43c896ade3c1c75ee4efa9a89d58ac555
+  metadata.gz: d8bb3c845cef4655af444f78682841a1d882176463aca7d05e6d156f64e70f38
+  data.tar.gz: 58e18c72976148f86eb6c9f845d976b69311ce3edbd5fe219a141accc9cec6a1
 SHA512:
-  metadata.gz: 220ba3ccc61ce56a09ef245b07c36a8a7e695688e57e98039882ecb8917fa83bca7fe5e075fd5b68d671639a04d7fe92ad600587c9a20717296675c6ecb8053b
-  data.tar.gz: 05cf1fcac1bdff9c4414530ab1561057b52cfc0903fd64c1af0962b49bd91702e662d2f0467494862ad0bda633842a05e3665d68a91fe61316760c97adbf8a31
+  metadata.gz: c201ccb87e62e2424f38784aefaae67410c1725c6c2a33f00126412f9d495c081c6b8faf4fbf52b17e9f2ae674b87b8454002eedafdf4f5209e328afe4892821
+  data.tar.gz: d7a6bb166580c9f8d8df2aba63cefbbc3251b2e84daf6ca9863442b585267459ba9b528327e484a86a26a4f5e031adaa911d3acfca36b3cf6d434e2aa50bd14d

data/.travis.yml

@@ -17,6 +17,9 @@ matrix:
   - rvm: jruby-head
     gemfile: gemfiles/with_external_deps.gemfile
     env: TEST_PLUGINS=true
+  - rvm: truffleruby
+    gemfile: gemfiles/with_external_deps.gemfile
+    env: TEST_PLUGINS=true
   - rvm: 2.4.9
     gemfile: gemfiles/without_external_deps.gemfile
   - rvm: 2.5.7
@@ -27,9 +30,12 @@ matrix:
     gemfile: gemfiles/without_external_deps.gemfile
   - rvm: jruby-head
     gemfile: gemfiles/without_external_deps.gemfile
+  - rvm: truffleruby
+    gemfile: gemfiles/without_external_deps.gemfile
   allow_failures:
   - rvm: ruby-head
   - rvm: jruby-head
+  - rvm: truffleruby
 sudo: false
 cache: bundler
 before_install: gem install bundler

data/CHANGELOG.md

@@ -1,6 +1,35 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [Unreleased]
+### Added
+- Brand new type of config objects `Qonfig::Compacted`:
+  - represents the compacted config object with setting readers and setting writers only;
+  - setting keys are represented as direct instace methods (`#settings` invokation does not need);
+  - no any other useful instance-based functionality;
+  - full support of `Qonfig::DataSet` DSL commands (`setting`, `validate`, `add_validator`, `load_from_x`/`expose_x` and etc);
+  - can be instantiated by:
+    - by existing config object: `Qonfig::DataSet#compacted` or `Qonfig::Compacted.build_from(config, &configuration)`
+    - by direct instantiation: `Qonfig::Compacted.new(settings_values = {}, &configuration)`;
+    - by implicit instance building without explicit class definition `Qonfig::Compacted.build(&dsl_commands) # => instance of Qonfig::Compacted`;
+- Added `Qonfig::DataSet.build_compacted` method: works in `Qonfig::DataSet.build` manner but returns compacted config object (`Qonfig::Compacted`);
+- Added missing `#[]=(key, value)` accessor-method for `Qonfig::DataSet` objects;
+- Added support for `do |config|` configuration block in `#load_from_self` / `#load_from_yaml` / `#load_from_json` / `#load_from_toml`
+  values-loading methods;
+- **Plugins** `pretty_print`:
+  - added missing beautification logic for `Qonfig::Settings` objects;
+  - added support for `Qonfig::Compacted` beautification;
+- `#valid_with?` now supports configuration block (`do |config|`);
+- `Import API`: support for predicate methods;
+
+### Changed
+- `.load_from_self`: default format was changed from `:yaml` to `:dynamic`;
+- `.expose_self`: default format was changed from `:yaml` to `:dynamic`;
+- Minor `Qonfig::DataSet` and `Qonfig::Settings::Builder` refactorings;
+
+### Fixed
+- Configs without any setting key can not be imported and exported by generic key patterns (`*` and `#`);
+
 ## [0.20.0] - 2019-12-01
 ### Added
 - Extended **Validation API**: you can define your own predefined validators via `.define_validator(name, &validation)` directive;

data/README.md

@@ -42,6 +42,17 @@ require 'qonfig'
   - [Hash representation](#hash-representation)
   - [Smart Mixin](#smart-mixin) (`Qonfig::Configurable`)
   - [Instantiation without class definition](#instantiation-without-class-definition) (`Qonfig::DataSet.build(&definitions)`)
+- [Compacted config](#compacted-config)
+  - [Definition and instantiation](#definition-and-instantiation)
+    - [by raw initialization](#by-raw-initialization)
+    - [by existing Qonfig::DataSet class](#by-existing-qonfigdataset-class)
+    - [by existing Qonfig::DataSet instance](#by-existing-qonfigdataset-instance)
+    - [instantiation without class definition](#instantiation-without-class-definition-1)
+    - [validation API](#validation-api-see-full-documentation)
+  - [Setting readers and writers](#setting-readers-and-writers)
+    - [reading](#reading-by-setting-name-and-index-method-with-dot-notation-support-and-indifferent-access)
+    - [writing](#writing-by-setting-name-and-index-method-with-dot-notation-support-and-indifferent-access)
+    - [precitaes](#predicates-see-full-documentation)
 - [Interaction](#interaction)
   - [Iteration over setting keys](#iteration-over-setting-keys) (`#each_setting`, `#deep_each_setting`)
   - [List of config keys](#list-of-config-keys) (`#keys`, `#root_keys`)
@@ -53,6 +64,12 @@ require 'qonfig'
   - [Run arbitrary code with temporary settings](#run-arbitrary-code-with-temporary-settings) (`#with(configs = {}, &arbitrary_code)`)
 - [Import settings / Export settings](#import-settings--export-settings)
   - [Import config settings](#import-config-settings) (`as instance methods`)
+    - [Import a set of setting keys (simple dot-noated key list)](#import-a-set-of-setting-keys-simple-dot-noated-key-list)
+    - [Import with custom method names (mappings)](#import-with-custom-method-names-mappings)
+    - [Prexify method name](#prexify-method-name)
+    - [Import nested settings as raw Qonfig::Settings objects](#import-nested-settings-as-raw-qonfigsettings-objects)
+    - [Import with pattern-matching](#import-with-pattern-matching)
+    - [Support for predicate-like methods](#support-for-predicate-like-methods)
   - [Export config settings](#export-config-settings) (`as singleton methods`)
 - [Validation](#validation)
   - [Introduction](#introduction)
@@ -64,6 +81,7 @@ require 'qonfig'
   - [Validation of potential setting values](#validation-of-potential-setting-values)
 - [Work with files](#work-with-files)
   - **Setting keys definition**
+    - `(DSL methods for dynamic setting keys definition by reading them from a file)`
     - [Load from YAML file](#load-from-yaml-file)
     - [Expose YAML](#expose-yaml) (`Rails`-like environment-based YAML configs)
     - [Load from JSON file](#load-from-json-file)
@@ -72,6 +90,7 @@ require 'qonfig'
     - [Load from \_\_END\_\_](#load-from-__end__) (aka `.load_from_self`)
     - [Expose \_\_END\_\_](#expose-__end__) (aka `.expose_self`)
   - **Setting values**
+    - `(instance methods for loading setting values from a file to existing config object with already defined setting keys)`
     - [Default setting values file](#default-setting-values-file)
     - [Load setting values from YAML file](#load-setting-values-from-yaml-file-by-instance)
     - [Load setting values from JSON file](#load-setting-values-from-json-file-by-instance)
@@ -99,9 +118,9 @@ require 'qonfig'
 
 ### Definition and Access
 
-- `setting(name, value)` - define setting with corresponding name and value;
-- `setting(name) { setting(name, value); ... }` - define nested settings OR reopen existing nested setting and define some new nested settings;
-- `re_setting(name, value)`, `re_setting(name) { ... }` - re-define existing setting (or define new if the original does not exist);
+- `setting(name, value = nil)` - define setting with corresponding name and value;
+- `setting(name) { setting(name, value = nil); ... }` - define nested settings OR reopen existing nested setting and define some new nested settings;
+- `re_setting(name, value = nil)`, `re_setting(name) { ... }` - re-define existing setting (or define new if the original does not exist);
 - accessing: [access via method](#access-via-method), [access via index-method \[\]](#access-via-index-method-),
   [.dig](#dig), [.slice](#slice), [.slice_value](#slice_value), [.subset](#subset);
 
@@ -599,6 +618,218 @@ config.settings.web_api # => "api.google.com"
 
 ---
 
+## Compacted config
+
+- [Definition and instantiation](#definition-and-instantiation)
+  - [by raw initialization](#by-raw-initialization)
+  - [by existing Qonfig::DataSet class](#by-existing-qonfigdataset-class)
+  - [by existing Qonfig::DataSet instance](#by-existing-qonfigdataset-instance)
+  - [instantiation without class definition](#instantiation-without-class-definition-1)
+  - [validation API](#validation-api-see-full-documentation)
+- [Setting readers and writers](#setting-readers-and-writers)
+  - [reading](#reading-by-setting-name-and-index-method-with-dot-notation-support-and-indifferent-access)
+  - [writing](#writing-by-setting-name-and-index-method-with-dot-notation-support-and-indifferent-access)
+  - [precitaes](#predicates-see-full-documentation)
+
+---
+
+- `Qonfig::Compacted`: represents the compacted config object with setting readers and setting writers;
+- setting keys are represented as direct instace methods (`#settings` invokation does not need);
+- no any other useful instance-based functionality - just setting readers, setting writers and setting predicates:
+- support for index-like access methods (`[]`,`[]=`);
+- full support of `Qonfig::DataSet` definition DSL commands:
+  - `setting`, `re_setting` [doc](#definition-and-access)
+  - `validate`, `add_validator` [doc](#validation)
+  - `load_from_self` [doc](#load-from-__end__), `load_from_yaml` [doc](#load-from-yaml-file), `load_from_json` [doc](#load-from-json-file), `load_from_toml` [doc](#plugins-toml);
+  - `expose_self` [doc](#expose-__end__), `expose_yaml` [doc](#expose-yaml), `expose_json` [doc](#expose-json), `expose_toml` [doc](#plugins-toml)
+  - `values_file` [doc](#default-setting-values-file)
+- support for validation of potential setting values `.valid_with?` [documentation](#validation-of-potential-setting-values);
+- can be instantiated by:
+  - by existing config object: `Qonfig::DataSet#compacted` or `Qonfig::Compacted.build_from(config, &configuration)`;
+  - from existing `Qonfig::DataSet` class: ``Qonfig::DataSet.build_compacted`;
+  - by direct instantiation: `Qonfig::Compacted.new(settings_values = {}, &configuration)`;
+  - by implicit instance building without explicit class definition `Qonfig::Compacted.build(&dsl_commands) # => instance of Qonfig::Compacted`;
+- you can define your own instance methods too;
+
+---
+
+### Definition and instantiation
+
+#### by raw initialization
+
+```ruby
+class Config < Qonfig::Compacted
+  setting :api, 'google.com'
+  setting :enabled, true
+  setting :queue do
+    setting :engine, :sidekiq
+  end
+end
+
+config = Config.new(api: 'yandex.ru') do |conf|
+  conf.enabled = false
+end
+
+config.api # => 'yandex.ru'
+config.enabled # => false
+config.queue.engine # => :sidekiq
+```
+
+#### by existing Qonfig::DataSet class
+
+```ruby
+class Config < Qonfig::DataSet
+  setting :api, 'google.com'
+  setting :enabled, true
+end
+
+config = Config.build_compacted # builds Qonfig::Compacted instance
+
+config.api # => 'google.com'
+config.enabled # => true
+```
+
+#### by existing Qonfig::DataSet instance
+
+- `Qonfig::DataSet#compacted`
+- (or) `Qonfig::Compacted.build_from(config)`
+
+```ruby
+class Config < Qonfig::DataSet
+  setting :api, 'google.com'
+  setting :enabled, true
+end
+
+config = Config.new
+
+compacted_config = config.compacted
+# --- or ---
+compacted_config = Qonfig::Compacted.build_from(config)
+
+compacted_config.api # => 'google.com'
+compacted_config.enabled # => true
+```
+
+#### instantiation without class definition
+
+```ruby
+config = Qonfig::Compacted.build do
+  setting :api, 'google.ru'
+  setting :enabled, true
+end
+
+config.api # => 'google.ru'
+config.enabled # => true
+```
+
+#### validation API (see [full documentation](#validation)):
+
+```ruby
+# custom validators
+Qonfig::Compacted.define_validator(:version_check) do |value|
+  value.is_a?(Integer) && value < 100
+end
+
+class Config < Qonfig::Compacted
+  setting :api, 'google.ru'
+  setting :enabled, true
+  setting :version, 2
+  setting :queue { setting :engine, :sidekiq }
+
+  # full support of original validation api
+  validate :api, :string, strict: true
+  validate :enabled, :boolean, strict: true
+  validate :version, :version_check # custom validator
+  validate 'queue.#', :symbol
+end
+
+# potential values validation
+Config.valid_with?(api: :yandex) # => false
+Config.valid_with?(enabled: nil) # => false
+Config.valid_with?(version: nil) # => false
+Config.valid_with?(api: 'yandex.ru', enabled: false, version: 3) # => true
+
+config = Config.new
+
+# instance validation
+config.api = :yandex # => Qonfig::ValidationError (should be a type of string)
+config.version = nil # => Qonfig::ValidationError (can not be nil)
+config.queue.engine = 'sneakers' # => Qonfig::ValidationError (should be a type of symbol)
+```
+
+---
+
+### Setting readers and writers
+
+```ruby
+class Config < Qonfig::Compcated
+  setting :api, 'google.ru'
+  setting :enabled, true
+  setting :queue do
+    setting :engine, :sidekiq
+    setting :workers_count, 10
+  end
+end
+
+config = Config.new
+```
+
+#### reading (by setting name and index method with dot-notation support and indifferent access)
+
+```ruby
+# by setting name
+config.api # => 'google.ru'
+config.enabled # => true
+config.queue.engine # => :sidekiq
+config.queue.workers_count # => 10
+
+# by index method with dot-notation support and indiffernt access
+config[:api] # => 'google.ru'
+config['enabled'] # => true
+config[:queue][:engine] # => :sidekiq
+config['queue.workers_count'] # => 10
+```
+
+#### writing (by setting name and index method with dot-notation support and indifferent access)
+
+```ruby
+# by setting name
+config.api = 'yandex.ru'
+config.queue.engine = :sidekiq
+# and etc
+
+# by index method with dot-notaiton support and indifferent access
+config['api'] = 'yandex.ru'
+config['queue.engine'] = :sidekiq
+config[:queue][:workers_count] = 5
+```
+
+#### predicates ([see full documentation](#settings-as-predicates))
+
+```ruby
+class Config < Qonfig::Compcated
+  setting :enabled, true
+  setting :api, 'yandex.ru'
+  setting :queue do
+    setting :engine, :sidekiq
+  end
+end
+
+config = Config.new
+
+config.enabled? # => true
+config.enabled = nil
+config.enabled? # => false
+
+config.queue.engine? # => true
+config.queue.engine =  nil
+config.queue.engine? # => false
+
+config.queue? # => true
+```
+
+---
+
 ## Interaction
 
 - [Iteration over setting keys](#iteration-over-setting-keys) (`#each_setting`, `#deep_each_setting`)
@@ -1057,6 +1288,9 @@ You can use RabbitMQ-like pattern matching in setting key names:
 - `Qonfig::Imports` - a special mixin that provides the convenient DSL to work with config import features (`.import_settings` method);
 - `.import_settings` - DSL method for importing configuration settings (from a config instance) as instance methods of a class;
 - (**IMPORTANT**) `import_settings` imports config settings as access methods to config's settings (creates `attr_reader`s for your config);
+- generated methods can be used as predicates (with trailing `?` symbol);
+- you can generate `attr_accessor`s by specifying `accessor: true` option
+  (be careful: you can get `Qonfig::AmbiguousSettingValueError` when you try to assign a value to config option which have nested settings);
 - signature: `.import_settings(config_object, *setting_keys, mappings: {}, prefix: '', raw: false)`
   - `config_object` - an instance of `Qonfig::DataSet` whose config settings should be imported;
   - `*setting_keys` - an array of dot-notaed config's setting keys that should be imported
@@ -1065,7 +1299,7 @@ You can use RabbitMQ-like pattern matching in setting key names:
   - `mappings:` - a map of keys that describes custom method names for each imported setting;
   - `prefix:` - prexifies setting access method name with custom prefix;
   - `raw:` - use nested settings as objects or hashify them (`false` by default (means "hashify nested settings"));
-
+  - `accessor:` - generate `attr_accessor` for imported config settigns (`false` by default (means "generate `attr_reader`s only"));
 ---
 
 Suppose we have a config with deeply nested keys:
@@ -1088,6 +1322,13 @@ end
 
 Let's see what we can to do :)
 
+- [Import a set of setting keys (simple dot-noated key list)](#import-a-set-of-setting-keys-simple-dot-noated-key-list)
+- [Import with custom method names (mappings)](#import-with-custom-method-names-mappings)
+- [Prexify method name](#prexify-method-name)
+- [Import nested settings as raw Qonfig::Settings objects](#import-nested-settings-as-raw-qonfigsettings-objects)
+- [Import with pattern-matching](#import-with-pattern-matching)
+- [Support for predicate-like methods](#support-for-predicate-like-methods)
+
 #### Import a set of setting keys (simple dot-noated key list)
 
 - last part of dot-notated key will become a name of the setting access instance method;
@@ -1145,10 +1386,30 @@ end
 
 service = ServiceObject.new
 
-service.config_credentials # => { login" => "D@iVeR", "auth_token" => "IAdkoa0@()1239uA" }
+service.config_account # => { login" => "D@iVeR", "auth_token" => "IAdkoa0@()1239uA" }
 service.config_secret_token # => "IAdkoa0@()1239uA"
 ```
 
+#### Support for predicate-like methods
+
+- generated methods can be used as predicates (with trailing `?` symbol);
+
+```ruby
+class ServiceObject
+  include Qonfig::Imports
+
+  import_settings(AppConfig,
+    'web_api.credentials.account',
+    mappings: { secret_token: 'web_api.credentials.account.auth_token' },
+  )
+end
+
+service = ServiceObject.new
+
+service.account? # => true
+service.secret_token? # => true
+```
+
 #### Import nested settings as raw Qonfig::Settings objects
 
 - `raw: false` is used by default (hashify nested settings)
@@ -1181,7 +1442,7 @@ service = ServiceObject.new
 service.credentials # => { "account" => { "login" => "D@iVeR", "auth_token" => "IAdkoa0@()1239uA"} }
 ```
 
-#### Immport with pattern-matching
+#### Import with pattern-matching
 
 - import root keys only: `import_settings(config_object, '*')`;
 - import all keys: `import_settings(config_object, '#')`;
@@ -1211,7 +1472,7 @@ class ServiceObject
   #   => service.graphql_api
 
   # import ALL keys
-  import_Settings(AppConfig, '#')
+  import_settings(AppConfig, '#')
   # generated instance methods:
   #   => service.web_api
   #   => service.credentials
@@ -1226,8 +1487,12 @@ end
 
 ### Export config settings
 
+- works in `.import_settings` manner [doc](#import-config-settings) (see examples and documentation above `:)`)
 - all config objects can export their settings to an arbitrary object as singleton methods;
 - (**IMPORTANT**) `export_settings` exports config settings as access methods to config's settings (creates `attr_reader`s for your config);
+- generated methods can be used as predicates (with trailing `?` symbol);
+- you can generate `attr_accessor`s by specifying `accessor: true` option
+  (be careful: you can get `Qonfig::AmbiguousSettingValueError` when you try to assign a value to config option which have nested settings);
 - signature: `#export_settings(exportable_object, *setting_keys, mappings: {}, prefix: '', raw: false)`:
   - `exportable_object` - an arbitrary object for exporting;
   - `*setting_keys` - an array of dot-notaed config's setting keys that should be exported
@@ -1236,7 +1501,7 @@ end
   - `mappings:` - a map of keys that describes custom method names for each exported setting;
   - `prefix:` - prexifies setting access method name with custom prefix;
   - `raw:` - use nested settings as objects or hashify them (`false` by default (means "hashify nested settings"));
-- works in `.import_settings` manner [doc](#import-config-settings) (see examples and documentation above `:)`)
+ - `accessor:` - generate `attr_accessor` for imported config settigns (`false` by default (means "generate `attr_reader`s only"));
 
 ```ruby
 class Config < Qonfig::DataSet
@@ -1258,12 +1523,16 @@ config = Config.new
 service = ServiceObject.new
 
 service.config_account # => NoMethodError
+```
 
+```ruby
 # NOTE: export settings as access methods to config's settings
 config.export_settings(service, 'web_api.credentials.account', prefix: 'config_')
 
 service.config_account # => { "login" => "D@iVeR", "auth_token" => "IAdkoa0@()1239uA" }
+```
 
+```ruby
 # NOTE: export settings with pattern matching
 config.export_settings(service, '*') # export root settings
 
@@ -1271,6 +1540,14 @@ service.web_api # => { 'credentials' => { 'account' => { ... } }, 'graphql_api'
 service.graphql_api # => false
 ```
 
+```ruby
+# NOTE: predicates
+config.export_settings(service, '*')
+
+config.web_api? # => true
+config.graphql_api? # => false
+```
+
 ---
 
 ## Validation
@@ -1573,11 +1850,12 @@ class Config < Qonfig::DataSet
 
   setting :admin # some key
 
-  validate :admin, :user_type # NOTE: useage
+  # NOTE: usage
+  validate :admin, :user_type
 end
 ```
 
-#### Defin new global validator
+#### Define new global validator
 
 ```ruby
 Qonfig::DataSet.define_validator(:secured_value) do |value|
@@ -1619,8 +1897,8 @@ end
 
 ### Validation of potential setting values
 
-- (**instance-level**) `#valid_with?(configurations = {})` - check that current config instalce will be valid with passed configurations;
-- (**class-level**) `.valid_with?(configurations = {})` - check that potential config instancess will be valid with passed configurations;
+- (**instance-level**) `#valid_with?(setting_values = {}, &configuration)` - check that current config instalce will be valid with passed configurations;
+- (**class-level**) `.valid_with?(setting_values = {}, &configuration)` - check that potential config instancess will be valid with passed configurations;
 - makes no assignments;
 
 #### #valid_with? (instance-level)
@@ -1641,6 +1919,12 @@ config = Config.new
 config.valid_with?(enabled: true, queue: { adapter: 'que' }) # => true
 config.valid_with?(enabled: 123) # => false (should be a type of boolean)
 config.valid_with?(enabled: true, queue: { adapter: Sidekiq }) # => false (queue.adapter should be a type of string)
+
+# do-config notation is supported too
+config.valid_with?(enabled: true) do |conf|
+  conf.queue.adapter = :sidekiq
+end
+# => false (queue.adapter should be a type of string)
 ```
 
 #### .valid_with? (class-level)
@@ -1659,6 +1943,12 @@ end
 Config.valid_with?(enabled: true, queue: { adapter: 'que' }) # => true
 Config.valid_with?(enabled: 123) # => false (should be a type of boolean)
 Config.valid_with?(enabled: true, queue: { adapter: Sidekiq }) # => false (queue.adapter should be a type of string)
+
+# do-config notation is supported too
+Config.valid_with?(enabled: true) do |config|
+  config.queue.adapter = :sidekiq
+end
+# => false (queue.adapter should be a type of string)
 ```
 
 ---
@@ -2117,13 +2407,14 @@ config.settings['RUN_CI'] # => '1'
 
 - aka `load_from_self`
 - `:format` - specify the format of data placed under the `__END__` instruction:
-  - `format: :yaml` - **YAML** format (by default);
+  - `format: :dynamic` (default) - automatic format resolvation;
+  - `format: :yaml` - **YAML** format;
   - `format: :json` - **JSON** format;
   - `format: :toml` - **TOML** format (via `toml`-plugin);
 
 ```ruby
 class Config < Qonfig::DataSet
-  load_from_self # on the root (format: :yaml is used by default)
+  load_from_self # on the root (:dynamic format is used by default)
 
   setting :nested do
     load_from_self, format: :yaml # with explicitly identified YAML format
@@ -2164,7 +2455,8 @@ connection_timeout:
 - works in `expose_json` and `expose_yaml` manner, but with `__END__` instruction of the current file;
 - `env:` - your environment name (must be a type of `String`, `Symbol` or `Numeric`);
 - `:format` - specify the format of data placed under the `__END__` instruction:
-  - `format: :yaml` - **YAML** format (by default);
+  - `format: :dynamic` (default) - automatic format resolvation;
+  - `format: :yaml` - **YAML** format;
   - `format: :json` - **JSON** format;
   - `format: :toml` - **TOML** format (via `toml`-plugin);
 
@@ -2333,10 +2625,11 @@ config = Config.new # => Qonfig::FileNotFoundError
 ### Load setting values from YAML file (by instance)
 
 - prvoides an ability to load predefined setting values from a yaml file;
-- `#load_from_yaml(file_path, strict: true, expose: nil)`
+- `#load_from_yaml(file_path, strict: true, expose: nil, &configurations)`
   - `file_path` - full file path or `:self` (`:self` means "load setting values from __END__ data");
   - `:strict` - rerquires that file (or __END__-data) should exist (`true` by default);
   - `:expose` - what the environment-based subset of keys should be used (`nil` means "do not use any subset of keys") (`nil` by default);
+  - `&configurations` - `do |config|` ability :)
 
 #### Default behavior
 
@@ -2431,10 +2724,11 @@ config.settings.creds.auth_token # => "kek.pek" (from config.yml)
 ### Load setting values from JSON file (by instance)
 
 - prvoides an ability to load predefined setting values from a json file;
-- `#load_from_yaml(file_path, strict: true, expose: nil)`
+- `#load_from_json(file_path, strict: true, expose: nil, &configurations)`
   - `file_path` - full file path or `:self` (`:self` means "load setting values from __END__ data");
   - `:strict` - rerquires that file (or __END__-data) should exist (`true` by default);
   - `:expose` - what the environment-based subset of keys should be used (`nil` means "do not use any subset of keys") (`nil` by default);
+  - `&configurations` - `do |config|` ability :)
 
 #### Default behavior
 
@@ -2539,11 +2833,12 @@ config.settings.creds.auth_token # => "kek.pek" (from config.json)
 ### Load setting values from \_\_END\_\_ (by instance)
 
 - prvoides an ability to load predefined setting values from `__END__` file section;
-- `#load_from_self(strict: true, expose: nil)`
+- `#load_from_self(strict: true, expose: nil, &configurations)`
   - `:format` - defines the format of file (`:dynamic` means "try to automatically infer the file format") (`:dynamic` by default);
     - supports `:yaml`, `:json`, `:toml` (via `Qonfig.plugin(:toml)`), `:dynamic` (automatic format detection);
   - `:strict` - requires that __END__-data should exist (`true` by default);
   - `:expose` - what the environment-based subset of keys should be used (`nil` means "do not use any subset of keys") (`nil` by default);
+  - `&configurations` - `do |config|` ability :)
 
 #### Default behavior
 
@@ -2627,12 +2922,13 @@ __END__
 
 - prvoides an ability to load predefined setting values from a file;
 - works in instance-based `#load_from_yaml` / `#load_from_json` / `#load_from_self` manner;
-- signature: `#load_from_file(file_path, format: :dynamic, strict: true, expose: nil)`:
+- signature: `#load_from_file(file_path, format: :dynamic, strict: true, expose: nil, &configurations)`:
   - `file_path` - full file path or `:self` (`:self` means "load setting values from __END__ data");
   - `:format` - defines the format of file (`:dynamic` means "try to automatically infer the file format") (`:dynamic` by default);
     - supports `:yaml`, `:json`, `:toml` (via `Qonfig.plugin(:toml)`), `:dynamic` (automatic format detection);
   - `:strict` - rerquires that file (or __END__-data) should exist (`true` by default);
   - `:expose` - what the environment-based subset of keys should be used (`nil` means "do not use any subset of keys") (`nil` by default);
+  - `&configurations` - `do |config|` ability :)
 - see examples for instance-based `#load_from_yaml` ([doc](#load-setting-values-from-yaml-by-instance)) / `#load_from_json` ([doc](#load-setting-values-from-json-by-instance)) / `#load_from_self` ([doc](#load-setting-values-from-__end__-by-instance));
 
 ---
@@ -2818,9 +3114,10 @@ Qonfig.enabled_plugins # => ["pretty_print"]
 
 ### Plugins: toml
 
+- `Qonfig.plugin(:toml)`
 - adds support for `toml` format ([specification](https://github.com/toml-lang/toml));
-- depends on `toml-rb` gem ([link](https://github.com/emancu/toml-rb));
-- supports TOML `0.5.0` format (dependency lock);
+- depends on `toml-rb` gem ([link](https://github.com/emancu/toml-rb)) (tested on `>= 2.0`);
+- supports TOML `0.5.0` format (dependency lock) (`toml-rb >= 2.0`);
 - provides `.load_from_toml` (works in `.load_from_yaml` manner ([doc](#load-from-yaml-file)));
 - provides `.expose_toml` (works in `.expose_yaml` manner ([doc](#expose-yaml)));
 - provides `#save_to_toml` (works in `#save_to_yaml` manner ([doc](#save-to-yaml-file))) (`toml-rb` has no native options);