qonfig 0.24.0 → 0.27.0

data/spec/features/iteration_over_setting_keys_spec.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+describe 'Iteration over setting keys (#each_setting / #deep_each_setting)' do
+  let(:config) do
+    Class.new(Qonfig::DataSet) do
+      setting :db do
+        setting :creds do
+          setting :user, 'D@iVeR'
+          setting :password, 'test123'
+          setting :data, test: false
+        end
+      end
+
+      setting :telegraf_url, 'udp://localhost:8094'
+      setting :telegraf_prefix, 'test'
+    end.new
+  end
+
+  specify '#each_setting provides ("key" => value) format' do
+    key_value_pairs = {}.tap do |pairs|
+      config.each_setting do |setting_key, setting_value|
+        pairs[setting_key] = setting_value
+      end
+    end
+
+    expect(key_value_pairs).to match(
+      'db' => config.settings.db,
+      'telegraf_url' => 'udp://localhost:8094',
+      'telegraf_prefix' => 'test'
+    )
+  end
+
+  specify '#deep_each_setting provides ("key.sub_key.subkey" => value) format' do
+    key_value_pairs = {}.tap do |pairs|
+      config.deep_each_setting do |setting_key, setting_value|
+        pairs[setting_key] = setting_value
+      end
+    end
+
+    expect(key_value_pairs).to match(
+      'db.creds.user' => 'D@iVeR',
+      'db.creds.password' => 'test123',
+      'db.creds.data' => { test: false },
+      'telegraf_url' => 'udp://localhost:8094',
+      'telegraf_prefix' => 'test'
+    )
+  end
+end

data/spec/features/load_from_env_spec.rb

