complex_config 0.20.0 → 0.21.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a383ead2fa3f869b63ae75a7e32321a86027440d387942020721b8b68b1d081
-  data.tar.gz: 95e904f31eff85a43ec1c10ab255f0956152ef2208bc33f4c8a0a2d81eb49cbf
+  metadata.gz: 1be2d6a3e3fa81319f6455a9e4f158f45d096c322a3d224e8547fe81a4490b33
+  data.tar.gz: fc4bfec9fac1f616f51818f3bcd1ebf0ca4db5102d7430b09207339746472293
 SHA512:
-  metadata.gz: e77f6fc234a0c5e39cb51706d102252b8d809592529b6642b06931532849e9aa740fd395d325fc6e1e2172623677c1d3390fa2afcc012effaf8a01a440791aca
-  data.tar.gz: d5f857481ebf24869540d53aa31fe021f54ff1cd4759b935236e63d0c2305ced2be867c9e34f2997f5b3fdd6825cac028ef3d7722de409c0e307125d2c811e71
+  metadata.gz: 65f0b0f8c29597bda6a31a2c80285e02caeccb7068e184f8385dfa8849233623382a6667407328fcc3b2c5a91f108885daba55f4b4eb70f7ea7f1b241e82833a
+  data.tar.gz: 23fbb4f4bc736e10606cd001ec1af90bba397ad939720d148354e9fada7cbb4a0b6b849ffe7592d7692247a4d615d600f430ddbc39c11423d33e3ce360be902b

data/.all_images.yml

@@ -6,7 +6,7 @@ script: &script |-
   echo -e "\e[1m"
   ruby -v
   echo -e "\e[0m"
-  bundle
+  bundle install --full-index
   rake spec
 
 images:

data/CHANGES.md

