qonfig 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7f383ceef309126a60c17c1383cdfd3de9445aa5978ccb80374226dfd17e83c
-  data.tar.gz: 6f2f868550a9822b4feb8daff758a2a91d486903f9e57726c1045725fc658e55
+  metadata.gz: 881009df231adc7035ec25267ffe8d63a58a66878eb5017cc8a8f2084bd5753d
+  data.tar.gz: de6d094271c5a42737b1f868cb5e6ec61d4e1c15090bf69249f4147ae168ae15
 SHA512:
-  metadata.gz: bf030ed32f26241ebe6a8717e02e3b705d5f31e666c1096f19776c14e2db92f251e08ee12e668831a69bea51ce2fb40288791dbc4d8dfd19bc9fdd10c0505db8
-  data.tar.gz: 67e3f1712357a8de30e651271b8ca2dd2590af18cedd42ee57d48b86a755bfe15a0ea7ae59fea448212ae5fa798b19a12364acaa2fde588fc5778c33ef4d25c1
+  metadata.gz: d65fa945c02683ed445089bfec0f558eda6db5e34157ed315b781cf4410302b5c9a7908580f484ea82657a211674d1a04615291ec81e3fda127d45accf060858
+  data.tar.gz: 6dab7357d7315839c5aeeb8a3a67b53cda1ad535847635ba099f37a979d43517c1b464d85eb7b37bd85c5864c5ee6ac8eb3eadce5ea3bb7f23367a45b34fe30c

data/.gitignore