@@ -0,0 +1,240 @@
+# frozen_string_literal: true
+
+describe 'Load from ENV' do
+  specify 'defines config object by ENV data' do
+    ENV['QONFIG_SPEC_TRUE_VALUE_V1'] = 'true'
+    ENV['QONFIG_SPEC_TRUE_VALUE_V2'] = 't'
+    ENV['QONFIG_SPEC_TRUE_VALUE_V3'] = 'TRUE'
+    ENV['QONFIG_SPEC_TRUE_VALUE_V4'] = 'T'
+
+    ENV['QONFIG_SPEC_FALSE_VALUE_V1'] = 'false'
+    ENV['QONFIG_SPEC_FALSE_VALUE_V2'] = 'f'
+    ENV['QONFIG_SPEC_FALSE_VALUE_V3'] = 'FALSE'
+    ENV['QONFIG_SPEC_FALSE_VALUE_V4'] = 'F'
+
+    ENV['QONFIG_SPEC_INTEGER_VALUE'] = '1'
+    ENV['QONFIG_SPEC_FLOAT_VALUE']   = '1.55'
+
+    ENV['QONFIG_SPEC_ARRAY_VALUE_V1'] = 'true, t, TRUE ,T , false,f,FALSE,f'
+    ENV['QONFIG_SPEC_ARRAY_VALUE_V2'] = '1, 2, 3.4, 5.6 ,0.0'
+    ENV['QONFIG_SPEC_ARRAY_VALUE_V3'] = 'Qonfig,Settings,DSL'
+
+    ENV['QONFIG_SPEC_QUOTED_STRING_VALUE_V1'] = '"test, please"'
+    ENV['QONFIG_SPEC_QUOTED_STRING_VALUE_V2'] = "'please, test'"
+
+    ENV['QONFIG_SPEC_GENERIC_VALUE_V1'] = '1,66'
+    ENV['QONFIG_SPEC_GENERIC_VALUE_V2'] = '123.456trueTRUEfalseFALSEtTfF.123'
+
+    ENV['NON_QONFIG_SPEC_GENERIC_VALUE'] = 'test'
+
+    class EnvConfig < Qonfig::DataSet
+      setting :default do
+        load_from_env
+      end
+
+      setting :converted do
+        load_from_env convert_values: true
+      end
+
+      setting :prefixed do
+        load_from_env prefix: 'QONFIG_SPEC'
+      end
+
+      setting :prefix_regexp do
+        load_from_env prefix: /\Aqonfig.*\z/i
+      end
+
+      setting :trimmed_prefix do
+        load_from_env prefix: 'QONFIG_SPEC_', trim_prefix: true
+      end
+
+      setting :all_in do
+        load_from_env convert_values: true, prefix: 'QONFIG_SPEC_', trim_prefix: true
+      end
+    end
+
+    config = EnvConfig.new
+
+    # rubocop:disable Layout/LineLength, Naming/VariableNumber
+    expect(config[:default][:QONFIG_SPEC_TRUE_VALUE_V1]).to          eq('true')
+    expect(config[:default][:QONFIG_SPEC_TRUE_VALUE_V2]).to          eq('t')
+    expect(config[:default][:QONFIG_SPEC_TRUE_VALUE_V3]).to          eq('TRUE')
+    expect(config[:default][:QONFIG_SPEC_TRUE_VALUE_V4]).to          eq('T')
+    expect(config[:default][:QONFIG_SPEC_FALSE_VALUE_V1]).to         eq('false')
+    expect(config[:default][:QONFIG_SPEC_FALSE_VALUE_V2]).to         eq('f')
+    expect(config[:default][:QONFIG_SPEC_FALSE_VALUE_V3]).to         eq('FALSE')
+    expect(config[:default][:QONFIG_SPEC_FALSE_VALUE_V4]).to         eq('F')
+    expect(config[:default][:QONFIG_SPEC_INTEGER_VALUE]).to          eq('1')
+    expect(config[:default][:QONFIG_SPEC_FLOAT_VALUE]).to            eq('1.55')
+    expect(config[:default][:QONFIG_SPEC_GENERIC_VALUE_V1]).to       eq('1,66')
+    expect(config[:default][:QONFIG_SPEC_GENERIC_VALUE_V2]).to       eq('123.456trueTRUEfalseFALSEtTfF.123')
+    expect(config[:default][:QONFIG_SPEC_ARRAY_VALUE_V1]).to         eq('true, t, TRUE ,T , false,f,FALSE,f')
+    expect(config[:default][:QONFIG_SPEC_ARRAY_VALUE_V2]).to         eq('1, 2, 3.4, 5.6 ,0.0')
+    expect(config[:default][:QONFIG_SPEC_ARRAY_VALUE_V3]).to         eq('Qonfig,Settings,DSL')
+    expect(config[:default][:QONFIG_SPEC_QUOTED_STRING_VALUE_V1]).to eq('"test, please"')
+    expect(config[:default][:QONFIG_SPEC_QUOTED_STRING_VALUE_V2]).to eq("'please, test'")
+    expect(config[:default][:NON_QONFIG_SPEC_GENERIC_VALUE]).to      eq('test')
+
+    expect(config[:converted][:QONFIG_SPEC_TRUE_VALUE_V1]).to          eq(true)
+    expect(config[:converted][:QONFIG_SPEC_TRUE_VALUE_V2]).to          eq(true)
+    expect(config[:converted][:QONFIG_SPEC_TRUE_VALUE_V3]).to          eq(true)
+    expect(config[:converted][:QONFIG_SPEC_TRUE_VALUE_V4]).to          eq(true)
+    expect(config[:converted][:QONFIG_SPEC_FALSE_VALUE_V1]).to         eq(false)
+    expect(config[:converted][:QONFIG_SPEC_FALSE_VALUE_V2]).to         eq(false)
+    expect(config[:converted][:QONFIG_SPEC_FALSE_VALUE_V3]).to         eq(false)
+    expect(config[:converted][:QONFIG_SPEC_FALSE_VALUE_V4]).to         eq(false)
+    expect(config[:converted][:QONFIG_SPEC_INTEGER_VALUE]).to          eq(1)
+    expect(config[:converted][:QONFIG_SPEC_FLOAT_VALUE]).to            eq(1.55)
+    expect(config[:converted][:QONFIG_SPEC_GENERIC_VALUE_V1]).to       eq([1, 66])
+    expect(config[:converted][:QONFIG_SPEC_GENERIC_VALUE_V2]).to       eq('123.456trueTRUEfalseFALSEtTfF.123')
+    expect(config[:converted][:QONFIG_SPEC_ARRAY_VALUE_V1]).to         eq([true, true, true, true, false, false, false, false])
+    expect(config[:converted][:QONFIG_SPEC_ARRAY_VALUE_V2]).to         eq([1, 2, 3.4, 5.6, 0.0])
+    expect(config[:converted][:QONFIG_SPEC_ARRAY_VALUE_V3]).to         eq(%w[Qonfig Settings DSL])
+    expect(config[:converted][:QONFIG_SPEC_QUOTED_STRING_VALUE_V1]).to eq('test, please')
+    expect(config[:converted][:QONFIG_SPEC_QUOTED_STRING_VALUE_V2]).to eq('please, test')
+    expect(config[:converted][:NON_QONFIG_SPEC_GENERIC_VALUE]).to      eq('test')
+
+    expect(config[:prefixed][:QONFIG_SPEC_TRUE_VALUE_V1]).to          eq('true')
+    expect(config[:prefixed][:QONFIG_SPEC_TRUE_VALUE_V2]).to          eq('t')
+    expect(config[:prefixed][:QONFIG_SPEC_TRUE_VALUE_V3]).to          eq('TRUE')
+    expect(config[:prefixed][:QONFIG_SPEC_TRUE_VALUE_V4]).to          eq('T')
+    expect(config[:prefixed][:QONFIG_SPEC_FALSE_VALUE_V1]).to         eq('false')
+    expect(config[:prefixed][:QONFIG_SPEC_FALSE_VALUE_V2]).to         eq('f')
+    expect(config[:prefixed][:QONFIG_SPEC_FALSE_VALUE_V3]).to         eq('FALSE')
+    expect(config[:prefixed][:QONFIG_SPEC_FALSE_VALUE_V4]).to         eq('F')
+    expect(config[:prefixed][:QONFIG_SPEC_INTEGER_VALUE]).to          eq('1')
+    expect(config[:prefixed][:QONFIG_SPEC_FLOAT_VALUE]).to            eq('1.55')
+    expect(config[:prefixed][:QONFIG_SPEC_GENERIC_VALUE_V1]).to       eq('1,66')
+    expect(config[:prefixed][:QONFIG_SPEC_GENERIC_VALUE_V2]).to       eq('123.456trueTRUEfalseFALSEtTfF.123')
+    expect(config[:prefixed][:QONFIG_SPEC_ARRAY_VALUE_V1]).to         eq('true, t, TRUE ,T , false,f,FALSE,f')
+    expect(config[:prefixed][:QONFIG_SPEC_ARRAY_VALUE_V2]).to         eq('1, 2, 3.4, 5.6 ,0.0')
+    expect(config[:prefixed][:QONFIG_SPEC_ARRAY_VALUE_V3]).to         eq('Qonfig,Settings,DSL')
+    expect(config[:prefixed][:QONFIG_SPEC_QUOTED_STRING_VALUE_V1]).to eq('"test, please"')
+    expect(config[:prefixed][:QONFIG_SPEC_QUOTED_STRING_VALUE_V2]).to eq("'please, test'")
+    expect { config[:prefixed][:NON_QONFIG_SPEC_GENERIC_VALUE] }.to raise_error(Qonfig::UnknownSettingError)
+
+    expect(config[:prefix_regexp][:QONFIG_SPEC_TRUE_VALUE_V1]).to          eq('true')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_TRUE_VALUE_V2]).to          eq('t')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_TRUE_VALUE_V3]).to          eq('TRUE')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_TRUE_VALUE_V4]).to          eq('T')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_FALSE_VALUE_V1]).to         eq('false')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_FALSE_VALUE_V2]).to         eq('f')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_FALSE_VALUE_V3]).to         eq('FALSE')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_FALSE_VALUE_V4]).to         eq('F')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_INTEGER_VALUE]).to          eq('1')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_FLOAT_VALUE]).to            eq('1.55')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_GENERIC_VALUE_V1]).to       eq('1,66')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_GENERIC_VALUE_V2]).to       eq('123.456trueTRUEfalseFALSEtTfF.123')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_ARRAY_VALUE_V1]).to         eq('true, t, TRUE ,T , false,f,FALSE,f')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_ARRAY_VALUE_V2]).to         eq('1, 2, 3.4, 5.6 ,0.0')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_ARRAY_VALUE_V3]).to         eq('Qonfig,Settings,DSL')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_QUOTED_STRING_VALUE_V1]).to eq('"test, please"')
+    expect(config[:prefix_regexp][:QONFIG_SPEC_QUOTED_STRING_VALUE_V2]).to eq("'please, test'")
+    expect { config[:prefix_regexp][:NON_QONFIG_SPEC_GENERIC_VALUE] }.to raise_error(Qonfig::UnknownSettingError)
+
+    expect(config[:trimmed_prefix][:TRUE_VALUE_V1]).to          eq('true')
+    expect(config[:trimmed_prefix][:TRUE_VALUE_V2]).to          eq('t')
+    expect(config[:trimmed_prefix][:TRUE_VALUE_V3]).to          eq('TRUE')
+    expect(config[:trimmed_prefix][:TRUE_VALUE_V4]).to          eq('T')
+    expect(config[:trimmed_prefix][:FALSE_VALUE_V1]).to         eq('false')
+    expect(config[:trimmed_prefix][:FALSE_VALUE_V2]).to         eq('f')
+    expect(config[:trimmed_prefix][:FALSE_VALUE_V3]).to         eq('FALSE')
+    expect(config[:trimmed_prefix][:FALSE_VALUE_V4]).to         eq('F')
+    expect(config[:trimmed_prefix][:INTEGER_VALUE]).to          eq('1')
+    expect(config[:trimmed_prefix][:FLOAT_VALUE]).to            eq('1.55')
+    expect(config[:trimmed_prefix][:GENERIC_VALUE_V1]).to       eq('1,66')
+    expect(config[:trimmed_prefix][:GENERIC_VALUE_V2]).to       eq('123.456trueTRUEfalseFALSEtTfF.123')
+    expect(config[:trimmed_prefix][:ARRAY_VALUE_V1]).to         eq('true, t, TRUE ,T , false,f,FALSE,f')
+    expect(config[:trimmed_prefix][:ARRAY_VALUE_V2]).to         eq('1, 2, 3.4, 5.6 ,0.0')
+    expect(config[:trimmed_prefix][:ARRAY_VALUE_V3]).to         eq('Qonfig,Settings,DSL')
+    expect(config[:trimmed_prefix][:QUOTED_STRING_VALUE_V1]).to eq('"test, please"')
+    expect(config[:trimmed_prefix][:QUOTED_STRING_VALUE_V2]).to eq("'please, test'")
+    expect { config[:trimmed_prefix][:NON_QONFIG_SPEC_GENERIC_VALUE] }.to raise_error(Qonfig::UnknownSettingError)
+
+    expect(config[:all_in][:TRUE_VALUE_V1]).to          eq(true)
+    expect(config[:all_in][:TRUE_VALUE_V2]).to          eq(true)
+    expect(config[:all_in][:TRUE_VALUE_V3]).to          eq(true)
+    expect(config[:all_in][:TRUE_VALUE_V4]).to          eq(true)
+    expect(config[:all_in][:FALSE_VALUE_V1]).to         eq(false)
+    expect(config[:all_in][:FALSE_VALUE_V2]).to         eq(false)
+    expect(config[:all_in][:FALSE_VALUE_V3]).to         eq(false)
+    expect(config[:all_in][:FALSE_VALUE_V4]).to         eq(false)
+    expect(config[:all_in][:INTEGER_VALUE]).to          eq(1)
+    expect(config[:all_in][:FLOAT_VALUE]).to            eq(1.55)
+    expect(config[:all_in][:GENERIC_VALUE_V1]).to       eq([1, 66])
+    expect(config[:all_in][:GENERIC_VALUE_V2]).to       eq('123.456trueTRUEfalseFALSEtTfF.123')
+    expect(config[:all_in][:ARRAY_VALUE_V1]).to         eq([true, true, true, true, false, false, false, false])
+    expect(config[:all_in][:ARRAY_VALUE_V2]).to         eq([1, 2, 3.4, 5.6, 0.0])
+    expect(config[:all_in][:ARRAY_VALUE_V3]).to         eq(%w[Qonfig Settings DSL])
+    expect(config[:all_in][:QUOTED_STRING_VALUE_V1]).to eq('test, please')
+    expect(config[:all_in][:QUOTED_STRING_VALUE_V2]).to eq('please, test')
+    expect { config[:all_in][:NON_QONFIG_SPEC_GENERIC_VALUE] }.to raise_error(Qonfig::UnknownSettingError)
+    # rubocop:enable Layout/LineLength, Naming/VariableNumber
+  end
+
+  specify 'incorrect definition' do
+    incorrect_convert_value_option_values = [
+      123, '123', 'true', 't', 'false', 'f', Object.new, 123.5, Class.new
+    ]
+
+    incorrect_prefix_option_values = [
+      123, Object.new, 123.5, true, false, Class.new
+    ]
+
+    incorrect_trim_prefix_option_values = [
+      123, '123', 'true', 't', 'false', 'f', Object.new, 123.5, Class.new
+    ]
+
+    correct_convert_value_option_values = [true, false]
+    correct_prefix_option_values = [nil, 'qonfig', /\Aqonfig.*\z/i]
+    correct_trim_prefix_option_values = [true, false]
+
+    incorrect_convert_value_option_values.each do |incorrect_option|
+      expect do
+        Class.new(Qonfig::DataSet) do
+          load_from_env convert_values: incorrect_option
+        end
+      end.to raise_error(Qonfig::ArgumentError)
+    end
+
+    incorrect_prefix_option_values.each do |incorrect_option|
+      expect do
+        Class.new(Qonfig::DataSet) do
+          load_from_env prefix: incorrect_option
+        end
+      end.to raise_error(Qonfig::ArgumentError)
+    end
+
+    incorrect_trim_prefix_option_values.each do |incorrect_option|
+      expect do
+        Class.new(Qonfig::DataSet) do
+          load_from_env trim_prefix: incorrect_option
+        end
+      end.to raise_error(Qonfig::ArgumentError)
+    end
+
+    correct_convert_value_option_values.each do |correct_option|
+      expect do
+        Class.new(Qonfig::DataSet) do
+          load_from_env convert_values: correct_option
+        end
+      end.not_to raise_error
+    end
+
+    correct_prefix_option_values.each do |correct_option|
+      expect do
+        Class.new(Qonfig::DataSet) do
+          load_from_env prefix: correct_option
+        end
+      end.not_to raise_error
+    end
+
+    correct_trim_prefix_option_values.each do |correct_option|
+      expect do
+        Class.new(Qonfig::DataSet) do
+          load_from_env trim_prefix: correct_option
+        end
+      end.not_to raise_error
+    end
+  end
+end

