complex_config 0.19.4 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9912bf6cc72581ab1ac092dc366b4d9e1fa33b52420ffe7c6abc2a55ed7fc02
-  data.tar.gz: 30553c4257559ab024d0fa901a493458b7876dff14e7d0e467a7125aa7c51f01
+  metadata.gz: 432209a0d29d4d47874c82ebe27f311e3a545b1aac932bcf31e0307f8b3dc1fb
+  data.tar.gz: 6ed546fc3bbb9032503dc501c7d8350e145255756ca5cbcea18c10758e982577
 SHA512:
-  metadata.gz: fb28ff834517685f7fa1942d2ac0409b93bdca7a26f1bd211d63af3991e7bb99088f6027f6f532f5be191c040e43885a876176b6ba0566aa56146c78a41bc4d7
-  data.tar.gz: 6702bd2669f2d91e326d81748207c4e90157c4ce860e1422d3e8700794b6cee2dd18b6e5066e8f1d015f1ca2141ceae18856005395cd9eae7b995f1b3be07748
+  metadata.gz: b7a1a956b49424098d206442242850356de73db068d715d1d9bcfa0659cb336043d6d65af530c7ef0c6d7a021a91122bcaf2baba1998bbc49c0ea7266b582b55
+  data.tar.gz: c07a01e3c26ce55862c34a9b42caff05dfa7ed7730be92684eb1eacd335f4badf82c2dcaabe042429610ba4ac3324a2b62b3903dc8c89e428568e4fa230ffe16

data/.all_images.yml

@@ -6,12 +6,11 @@ script: &script |-
   echo -e "\e[1m"
   ruby -v
   echo -e "\e[0m"
-  bundle
-  rake test
+  bundle install --full-index
+  rake spec
 
 images:
+  ruby:3.3-alpine: *script
+  ruby:3.2-alpine: *script
   ruby:3.1-alpine: *script
   ruby:3.0-alpine: *script
-  ruby:2.7-alpine: *script
-  ruby:2.6-alpine: *script
-  ruby:2.5-alpine: *script

data/CHANGES.md

@@ -0,0 +1,372 @@
+# Changes
+
+## 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.
@@ -82,6 +101,10 @@ You can also fetch config settings from a different environment:
     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.components[0] = "Experimental Chrono-Levitation Chamber (ECLC)"
+    products.flux_capacitor.test_version.components[1] = "Modular Gravitational Displacement Coils (MGDCs)"
+    products.flux_capacitor.test_version.components[2] = "Variable Quantum Flux Transducer (VQFT)"
+    products.flux_capacitor.test_version.components[3] = "Development Time-Space Navigation System (DTNS)"
 
 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,14 +20,18 @@ GemHadar do
   title       "#{name.camelize} -- configuration library"
   licenses    << 'Apache-2.0'
 
+  clobber 'coverage'
+
   dependency             'json'
   dependency             'tins'
   dependency             'mize', '~> 0.3', '>= 0.3.4'
+  dependency             'base64'
   development_dependency 'rake'
   development_dependency 'simplecov'
   development_dependency 'rspec'
   development_dependency 'monetize'
   development_dependency 'utils'
+  development_dependency 'debug'
 end
 
 task :default => :spec

data/VERSION

@@ -1 +1 @@
-0.19.4
+0.21.0

data/complex_config.gemspec

@@ -1,49 +1,37 @@
 # -*- encoding: utf-8 -*-
-# stub: complex_config 0.19.4 ruby lib
+# stub: complex_config 0.21.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "complex_config".freeze
-  s.version = "0.19.4"
+  s.version = "0.21.0".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 = "2022-07-11"
+  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.3.17".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]
 
-  if s.respond_to? :specification_version then
-    s.specification_version = 4
-  end
+  s.specification_version = 4
 
-  if s.respond_to? :add_runtime_dependency then
-    s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.12.0"])
-    s.add_development_dependency(%q<rake>.freeze, [">= 0"])
-    s.add_development_dependency(%q<simplecov>.freeze, [">= 0"])
-    s.add_development_dependency(%q<rspec>.freeze, [">= 0"])
-    s.add_development_dependency(%q<monetize>.freeze, [">= 0"])
-    s.add_development_dependency(%q<utils>.freeze, [">= 0"])
-    s.add_runtime_dependency(%q<json>.freeze, [">= 0"])
-    s.add_runtime_dependency(%q<tins>.freeze, [">= 0"])
-    s.add_runtime_dependency(%q<mize>.freeze, ["~> 0.3", ">= 0.3.4"])
-  else
-    s.add_dependency(%q<gem_hadar>.freeze, ["~> 1.12.0"])
-    s.add_dependency(%q<rake>.freeze, [">= 0"])
-    s.add_dependency(%q<simplecov>.freeze, [">= 0"])
-    s.add_dependency(%q<rspec>.freeze, [">= 0"])
-    s.add_dependency(%q<monetize>.freeze, [">= 0"])
-    s.add_dependency(%q<utils>.freeze, [">= 0"])
-    s.add_dependency(%q<json>.freeze, [">= 0"])
-    s.add_dependency(%q<tins>.freeze, [">= 0"])
-    s.add_dependency(%q<mize>.freeze, ["~> 0.3", ">= 0.3.4"])
-  end
+  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])
+  s.add_development_dependency(%q<monetize>.freeze, [">= 0".freeze])
+  s.add_development_dependency(%q<utils>.freeze, [">= 0".freeze])
+  s.add_development_dependency(%q<debug>.freeze, [">= 0".freeze])
+  s.add_runtime_dependency(%q<json>.freeze, [">= 0".freeze])
+  s.add_runtime_dependency(%q<tins>.freeze, [">= 0".freeze])
+  s.add_runtime_dependency(%q<mize>.freeze, ["~> 0.3".freeze, ">= 0.3.4".freeze])
+  s.add_runtime_dependency(%q<base64>.freeze, [">= 0".freeze])
 end

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,14 +4,15 @@ require 'pathname'
 require 'yaml'
 require 'mize'
 require 'tins/xt/secure_write'
+require 'tins/xt/ask_and_send'
 
 class ComplexConfig::Provider
   include Tins::SexySingleton
   include ComplexConfig::Provider::Shortcuts
 
   def initialize
-    @plugins             = Set.new
-    @deep_freeze         = true
+    @plugins     = Set.new
+    @deep_freeze = true
   end
 
   attr_writer :master_key_pathname

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

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.19.4'
+  VERSION         = '0.21.0'
   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,15 +81,15 @@ 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"
+root/foo/bar/baz → true
+root/foo/qux → "quux"
 EOT
   end
 
@@ -98,17 +100,33 @@ EOT
   it 'can be represented 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
+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("root.foo.bar.baz = true\nroot.foo.qux = \"quux\"\n")
     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.19.4
+  version: 0.21.0
 platform: ruby
 authors:
 - Florian Frank
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-07-11 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.12.0
+        version: 1.17.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.12.0
+        version: 1.17.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -94,6 +94,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -142,6 +156,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.3.4
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: This library allows you to access configuration files via a simple interface
 email: flori@ping.de
 executables:
@@ -165,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
@@ -192,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
@@ -203,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
@@ -232,7 +264,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.17
+rubygems_version: 3.5.18
 signing_key:
 specification_version: 4
 summary: configuration library