anyway_config 2.3.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe4f769be22bc9cb820fd1159b88a565b2fb71e13ad617d90aaafbcb1673f995
-  data.tar.gz: 175e468716722b43b6c7d163a97b6523801f6658118d1c56bb5a4a0255807ef9
+  metadata.gz: 44a860f50ae339b170da1a4ea99a7c6125b8ddcf2e25269c7341150bb8b8cf1f
+  data.tar.gz: f39c3ff413a1f334ad85a8f3eb0dfabca16dfc0c18c7f8719236607a777f947d
 SHA512:
-  metadata.gz: 7c323f89197ca35405ca77ee1e58a8b3fbbf4b0d6b57e7ccce380311a13994d18121966428a2681cb55a5892c2eff52ec347a6e3568072ea8f85d1cf7f75aa80
-  data.tar.gz: 25ee0b877318a2335c2019a414684d5b15e3755ceff90e51de3a0b821ee48f86a119f9753eaddac5dfb4724e38876ec5f18b68b065db7aa4b23d20b837666929
+  metadata.gz: 6b903f239c176e8c031fdea2d81f9d6d46d0657c2b5525f7e36fed495ab2410dc017bbe676fdc8c633d6b303c619e5caeb109d8c172d172720bfb3417746c612
+  data.tar.gz: 7bbb6db11016ce9c9473009c49aa676e3121ab921a2493ceb6d8e0e270cf75369935678bb1a2e5f69ebe387be1d5a44d159df819dcfab4a591aa67bab2e757fa

data/CHANGELOG.md

@@ -2,6 +2,61 @@
 
 ## master
 