data/spec/features/load_from_json_spec.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+describe 'Load from JSON' do
+  specify 'defines config object by json instructions' do
+    class JSONBasedConfig < Qonfig::DataSet
+      load_from_json SpecSupport.fixture_path('json_object_sample.json')
+
+      setting :nested do
+        load_from_json SpecSupport.fixture_path('json_object_sample.json')
+      end
+
+      setting :with_empty_objects do
+        load_from_json SpecSupport.fixture_path('json_with_empty_object.json')
+      end
+
+      setting :with_erb do
+        load_from_json SpecSupport.fixture_path('json_with_erb.json')
+      end
+    end
+
+    JSONBasedConfig.new.settings.tap do |conf|
+      expect(conf.user).to eq('D@iVeR')
+      expect(conf.maxAuthCount).to eq(55)
+      expect(conf.rubySettings.allowedVersions).to eq(['2.3', '2.4.2', '1.9.8'])
+      expect(conf.rubySettings.gitLink).to eq(nil)
+      expect(conf.rubySettings.withAdditionals).to eq(false)
+
+      expect(conf.nested.user).to eq('D@iVeR')
+      expect(conf.nested.maxAuthCount).to eq(55)
+      expect(conf.nested.rubySettings.allowedVersions).to eq(['2.3', '2.4.2', '1.9.8'])
+      expect(conf.nested.rubySettings.gitLink).to eq(nil)
+      expect(conf.nested.rubySettings.withAdditionals).to eq(false)
+
+      expect(conf.with_empty_objects.requirements).to eq({})
+      expect(conf.with_empty_objects.credentials.excluded).to eq({})
+
+      expect(conf.with_erb.count).to eq(10_000)
+      expect(conf.with_erb.credentials.excluded).to eq('some string here')
+    end
+  end
+
+  specify 'fails when json object has non-hash-like structure' do
+    class IncompatibleJSONConfig < Qonfig::DataSet
+      load_from_json SpecSupport.fixture_path('json_array_sample.json')
+    end
+
+    expect { IncompatibleJSONConfig.new }.to raise_error(Qonfig::IncompatibleJSONStructureError)
+  end
+
+  specify 'support for Pathname in file path' do
+    class PathanmeJSONLoadCheckConfig < Qonfig::DataSet
+      load_from_json Pathname.new(SpecSupport.fixture_path('json_object_sample.json'))
+    end
+
+    config = PathanmeJSONLoadCheckConfig.new
+
+    expect(config.settings.user).to eq('D@iVeR')
+    expect(config.settings.maxAuthCount).to eq(55)
+    expect(config.settings.rubySettings.allowedVersions).to eq(['2.3', '2.4.2', '1.9.8'])
+    expect(config.settings.rubySettings.gitLink).to eq(nil)
+    expect(config.settings.rubySettings.withAdditionals).to eq(false)
+  end
+
+  describe ':strict mode option (when file doesnt exist)' do
+    context 'when :strict => true (by default)' do
+      specify 'fails with corresponding error' do
+        # check default behaviour (strict: true)
+        class FailingJSONConfig < Qonfig::DataSet
+          load_from_json 'no_file.json'
+        end
+
+        expect { FailingJSONConfig.new }.to raise_error(Qonfig::FileNotFoundError)
+
+        class ExplicitlyStrictedJSONCOnfig < Qonfig::DataSet
+          load_from_json 'no_file.json', strict: true
+        end
+
+        expect { ExplicitlyStrictedJSONCOnfig.new }.to raise_error(Qonfig::FileNotFoundError)
+      end
+    end
+
+    context 'when :strict => false' do
+      specify 'does not fail - empty config' do
+        class NonFailingJSONConfig < Qonfig::DataSet
+          load_from_json 'no_file.json', strict: false
+
+          setting :nested do
+            load_from_json 'no_file.json', strict: false
+          end
+        end
+
+        expect { NonFailingJSONConfig.new }.not_to raise_error
+        expect(NonFailingJSONConfig.new.to_h).to eq('nested' => {})
+      end
+    end
+  end
+end