@@ -13,3 +13,4 @@ Gemfile.lock
 /.vscode/
 /spec/artifacts/
 /gemfiles/*.gemfile.lock
+*.gem

data/.rubocop.yml

@@ -13,3 +13,7 @@ AllCops:
     - qonfig.gemspec
     - bin/console
     - bin/rspec
+
+# NOTE: for code clarity in tests
+RSpec/LeakyConstantDeclaration:
+  Enabled: false

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.14.0] - 2019-08-28
+### Added
+- `expose_json`
+  - a command that provides an ability to define config settings by loading them from a json file
+    where the concrete settings depends on the chosen environment;
+  - works in `expose_yaml` manner;
+- `expose_self`
+  - a command that provides an ability to define config settings by loading them from the current file
+    where `__END__` instruction is defined (concrete settings dependes on the chosen environment);
+  - works with `YAML` format;
+
+### Changed
+- `Qonfig::Settings::Callbacks` is thread safe now;
+- Minor refactorings;
+
 ## [0.13.0] - 2019-08-13
 ### Added
 - Iteration over setting keys (`#each_setting { |key, value| }`, `#deep_each_setting { |key, value| }`);
@@ -14,6 +29,7 @@ All notable changes to this project will be documented in this file.
 - Support for **TOML** (`.toml`) format
   - realized as a plugin (`Qonfig.plugin(:toml)`);
   - provides `#save_to_toml`, `#load_from_toml`, `#expose_toml` methods and works in `#*_yaml`-like manner);
+  - depends on `gem toml-rb (>= 1)`
 - Custom `bin/rspec` command:
   - `bin/rspec -n` - run tests without plugin tests;
   - `bin/rspec -w` - run all tests;

data/README.md

@@ -36,6 +36,7 @@ require 'qonfig'
   - [State freeze](#state-freeze)
   - [Settings as Predicates](#settings-as-predicates)
 - [Validation](#validation)
+  - [Introduction](#introdaction)
   - [Key search pattern](#key-search-pattern)
   - [Proc-based validation](#proc-based-validation)
   - [Method-based validation](#method-based-validation)
@@ -44,16 +45,28 @@ require 'qonfig'
   - [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)
+  - [Expose JSON](#expose-json) (`Rails`-like environment-based JSON configs)
   - [Load from ENV](#load-from-env)
   - [Load from \_\_END\_\_](#load-from-__end__) (aka `load_from_self`)
+  - [Expose \_\_END\_\_](#expose-__end__) (aka `expose_self`)
   - [Save to JSON file](#save-to-json-file) (`save_to_json`)
   - [Save to YAML file](#save-to-yaml-file) (`save_to_yaml`)
 - [Plugins](#plugins)
   - [toml](#plugins-toml) (provides `load_from_toml`, `save_to_toml`, `expose_toml`)
+- [Roadmap](#roadmap)
 ---
 
 ## Definition
 
+- [Definition and Settings Access](#definition-and-access)
+- [Configuration](#configuration)
+- [Inheritance](#inheritance)
+- [Composition](#composition)
+- [Hash representation](#hash-representation)
+- [Smart Mixin](#smart-mixin) (`Qonfig::Configurable`)
+
+---
+
 ### Definition and Access
 
 ```ruby
@@ -396,9 +409,14 @@ GeneralApplication.config.to_h
 
 ---
 
-
 ## Interaction
 
+- [Iteration over setting keys](#iteration-over-setting-keys) (`#each_setting`, `#deep_each_setting`)
+- [Config reloading](#config-reloading) (reload config definitions and option values)
+- [Clear options](#clear-options) (set to nil)
+- [State freeze](#state-freeze)
+- [Settings as Predicates](#settings-as-predicates)
+
 ---
 
 ### Iteration over setting keys
@@ -407,7 +425,8 @@ GeneralApplication.config.to_h
   - iterates over the root setting keys;
 - `#deep_each_setting { |key, value| }`
   - iterates over all setting keys (deep inside);
-  - key object is represented as a string of `.`-joined keys;
+  - key object is represented as a string of `.`-joined setting key names;
+
 
 ```ruby
 class Config < Qonfig::DataSet
@@ -424,16 +443,24 @@ class Config < Qonfig::DataSet
 end
 
 config = Config.new
+```
+
+#### .each_setting
 
-# 1. #each_setting
+```ruby
 config.each_setting { |key, value| { key => value } }
+
 # result of each step:
 { 'db' => <Qonfig::Settings:0x00007ff8> }
 { 'telegraf_url' => 'udp://localhost:8094' }
 { 'telegraf_prefix' => 'test' }
+```
+
+#### .deep_each_setting
 
-# 2. #deep_each_setting
+```ruby
 config.deep_each_setting { |key, value| { key => value } }
+
 # result of each step:
 { 'db.creds.user' => 'D@iveR' }
 { 'db.creds.password' => 'test123' }
@@ -595,25 +622,32 @@ config.settings.database.engine.driver? # => true (true => true)
 
 ## Validation
 
+- [Introduction](#introduction)
+- [Key Search Pattern](#key-search-pattern)
+- [Proc-based validation](#proc-based-validation)
+- [Method-based validation](#method-based-validation)
+- [Predefined validations](#predefined-validations)
+
+---
+
+### Introduction
+
 Qonfig provides a lightweight DSL for defining validations and works in all cases when setting values are initialized or mutated.
-Settings are validated as keys (matched with a [specific string pattern](#key-search-patern)).
+Settings are validated as keys (matched with a [specific string pattern](#key-search-pattern)).
 You can validate both a set of keys and each key separately.
 If you want to check the config object completely you can define a custom validation.
 
 **Features**:
-
-- is invoked on any mutation of any setting key
+- validation is invoked on any mutation of any setting:
   - during dataset instantiation;
   - when assigning new values;
   - when calling `#reload!`;
   - when calling `#clear!`;
-
 - provides special [key search pattern](#key-search-pattern) for matching setting key names;
 - uses the [key search pattern](#key-search-pattern) for definging what the setting key should be validated;
 - you can define your own custom validation logic and validate dataset instance completely;
 - validation logic should return **truthy** or **falsy** value;
-
-- supprots two validation techniques (**proc-based** and **dataset-method-based**)
+- supprots two validation techniques (**proc-based** ([doc](#proc-based-validation)) and **dataset-method-based** ([doc](#method-based-validation))):
   - **proc-based** (`setting validation`)
     ```ruby
       validate 'db.user' do |value|
@@ -642,22 +676,23 @@ If you want to check the config object completely you can define a custom valida
         settings.user == User[1]
       end
     ```
-
-- provides a set of standard validations:
-  - `integer`
-  - `float`
-  - `numeric`
-  - `big_decimal`
-  - `boolean`
-  - `string`
-  - `symbol`
-  - `text` (string or symbol)
-  - `array`
-  - `hash`
-  - `proc`
-  - `class`
-  - `module`
-  - `not_nil`
+- provides a **set of standard validations** ([doc](#predefined-validations)):
+  - DSL: `validate 'key.pattern', :predefned_validator`;
+  - validators:
+    - `integer`
+    - `float`
+    - `numeric`
+    - `big_decimal`
+    - `boolean`
+    - `string`
+    - `symbol`
+    - `text` (string or symbol)
+    - `array`
+    - `hash`
+    - `proc`
+    - `class`
+    - `module`
+    - `not_nil`
 
 ---
 
@@ -818,12 +853,12 @@ config.settings.enabled = nil # => Qonfig::ValidationError (should be a boolean)
 
 ```ruby
 class Config < Qonfig::DataSet
-  setting :user
-  setting :password
+  setting :user, 'empty'
+  setting :password, 'empty'
 
   setting :service do
-    setting :provider
-    setting :protocol
+    setting :provider, :empty
+    setting :protocol, :empty
     setting :on_fail, -> { puts 'atata!' }
   end
 
@@ -851,6 +886,18 @@ config.settings.ignorance = nil # => Qonfig::ValidationError (cant be nil)
 
 ## Work with files
 
+- [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)
+- [Expose JSON](#expose-json) (`Rails`-like environment-based JSON configs)
+- [Load from ENV](#load-from-env)
+- [Load from \_\_END\_\_](#load-from-__end__) (aka `load_from_self`)
+- [Expose \_\_END\_\_](#expose-__end__) (aka `expose_self`)
+- [Save to JSON file](#save-to-json-file) (`save_to_json`)
+- [Save to YAML file](#save-to-yaml-file) (`save_to_yaml`)
+
+---
+
 ### Load from YAML file
 
 - supports `ERB`;
@@ -1097,6 +1144,120 @@ Config.new.to_h # => { "nonexistent_json" => {}, "another_key" => nil }
 
 ---
 
+### Expose JSON
+
+- load configurations from JSON file in Rails-like manner (with environments);
+- works in `load_from_jsom`/`expose_yaml` manner;
+- `via:` - how an environment will be determined:
+    - `:file_name`
+        - load configuration from JSON file that have an `:env` part in it's name;
+    - `:env_key`
+        - load configuration from JSON file;
+        - concrete configuration should be defined in the root key with `:env` name;
+- `env:` - your environment name (must be a type of `String`, `Symbol` or `Numeric`);
+- `strict:` - requires the existence of the file and/or key with the name of the used environment:
+    - `true`:
+        - file should exist;
+        - root key with `:env` name should exist (if `via: :env_key` is used);
+        - raises `Qonfig::ExposeError` if file does not contain the required env key (if `via: :env` key is used);
+        - raises `Qonfig::FileNotFoundError` if the required file does not exist;
+    - `false`:
+        - file is not required;
+        - root key with `:env` name is not required (if `via: :env_key` is used);
+
+#### Environment is defined as a root key of JSON file
+
+```json
+// config/project.json
+
+{
+  "development": {
+    "api_mode_enabled": true,
+    "logging": false,
+    "db_driver": "sequel",
+    "throttle_requests": false,
+    "credentials": {}
+  },
+  "test": {
+    "api_mode_enabled": true,
+    "logging": false,
+    "db_driver": "in_memory",
+    "throttle_requests": false,
+    "credentials": {}
+  },
+  "staging": {
+    "api_mode_enabled": true,
+    "logging": true,
+    "db_driver": "active_record",
+    "throttle_requests": true,
+    "credentials": {}
+  },
+  "production": {
+    "api_mode_enabled": true,
+    "logging": true,
+    "db_driver": "rom",
+    "throttle_requests": true,
+    "credentials": {}
+  }
+}
+```
+
+```ruby
+class Config < Qonfig::DataSet
+  expose_json 'config/project.json', via: :env_key, env: :production # load from production env
+
+  # NOTE: in rails-like application you can use this:
+  expose_json 'config/project.json', via: :env_key, env: Rails.env
+end
+
+config = Config.new
+
+config.settings.api_mode_enabled # => true (from :production subset of keys)
+config.settings.logging # => true (from :production subset of keys)
+config.settings.db_driver # => "rom" (from :production subset of keys)
+config.settings.throttle_requests # => true (from :production subset of keys)
+config.settings.credentials # => {} (from :production subset of keys)
+```
+
+#### Environment is defined as a part of JSON file name
+
+```json
+// config/sidekiq.staging.json
+{
+  "web": {
+    "username": "staging_admin",
+    "password": "staging_password"
+  }
+}
+```
+
+```json
+// config/sidekiq.production.json
+{
+  "web": {
+    "username": "urj1o2",
+    "password": "u192jd0ixz0"
+  }
+}
+```
+
+```ruby
+class SidekiqConfig < Qonfig::DataSet
+  # NOTE: file name should be described WITHOUT environment part (in file name attribute)
+  expose_json 'config/sidekiq.json', via: :file_name, env: :staging # load from staging env
+
+  # NOTE: in rails-like application you can use this:
+  expose_json 'config/sidekiq.json', via: :file_name, env: Rails.env
+end
+
+config = SidekiqConfig.new
+
+config.settings.web.username # => "staging_admin" (from sidekiq.staging.json)
+config.settings.web.password # => "staging_password" (from sidekiq.staging.json)
+```
+
+---
+
 ### Load from ENV
 
 - `:convert_values` (`false` by default):
@@ -1168,6 +1329,7 @@ config.settings['RUN_CI'] # => '1'
 ### Load from \_\_END\_\_
 
 - aka `load_from_self`
+- works with `YAML` format;
 
 ```ruby
 class Config < Qonfig::DataSet
@@ -1206,6 +1368,57 @@ connection_timeout:
 
 ---
 
+### Expose \_\_END\_\_
+
+- aka `expose_self`;
+- 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`);
+- works with `YAML` format;
+
+```ruby
+class Config < Qonfig::DataSet
+  expose_self env: :production
+
+  # NOTE: for Rails-like applications you can use this:
+  expose_self env: Rails.env
+end
+
+config = Config.new
+
+config.settings.log # => true (from :production environment)
+config.settings.api_enabled # => true (from :production environment)
+config.settings.creds.user # => "D@iVeR" (from :production environment)
+config.settings.creds.password # => "test123" (from :production environment)
+
+__END__
+default: &default
+  log: false
+  api_enabled: true
+  creds:
+    user: admin
+    password: 1234
+
+development:
+  <<: *default
+  log: true
+
+test:
+  <<: *default
+  log: false
+
+staging:
+  <<: *default
+
+production:
+  <<: *default
+  log: true
+  creds:
+    user: D@iVeR
+    password: test123
+```
+
+---
+
 ### Save to JSON file
 
 - `#save_to_json` - represents config object as a json structure and saves it to a file:
@@ -1360,6 +1573,10 @@ Qonfig.plugins # => array of strings
 Qonfig.plugin(:plugin_name) # or Qonfig.plugin('plugin_name')
 ```
 
+Provided plugins:
+
+- [toml](#plugins-toml) (provides `load_from_toml`, `save_to_toml`, `expose_toml`)
+
 ---
 
 ### Plugins: toml

data/lib/qonfig/commands/expose_json.rb

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.14.0
+class Qonfig::Commands::ExposeJSON < Qonfig::Commands::Base
+  # @return [Hash]
+  #
+  # @api private
+  # @since 0.14.0
+  EXPOSERS = { file_name: :file_name, env_key: :env_key }.freeze
+
+  # @return [Hash]
+  #
+  # @api private
+  # @since 0.14.0
+  EMPTY_JSON_DATA = {}.freeze
+
+  # @return [String]
+  #
+  # @api private
+  # @since 0.14.0
+  attr_reader :file_path
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.14.0
+  attr_reader :strict
+
+  # @return [Symbol]
+  #
+  # @api private
+  # @since 0.14.0
+  attr_reader :via
+
+  # @return [Symbol, String]
+  #
+  # @api private
+  # @since 0.14.0
+  attr_reader :env
+
+  # @param file_path [String]
+  # @option strict [Boolean]
+  # @option via [Symbol]
+  # @option env [String, Symbol]
+  #
+  # @api private
+  # @since 0.14.0
+  def initialize(file_path, strict: true, via:, env:)
+    unless env.is_a?(Symbol) || env.is_a?(String) || env.is_a?(Numeric)
+      raise Qonfig::ArgumentError, ':env should be a string or a symbol'
+    end
+
+    raise Qonfig::ArgumentError, ':env should be provided'  if env.to_s.empty?
+    raise Qonfig::ArgumentError, 'used :via is unsupported' unless EXPOSERS.key?(via)
+
+    @file_path = file_path
+    @strict    = strict
+    @via       = via
+    @env       = env
+  end
+
+  # @param data_set [Qonfig::DataSet]
+  # @param settings [Qonfig::Settings]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.14.0
+  def call(data_set, settings)
+    case via
+    when EXPOSERS[:file_name]
+      expose_file_name!(settings)
+    when EXPOSERS[:env_key]
+      expose_env_key!(settings)
+    end
+  end
+
+  private
+
+  # @param settings [Qonfig::Settings]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.14.0
+  # rubocop:disable Metrics/AbcSize
+  def expose_file_name!(settings)
+    # NOTE: transform file name (insert environment name into the file name)
+    #   from: path/to/file/file_name.file_extension
+    #   to:   path/to/file/file_name.env_name.file_extension
+
+    pathname = Pathname.new(file_path)
+    dirname  = pathname.dirname
+    extname  = pathname.extname.to_s
+    basename = pathname.basename.to_s.sub!(extname, '')
+    envname  = [env.to_s, extname].reject(&:empty?).join('')
+    envfile  = [basename, envname].reject(&:empty?).join('.')
+    realfile = dirname.join(envfile).to_s
+
+    json_data = load_json_data(realfile)
+    json_based_settings = build_data_set_klass(json_data).new.settings
+
+    settings.__append_settings__(json_based_settings)
+  end
+  # rubocop:enable Metrics/AbcSize
+
+  # @param settings [Qonfig::Settings]
+  # @return [void]
+  #
+  # @raise [Qonfig::ExposeError]
+  # @raise [Qonfig::IncompatibleJSONStructureError]
+  #
+  # @api private
+  # @since 0.14.0
+  # rubocop:disable Metrics/AbcSize
+  def expose_env_key!(settings)
+    json_data       = load_json_data(file_path)
+    json_data_slice = json_data[env] || json_data[env.to_s] || json_data[env.to_sym]
+    json_data_slice = EMPTY_JSON_DATA.dup if json_data_slice.nil? && !strict
+
+    raise(
+      Qonfig::ExposeError,
+      "#{file_path} file does not contain settings with <#{env}> environment key!"
+    ) unless json_data_slice
+
+    raise(
+      Qonfig::IncompatibleJSONStructureError,
+      'JSON content should have a hash-like structure'
+    ) unless json_data_slice.is_a?(Hash)
+
+    json_based_settings = build_data_set_klass(json_data_slice).new.settings
+
+    settings.__append_settings__(json_based_settings)
+  end
+  # rubocop:enable Metrics/AbcSize
+
+  # @param file_path [String]
+  # @return [Hash]
+  #
+  # @raise [Qonfig::IncompatibleJSONStructureError]
+  #
+  # @api private
+  # @since 0.14.0
+  def load_json_data(file_path)
+    Qonfig::Loaders::JSON.load_file(file_path, fail_on_unexist: strict).tap do |json_data|
+      raise(
+        Qonfig::IncompatibleJSONStructureError,
+        'JSON content should have a hash-like structure'
+      ) unless json_data.is_a?(Hash)
+    end
+  end
+
+  # @param json_data [Hash]
+  # @return [Class<Qonfig::DataSet>]
+  #
+  # @api private
+  # @since 0.14.0
+  def build_data_set_klass(json_data)
+    Qonfig::DataSet::ClassBuilder.build_from_hash(json_data)
+  end
+end

data/lib/qonfig/commands/expose_self.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.14.0
+class Qonfig::Commands::ExposeSelf < Qonfig::Commands::Base
+  # @return [String]
+  #
+  # @api private
+  # @since 0.14.0
+  attr_reader :caller_location
+
+  # @return [Symbol, String]
+  #
+  # @api private
+  # @since 0.14.0
+  attr_reader :env
+
+  # @param caller_location [String]
+  # @option env [String, Symbol]
+  #
+  # @api private
+  # @since 0.14.0
+  def initialize(caller_location, env:)
+    unless env.is_a?(Symbol) || env.is_a?(String)
+      raise Qonfig::ArgumentError, ':env should be a string or a symbol'
+    end
+
+    if env.to_s.empty?
+      raise Qonfig::ArgumentError, ':env should be provided'
+    end
+
+    @caller_location = caller_location
+    @env = env
+  end
+
+  # @param data_set [Qonfig::DataSet]
+  # @param settings [Qonfig::Settings]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.14.0
+  def call(data_set, settings)
+    yaml_data = load_self_placed_yaml_data
+    yaml_data_slice = yaml_data[env] || yaml_data[env.to_s] || yaml_data[env.to_sym]
+
+    raise(
+      Qonfig::ExposeError,
+      "#{file_path} file does not contain settings with <#{env}> environment key!"
+    ) unless yaml_data_slice
+
+    raise(
+      Qonfig::IncompatibleYAMLStructureError,
+      'YAML content should have a hash-like structure'
+    ) unless yaml_data_slice.is_a?(Hash)
+
+    yaml_based_settings = build_data_set_klass(yaml_data_slice).new.settings
+    settings.__append_settings__(yaml_based_settings)
+  end
+
+  private
+
+  # @return [Hash]
+  #
+  # @raise [Qonfig::SelfDataNotFound]
+  # @raise [Qonfig::IncompatibleYAMLStructureError]
+  #
+  # @api private
+  # @since 0.14.0
+  def load_self_placed_yaml_data
+    caller_file = caller_location.split(':').first
+
+    raise(
+      Qonfig::SelfDataNotFoundError,
+      "Caller file does not exist! (location: #{caller_location})"
+    ) unless File.exist?(caller_file)
+
+    data_match = IO.read(caller_file).match(/\n__END__\n(?<end_data>.*)/m)
+    raise Qonfig::SelfDataNotFoundError, '__END__ data not found!' unless data_match
+
+    end_data = data_match[:end_data]
+    raise Qonfig::SelfDataNotFoundError, '__END__ data not found!' unless end_data
+
+    yaml_data = Qonfig::Loaders::YAML.load(end_data)
+    raise(
+      Qonfig::IncompatibleYAMLStructureError,
+      'YAML content should have a hash-like structure'
+    ) unless yaml_data.is_a?(Hash)
+
+    yaml_data
+  end
+
+  # @param self_placed_yaml_data [Hash]
+  # @return [Class<Qonfig::DataSet>]
+  #
+  # @api private
+  # @since 0.14.0
+  def build_data_set_klass(self_placed_yaml_data)
+    Qonfig::DataSet::ClassBuilder.build_from_hash(self_placed_yaml_data)
+  end
+end

data/lib/qonfig/commands/expose_yaml.rb

@@ -97,7 +97,7 @@ class Qonfig::Commands::ExposeYAML < Qonfig::Commands::Base
     realfile = dirname.join(envfile).to_s
 
     yaml_data = load_yaml_data(realfile)
-    yaml_based_settings = build_data_set_class(yaml_data).new.settings
+    yaml_based_settings = build_data_set_klass(yaml_data).new.settings
 
     settings.__append_settings__(yaml_based_settings)
   end
@@ -127,7 +127,7 @@ class Qonfig::Commands::ExposeYAML < Qonfig::Commands::Base
       'YAML content should have a hash-like structure'
     ) unless yaml_data_slice.is_a?(Hash)
 
-    yaml_based_settings = build_data_set_class(yaml_data_slice).new.settings
+    yaml_based_settings = build_data_set_klass(yaml_data_slice).new.settings
 
     settings.__append_settings__(yaml_based_settings)
   end
@@ -154,7 +154,7 @@ class Qonfig::Commands::ExposeYAML < Qonfig::Commands::Base
   #
   # @api private
   # @since 0.7.0
-  def build_data_set_class(yaml_data)
+  def build_data_set_klass(yaml_data)
     Qonfig::DataSet::ClassBuilder.build_from_hash(yaml_data)
   end
 end

data/lib/qonfig/commands/load_from_env.rb

@@ -64,7 +64,7 @@ class Qonfig::Commands::LoadFromENV < Qonfig::Commands::Base
   def call(data_set, settings)
     env_data = extract_env_data
 
-    env_based_settings = build_data_set_class(env_data).new.settings
+    env_based_settings = build_data_set_klass(env_data).new.settings
 
     settings.__append_settings__(env_based_settings)
   end
@@ -90,7 +90,7 @@ class Qonfig::Commands::LoadFromENV < Qonfig::Commands::Base
   #
   # @api private
   # @since 0.2.0
-  def build_data_set_class(env_data)
+  def build_data_set_klass(env_data)
     Qonfig::DataSet::ClassBuilder.build_from_hash(env_data)
   end
 end

data/lib/qonfig/commands/load_from_json.rb

@@ -39,7 +39,7 @@ class Qonfig::Commands::LoadFromJSON < Qonfig::Commands::Base
       'JSON object should have a hash-like structure'
     ) unless json_data.is_a?(Hash)
 
-    json_based_settings = build_data_set_class(json_data).new.settings
+    json_based_settings = build_data_set_klass(json_data).new.settings
 
     settings.__append_settings__(json_based_settings)
   end
@@ -51,7 +51,7 @@ class Qonfig::Commands::LoadFromJSON < Qonfig::Commands::Base
   #
   # @api private
   # @since 0.5.0
-  def build_data_set_class(json_data)
+  def build_data_set_klass(json_data)
     Qonfig::DataSet::ClassBuilder.build_from_hash(json_data)
   end
 end

data/lib/qonfig/commands/load_from_yaml.rb

@@ -41,7 +41,7 @@ class Qonfig::Commands::LoadFromYAML < Qonfig::Commands::Base
       'YAML content should have a hash-like structure'
     ) unless yaml_data.is_a?(Hash)
 
-    yaml_based_settings = build_data_set_class(yaml_data).new.settings
+    yaml_based_settings = build_data_set_klass(yaml_data).new.settings
 
     settings.__append_settings__(yaml_based_settings)
   end
@@ -53,7 +53,7 @@ class Qonfig::Commands::LoadFromYAML < Qonfig::Commands::Base
   #
   # @api private
   # @since 0.2.0
-  def build_data_set_class(yaml_data)
+  def build_data_set_klass(yaml_data)
     Qonfig::DataSet::ClassBuilder.build_from_hash(yaml_data)
   end
 end

data/lib/qonfig/commands.rb

@@ -12,4 +12,6 @@ module Qonfig::Commands
   require_relative 'commands/load_from_self'
   require_relative 'commands/load_from_env'
   require_relative 'commands/expose_yaml'
+  require_relative 'commands/expose_json'
+  require_relative 'commands/expose_self'
 end

data/lib/qonfig/dsl.rb

@@ -119,4 +119,28 @@ module Qonfig::DSL
   def expose_yaml(file_path, strict: true, via:, env:)
     commands << Qonfig::Commands::ExposeYAML.new(file_path, strict: strict, via: via, env: env)
   end
+
+  # @param file_path [String]
+  # @option strict [Boolean]
+  # @option via [Symbol]
+  # @option env [Symbol, String]
+  # @return [void]
+  #
+  # @api public
+  # @since 0.14.0
+  def expose_json(file_path, strict: true, via:, env:)
+    commands << Qonfig::Commands::ExposeJSON.new(file_path, strict: strict, via: via, env: env)
+  end
+
+  # @option env [Symbol, String]
+  # @return [void]
+  #
+  # @see Qonfig::Commands::LoadFromSelf
+  #
+  # @api public
+  # @since 0.14.0
+  def expose_self(env:)
+    caller_location = caller(1, 1).first
+    commands << Qonfig::Commands::ExposeSelf.new(caller_location, env: env)
+  end
 end

data/lib/qonfig/plugins/toml/commands/expose_toml.rb

@@ -97,7 +97,7 @@ class Qonfig::Commands::ExposeTOML < Qonfig::Commands::Base
     realfile = dirname.join(envfile).to_s
 
     toml_data = load_toml_data(realfile)
-    toml_based_settings = build_data_set_class(toml_data).new.settings
+    toml_based_settings = builde_data_set_klass(toml_data).new.settings
 
     settings.__append_settings__(toml_based_settings)
   end
@@ -121,7 +121,7 @@ class Qonfig::Commands::ExposeTOML < Qonfig::Commands::Base
       "#{file_path} file does not contain settings with <#{env}> environment key!"
     ) unless toml_data_slice
 
-    toml_based_settings = build_data_set_class(toml_data_slice).new.settings
+    toml_based_settings = builde_data_set_klass(toml_data_slice).new.settings
 
     settings.__append_settings__(toml_based_settings)
   end
@@ -141,7 +141,7 @@ class Qonfig::Commands::ExposeTOML < Qonfig::Commands::Base
   #
   # @api private
   # @since 0.12.0
-  def build_data_set_class(toml_data)
+  def builde_data_set_klass(toml_data)
     Qonfig::DataSet::ClassBuilder.build_from_hash(toml_data)
   end
 end

data/lib/qonfig/plugins/toml/commands/load_from_toml.rb

@@ -33,7 +33,7 @@ class Qonfig::Commands::LoadFromTOML < Qonfig::Commands::Base
   # @since 0.12.0
   def call(data_set, settings)
     toml_data = Qonfig::Loaders::TOML.load_file(file_path, fail_on_unexist: strict)
-    toml_based_settings = build_data_set_class(toml_data).new.settings
+    toml_based_settings = build_data_set_klass(toml_data).new.settings
     settings.__append_settings__(toml_based_settings)
   end
 
@@ -44,7 +44,7 @@ class Qonfig::Commands::LoadFromTOML < Qonfig::Commands::Base
   #
   # @api private
   # @since 0.12.0
-  def build_data_set_class(toml_data)
+  def build_data_set_klass(toml_data)
     Qonfig::DataSet::ClassBuilder.build_from_hash(toml_data)
   end
 end

data/lib/qonfig/settings/builder.rb

@@ -25,9 +25,10 @@ module Qonfig::Settings::Builder
     # @api private
     # @since 0.13.0
     def build_mutation_callbacks(data_set)
+      validation_callback = proc { data_set.validate! }
+
       Qonfig::Settings::Callbacks.new.tap do |callbacks|
-        # NOTE: validation callbacks
-        callbacks.add(proc { data_set.validate! })
+        callbacks.add(validation_callback)
       end
     end
   end

data/lib/qonfig/settings/callbacks.rb

@@ -13,6 +13,7 @@ class Qonfig::Settings::Callbacks
   # @since 0.13.0
   def initialize
     @callbacks = []
+    @lock = Mutex.new
   end
 
   # @return [void]
@@ -20,7 +21,7 @@ class Qonfig::Settings::Callbacks
   # @api private
   # @since 0.13.0
   def call
-    callbacks.each(&:call)
+    thread_safe { callbacks.each(&:call) }
   end
 
   # @param callback [Proc, Qonfig::Settings::Callbacks, #call]
@@ -29,9 +30,8 @@ class Qonfig::Settings::Callbacks
   # @api private
   # @since 0.13.0
   def add(callback)
-    callbacks << callback
+    thread_safe { callbacks << callback }
   end
-  attr_reader :callback
 
   private
 
@@ -40,4 +40,12 @@ class Qonfig::Settings::Callbacks
   # @api private
   # @since 0.13.0
   attr_reader :callbacks
+
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.14.0
+  def thread_safe(&block)
+    @lock.owned? ? yield : @lock.synchronize(&block)
+  end
 end

data/lib/qonfig/version.rb

@@ -5,5 +5,5 @@ module Qonfig
   #
   # @api public
   # @since 0.1.0
-  VERSION = '0.13.0'
+  VERSION = '0.14.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: qonfig
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-13 00:00:00.000000000 Z
+date: 2019-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: coveralls
@@ -140,6 +140,8 @@ files:
 - lib/qonfig/commands/add_option.rb
 - lib/qonfig/commands/base.rb
 - lib/qonfig/commands/compose.rb
+- lib/qonfig/commands/expose_json.rb
+- lib/qonfig/commands/expose_self.rb
 - lib/qonfig/commands/expose_yaml.rb
 - lib/qonfig/commands/load_from_env.rb
 - lib/qonfig/commands/load_from_env/value_converter.rb