@@ -0,0 +1,379 @@
+# Changes
+
+## 2024-09-09 v0.21.1
+
+* **API Changes**:
+  * The default string representation of ComplexConfig has been changed to a tree-like structure.
+  * The `to_s` method in ComplexConfig::Settings has been renamed to `list`.
+  * A new `list` method has been added to ComplexConfig::Settings for listing settings as a string.
+
+## 2024-09-09 v0.21.0
+
+* **Tree Representation**:
+	+ Add `Tree` class to convert complex config objects into trees.
+	+ Update `Settings` class to use `Tree` conversion in `to_tree` method.
+	+ Update tests to reflect changes.
+* **Components Array**: Add components array for flux capacitors
+* **Rakefile and Gemspec**:
+	- Add clobber task for coverage to Rakefile
+	- Update all_images script: update `bundle` to `bundle install --full-index`
+* **.gitignore**: Remove `.byebug_history` from ignored files
+* **Complex Config**:
+	+ Raise type error and add test for empty configuration file.
+	+ Update gemspec to use GemHadar 1.17.0
+	+ Add requirement for tins/xt/ask_and_send in complex_config/provider.rb
+	+ Add check for hash type in ComplexConfig::Settings#build method
+	+ Add test for reading from empty configuration file in provider_spec.rb
+	+ Replace byebug with debug in spec_helper.rb
+
+## 2024-04-17 v0.20.0
+
+#### Significant Changes
+
+* **Add dependency to base64**: The code now depends on the `base64` library,
+  which will be extracted from Ruby 3.4.
+* **Upgrade ruby and add debug gem**: The project has been upgraded to use a
+  newer version of Ruby and includes the `debug` gem for debugging purposes.
+* **Use newest ruby, drop the older 2.5 version**: The code now targets the
+  latest version of Ruby and no longer supports Ruby 2.5.
+
+#### Other Changes
+
+* Run specs: The project now runs its specifications as part of its build
+  process.
+* Test on newest ruby, on older ones don't: The project's tests are now run
+  only on the latest version of Ruby, with older versions being skipped.
+* Align: The code has been aligned to follow best practices.
+
+## 2022-07-11 v0.19.4
+
+* **Configuration File Handling Improvements**
+    + Replaced defaulting to `unsafe_load` with explicit usage, ensuring safer
+      handling of configuration files.
+
+## 2022-05-19 v0.19.3
+
+* **New Feature**: Pass parameters to json generator, allowing for more dynamic
+  and customizable JSON output.
+* **Improvement**: Use `all_images` for testing, improving the robustness and
+  accuracy of image-related tests.
+
+## 2021-10-28 v0.19.2
+
+* **New Psych Support**
+	+ Added support for newest Psych 4 library
+	+ Defaults to disabling YAML alias feature
+* **Psych API Update**
+	+ Updated code to use new Psych/YAML API when Psych version < 4
+	+ Retained behavior of evaluating aliases
+* **Ruby Version Bump**
+	+ Updated Ruby version in tool-versions to 3.0.2
+
+## 2021-04-09 v0.19.1
+
+* **Breaking Change**: Updated code to adapt to the new keyword interface of
+  ERB for Ruby versions greater than or equal to 3.
+
+## 2021-01-05 v0.19.0
+
+* Added two new methods:
+	+ `get_attribute_by_name`
+	+ `get_attributes_by_name`
+
+## 2020-08-26 v0.18.2
+
+* **Bug Fix**: Resolved a similar issue, mirroring the fix introduced in
+  version 0.18.1.
+
+## 2020-08-26 v0.18.1
+
+* **New Feature**: Added support for faking data, allowing users to simulate
+  scenarios without actual data.
+    + Implemented a new module `FakeIt` with methods for generating fake data.
+    + Updated relevant tests to include fake data scenarios.
+
+## 2020-01-07 v0.18.0
+
+* **New Version Summary**
+	+ Added support for Ruby 2.7.0
+	+ Updated tests to include Ruby 2.7.0
+	+ Refactored code to avoid string modifications
+* Significant Changes:
+	* Support added for Ruby 2.7.0
+	* Tests updated to include Ruby 2.7.0
+	* String modification stopped
+
+## 2019-11-27 v0.17.1
+
+* **Shared Settings Implementation**: The code now uses a more sane and
+  efficient approach for shared settings.
+
+## 2019-03-18 v0.17.0
+
+* **Decoding Fix**: Corrected the decoding issue to ensure proper data
+  interpretation.
+
+## 2019-03-18 v0.16.2
+
+* **New Feature**: Added support for handling complex scenarios
+	+ Implemented a new logic to handle intricate cases
+* Improved error handling and reporting
+	+ Enhanced logging to provide more detailed information about errors
+* Minor code refactoring
+	+ Simplified some conditional statements
+
+## 2019-03-18 v0.16.1
+
+* Improved error message for missing encryption key:
+    + Added more informative and user-friendly error message when encryption
+      key is not provided.
+
+## 2019-03-14 v0.16.0
+
+* **New Features**
+	+ Added support for `trim_mode` in legacy mode
+	+ Enabled `trim_mode` by default
+	+ Added `#to_json` method to settings objects
+* **Changes**
+	+ Updated code to use new `trim_mode` feature
+	+ Modified settings objects to include `#to_json` method
+
+## 2019-03-14 v0.15.1
+
+* **Fix**: Shared feature now works correctly even when the top-level settings
+  are empty.
+
+## 2018-12-07 v0.15.0
+
+* **New Feature**: Allow recrypting a file in-place with options.
+    + Added functionality to enable recrypting a file without creating a new
+      copy.
+
+## 2018-12-07 v0.14.1
+
+* **New Version**: Bumped version
+* **Improved Error Handling**:
+	+ Improved error handling if key isn't valid
+	+ Raises `ComplexConfig::DecryptionFailed` for encrypted files
+* **Compatibility**:
+	+ Make this run on older rubies
+* **Documentation**:
+	+ Cleanup documentation
+* **RubyGems**:
+	+ Use newest rubygems
+
+## 2018-06-07 v0.14.0
+
+* Added `complex_config` executable to handle configuration files.
+
+## 2018-02-23 v0.13.3
+
+* **Changes in Evaluation Order**
+	+ The evaluation order of key sources has been modified.
+
+## 2018-02-23 v0.13.2
+
+* **Compatibility improvements**
+	+ Be compatible with ancient rubies^3
+	+ Be compatible with ancient rubies^2
+	+ Be compatible with ancient rubies
+* **Refactoring**
+	+ Refactor key provision with source object
+
+## 2018-02-09 v0.13.1
+
+* **New Features**
+	+ Added information to README file
+* **Significant Changes**
+	+ Bumped version number
+	+ Improved error reporting for encrypted files with missing keys
+
+## 2018-01-26 v0.13.0
+
+* Improved the `write_config` interface
+* Added more tests
+
+## 2017-11-17 v0.12.2
+
+* **Output string keys on top level configs**: 
+  * Added functionality to output string keys on top level configurations.
+
+## 2017-11-17 v0.12.1
+
+* **New Feature**: Suppress newline output during encryption.
+
+## 2017-11-16 v0.12.0
+
+* **New Features**
+	+ Add support for writing configurations (encrypted or not)
+* **Version Bump**
+	+ Bump version to 0.12.0
+* **Compatibility Improvements**
+	+ Support older Rubies
+
+## 2017-11-02 v0.11.3
+
+* **New Feature:** Added striping functionality.
+* **Bug Fix:** Fixed issue where caches were not cleared when `deep_freeze` was
+  disabled.
+
+## 2017-10-30 v0.11.2
+
+* **Behavioral Fix**: 
+  * Fixed the behavior for incomplete key setup.
+
+## 2017-10-27 v0.11.1
+
+* Added support for shared features.
+
+## 2017-10-27 v0.11.0
+
+* **New Feature**: Support for encrypted YAML files, compatible with Rails'
+  encryption.
+* **Test Update**: Added testing to ensure compatibility with Ruby 2.4.2.
+
+## 2017-02-02 v0.10.0
+
+## 2017-01-23 v0.9.2
+
+* **New Version**: Released version 0.9.2.
+* **Performance Improvement**:
+	+ Memoized proxy object for improved performance.
+
+## 2016-11-23 v0.9.1
+
+* **New Features**
+	+ Use newest RubyGems
+	+ Test on Ruby 2.3.3
+* **Bug Fixes**
+	+ Fix Travis builds
+	+ travis fiddles with RAILS_ENV variable, breaking specs (resolved)
+* **Testing Improvements**
+	+ Test newer Rubies
+
+## 2016-11-22 v0.9.0
+
+* **Gem Update**: Updated to newest gem_hadar.
+* **Coverage Report**: Only send new coverage report on success.
+* **Manual Run**: We are supposed to run this manually now.
+* **Code Organization**: Moved provider shortcuts into its own module.
+
+## 2016-07-27 v0.8.0
+
+* **New Feature**: Added support for replacing attributes in
+  `ComplexConfig::Settings` using the `#replace_attributes` method.
+
+## 2016-07-18 v0.7.0
+
+* **New Features**
+	+ Added new date functionality
+* **Improvements**
+    + Simplified `ComplexConfig::Settings` interface by basing it on
+      `BasicObject` and reducing mixin usage
+* **Documentation**
+	+ Updated README.md with new changes
+
+## 2016-07-15 v0.6.0
+
+* **Caching Improvements**
+	+ Use `mize` for caching
+
+## 2016-06-23 v0.5.2
+
+* **Index Access Feature**
+	+ Fixed issue with incorrect indexing behavior (#56190d3)
+	+ Improved performance and reliability of index access functionality
+
+## 2016-06-23 v0.5.1
+
+* **New Features**
+    + Resolve index access via the plugin code path, making `foo.bar` and
+      `foo[:bar]` equivalent for a plugin key.
+    + Test on Ruby 2.3.1 and 2.4.0-preview1
+* **Infrastructure Changes**
+	+ Use new infrastructure
+* **Bug Fixes**
+	+ Fix typo
+
+## 2015-11-19 v0.5.0
+
+* **New Features**
+	+ Add configure method
+	+ Add configuration example to README
+* **Bug Fixes**
+	+ Flush cache for every request in rails development
+	+ Change the Changes
+* **Improvements**
+	+ Just always skip to avoid interference
+
+## 2015-11-17 v0.4.0
+
+* **New Feature:** Implemented root object method call syntax.
+
+## 2015-11-03 v0.3.1
+
+* **New Features**
+	+ Add missing tins dependency
+	+ Show improved settings output in README.md
+	+ Adds a decent string representation for ComplexConfig::Settings objects
+* **Dependency Updates**
+	+ Use newest gem hadar
+	+ Add some development_dependencies (including tins)
+* **Code Improvements**
+	+ Shorten codeclimate snippet
+
+## 2015-03-24 v0.3.0
+
+## 2015-03-24 v0.2.3
+
+* **Typo Fix**: Corrected a typo in the `LoadErro(r)` method.
+* **JRuby Update**: Updated JRuby version to use `jruby-head` and allowed it to
+  potentially fail.
+
+## 2015-02-25 v0.2.2
+
+* Removed unnecessary `sprintf` format.
+
+## 2015-01-28 v0.2.1
+
+* **New Version**: 
+  * Added support for JRuby test target
+  * Removed always broken jruby-head
+  * Bumped version number to 0.2.0
+  * Bumped version to 0.2.1
+* **Plugin Changes**:
+  * Skip the money plugin if monetize cannot be loaded (optional runtime
+    dependency)
+  * Remove require for plugins, allowing users to use the gem without requiring
+    the money gem
+  * Fixed requiring *with* plugins, enabling them to load correctly
+
+## 2015-01-27 v0.2.0
+
+* **New Features**
+	+ Added support for JRuby in tests
+	+ Updated to newest Ruby 2.2
+* **Improvements**
+    + Replaced mixin with delegation for Enumerable, allowing attribute names
+      like `zip`, `min`, or `max` without conflicts
+* **Documentation**
+	+ Added Apache license file
+
+## 2015-01-01 v0.1.1
+
+* **New Version Summary**
+	+ Use value from non-associative list arrays
+	+ Fix `puts` method to call `to_ary` correctly
+	+ Prevent cash leakage after flushing cache
+	+ Add `to_ary` method for level on demand
+
+## 2014-12-15 v0.1.0
+
+* **Significant Changes**:
+	+ Freeze cached configuration by default (versioning)
+	+ Add to-do list for future development
+	+ Integrate CodeClimate for code analysis and improvement
+
+## 2014-12-12 v0.0.0
+
+  * Start

data/README.md

@@ -30,21 +30,40 @@ Given a config file like this and named `config/products.yml`
           name: Flux Capacitor Version 2.0
           price_in_cents: 12_000_00
           manual_pdf_url: "http://brown-inc.com/manuals/fc_20.pdf"
+          components:
+            - Miniature Chrono-Levitation Chamber (mCLC)
+            - Single Gravitational Displacement Coil (SGDC)
+            - Simple Quantum Flux Transducer (SQFT)
+            - Basic Time-Space Navigation System (BTN)
         pro_version:
           name: Flux Capacitor Professional
           price_in_cents: 23_000_00
           manual_pdf_url: "http://brown-inc.com/manuals/fc_pro.pdf"
+          components:
+            - Advanced Chrono-Levitation Chamber (ACL)
+            - Dual Gravitational Displacement Coils (DGDCs)
+            - Advanced Quantum Flux Transducer (AQFT)
+            - Professional Time-Space Navigation System (PTNS)
         enterprise_version:
           name: Flux Capacitor Enterpise
           price_in_cents: 1_600_000_00
           manual_pdf_url: "http://brown-inc.com/manuals/fc_enterprise.pdf"
-
+          components:
+            - Super-Advanced Chrono-Levitation Chamber (SACL)
+            - Quadruple Gravitational Displacement Coils (QGDCs)
+            - Ultra-Advanced Quantum Flux Transducer (UAQFT)
+            - Enterprise Time-Space Navigation System (ETNS)
     test:
       flux_capacitor:
         test_version:
           name: Yadayada
           price_in_cents: 6_66
           manual_pdf_url: "http://staging.brown-inc.com/manuals/fc_10.pdf"
+          components:
+            - Experimental Chrono-Levitation Chamber (ECLC)
+            - Modular Gravitational Displacement Coils (MGDCs)
+            - Variable Quantum Flux Transducer (VQFT)
+            - Development Time-Space Navigation System (DTNS)
 
 and using `require "complex_config/rude"` in the `"development"` environment you
 can now access the configuration.
@@ -79,9 +98,17 @@ plugin return an URI instance:
 You can also fetch config settings from a different environment:
 
     >> pp cc.products(:test); nil
-    products.flux_capacitor.test_version.name = "Yadayada"
-    products.flux_capacitor.test_version.price_in_cents = 666
-    products.flux_capacitor.test_version.manual_pdf_url = "http://staging.brown-inc.com/manuals/fc_10.pdf"
+    products
+    └─ flux_capacitor
+       └─ test_version
+          ├─ name = "Yadayada"
+          ├─ price_in_cents = 666
+          ├─ manual_pdf_url = "http://staging.brown-inc.com/manuals/fc_10.pdf"
+          └─ components
+             ├─ "Experimental Chrono-Levitation Chamber (ECLC)"
+             ├─ "Modular Gravitational Displacement Coils (MGDCs)"
+             ├─ "Variable Quantum Flux Transducer (VQFT)"
+             └─ "Development Time-Space Navigation System (DTNS)"kk
 
 Calling `complex_config.products.` instead of `cc(…)` would skip the implicite
 namespacing via the `RAILS_ENV` environment, so

data/Rakefile

@@ -12,7 +12,7 @@ GemHadar do
   executables 'complex_config'
   test_dir    'spec'
   ignore      '.*.sw[pon]', 'pkg', 'Gemfile.lock', 'coverage', '.rvmrc',
-    '.AppleDouble', '.DS_Store', '.byebug_history', 'errors.lst', 'tags'
+    '.AppleDouble', '.DS_Store', 'errors.lst', 'tags'
   package_ignore '.all_images', '.utilsrc', '.rspec', '.tool-versions',
     '.gitignore'
 
@@ -20,6 +20,8 @@ GemHadar do
   title       "#{name.camelize} -- configuration library"
   licenses    << 'Apache-2.0'
 
+  clobber 'coverage'
+
   dependency             'json'
   dependency             'tins'
   dependency             'mize', '~> 0.3', '>= 0.3.4'

data/VERSION

@@ -1 +1 @@
-0.20.0
+0.21.1

data/complex_config.gemspec

@@ -1,29 +1,29 @@
 # -*- encoding: utf-8 -*-
-# stub: complex_config 0.20.0 ruby lib
+# stub: complex_config 0.21.1 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "complex_config".freeze
-  s.version = "0.20.0".freeze
+  s.version = "0.21.1".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Florian Frank".freeze]
-  s.date = "2024-04-17"
+  s.date = "2024-09-09"
   s.description = "This library allows you to access configuration files via a simple interface".freeze
   s.email = "flori@ping.de".freeze
   s.executables = ["complex_config".freeze]
-  s.extra_rdoc_files = ["README.md".freeze, "lib/complex_config.rb".freeze, "lib/complex_config/config.rb".freeze, "lib/complex_config/encryption.rb".freeze, "lib/complex_config/errors.rb".freeze, "lib/complex_config/key_source.rb".freeze, "lib/complex_config/plugins.rb".freeze, "lib/complex_config/plugins/enable.rb".freeze, "lib/complex_config/plugins/money.rb".freeze, "lib/complex_config/plugins/uri.rb".freeze, "lib/complex_config/provider.rb".freeze, "lib/complex_config/provider/shortcuts.rb".freeze, "lib/complex_config/proxy.rb".freeze, "lib/complex_config/railtie.rb".freeze, "lib/complex_config/rude.rb".freeze, "lib/complex_config/settings.rb".freeze, "lib/complex_config/shortcuts.rb".freeze, "lib/complex_config/version.rb".freeze]
-  s.files = [".all_images.yml".freeze, "COPYING".freeze, "Gemfile".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/complex_config".freeze, "complex_config.gemspec".freeze, "config/products.yml".freeze, "lib/complex_config.rb".freeze, "lib/complex_config/config.rb".freeze, "lib/complex_config/encryption.rb".freeze, "lib/complex_config/errors.rb".freeze, "lib/complex_config/key_source.rb".freeze, "lib/complex_config/plugins.rb".freeze, "lib/complex_config/plugins/enable.rb".freeze, "lib/complex_config/plugins/money.rb".freeze, "lib/complex_config/plugins/uri.rb".freeze, "lib/complex_config/provider.rb".freeze, "lib/complex_config/provider/shortcuts.rb".freeze, "lib/complex_config/proxy.rb".freeze, "lib/complex_config/railtie.rb".freeze, "lib/complex_config/rude.rb".freeze, "lib/complex_config/settings.rb".freeze, "lib/complex_config/shortcuts.rb".freeze, "lib/complex_config/version.rb".freeze, "spec/complex_config/config_spec.rb".freeze, "spec/complex_config/encryption_spec.rb".freeze, "spec/complex_config/key_source_spec.rb".freeze, "spec/complex_config/plugins_spec.rb".freeze, "spec/complex_config/provider_spec.rb".freeze, "spec/complex_config/settings_spec.rb".freeze, "spec/complex_config/shortcuts_spec.rb".freeze, "spec/config/broken_config.yml".freeze, "spec/config/config.yml".freeze, "spec/config/config_with_alias.yml".freeze, "spec/config/legacy_classes.yml".freeze, "spec/config/master.key".freeze, "spec/config/with-key-file.yml.enc".freeze, "spec/config/with-key-file.yml.key".freeze, "spec/config/without-key-file.yml.enc".freeze, "spec/spec_helper.rb".freeze]
+  s.extra_rdoc_files = ["README.md".freeze, "lib/complex_config.rb".freeze, "lib/complex_config/config.rb".freeze, "lib/complex_config/encryption.rb".freeze, "lib/complex_config/errors.rb".freeze, "lib/complex_config/key_source.rb".freeze, "lib/complex_config/plugins.rb".freeze, "lib/complex_config/plugins/enable.rb".freeze, "lib/complex_config/plugins/money.rb".freeze, "lib/complex_config/plugins/uri.rb".freeze, "lib/complex_config/provider.rb".freeze, "lib/complex_config/provider/shortcuts.rb".freeze, "lib/complex_config/proxy.rb".freeze, "lib/complex_config/railtie.rb".freeze, "lib/complex_config/rude.rb".freeze, "lib/complex_config/settings.rb".freeze, "lib/complex_config/shortcuts.rb".freeze, "lib/complex_config/tree.rb".freeze, "lib/complex_config/version.rb".freeze]
+  s.files = [".all_images.yml".freeze, "CHANGES.md".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/complex_config".freeze, "complex_config.gemspec".freeze, "config/products.yml".freeze, "lib/complex_config.rb".freeze, "lib/complex_config/config.rb".freeze, "lib/complex_config/encryption.rb".freeze, "lib/complex_config/errors.rb".freeze, "lib/complex_config/key_source.rb".freeze, "lib/complex_config/plugins.rb".freeze, "lib/complex_config/plugins/enable.rb".freeze, "lib/complex_config/plugins/money.rb".freeze, "lib/complex_config/plugins/uri.rb".freeze, "lib/complex_config/provider.rb".freeze, "lib/complex_config/provider/shortcuts.rb".freeze, "lib/complex_config/proxy.rb".freeze, "lib/complex_config/railtie.rb".freeze, "lib/complex_config/rude.rb".freeze, "lib/complex_config/settings.rb".freeze, "lib/complex_config/shortcuts.rb".freeze, "lib/complex_config/tree.rb".freeze, "lib/complex_config/version.rb".freeze, "spec/complex_config/config_spec.rb".freeze, "spec/complex_config/encryption_spec.rb".freeze, "spec/complex_config/key_source_spec.rb".freeze, "spec/complex_config/plugins_spec.rb".freeze, "spec/complex_config/provider_spec.rb".freeze, "spec/complex_config/settings_spec.rb".freeze, "spec/complex_config/shortcuts_spec.rb".freeze, "spec/config/broken_config.yml".freeze, "spec/config/config.yml".freeze, "spec/config/config_with_alias.yml".freeze, "spec/config/empty_config.yml".freeze, "spec/config/legacy_classes.yml".freeze, "spec/config/master.key".freeze, "spec/config/with-key-file.yml.enc".freeze, "spec/config/with-key-file.yml.key".freeze, "spec/config/without-key-file.yml.enc".freeze, "spec/spec_helper.rb".freeze]
   s.homepage = "https://github.com/flori/complex_config".freeze
   s.licenses = ["Apache-2.0".freeze]
   s.rdoc_options = ["--title".freeze, "ComplexConfig -- configuration library".freeze, "--main".freeze, "README.md".freeze]
-  s.rubygems_version = "3.5.3".freeze
+  s.rubygems_version = "3.5.18".freeze
   s.summary = "configuration library".freeze
   s.test_files = ["spec/complex_config/config_spec.rb".freeze, "spec/complex_config/encryption_spec.rb".freeze, "spec/complex_config/key_source_spec.rb".freeze, "spec/complex_config/plugins_spec.rb".freeze, "spec/complex_config/provider_spec.rb".freeze, "spec/complex_config/settings_spec.rb".freeze, "spec/complex_config/shortcuts_spec.rb".freeze, "spec/spec_helper.rb".freeze]
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.15.0".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.17.0".freeze])
   s.add_development_dependency(%q<rake>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<simplecov>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<rspec>.freeze, [">= 0".freeze])

data/config/products.yml

@@ -4,18 +4,37 @@ development:
       name: Flux Capacitor Version 2.0
       price_in_cents: 12_000_00
       manual_pdf_url: "http://brown-inc.com/manuals/fc_20.pdf"
+      components:
+        - Miniature Chrono-Levitation Chamber (mCLC)
+        - Single Gravitational Displacement Coil (SGDC)
+        - Simple Quantum Flux Transducer (SQFT)
+        - Basic Time-Space Navigation System (BTN)
     pro_version:
       name: Flux Capacitor Professional
       price_in_cents: 23_000_00
       manual_pdf_url: "http://brown-inc.com/manuals/fc_pro.pdf"
+      components:
+        - Advanced Chrono-Levitation Chamber (ACL)
+        - Dual Gravitational Displacement Coils (DGDCs)
+        - Advanced Quantum Flux Transducer (AQFT)
+        - Professional Time-Space Navigation System (PTNS)
     enterprise_version:
       name: Flux Capacitor Enterpise
       price_in_cents: 1_600_000_00
       manual_pdf_url: "http://brown-inc.com/manuals/fc_enterprise.pdf"
-
+      components:
+        - Super-Advanced Chrono-Levitation Chamber (SACL)
+        - Quadruple Gravitational Displacement Coils (QGDCs)
+        - Ultra-Advanced Quantum Flux Transducer (UAQFT)
+        - Enterprise Time-Space Navigation System (ETNS)
 test:
   flux_capacitor:
     test_version:
       name: Yadayada
       price_in_cents: 6_66
       manual_pdf_url: "http://staging.brown-inc.com/manuals/fc_10.pdf"
+      components:
+        - Experimental Chrono-Levitation Chamber (ECLC)
+        - Modular Gravitational Displacement Coils (MGDCs)
+        - Variable Quantum Flux Transducer (VQFT)
+        - Development Time-Space Navigation System (DTNS)

data/lib/complex_config/provider.rb

@@ -4,6 +4,7 @@ require 'pathname'
 require 'yaml'
 require 'mize'
 require 'tins/xt/secure_write'
+require 'tins/xt/ask_and_send'
 
 class ComplexConfig::Provider
   include Tins::SexySingleton

data/lib/complex_config/settings.rb

@@ -28,6 +28,7 @@ class ComplexConfig::Settings < BasicObject
 
     def build(name, hash)
       name.nil? or self.name_prefix = name.to_sym
+      hash.respond_to?(:to_hash) or raise TypeError, 'require hash to build'
       from_hash(hash)
     ensure
       self.name_prefix = nil
@@ -122,6 +123,10 @@ class ComplexConfig::Settings < BasicObject
     to_h.to_json(*a)
   end
 
+  def to_tree
+    ::ComplexConfig::Tree.convert(name_prefix, self)
+  end
+
   def size
     each.count
   end
@@ -130,13 +135,18 @@ class ComplexConfig::Settings < BasicObject
     size == 0
   end
 
-  def to_s(pair_sep: ' = ', path_sep: ?.)
+  def list(pair_sep: ' = ', path_sep: ?.)
     empty? and return self.class.name
     pathes(path_sep: path_sep).inject('') do |result, (path, value)|
       result + "#{path}#{pair_sep}#{value.inspect}\n"
     end
   end
 
+  def to_s(*)
+    empty? and return self.class.name
+    to_tree.to_s
+  end
+
   def pathes(hash = table, path_sep: ?., prefix: name_prefix.to_s, result: {})
     hash.each do |key, value|
       path = prefix.empty? ? key.to_s : "#{prefix}#{path_sep}#{key}"

data/lib/complex_config/tree.rb

@@ -0,0 +1,80 @@
+module ComplexConfig
+  class Tree
+    def self.convert(name, value)
+      case value
+      when ComplexConfig::Settings
+        convert(name, value.to_h)
+      when Hash
+        obj = new(name.to_s)
+        value.each do |name, value|
+          obj << convert(name, value)
+        end
+        obj
+      when Array
+        obj = new(name.to_s)
+        value.each_with_index do |value, i|
+          obj << convert(i, value)
+        end
+        obj
+      else
+        if name.is_a?(Integer)
+          new value.inspect
+        else
+          new "#{name} = #{value.inspect}"
+        end
+      end
+    end
+
+    def initialize(name)
+      @name     = name
+      @children = []
+    end
+
+    private
+
+    def inner_child_prefix(i)
+      i.zero? ? "├─ " : "│  "
+    end
+
+    def last_child_prefix(i)
+      i.zero? ? "└─ " : "   "
+    end
+
+    public
+
+    def to_enum
+      Enumerator.new do |y|
+        y.yield @name
+
+        @children.each_with_index do |child, child_index|
+          children_enum = child.to_enum
+          if child_index < @children.size - 1
+            children_enum.each_with_index do |setting, i|
+              y.yield "#{inner_child_prefix(i)}#{setting}"
+            end
+          else
+            children_enum.each_with_index do |setting, i|
+              y.yield "#{last_child_prefix(i)}#{setting}"
+            end
+          end
+        end
+      end
+    end
+
+    def <<(child)
+      @children << child
+    end
+
+    def to_ary
+      to_enum.to_a
+    end
+
+    alias to_a to_ary
+
+    def to_str
+      to_ary * ?\n
+    end
+
+    alias to_s to_str
+  end
+end

data/lib/complex_config/version.rb

@@ -1,6 +1,6 @@
 module ComplexConfig
   # ComplexConfig version
-  VERSION         = '0.20.0'
+  VERSION         = '0.21.1'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/complex_config.rb

@@ -6,6 +6,7 @@ end
 require 'complex_config/version'
 require 'complex_config/errors'
 require 'complex_config/proxy'
+require 'complex_config/tree'
 require 'complex_config/settings'
 require 'complex_config/config'
 require 'complex_config/key_source'

data/spec/complex_config/provider_spec.rb

@@ -84,6 +84,12 @@ RSpec.describe ComplexConfig::Provider do
       ).to be_a ComplexConfig::Settings
     end
 