data/spec/features/load_from_self/format_option_json_spec.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+describe '#load_from_self => format: :json' do
+  specify ':json-format support' do
+    class JsonEndDataConfig < Qonfig::DataSet
+      load_from_self format: :json
+    end
+
+    config = JsonEndDataConfig.new
+
+    expect(config.settings.credentials.user).to eq('admin')
+    expect(config.settings.credentials.password).to eq('123')
+    expect(config.settings.credentials.enabled).to eq(true)
+    expect(config.settings.amount).to eq(123.456)
+    expect(config.settings.data).to eq(nil)
+    expect(config.settings.methods).to eq([1, 'test', nil, true, false, ['data']])
+  end
+end
+
+__END__
+
+{
+  "credentials": {
+    "user": "admin",
+    "password": "123",
+    "enabled": true
+  },
+  "amount": 123.456,
+  "data": null,
+  "methods": [1, "test", null, true, false, ["data"]]
+}

data/spec/features/load_from_self/format_option_unsupported_spec.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+describe '#load_from_self => format: <unsupported>' do
+  specify 'fails on unsupported formats' do
+    expect do
+      Class.new(Qonfig::DataSet) do
+        load_from_self format: :atata
+      end
+    end.to raise_error(Qonfig::UnsupportedLoaderFormatError)
+  end
+
+  specify 'fails on empty format parameter' do
+    expect do
+      Class.new(Qonfig::DataSet) do
+        load_from_self format: ''
+      end
+    end.to raise_error(Qonfig::UnsupportedLoaderFormatError)
+  end
+
+  specify 'fails on incorrect format parameter' do
+    expect do
+      Class.new(Qonfig::DataSet) do
+        load_from_self format: Object.new
+      end
+    end.to raise_error(Qonfig::ArgumentError)
+  end
+end