+## 2.4.0 (2023-04-04)
+
+- Add `Confi#as_env` to convert config into a ENV-like HASH. ([@tagirahmad][])
+
+- Added experimental support for sub-configs via coercion. ([@palkan][])
+
+```ruby
+class AnotherConfig < Anyway::Config
+  attr_config foo: "bar"
+end
+
+class MyConfig < Anyway::Config
+  attr_config :another_config
+
+  coerce_types another_config: "AnotherConfig"
+end
+
+MyConfig.new.another_config.foo #=> "bar"
+
+ENV["MY_ANOTHER_CONFIG__FOO"] = "baz"
+MyConfig.new.another_config.foo #=> "baz"
+```
+
+- Define predicate methods when `:boolean` type is specified for the attribute. ([@palkan][])
+
+- Add support for nested required config attributes. ([@palkan][])
+
+The API is inspired by Rails permitted params:
+
+```ruby
+class AppConfig < Anyway::Config
+  attr_config :assets_host, database: {host: nil, port: nil}
+
+  required :assets_host, database: [:host, :port]
+end
+```
+
+- Add support for using `env_prefix ""` to load from unprefixed env vars. ([@palkan][])
+
+See [#118](https://github.com/palkan/anyway_config/issues/118).
+
+- Added EJSON support. ([@inner-whisper])
+
+- Add Doppler loader. ([@prog-supdex][]).
+
+## 2.3.1 (2023-01-17)
+
+- [Fixes [#110](https://github.com/palkan/anyway_config/issues/110)] Fix setting up autoloader for the same folder. ([@palkan][])
+
+- RBS: Now `.on_load` automatically pass block context type (instance), so no need to add annotations! ([@palkan][])
+
+Steep 1.2+ is required. Read more about the [feature](https://hackmd.io/xLrYaqUtQ1GhgTHODkYypw?view).
+
+- Added `manifest.yml` for RBS. ([@palkan][])
+
 ## 2.3.0 (2022-03-11)
 
 - Add ability to load configurations under specific environments in pure Ruby apps. ([@fargelus][]).
@@ -459,3 +514,6 @@ No we're dependency-free!
 [@progapandist]: https://github.com/progapandist
 [@skryukov]: https://github.com/skryukov
 [@fargelus]: https://github.com/fargelus
+[@prog-supdex]: https://github.com/prog-supdex
+[@inner-whisper]: https://github.com/inner-whisper
+[@tagirahmad]: https://github.com/tagirahmad

data/README.md

@@ -45,6 +45,9 @@ For version 1.x see the [1-4-stable branch](https://github.com/palkan/anyway_con
 - [Type coercion](#type-coercion)
 - [Local configuration](#local-files)
 - [Data loaders](#data-loaders)
+  - [Doppler integration](#doppler-integration)
+  - [EJSON support](#ejson-support)
+  - [Custom loaders](#custom-loaders)
 - [Source tracing](#tracing)
 - [Pattern matching](#pattern-matching)
 - [Test helpers](#test-helpers)
@@ -269,7 +272,7 @@ This feature is similar to `Rails.application.config_for` but more powerful:
 | Load data from `secrets` | ❌ | ✅ |
 | Load data from `credentials` | ❌ | ✅ |
 | Load data from environment | ❌ | ✅ |
-| Load data from [custom sources](#data-loaders) | ❌ | ✅ |
+| Load data from [other sources](#data-loaders) | ❌ | ✅ |
 | Local config files | ❌ | ✅ |
 | Type coercion | ❌ | ✅ |
 | [Source tracing](#tracing) | ❌ | ✅ |
@@ -733,6 +736,62 @@ Don't forget to add `*.local.yml` (and `config/credentials/local.*`) to your `.g
 
 ## Data loaders
 
+### Doppler integration
+
+Anyway Config can pull configuration data from [Doppler](https://www.doppler.com/). All you need is to specify the `DOPPLER_TOKEN` environment variable with the **service token**, associated with the specific content (read more about [service tokens](https://docs.doppler.com/docs/service-tokens)).
+
+You can also configure Doppler loader manually if needed:
+
+```ruby
+# Add loader
+Anyway.loaders.append :Doppler, Anyway::Loaders::Doppler
+
+# Configure API URL and token (defaults are shown)
+Anyway::Loaders::Doppler.download_url = "https://api.doppler.com/v3/configs/config/secrets/download"
+Anyway::Loaders::Doppler.token = ENV["DOPPLER_TOKEN"]
+```
+
+**NOTE:** You can opt-out from Doppler loader by specifying the`ANYWAY_CONFIG_DISABLE_DOPPLER=true` env var (in case you have the `DOPPLER_TOKEN` env var, but don't want to use it with Anyway Config).
+
+### EJSON support
+
+Anyway Config allows you to keep your configuration also in encrypted `.ejson` files. More information
+about EJSON format you can read [here](https://github.com/Shopify/ejson).
+
+Configuration will be loaded only if you have `ejson` executable in your PATH. Easiest way to do this - install `ejson` as a gem into project:
+
+```ruby
+# Gemfile
+gem "ejson"
+```
+
+Loading order of configuration is next:
+
+- `config/secrets.local.ejson` (see [Local files](#local-files) for more information)
+- `config/<environment>/secrets.ejson` (if you have any multi-environment setup, e.g Rails environments)
+- `config/secrets.ejson`
+
+Example of `config/secrets.ejson` file content for your `MyConfig`:
+
+```json
+{
+  "_public_key": "0843d33f0eee994adc66b939fe4ef569e4c97db84e238ff581934ee599e19d1a",
+  "my":
+    {
+      "_username": "root",
+      "password": "EJ[1:IC1d347GkxLXdZ0KrjGaY+ljlsK1BmK7CobFt6iOLgE=:Z55OYS1+On0xEBvxUaIOdv/mE2r6lp44:T7bE5hkAbazBnnH6M8bfVcv8TOQJAgUDQffEgw==]"
+    }
+}
+```
+
+To debug any problems with loading configurations from `.ejson` files you can directly call `ejson decrypt`:
+
+```sh
+ejson decrypt config/secrets.ejson
+```
+
+### Custom loaders
+
 You can provide your own data loaders or change the existing ones using the Loaders API (which is very similar to Rack middleware builder):
 
 ```ruby

data/lib/.rbnext/2.6/anyway/ejson_parser.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require "open3"
+require "anyway/ext/hash"
+
+using Anyway::Ext::Hash
+
+module Anyway
+  class EJSONParser
+    attr_reader :bin_path
+
+    def initialize(bin_path = "ejson")
+      @bin_path = bin_path
+    end
+
+    def call(file_path)
+      return unless File.exist?(file_path)
+
+      raw_content = nil
+
+      stdout, stderr, status = Open3.capture3("#{bin_path} decrypt #{file_path}")
+
+      if status.success?
+        raw_content = JSON.parse(stdout.chomp)
+      else
+        Kernel.warn "Failed to decrypt #{file_path}: #{stderr}"
+      end
+
+      return unless raw_content
+
+      raw_content.deep_transform_keys do |key|
+        if key[0] == "_"
+          key[1..-1]
+        else
+          key
+        end
+      end
+    end
+  end
+end

data/lib/.rbnext/2.7/anyway/config.rb

@@ -8,6 +8,7 @@ module Anyway # :nodoc:
   using Anyway::Ext::DeepDup
   using Anyway::Ext::DeepFreeze
   using Anyway::Ext::Hash
+  using Anyway::Ext::FlattenNames
 
   using(Module.new do
     refine Object do
@@ -26,6 +27,7 @@ module Anyway # :nodoc:
     RESERVED_NAMES = %i[
       config_name
       env_prefix
+      as_env
       values
       class
       clear
@@ -47,8 +49,6 @@ module Anyway # :nodoc:
       __type_caster__
     ].freeze
 
-    ENV_OPTION_EXCLUDE_KEY = :except
-
     class Error < StandardError; end
 
     class ValidationError < Error; end
@@ -128,34 +128,14 @@ module Anyway # :nodoc:
         end
       end
 
-      def required(*names, env: nil)
-        unknown_names = names - config_attributes
+      def required(*names, env: nil, **nested)
+        unknown_names = names + nested.keys - config_attributes
         raise ArgumentError, "Unknown config param: #{unknown_names.join(",")}" if unknown_names.any?
 
-        names = filter_by_env(names, env)
-        required_attributes.push(*names)
-      end
+        return unless Settings.matching_env?(env)
 
-      def filter_by_env(names, env)
-        return names if env.nil? || env.to_s == current_env
-
-        filtered_names = if env.is_a?(Hash)
-          names_with_exclude_env_option(names, env)
-        elsif env.is_a?(Array)
-          names if env.flat_map(&:to_s).include?(current_env)
-        end
-
-        filtered_names || []
-      end
-
-      def current_env
-        Settings.current_environment.to_s
-      end
-
-      def names_with_exclude_env_option(names, env)
-        envs = env[ENV_OPTION_EXCLUDE_KEY]
-        excluded_envs = [envs].flat_map(&:to_s)
-        names if excluded_envs.none?(current_env)
+        required_attributes.push(*names)
+        required_attributes.push(*nested.flatten_names)
       end
 
       def required_attributes
@@ -223,6 +203,12 @@ module Anyway # :nodoc:
 
       def coerce_types(mapping)
         Utils.deep_merge!(coercion_mapping, mapping)
+
+        mapping.each do |key, val|
+          next unless val == :boolean || (val.is_a?(::Hash) && val[:type] == :boolean)
+
+          alias_method :"#{key}?", :"#{key}"
+        end
       end
 
       def coercion_mapping
@@ -268,7 +254,7 @@ module Anyway # :nodoc:
         names.each do |name|
           accessors_module.module_eval <<~RUBY, __FILE__, __LINE__ + 1
             def #{name}=(val)
-              __trace__&.record_value(val, \"#{name}\", **Tracing.current_trace_source)
+              __trace__&.record_value(val, "#{name}", **Tracing.current_trace_source)
               values[:#{name}] = val
             end
 
@@ -297,7 +283,7 @@ module Anyway # :nodoc:
         # - SomeModule::Config => "some_module"
         # - SomeConfig => "some"
         unless name =~ /^(\w+)(::)?Config$/
-          raise "Couldn't infer config name, please, specify it explicitly" \
+          raise "Couldn't infer config name, please, specify it explicitly " \
             "via `config_name :my_config`"
         end
 
@@ -430,13 +416,18 @@ module Anyway # :nodoc:
       end
     end
 
+    def as_env
+      Env.from_hash(to_h, prefix: env_prefix)
+    end
+
     private
 
     attr_reader :values, :__trace__
 
     def validate_required_attributes!
       self.class.required_attributes.select do |name|
-        values[name].nil? || (values[name].is_a?(String) && values[name].empty?)
+        val = values.dig(*name.to_s.split(".").map(&:to_sym))
+        val.nil? || (val.is_a?(String) && val.empty?)
       end.then do |missing|
         next if missing.empty?
         raise_validation_error "The following config parameters for `#{self.class.name}(config_name: #{self.class.config_name})` are missing or empty: #{missing.join(", ")}"

data/lib/.rbnext/2.7/anyway/loaders/yaml.rb

@@ -53,13 +53,13 @@ module Anyway
         # the interface when no config file is present.
         begin
           if defined?(ERB)
-            ::YAML.load(ERB.new(File.read(path)).result, aliases: true) || {} # rubocop:disable Security/YAMLLoad
+            ::YAML.load(ERB.new(File.read(path)).result, aliases: true) || {}
           else
             ::YAML.load_file(path, aliases: true) || {}
           end
         rescue ArgumentError
           if defined?(ERB)
-            ::YAML.load(ERB.new(File.read(path)).result) || {} # rubocop:disable Security/YAMLLoad
+            ::YAML.load(ERB.new(File.read(path)).result) || {}
           else
             ::YAML.load_file(path) || {}
           end

data/lib/.rbnext/2.7/anyway/rbs.rb

@@ -44,7 +44,7 @@ module Anyway
             TYPE_TO_CLASS.fetch(type) { defaults[param] ? "Symbol" : "untyped" }
           when (Array === __m__)
             "Array[untyped]"
-          when ((__m__.respond_to?(:deconstruct_keys) && (((__m_hash__src__ = __m__.deconstruct_keys(nil)) || true) && (Hash === __m_hash__src__ || Kernel.raise(TypeError, "#deconstruct_keys must return Hash"))) && (__m_hash__ = __m_hash__src__.dup)) && ((__m_hash__.key?(:array) && __m_hash__.key?(:type)) && (((array = __m_hash__.delete(:array)) || true) && (((type = __m_hash__.delete(:type)) || true) && __m_hash__.empty?))))
+          when (((array, type) = nil) || ((__m__.respond_to?(:deconstruct_keys) && (((__m_hash__src__ = __m__.deconstruct_keys(nil)) || true) && (Hash === __m_hash__src__ || Kernel.raise(TypeError, "#deconstruct_keys must return Hash"))) && (__m_hash__ = __m_hash__src__.dup)) && ((__m_hash__.key?(:array) && __m_hash__.key?(:type)) && (((array = __m_hash__.delete(:array)) || true) && (((type = __m_hash__.delete(:type)) || true) && __m_hash__.empty?)))))
             "Array[#{TYPE_TO_CLASS.fetch(type, "untyped")}]"
           when (Hash === __m__)
             "Hash[string,untyped]"

data/lib/.rbnext/2.7/anyway/settings.rb

@@ -80,6 +80,20 @@ module Anyway
       def default_environmental_key?
         !default_environmental_key.nil?
       end
+
+      def matching_env?(env)
+        return true if env.nil? || env.to_s == current_environment
+
+        if env.is_a?(::Hash)
+          envs = env[:except]
+          excluded_envs = [envs].flat_map(&:to_s)
+          excluded_envs.none?(current_environment)
+        elsif env.is_a?(::Array)
+          env.flat_map(&:to_s).include?(current_environment)
+        else
+          false
+        end
+      end
     end
 
     # By default, use local files only in development (that's the purpose if the local files)

data/lib/.rbnext/2.7/anyway/tracing.rb

@@ -19,12 +19,12 @@ module Anyway
       def initialize(type = :trace, value = UNDEF, **source)
         @type = type
         @source = source
-        @value = value == UNDEF ? Hash.new { |h, k| h[k] = Trace.new(:trace) } : value
+        @value = (value == UNDEF) ? Hash.new { |h, k| h[k] = Trace.new(:trace) } : value
       end
 
       def dig(*__rest__, &__block__)
         value.dig(*__rest__, &__block__)
-      end
+      end; respond_to?(:ruby2_keywords, true) && (ruby2_keywords :dig)
 
       def record_value(val, *path, **opts)
         key = path.pop
@@ -35,7 +35,7 @@ module Anyway
         end
 
         target_trace = path.empty? ? self : value.dig(*path)
-        target_trace.value[key.to_s] = trace
+        target_trace.record_key(key.to_s, trace)
 
         val
       end
@@ -54,6 +54,12 @@ module Anyway
         hash
       end
 
+      def record_key(key, key_trace)
+        @value = Hash.new { |h, k| h[k] = Trace.new(:trace) } unless value.is_a?(::Hash)
+
+        value[key] = key_trace
+      end
+
       def merge!(another_trace)
         raise ArgumentError, "You can only merge into a :trace type, and this is :#{type}" unless trace?
         raise ArgumentError, "You can only merge a :trace type, but trying :#{type}" unless another_trace.trace?
@@ -70,7 +76,7 @@ module Anyway
       def keep_if(*__rest__, &__block__)
         raise ArgumentError, "You can only filter :trace type, and this is :#{type}" unless trace?
         value.keep_if(*__rest__, &__block__)
-      end
+      end; respond_to?(:ruby2_keywords, true) && (ruby2_keywords :keep_if)
 
       def clear() ;  value.clear; end
 

data/lib/.rbnext/2.7/anyway/type_casting.rb

@@ -90,6 +90,11 @@ module Anyway
     end
   end
 
+  unless "".respond_to?(:safe_constantize)
+    require "anyway/ext/string_constantize"
+    using Anyway::Ext::StringConstantize
+  end
+
   # TypeCaster is an object responsible for type-casting.
   # It uses a provided types registry and mapping, and also
   # accepts a fallback typecaster.
@@ -109,8 +114,16 @@ module Anyway
       return fallback.coerce(key, val) unless caster_config
 
       case; when ((__m__ = caster_config)) && false 
-      when ((__m__.respond_to?(:deconstruct_keys) && (((__m_hash__src__ = __m__.deconstruct_keys(nil)) || true) && (Hash === __m_hash__src__ || Kernel.raise(TypeError, "#deconstruct_keys must return Hash"))) && (__m_hash__ = __m_hash__src__.dup)) && ((__m_hash__.key?(:array) && __m_hash__.key?(:type)) && (((array = __m_hash__.delete(:array)) || true) && (((type = __m_hash__.delete(:type)) || true) && __m_hash__.empty?))))
+      when (((array, type) = nil) || ((Hash === __m__) && ((__m__.respond_to?(:deconstruct_keys) && (((__m_hash__src__ = __m__.deconstruct_keys(nil)) || true) && (Hash === __m_hash__src__ || Kernel.raise(TypeError, "#deconstruct_keys must return Hash"))) && (__m_hash__ = __m_hash__src__.dup)) && ((__m_hash__.key?(:array) && __m_hash__.key?(:type)) && (((array = __m_hash__.delete(:array)) || true) && (((type = __m_hash__.delete(:type)) || true) && __m_hash__.empty?))))))
         registry.deserialize(val, type, array: array)
+      when (((subconfig,) = nil) || ((Hash === __m__) && (__m__.respond_to?(:deconstruct_keys) && (((__m_hash__ = __m__.deconstruct_keys([:config])) || true) && (Hash === __m_hash__ || Kernel.raise(TypeError, "#deconstruct_keys must return Hash"))) && (__m_hash__.key?(:config) && ((subconfig = __m_hash__[:config]) || true)))))
+
+
+
+        subconfig = subconfig.safe_constantize if subconfig.is_a?(::String)
+        raise ArgumentError, "Config is not found: #{subconfig}" unless subconfig
+
+        subconfig.new(val)
       when (Hash === __m__)
 
 

data/lib/.rbnext/3.0/anyway/config.rb

@@ -8,6 +8,7 @@ module Anyway # :nodoc:
   using Anyway::Ext::DeepDup
   using Anyway::Ext::DeepFreeze
   using Anyway::Ext::Hash
+  using Anyway::Ext::FlattenNames
 
   using(Module.new do
     refine Object do
@@ -26,6 +27,7 @@ module Anyway # :nodoc:
     RESERVED_NAMES = %i[
       config_name
       env_prefix
+      as_env
       values
       class
       clear
@@ -47,8 +49,6 @@ module Anyway # :nodoc:
       __type_caster__
     ].freeze
 
-    ENV_OPTION_EXCLUDE_KEY = :except
-
     class Error < StandardError; end
 
     class ValidationError < Error; end
@@ -128,34 +128,14 @@ module Anyway # :nodoc:
         end
       end
 
-      def required(*names, env: nil)
-        unknown_names = names - config_attributes
+      def required(*names, env: nil, **nested)
+        unknown_names = names + nested.keys - config_attributes
         raise ArgumentError, "Unknown config param: #{unknown_names.join(",")}" if unknown_names.any?
 
-        names = filter_by_env(names, env)
-        required_attributes.push(*names)
-      end
+        return unless Settings.matching_env?(env)
 
-      def filter_by_env(names, env)
-        return names if env.nil? || env.to_s == current_env
-
-        filtered_names = if env.is_a?(Hash)
-          names_with_exclude_env_option(names, env)
-        elsif env.is_a?(Array)
-          names if env.flat_map(&:to_s).include?(current_env)
-        end
-
-        filtered_names || []
-      end
-
-      def current_env
-        Settings.current_environment.to_s
-      end
-
-      def names_with_exclude_env_option(names, env)
-        envs = env[ENV_OPTION_EXCLUDE_KEY]
-        excluded_envs = [envs].flat_map(&:to_s)
-        names if excluded_envs.none?(current_env)
+        required_attributes.push(*names)
+        required_attributes.push(*nested.flatten_names)
       end
 
       def required_attributes
@@ -223,6 +203,12 @@ module Anyway # :nodoc:
 
       def coerce_types(mapping)
         Utils.deep_merge!(coercion_mapping, mapping)
+
+        mapping.each do |key, val|
+          next unless val == :boolean || (val.is_a?(::Hash) && val[:type] == :boolean)
+
+          alias_method :"#{key}?", :"#{key}"
+        end
       end
 
       def coercion_mapping
@@ -268,7 +254,7 @@ module Anyway # :nodoc:
         names.each do |name|
           accessors_module.module_eval <<~RUBY, __FILE__, __LINE__ + 1
             def #{name}=(val)
-              __trace__&.record_value(val, \"#{name}\", **Tracing.current_trace_source)
+              __trace__&.record_value(val, "#{name}", **Tracing.current_trace_source)
               values[:#{name}] = val
             end
 
@@ -297,7 +283,7 @@ module Anyway # :nodoc:
         # - SomeModule::Config => "some_module"
         # - SomeConfig => "some"
         unless name =~ /^(\w+)(::)?Config$/
-          raise "Couldn't infer config name, please, specify it explicitly" \
+          raise "Couldn't infer config name, please, specify it explicitly " \
             "via `config_name :my_config`"
         end
 
@@ -430,13 +416,18 @@ module Anyway # :nodoc:
       end
     end
 
+    def as_env
+      Env.from_hash(to_h, prefix: env_prefix)
+    end
+
     private
 
     attr_reader :values, :__trace__
 
     def validate_required_attributes!
       self.class.required_attributes.select do |name|
-        values[name].nil? || (values[name].is_a?(String) && values[name].empty?)
+        val = values.dig(*name.to_s.split(".").map(&:to_sym))
+        val.nil? || (val.is_a?(String) && val.empty?)
       end.then do |missing|
         next if missing.empty?
         raise_validation_error "The following config parameters for `#{self.class.name}(config_name: #{self.class.config_name})` are missing or empty: #{missing.join(", ")}"

data/lib/.rbnext/3.0/anyway/loaders.rb

@@ -75,3 +75,5 @@ end
 require "anyway/loaders/base"
 require "anyway/loaders/yaml"
 require "anyway/loaders/env"
+require "anyway/loaders/doppler"
+require "anyway/loaders/ejson"

data/lib/.rbnext/3.0/anyway/tracing.rb

@@ -19,12 +19,12 @@ module Anyway
       def initialize(type = :trace, value = UNDEF, **source)
         @type = type
         @source = source
-        @value = value == UNDEF ? Hash.new { |h, k| h[k] = Trace.new(:trace) } : value
+        @value = (value == UNDEF) ? Hash.new { |h, k| h[k] = Trace.new(:trace) } : value
       end
 
       def dig(...)
         value.dig(...)
-      end
+      end; respond_to?(:ruby2_keywords, true) && (ruby2_keywords :dig)
 
       def record_value(val, *path, **opts)
         key = path.pop
@@ -35,7 +35,7 @@ module Anyway
         end
 
         target_trace = path.empty? ? self : value.dig(*path)
-        target_trace.value[key.to_s] = trace
+        target_trace.record_key(key.to_s, trace)
 
         val
       end
@@ -54,6 +54,12 @@ module Anyway
         hash
       end
 
+      def record_key(key, key_trace)
+        @value = Hash.new { |h, k| h[k] = Trace.new(:trace) } unless value.is_a?(::Hash)
+
+        value[key] = key_trace
+      end
+
       def merge!(another_trace)
         raise ArgumentError, "You can only merge into a :trace type, and this is :#{type}" unless trace?
         raise ArgumentError, "You can only merge a :trace type, but trying :#{type}" unless another_trace.trace?
@@ -70,7 +76,7 @@ module Anyway
       def keep_if(...)
         raise ArgumentError, "You can only filter :trace type, and this is :#{type}" unless trace?
         value.keep_if(...)
-      end
+      end; respond_to?(:ruby2_keywords, true) && (ruby2_keywords :keep_if)
 
       def clear() ;  value.clear; end