+    it 'cannot read from an empty configuration file' do
+      expect {
+        described_class.config(asset('empty_config.yml'))
+      }.to raise_error(TypeError)
+    end
+
     it 'has deep frozen settings' do
       settings = described_class.config(asset('config.yml'))
       expect(settings).to be_frozen

data/spec/complex_config/settings_spec.rb

@@ -7,7 +7,7 @@ RSpec.describe ComplexConfig::Settings do
   end
 
   let :settings do
-    described_class[
+    obj = described_class[
       foo: {
         bar: {
           baz: true
@@ -15,6 +15,8 @@ RSpec.describe ComplexConfig::Settings do
         qux: 'quux'
       }
     ]
+    obj.name_prefix = 'root'
+    obj
   end
 
   it 'can be initialized with a hash' do
@@ -79,36 +81,58 @@ RSpec.describe ComplexConfig::Settings do
 
   it 'can return a hash with pathes as keys' do
     expect(settings.pathes(path_sep: ?:)).to eq(
-      'foo:bar:baz' => true,
-      'foo:qux'     => "quux"
+      'root:foo:bar:baz' => true,
+      'root:foo:qux'     => "quux"
     )
   end
 
-  it 'can be represented as a string' do
-    expect(settings.to_s(pair_sep: ' → ', path_sep: ?/)).to eq <<EOT
-foo/bar/baz → true
-foo/qux → "quux"
-EOT
+  it 'can be listed as string' do
+    expect(settings.list(pair_sep: ' → ', path_sep: ?/)).to eq <<~EOT
+      root/foo/bar/baz → true
+      root/foo/qux → "quux"
+    EOT
   end
 
   it 'responds with class name if #to_s is called on empty settigs' do
     expect(described_class.new.to_s).to eq described_class.name
   end
 
-  it 'can be represented as a string if it has arrays' do
+  it 'can be listesd as a string if it has arrays' do
     settings[:ary] = described_class[ [ 1, { nested: 2 }, 3 ] ]
-    expect(settings.to_s).to eq <<EOT
-foo.bar.baz = true
-foo.qux = "quux"
-ary[0] = 1
-ary[1].nested = 2
-ary[2] = 3
-EOT
+    expect(settings.list).to eq <<~EOT
+      root.foo.bar.baz = true
+      root.foo.qux = "quux"
+      root.ary[0] = 1
+      root.ary[1].nested = 2
+      root.ary[2] = 3
+    EOT
+  end
+
+  it 'can be represented as tree' do
+    settings[:ary] = described_class[ [ 1, { nested: 2 }, 3 ] ]
+    expect(settings.to_tree.to_s).to eq <<~EOT.chomp
+      root
+      ├─ foo
+      │  ├─ bar
+      │  │  └─ baz = true
+      │  └─ qux = "quux"
+      └─ ary
+         ├─ 1
+         ├─ 1
+         │  └─ nested = 2
+         └─ 3
+    EOT
   end
 
   it 'can be pretty printed' do
     q = double
-    expect(q).to receive(:text).with("foo.bar.baz = true\nfoo.qux = \"quux\"\n")
+    expect(q).to receive(:text).with(<<~EOT.chomp)
+      root
+      └─ foo
+         ├─ bar
+         │  └─ baz = true
+         └─ qux = "quux"
+    EOT
     settings.pretty_print(q)
   end
 

data/spec/spec_helper.rb

@@ -6,7 +6,7 @@ if ENV['START_SIMPLECOV'].to_i == 1
 end
 require 'rspec'
 begin
-  require 'byebug'
+  require 'debug'
 rescue LoadError
 end
 require 'complex_config'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: complex_config
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.21.1
 platform: ruby
 authors:
 - Florian Frank
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-17 00:00:00.000000000 Z
+date: 2024-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gem_hadar
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.15.0
+        version: 1.17.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.15.0
+        version: 1.17.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -193,11 +193,13 @@ extra_rdoc_files:
 - lib/complex_config/rude.rb
 - lib/complex_config/settings.rb
 - lib/complex_config/shortcuts.rb
+- lib/complex_config/tree.rb
 - lib/complex_config/version.rb
 files:
 - ".all_images.yml"
-- COPYING
+- CHANGES.md
 - Gemfile
+- LICENSE
 - README.md
 - Rakefile
 - VERSION
@@ -220,6 +222,7 @@ files:
 - lib/complex_config/rude.rb
 - lib/complex_config/settings.rb
 - lib/complex_config/shortcuts.rb
+- lib/complex_config/tree.rb
 - lib/complex_config/version.rb
 - spec/complex_config/config_spec.rb
 - spec/complex_config/encryption_spec.rb
@@ -231,6 +234,7 @@ files:
 - spec/config/broken_config.yml
 - spec/config/config.yml
 - spec/config/config_with_alias.yml
+- spec/config/empty_config.yml
 - spec/config/legacy_classes.yml
 - spec/config/master.key
 - spec/config/with-key-file.yml.enc
@@ -260,7 +264,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.18
 signing_key:
 specification_version: 4
 summary: configuration library