data/spec/features/load_from_self/format_option_yaml_spec.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+describe '#load_from_self => format: :yaml' do
+  specify ':yaml/:yml-format support' do
+    class YamlEndDataConfig < Qonfig::DataSet
+      setting :by_yml do
+        load_from_self format: :yml # the same as :yaml
+      end
+
+      setting :by_yaml do
+        load_from_self format: :yaml # the same as :yml
+      end
+    end
+
+    config = YamlEndDataConfig.new
+
+    # NOTE: format: :yml
+    expect(config.settings.by_yml.credentials.user).to eq('admin')
+    expect(config.settings.by_yml.credentials.password).to eq('123')
+    expect(config.settings.by_yml.credentials.enabled).to eq(true)
+    expect(config.settings.by_yml.amount).to eq(123.456)
+    expect(config.settings.by_yml.data).to eq(nil)
+    expect(config.settings.by_yml.methods).to eq([1, 'test', nil, true, false, ['data']])
+
+    # NOTE: format: :yaml
+    expect(config.settings.by_yaml.credentials.user).to eq('admin')
+    expect(config.settings.by_yaml.credentials.password).to eq('123')
+    expect(config.settings.by_yaml.credentials.enabled).to eq(true)
+    expect(config.settings.by_yaml.amount).to eq(123.456)
+    expect(config.settings.by_yaml.data).to eq(nil)
+    expect(config.settings.by_yaml.methods).to eq([1, 'test', nil, true, false, ['data']])
+  end
+end
+
+__END__
+
+credentials:
+  user: 'admin'
+  password: '123'
+  enabled: true
+amount: 123.456
+data: ~
+methods:
+  - 1
+  - 'test'
+  - ~
+  - true
+  - false
+  - ['data']

data/spec/features/load_from_self/with_erb_instructions_spec.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+describe 'Load from self (hash-like __END__ data representation with ERB inserts)' do
+  specify 'defines config object by self-contained __END__ yaml data with ERB inserts' do
+    class SelfDefinedWithErbConfig < Qonfig::DataSet
+      load_from_self
+    end
+
+    SelfDefinedWithErbConfig.new.settings.tap do |conf|
+      expect(conf.defaults.host).to eq('localhost')
+      expect(conf.defaults.user).to eq('0exp')
+      expect(conf.defaults.password).to eq('password4')
+      expect(conf.defaults.credentials).to eq({})
+
+      expect(conf.staging.host).to eq('yandex.ru')
+      expect(conf.staging.user).to eq('0exp')
+      expect(conf.staging.password).to eq('password4')
+      expect(conf.staging.credentials).to eq({})
+    end
+  end
+end
+
+__END__
+
+defaults: &defaults
+  host: localhost
+  user: <%= '0exp' %>
+  password: <%= "password#{(2 * 2)}" %>
+  credentials: <%= {} %>
+
+staging:
+  <<: *defaults
+  host: yandex.ru

data/spec/features/load_from_self/with_hash_like_data_representation_spec.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+describe 'Load from self (hash-like __END__ data representation)' do
+  specify 'defines config object by self-contained __END__ yaml data' do
+    class SelfDefinedConfig < Qonfig::DataSet
+      load_from_self # yaml format will be automatically resolved
+
+      setting :with_nesting do
+        load_from_self
+      end
+    end
+
+    SelfDefinedConfig.new.settings.tap do |conf|
+      # access via method
+      expect(conf.secret_key).to eq('top-mega-secret')
+      expect(conf.api_host).to eq('super.puper-google.com')
+      expect(conf.requirements).to eq({})
+      expect(conf.connection_timeout.seconds).to eq(10)
+      expect(conf.connection_timeout.enabled).to eq(false)
+      expect(conf.defaults.port).to eq(12_345)
+      expect(conf.defaults.host).to eq('localhost')
+      expect(conf.staging.port).to eq(12_345)
+      expect(conf.staging.host).to eq('google.kek')
+
+      # access via index
+      expect(conf['secret_key']).to eq('top-mega-secret')
+      expect(conf['api_host']).to eq('super.puper-google.com')
+      expect(conf['requirements']).to eq({})
+      expect(conf[:connection_timeout]['seconds']).to eq(10)
+      expect(conf[:connection_timeout]['enabled']).to eq(false)
+      expect(conf['defaults']['port']).to eq(12_345)
+      expect(conf['defaults']['host']).to eq('localhost')
+      expect(conf['staging']['port']).to eq(12_345)
+      expect(conf['staging']['host']).to eq('google.kek')
+
+      expect(conf.with_nesting.secret_key).to eq('top-mega-secret')
+      expect(conf.with_nesting.api_host).to eq('super.puper-google.com')
+      expect(conf.with_nesting.connection_timeout.seconds).to eq(10)
+      expect(conf.with_nesting.connection_timeout.enabled).to eq(false)
+      expect(conf.with_nesting.requirements).to eq({})
+
+      expect(conf[:with_nesting]['secret_key']).to eq('top-mega-secret')
+      expect(conf[:with_nesting]['api_host']).to eq('super.puper-google.com')
+      expect(conf[:with_nesting][:requirements]).to eq({})
+      expect(conf[:with_nesting][:connection_timeout]['seconds']).to eq(10)
+      expect(conf[:with_nesting][:connection_timeout]['enabled']).to eq(false)
+    end
+  end
+end
+
+__END__
+
+defaults: &defaults
+  port: 12345
+  host: 'localhost'
+
+staging:
+  <<: *defaults
+  host: 'google.kek'
+
+secret_key: top-mega-secret
+api_host: super.puper-google.com
+requirements: {}
+:connection_timeout:
+   seconds: 10
+   enabled: false

data/spec/features/load_from_self/with_non_hash_like_data_representation_spec.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+describe 'Load from self (non-hash-like __END__ data representation)' do
+  specify 'fails when yaml data is not represented as a hash' do
+    class IncompatibleSelfDataConfig < Qonfig::DataSet
+      load_from_self
+    end
+
+    expect { IncompatibleSelfDataConfig.new }.to raise_error(
+      Qonfig::IncompatibleEndDataStructureError
+    )
+  end
+end
+
+__END__
+
+- user
+- password
+- 123

data/spec/features/load_from_self/without_end_data_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+describe 'Load from self (without __END__ data)' do
+  specify 'fails when yaml data is not represented as a hash' do
+    class MissingSelfDataConfig < Qonfig::DataSet
+      load_from_self
+    end
+
+    expect { MissingSelfDataConfig.new }.to raise_error(Qonfig::SelfDataNotFoundError)
+  end
+end