chamber 3.0.0rc2 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9de7c74ea902d381006bd6b5f05bae3680d1beef940ae75e483f30c923bc310f
-  data.tar.gz: b6f45eb5b668a5964e898ffb4caa5b9a3e9bc227736dd0e687e257cff0c99f84
+  metadata.gz: 9e37ed83e4c76419880c6abbfdc967f2e82a6fc8824b868904cae1fcb26878d0
+  data.tar.gz: a61415b6fcce618cbd452a7373b22b3ea1093cb8150b12df6798021743ff02d3
 SHA512:
-  metadata.gz: b1ab7fedfaf6cb26ab3e97402966368f3e686751ca76e441a7d9db64b7fe354a289ac4ac330cac806fb7960f3b4750c1ce4f7799e548c4f0f549ee57826e8552
-  data.tar.gz: 64cfa0683ca78d71cd620e38e60c4d2c25683c5217d74858995b2ee65eda704f7d2aca9395451ac743424bd75b8974ee088ed3563e192be5ab057f49ad458165
+  metadata.gz: c55d1d457aa0a4d908d4be0e790dc86f10895a2d6514613e1d2d27bfb6ebbde69a7d5e4bb4f0695e6f8da1d993f7d820644b3a975b88d2d91237936c15a6c5e3
+  data.tar.gz: d0cecb00b849c518ac20f1fefd6c76029e6dbd6a54a9676b28a94529a7df5da9e8a0ef8ea2301cfc9460a627ae168bbab3f07954a48931e5c9a9dd1d60d8f087

data/README.md

@@ -19,7 +19,7 @@ Chamber
   </a>
 
   <a href="https://github.com/thekompanee/chamber/actions?query=workflow%3ABuild" alt="Build Status">
-    <img src="https://img.shields.io/github/workflow/status/thekompanee/chamber/Build?label=CI&style=flat-square&logo=github" alt="Build Status" />
+    <img src="https://img.shields.io/github/actions/workflow/status/thekompanee/chamber/testing.yml?branch=master&label=CI&style=flat-square&logo=github" alt="Build Status" />
   </a>
 
   <a href="#" alt="Maintainability">
@@ -61,11 +61,11 @@ smtp_username: 'my_username'
 smtp_password: 'my_password'
 ```
 
-From there you can access your settings by using the special `Chamber.env`
+From there you can access your settings by using the special `Chamber.dig`
 constant.
 
 ```ruby
-Chamber.env.smtp_password
+Chamber.dig('smtp_password')
 # => 'my_password'
 ```
 
@@ -92,7 +92,7 @@ which you still access the same way because Chamber handles the decryption for
 you:
 
 ```ruby
-Chamber.env.smtp_password
+Chamber.dig('smtp_password')
 # => 'my_password'
 ```
 
@@ -117,7 +117,7 @@ The names and logos for The Kompanee are trademarks of The Kompanee, Ltd.
 License
 --------------------------------------------------------------------------------
 
-Chamber is Copyright © 2014-2021 Jeff Felchner and Mark McEahern. It is free
+Chamber is Copyright © 2014-2023 Jeff Felchner and Mark McEahern. It is free
 software, and may be redistributed under the terms specified in the
 [LICENSE][license] file.
 

data/lib/chamber/binary/runner.rb

@@ -2,9 +2,6 @@
 
 require 'thor'
 require 'chamber/rubinius_fix'
-require 'chamber/binary/travis'
-require 'chamber/binary/heroku'
-require 'chamber/binary/circle_ci'
 require 'chamber/commands/show'
 require 'chamber/commands/files'
 require 'chamber/commands/secure'
@@ -23,7 +20,7 @@ class   Runner < Thor
   class_option  :rootpath,
                 type:    :string,
                 aliases: '-r',
-                default: ENV['PWD'],
+                default: ENV.fetch('PWD', nil),
                 desc:    'The root filepath of the application'
 
   class_option  :basepath,
@@ -62,21 +59,6 @@ class   Runner < Thor
 
   ################################################################################
 
-  desc 'travis SUBCOMMAND ...ARGS', 'For manipulating Travis CI environment variables'
-  subcommand 'travis', Chamber::Binary::Travis
-
-  ################################################################################
-
-  desc 'heroku SUBCOMMAND ...ARGS', 'For manipulating Heroku environment variables'
-  subcommand 'heroku', Chamber::Binary::Heroku
-
-  ################################################################################
-
-  desc 'circleci SUBCOMMAND ...ARGS', 'For manipulating CircleCI environment variables'
-  subcommand 'circleci', Chamber::Binary::CircleCi
-
-  ################################################################################
-
   desc 'show', 'Displays the list of settings and their values'
 
   method_option :as_env,

data/lib/chamber/commands/base.rb

@@ -6,15 +6,15 @@ require 'chamber/instance'
 module  Chamber
 module  Commands
 class   Base
-  def self.call(**args)
-    new(**args).call
-  end
-
   attr_accessor :chamber,
                 :dry_run,
                 :rootpath,
                 :shell
 
+  def self.call(**args)
+    new(**args).call
+  end
+
   def initialize(shell: nil, rootpath: nil, dry_run: nil, **args)
     self.chamber  = Chamber::Instance.new(rootpath: rootpath, **args)
     self.shell    = shell

data/lib/chamber/commands/initialize.rb

@@ -11,14 +11,14 @@ require 'chamber/commands/base'
 module  Chamber
 module  Commands
 class   Initialize < Chamber::Commands::Base
-  def self.call(**args)
-    new(**args).call
-  end
-
   attr_accessor :basepath,
                 :namespaces,
                 :signature
 
+  def self.call(**args)
+    new(**args).call
+  end
+
   def initialize(signature:, namespaces: [], **args)
     super(**args)
 

data/lib/chamber/commands/securable.rb

@@ -52,11 +52,10 @@ module  Securable
       Shellwords.escape(filename)
     end
 
-    `
-      git ls-files --other --ignored --exclude-per-directory=.gitignore |
-      sed -e "s|^|#{Shellwords.escape(rootpath.to_s)}/|" |
-      grep --colour=never -E '#{shell_escaped_chamber_filenames.join('|')}'
-    `.split("\n")
+    `git ls-files --other --ignored --exclude-per-directory=.gitignore`
+      .split("\n")
+      .map    { |filename| "#{Shellwords.escape(rootpath.to_s)}/#{filename}" }
+      .select { |filename| shell_escaped_chamber_filenames.include?(filename) }
   end
 end
 end

data/lib/chamber/commands/show.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require 'pp'
 require 'chamber/commands/base'
 
 module  Chamber

data/lib/chamber/context_resolver.rb

@@ -10,6 +10,10 @@ module  Chamber
 class   ContextResolver
   attr_accessor :options
 
+  def self.resolve(**args)
+    new(**args).resolve
+  end
+
   def initialize(**args)
     self.options = args
   end
@@ -48,10 +52,6 @@ class   ContextResolver
   end
   # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize, Layout/LineLength
 
-  def self.resolve(**args)
-    new(**args).resolve
-  end
-
   protected
 
   def resolve_namespaces(other)

data/lib/chamber/errors/disallowed_class.rb

@@ -2,7 +2,7 @@
 
 module  Chamber
 module  Errors
-class   DisallowedClass < ::Psych::DisallowedClass
+class   DisallowedClass < ::ArgumentError
 end
 end
 end

data/lib/chamber/errors/invalid_key_type.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Chamber
+module Errors
+class  InvalidKeyType < ::ArgumentError
+end
+end
+end

data/lib/chamber/errors/missing_index.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Chamber
+module Errors
+class  MissingIndex < ::IndexError
+  def initialize(missing_index, all_keys)
+    super(<<~HEREDOC.chomp)
+      You attempted to access setting '#{all_keys.join(':')}' but the index '#{missing_index}' in the array did not exist.
+    HEREDOC
+  end
+end
+end
+end

data/lib/chamber/errors/missing_setting.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Chamber
+module Errors
+class  MissingSetting < ::KeyError
+  def initialize(missing_key, all_keys)
+    super(<<~HEREDOC.chomp)
+      You attempted to access setting '#{all_keys.join(':')}' but '#{missing_key}' did not exist.
+    HEREDOC
+  end
+end
+end
+end

data/lib/chamber/file_set.rb

@@ -256,7 +256,6 @@ class   FileSet
 
   private
 
-  # rubocop:disable Performance/ChainArrayAllocation
   def all_files
     @all_files ||= file_globs
                      .map { |fg| Pathname.glob(fg) }
@@ -264,7 +263,6 @@ class   FileSet
                      .uniq
                      .sort
   end
-  # rubocop:enable Performance/ChainArrayAllocation
 
   def non_namespaced_files
     @non_namespaced_files ||= all_files - namespaced_files

data/lib/chamber/filters/decryption_filter.rb

@@ -35,16 +35,16 @@ class   DecryptionFilter
                 :secure_key_token
   attr_reader   :decryption_keys
 
+  def self.execute(**args)
+    new(**args).__send__(:execute)
+  end
+
   def initialize(data:, secure_key_prefix:, decryption_keys: {}, **_args)
     self.decryption_keys  = (decryption_keys || {}).transform_keys(&:to_s)
     self.data             = data.deep_dup
     self.secure_key_token = /\A#{Regexp.escape(secure_key_prefix)}/
   end
 
-  def self.execute(**args)
-    new(**args).__send__(:execute)
-  end
-
   protected
 
   def execute(raw_data = data)

data/lib/chamber/filters/encryption_filter.rb

@@ -28,16 +28,16 @@ class     EncryptionFilter
                 :secure_key_token
   attr_reader   :encryption_keys
 
+  def self.execute(**args)
+    new(**args).__send__(:execute)
+  end
+
   def initialize(data:, secure_key_prefix:, encryption_keys: {}, **_args)
     self.encryption_keys  = (encryption_keys || {}).transform_keys(&:to_s)
     self.data             = data.deep_dup
     self.secure_key_token = /\A#{Regexp.escape(secure_key_prefix)}/
   end
 
-  def self.execute(**args)
-    new(**args).__send__(:execute)
-  end
-
   protected
 
   def execute(raw_data = data, namespace = nil)

data/lib/chamber/filters/environment_filter.rb

@@ -7,6 +7,9 @@ require 'chamber/errors/environment_conversion'
 module  Chamber
 module  Filters
 class   EnvironmentFilter
+  attr_accessor :data,
+                :secure_key_token
+
   ###
   # Internal: Allows the existing environment to be injected into the passed in
   # hash.  The hash that is passed in is *not* modified, instead a new hash is
@@ -91,9 +94,6 @@ class   EnvironmentFilter
     new(**args).__send__(:execute)
   end
 
-  attr_accessor :data,
-                :secure_key_token
-
   def initialize(data:, secure_key_prefix:, **_args)
     self.data             = data
     self.secure_key_token = /\A#{Regexp.escape(secure_key_prefix)}/
@@ -111,7 +111,7 @@ class   EnvironmentFilter
       lambda do |key, value, environment_key|
         {
           key => convert_environment_value(environment_key,
-                                           ENV[environment_key],
+                                           ENV.fetch(environment_key, nil),
                                            value),
         }
       end,

data/lib/chamber/filters/failed_decryption_filter.rb

@@ -10,13 +10,13 @@ class   FailedDecryptionFilter
 
   BASE64_STRING_PATTERN = %r{\A[A-Za-z0-9+/]{342}==\z}.freeze
 
+  attr_accessor :data,
+                :secure_key_token
+
   def self.execute(**args)
     new(**args).__send__(:execute)
   end
 
-  attr_accessor :data,
-                :secure_key_token
-
   def initialize(data:, secure_key_prefix:, **_args)
     self.data             = data.deep_dup
     self.secure_key_token = /\A#{Regexp.escape(secure_key_prefix)}/

data/lib/chamber/filters/namespace_filter.rb

@@ -9,13 +9,13 @@ class   NamespaceFilter
   using ::Chamber::Refinements::DeepDup
   using ::Chamber::Refinements::Hash
 
+  attr_accessor :data,
+                :namespaces
+
   def self.execute(**args)
     new(**args).__send__(:execute)
   end
 
-  attr_accessor :data,
-                :namespaces
-
   def initialize(data:, namespaces:, **_args)
     self.data       = data.deep_dup
     self.namespaces = namespaces

data/lib/chamber/filters/secure_filter.rb

@@ -7,13 +7,13 @@ module  Filters
 class   SecureFilter
   using ::Chamber::Refinements::DeepDup
 
+  attr_accessor :data,
+                :secure_key_token
+
   def self.execute(**args)
     new(**args).__send__(:execute)
   end
 
-  attr_accessor :data,
-                :secure_key_token
-
   def initialize(data:, secure_key_prefix:, **_args)
     self.data             = data.deep_dup
     self.secure_key_token = /\A#{Regexp.escape(secure_key_prefix)}/

data/lib/chamber/filters/translate_secure_keys_filter.rb

@@ -7,13 +7,13 @@ module  Filters
 class   TranslateSecureKeysFilter
   using ::Chamber::Refinements::DeepDup
 
+  attr_accessor :data,
+                :secure_key_token
+
   def self.execute(**args)
     new(**args).__send__(:execute)
   end
 
-  attr_accessor :data,
-                :secure_key_token
-
   def initialize(data:, secure_key_prefix:, **_args)
     self.data             = data.deep_dup
     self.secure_key_token = /\A#{Regexp.escape(secure_key_prefix)}/

data/lib/chamber/integrations/sinatra.rb

@@ -7,7 +7,7 @@ module Integrations
 module Sinatra
   def self.registered(app)
     app.configure do |inner_app|
-      env  = inner_app.environment || ENV['RACK_ENV']
+      env  = inner_app.environment || ENV.fetch('RACK_ENV', nil)
       root = inner_app.root
 
       if defined?(Padrino)

data/lib/chamber/keys/base.rb

@@ -3,14 +3,14 @@
 module  Chamber
 module  Keys
 class   Base
-  def self.resolve(**args)
-    new(**args).resolve
-  end
-
   attr_accessor :rootpath
   attr_reader   :filenames,
                 :namespaces
 
+  def self.resolve(**args)
+    new(**args).resolve
+  end
+
   def initialize(rootpath:, namespaces:, filenames: nil)
     self.rootpath   = Pathname.new(rootpath)
     self.namespaces = namespaces
@@ -20,7 +20,11 @@ class   Base
   def resolve
     key_paths.each_with_object({}) do |path, memo|
       namespace = namespace_from_path(path) || '__default'
-      value     = path.readable? ? path.read : ENV[environment_variable_from_path(path)]
+      value     = if path.readable?
+                    path.read
+                  else
+                    ENV.fetch(environment_variable_from_path(path), nil)
+                  end
 
       memo[namespace.downcase.to_sym] = value if value
     end
@@ -39,13 +43,13 @@ class   Base
                  namespaces.map { |n| namespace_to_key_path(n) }
   end
 
-  # rubocop:disable Performance/ChainArrayAllocation, Performance/MapCompact
+  # rubocop:disable Performance/MapCompact
   def filenames=(other)
     @filenames = Array(other)
                    .map { |o| Pathname.new(o) }
                    .compact
   end
-  # rubocop:enable Performance/ChainArrayAllocation, Performance/MapCompact
+  # rubocop:enable Performance/MapCompact
 
   def namespaces=(other)
     @namespaces = other + %w{signature}

data/lib/chamber/namespace_set.rb

@@ -14,6 +14,8 @@ module  Chamber
 class   NamespaceSet
   include Enumerable
 
+  attr_reader :raw_namespaces
+
   ###
   # Internal: Allows for more compact NamespaceSet creation by giving a list of
   # namespace values.
@@ -28,8 +30,6 @@ class   NamespaceSet
     new(namespace_values)
   end
 
-  attr_reader :raw_namespaces
-
   ###
   # Internal: Creates a new NamespaceSet from arrays, hashes and sets.
   #

data/lib/chamber/rails.rb

@@ -1,3 +1,3 @@
 # frozen_string_literal: true
 
-require 'chamber/integrations/rails' if defined?(::Rails)
+require 'chamber/integrations/rails' if defined?(Rails)

data/lib/chamber/settings.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'chamber/errors/missing_index'
+require 'chamber/errors/missing_setting'
 require 'chamber/namespace_set'
 require 'chamber/filters/namespace_filter'
 require 'chamber/filters/encryption_filter'
@@ -236,9 +238,13 @@ class   Settings
   end
 
   def [](key)
-    fail ::ArgumentError, 'Bracket access with anything other than a String is unsupported.' unless key.is_a?(::String)
+    fail ::Chamber::Errors::InvalidKeyType, 'Bracket access with anything other than a String is unsupported.' unless key.is_a?(::String)
 
     data.fetch(key)
+  rescue ::KeyError => error
+    missing_setting_name = error.message.gsub(/.*key not found: "([^"]+)".*/, '\1')
+
+    raise ::Chamber::Errors::MissingSetting.new(missing_setting_name, [])
   end
 
   def dig!(*args)
@@ -247,11 +253,21 @@ class   Settings
 
       data_value.fetch(key)
     end
+  rescue ::KeyError => error
+    missing_setting_name = error.message.gsub(/.*key not found: "([^"]+)".*/, '\1')
+
+    raise ::Chamber::Errors::MissingSetting.new(missing_setting_name, args)
+  rescue ::IndexError => error
+    missing_index_number = error.message.gsub(/.*index (\d+) outside.*/, '\1')
+
+    raise ::Chamber::Errors::MissingIndex.new(missing_index_number, args)
   end
 
   def dig(*args)
     dig!(*args)
-  rescue ::KeyError, ::IndexError # rubocop:disable Lint/ShadowedException
+  rescue ::Chamber::Errors::MissingSetting,
+         ::Chamber::Errors::MissingIndex
+
     nil
   end
 

data/lib/chamber/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Chamber
-  VERSION = '3.0.0rc2'
+  VERSION = '3.0.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chamber
 version: !ruby/object:Gem::Version
-  version: 3.0.0rc2
+  version: 3.0.1
 platform: ruby
 authors:
 - thekompanee
@@ -14,8 +14,8 @@ cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
   MIIEdjCCAt6gAwIBAgIBATANBgkqhkiG9w0BAQsFADAyMTAwLgYDVQQDDCdhY2Nv
-  dW50c19ydWJ5Z2Vtcy9EQz10aGVrb21wYW5lZS9EQz1jb20wHhcNMjIwMzA1MjM0
-  OTEzWhcNMjMwMzA1MjM0OTEzWjAyMTAwLgYDVQQDDCdhY2NvdW50c19ydWJ5Z2Vt
+  dW50c19ydWJ5Z2Vtcy9EQz10aGVrb21wYW5lZS9EQz1jb20wHhcNMjMwMzA2MDM0
+  ODUxWhcNMjYwMzA1MDM0ODUxWjAyMTAwLgYDVQQDDCdhY2NvdW50c19ydWJ5Z2Vt
   cy9EQz10aGVrb21wYW5lZS9EQz1jb20wggGiMA0GCSqGSIb3DQEBAQUAA4IBjwAw
   ggGKAoIBgQD0Z84PxtE0iiWCMTQbnit6D4w55GGBQZnhpWUCJwC0SpQ/jnT0Fsma
   g8oAIdDclLvLC9jzqSAmkOujlpkJMb5NabgkhKFwHi6cVW/gz/cVnISAv8LQTIM5
@@ -28,17 +28,17 @@ cert_chain:
   y7jqKMpOE1UCAwEAAaOBljCBkzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNV
   HQ4EFgQU7+XQuN042fZGvzLhYbIwDfsxZV8wLAYDVR0RBCUwI4EhYWNjb3VudHMr
   cnVieWdlbXNAdGhla29tcGFuZWUuY29tMCwGA1UdEgQlMCOBIWFjY291bnRzK3J1
-  YnlnZW1zQHRoZWtvbXBhbmVlLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEA04F3jVFD
-  BwHv8GVMkvUAc7r247lEEYfYuU/Iq0fivT1ugxN9pqT/ODwyPSdYy4Aqj8j4HHbM
-  2OQcKXb9SXjlIa/u5McPlhbsTQozs77bXOmrlAXN6shRJtTKSKm5ttmM/sDeks6p
-  wdhM0KHu5PBFZQjWfJuqi0hH13l0qQH+8r2GzXTHMKNX+6m1cTAkP81OPFIekn0l
-  boFRgsIr1j335pLV/+hgCRNSlU84E59YVVm+W9kP0Ym/n6051mBaaEMsWnm3td7a
-  c7BNPTxfmZrtz3TVq9VvzdHad3/+1QdNl9+l3VdL7wZ3GKZLhyifn7dc5EXxiZHJ
-  eDcSScq4x5NTMajXoJLKcoQPJDL7rUpPtvGj3v9O20RzHlWVDqVdzeYlswDjIqwe
-  ZjvLRaDI6IVoq0skZju//VZLiN6slVhAYYQj0uka/T0DZieabVYDcT4BVpa9M7Gz
-  CDW/VDWjvEEbsCIW0oYhtUrkqE8GLIdrpLUjefOERbS5TslD7lG/MH5k
+  YnlnZW1zQHRoZWtvbXBhbmVlLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAIaR7p1yv
+  +nE+JX/7nItZ0YKE71L6JdAuAlUfvTuHq8S1dpKdewrm3ewNPGt2nK9svy8vxNUQ
+  AqT3KWIaGVwkslL/y/MRxBQHOOZz9XCMmUYXIencNXqNzkWLubcCK7uF1h8mRS46
+  jvGfiXfYDwi8QzqJA8IFEK/oyKCCKlNiIbz8Q4yHM4wTqLwjYQqlHiBEgCF2UHc6
+  0tCTD8eixdZUeuexdB7M7F/M086y1wjWyYCeijqbKmTPqKb8n6AmLo0fqkNBVibJ
+  nYVEOECVzKt/f3PoG0Z2oMnZ6FKqpFiDpPqgAlRDmVznjpMdZR204/t79NoEVlLf
+  lxz9Q1u83TUBUPvDRzKg6Kq9P28JV1Ipnst0ecQZOsnoLjl1BmxUt29hQPJKjd11
+  Z6HMkN0PHJ6eG0Zl3/H4H8Xb+KreWlEx3sXXfZj6UscrdHAVffRQnM1E98PCqnRX
+  l5EwT4ShG/HorJMQSTY1EoBLZf54NrD5WlWcfM0CLrcvT7QM77dIqmue
   -----END CERTIFICATE-----
-date: 2022-03-06 00:00:00.000000000 Z
+date: 2023-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -144,18 +144,8 @@ files:
 - README.md
 - bin/chamber
 - lib/chamber.rb
-- lib/chamber/adapters/cloud/circle_ci.rb
-- lib/chamber/adapters/cloud/heroku.rb
-- lib/chamber/binary/circle_ci.rb
-- lib/chamber/binary/heroku.rb
 - lib/chamber/binary/runner.rb
-- lib/chamber/binary/travis.rb
 - lib/chamber/commands/base.rb
-- lib/chamber/commands/cloud/base.rb
-- lib/chamber/commands/cloud/clear.rb
-- lib/chamber/commands/cloud/compare.rb
-- lib/chamber/commands/cloud/pull.rb
-- lib/chamber/commands/cloud/push.rb
 - lib/chamber/commands/comparable.rb
 - lib/chamber/commands/compare.rb
 - lib/chamber/commands/files.rb
@@ -165,7 +155,6 @@ files:
 - lib/chamber/commands/show.rb
 - lib/chamber/commands/sign.rb
 - lib/chamber/commands/travis.rb
-- lib/chamber/commands/travis/secure.rb
 - lib/chamber/commands/verify.rb
 - lib/chamber/configuration.rb
 - lib/chamber/context_resolver.rb
@@ -175,6 +164,9 @@ files:
 - lib/chamber/errors/decryption_failure.rb
 - lib/chamber/errors/disallowed_class.rb
 - lib/chamber/errors/environment_conversion.rb
+- lib/chamber/errors/invalid_key_type.rb
+- lib/chamber/errors/missing_index.rb
+- lib/chamber/errors/missing_setting.rb
 - lib/chamber/errors/non_conforming_key.rb
 - lib/chamber/file.rb
 - lib/chamber/file_set.rb
@@ -226,9 +218,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.7.5
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.1.6
 signing_key: 

data/lib/chamber/adapters/cloud/circle_ci.rb

@@ -1,85 +0,0 @@
-# frozen_string_literal: true
-
-require 'json'
-require 'net/http'
-require 'uri'
-
-module  Chamber
-module  Adapters
-module  Cloud
-class   CircleCi
-  API_HOST     = 'circleci.com'
-  API_PORT     = 443
-  API_BASE_URI = '/api/v1.1'
-
-  attr_accessor :api_token,
-                :project,
-                :username,
-                :vcs_type
-
-  def initialize(api_token:, project:, username:, vcs_type:)
-    self.api_token = api_token
-    self.project   = project
-    self.username  = username
-    self.vcs_type  = vcs_type
-  end
-
-  def add_environment_variable(name, value)
-    value   = value.gsub(/\n/, '\n')
-    request = ::Net::HTTP::Post.new(request_uri(resource: 'envvar'))
-
-    request.basic_auth api_token, ''
-    request['Content-Type'] = 'application/json'
-    request.body            = ::JSON.dump(name: name, value: value)
-
-    response = ::JSON.parse(response(request).body)
-
-    fail NameError, response['message'] if response['message']
-
-    response['name']
-  end
-
-  # rubocop:disable Layout/MultilineAssignmentLayout
-  def environment_variables
-    @environment_variables ||= \
-      begin
-        request = ::Net::HTTP::Get.new(request_uri(resource: 'envvar'))
-
-        request.basic_auth api_token, ''
-        request['Content-Type'] = 'application/json'
-
-        ::JSON
-          .parse(response(request).body)
-          .each_with_object({}) { |e, m| m[e['name']] = e['value'] }
-      end
-  end
-  # rubocop:enable Layout/MultilineAssignmentLayout
-
-  def remove_environment_variable(name)
-    request = ::Net::HTTP::Delete.new(request_uri(resource: "envvar/#{name}"))
-
-    request.basic_auth api_token, ''
-    request['Content-Type'] = 'application/json'
-
-    ::JSON.parse(response(request).body)['message'] == 'ok'
-  end
-
-  private
-
-  def request_uri(resource:)
-    "#{API_BASE_URI}/project/#{vcs_type}/#{username}/#{project}/#{resource}"
-  end
-
-  def response(request)
-    connection.request(request)
-  end
-
-  def connection
-    @connection ||= ::Net::HTTP.new(API_HOST, API_PORT).tap do |conn|
-      conn.use_ssl = true
-    end
-  end
-end
-end
-end
-end

data/lib/chamber/adapters/cloud/heroku.rb

@@ -1,74 +0,0 @@
-# frozen_string_literal: true
-
-require 'json'
-require 'net/http'
-require 'uri'
-
-module  Chamber
-module  Adapters
-module  Cloud
-class   Heroku
-  API_HOST     = 'api.heroku.com'
-  API_PORT     = 443
-  API_BASE_URI = ''
-
-  attr_accessor :api_token,
-                :app
-
-  def initialize(api_token:, app:)
-    self.api_token = api_token
-    self.app       = app
-  end
-
-  def add_environment_variable(name, value)
-    value   = value.gsub(/\n/, '\n') if value
-    request = ::Net::HTTP::Patch.new(config_vars_uri)
-
-    request['Authorization'] = "Bearer #{api_token}"
-    request['Accept']        = 'application/vnd.heroku+json; version=3'
-    request['Content-Type']  = 'application/json'
-    request.body             = ::JSON.dump({ name => value })
-
-    response = ::JSON.parse(response(request).body)
-
-    fail NameError, response['message'] if response['message']
-
-    response
-  end
-
-  def environment_variables
-    request = ::Net::HTTP::Get.new(config_vars_uri)
-
-    request['Authorization'] = "Bearer #{api_token}"
-    request['Accept']        = 'application/vnd.heroku+json; version=3'
-
-    response = ::JSON.parse(response(request).body)
-
-    fail NameError, response['message'] if response['message']
-
-    response
-  end
-
-  def remove_environment_variable(name)
-    add_environment_variable(name, nil)
-  end
-
-  private
-
-  def config_vars_uri
-    "#{API_BASE_URI}/apps/#{app}/config-vars"
-  end
-
-  def response(request)
-    connection.request(request)
-  end
-
-  def connection
-    @connection ||= ::Net::HTTP.new(API_HOST, API_PORT).tap do |conn|
-      conn.use_ssl = true
-    end
-  end
-end
-end
-end
-end

data/lib/chamber/binary/circle_ci.rb

@@ -1,121 +0,0 @@
-# frozen_string_literal: true
-
-require 'thor'
-require 'chamber/commands/cloud/clear'
-require 'chamber/commands/cloud/push'
-require 'chamber/commands/cloud/pull'
-require 'chamber/commands/cloud/compare'
-
-module  Chamber
-module  Binary
-class   CircleCi < Thor
-  include Thor::Actions
-
-  class_option :api_token,
-               type:     :string,
-               aliases:  '-t',
-               required: true,
-               desc:     'The API token to access your CircleCI project.'
-
-  class_option :project,
-               type:     :string,
-               aliases:  '-p',
-               required: true,
-               desc:     'The project name in your VCS (eg Github).'
-
-  class_option :username,
-               type:     :string,
-               aliases:  '-u',
-               required: true,
-               desc:     'The user/organization name in your VCS (eg Github).'
-
-  class_option :vcs_type,
-               type:    :string,
-               aliases: '-v',
-               default: 'github',
-               desc:    'The type of VCS your project is using.',
-               enum:    %w{github bitbucket}
-
-  desc 'clear',
-       'Removes all CircleCi environment variables which match settings that Chamber ' \
-       'knows about'
-
-  method_option :dry_run,
-                type:    :boolean,
-                aliases: '-d',
-                desc:    'Does not actually remove anything, but instead displays what ' \
-                         'would change if cleared'
-
-  def clear
-    Commands::Cloud::Clear.call(**options
-                                    .transform_keys(&:to_sym)
-                                    .merge(shell: self, adapter: 'circle_ci'))
-  end
-
-  desc 'push',
-       'Sends settings to CircleCi so that they may be used in the application ' \
-       'once it is deployed'
-
-  method_option :dry_run,
-                type:    :boolean,
-                aliases: '-d',
-                desc:    'Does not actually push anything to CircleCi, but instead ' \
-                         'displays what would change if pushed'
-
-  method_option :keys,
-                type:    :boolean,
-                aliases: '-k',
-                desc:    'Pushes private Chamber keys to CircleCi as environment ' \
-                         'variables. Chamber will automatically detect it and ' \
-                         'transparently decrypt your secure settings without any ' \
-                         'further synchronization.'
-
-  method_option :only_sensitive,
-                type:    :boolean,
-                aliases: '-o',
-                default: true,
-                desc:    'When enabled, only settings contained in files which have ' \
-                         'been gitignored or settings which are marked as "_secure" ' \
-                         'will be pushed'
-
-  def push
-    Commands::Cloud::Push.call(**options
-                                   .transform_keys(&:to_sym)
-                                   .merge(shell: self, adapter: 'circle_ci'))
-  end
-
-  desc 'pull',
-       'Retrieves the environment variables for the application and stores them in a ' \
-       'temporary file'
-
-  method_option :into,
-                type: :string,
-                desc: 'The file into which the CircleCi config information should be ' \
-                      'stored. This file WILL BE OVERRIDDEN.'
-
-  def pull
-    Commands::Cloud::Pull.call(**options
-                                   .transform_keys(&:to_sym)
-                                   .merge(shell: self, adapter: 'circle_ci'))
-  end
-
-  desc 'compare',
-       'Displays the difference between what is currently stored in the ' \
-       'CircleCi application\'s config and what Chamber knows about locally'
-
-  method_option :only_sensitive,
-                type:    :boolean,
-                aliases: '-o',
-                default: true,
-                desc:    'When enabled, the diff will only consider settings ' \
-                         'contained in files which have been gitignored or settings ' \
-                         'which are marked as "_secure"'
-
-  def compare
-    Commands::Cloud::Compare.call(**options
-                                      .transform_keys(&:to_sym)
-                                      .merge(shell: self, adapter: 'circle_ci'))
-  end
-end
-end
-end

data/lib/chamber/binary/heroku.rb

@@ -1,109 +0,0 @@
-# frozen_string_literal: true
-
-require 'thor'
-require 'chamber/commands/cloud/clear'
-require 'chamber/commands/cloud/push'
-require 'chamber/commands/cloud/pull'
-require 'chamber/commands/cloud/compare'
-
-module  Chamber
-module  Binary
-class   Heroku < Thor
-  include Thor::Actions
-
-  class_option :app,
-               type:     :string,
-               aliases:  '-a',
-               required: true,
-               desc:     'The name of the Heroku application whose config values will ' \
-                         'be affected'
-
-  class_option :api_token,
-               type:     :string,
-               aliases:  '-t',
-               required: true,
-               desc:     'The API token to access your Heroku project.'
-
-  desc 'clear',
-       'Removes all Heroku environment variables which match settings that ' \
-       'Chamber knows about'
-
-  method_option :dry_run,
-                type:    :boolean,
-                aliases: '-d',
-                desc:    'Does not actually remove anything, but instead displays what ' \
-                         'would change if cleared'
-
-  def clear
-    Commands::Cloud::Clear.call(**options
-                                    .transform_keys(&:to_sym)
-                                    .merge(shell: self, adapter: 'heroku'))
-  end
-
-  desc 'push',
-       'Sends settings to Heroku so that they may be used in the application ' \
-       'once it is deployed'
-
-  method_option :dry_run,
-                type:    :boolean,
-                aliases: '-d',
-                desc:    'Does not actually push anything to Heroku, but instead ' \
-                         'displays what would change if pushed'
-
-  method_option :keys,
-                type:    :boolean,
-                aliases: '-k',
-                desc:    'Pushes private Chamber keys to Heroku as environment ' \
-                         'variables. Chamber will automatically detect it and ' \
-                         'transparently decrypt your secure settings without any ' \
-                         'further synchronization.'
-
-  method_option :only_sensitive,
-                type:    :boolean,
-                aliases: '-o',
-                default: true,
-                desc:    'When enabled, only settings contained in files which have ' \
-                         'been gitignored or settings which are marked as "_secure" ' \
-                         'will be pushed'
-
-  def push
-    Commands::Cloud::Push.call(**options
-                                   .transform_keys(&:to_sym)
-                                   .merge(shell: self, adapter: 'heroku'))
-  end
-
-  desc 'pull',
-       'Retrieves the environment variables for the application and stores ' \
-       'them in a temporary file'
-
-  method_option :into,
-                type: :string,
-                desc: 'The file into which the Heroku config information should be ' \
-                      'stored. This file WILL BE OVERRIDDEN.'
-
-  def pull
-    Commands::Cloud::Pull.call(**options
-                                   .transform_keys(&:to_sym)
-                                   .merge(shell: self, adapter: 'heroku'))
-  end
-
-  desc 'compare',
-       'Displays the difference between what is currently stored in the ' \
-       'Heroku application\'s config and what Chamber knows about locally'
-
-  method_option :only_sensitive,
-                type:    :boolean,
-                aliases: '-o',
-                default: true,
-                desc:    'When enabled, the diff will only consider settings ' \
-                         'contained in files which have been gitignored or settings ' \
-                         'which are marked as "_secure"'
-
-  def compare
-    Commands::Cloud::Compare.call(**options
-                                      .transform_keys(&:to_sym)
-                                      .merge(shell: self, adapter: 'heroku'))
-  end
-end
-end
-end

data/lib/chamber/binary/travis.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-require 'thor'
-require 'chamber/commands/travis/secure'
-
-module  Chamber
-module  Binary
-class   Travis < Thor
-  desc 'secure',
-       'Uses your Travis CI public key to encrypt the settings you have ' \
-       'chosen not to commit to the repo'
-
-  method_option :dry_run,
-                type:    :boolean,
-                aliases: '-d',
-                desc:    'Does not actually encrypt anything to .travis.yml, but ' \
-                         'instead displays what values would be encrypted'
-
-  method_option :only_sensitive,
-                type:    :boolean,
-                aliases: '-o',
-                default: true,
-                desc:    'Does not encrypt settings into .travis.yml unless they are ' \
-                         'contained in files which have been gitignored or settings ' \
-                         'which are marked as "_secure"'
-
-  def secure
-    Commands::Travis::Secure.call(**options.transform_keys(&:to_sym).merge(shell: self))
-  end
-end
-end
-end

data/lib/chamber/commands/cloud/base.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require 'chamber/commands/base'
-
-module  Chamber
-module  Commands
-module  Cloud
-class   Base < Chamber::Commands::Base
-  attr_accessor :adapter
-
-  def initialize(adapter:, **args)
-    super(**args)
-
-    self.adapter = adapter_class(adapter).new(**args)
-  end
-
-  private
-
-  def adapter_class(adapter_name)
-    require "chamber/adapters/cloud/#{adapter_name}"
-
-    @adapter_class ||= case adapter_name
-                       when 'circle_ci'
-                         Chamber::Adapters::Cloud::CircleCi
-                       when 'heroku'
-                         Chamber::Adapters::Cloud::Heroku
-                       else
-                         fail ArgumentError,
-                              "Invalid Chamber cloud adapter name: #{adapter_name}"
-                       end
-  end
-end
-end
-end
-end

data/lib/chamber/commands/cloud/clear.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require 'chamber/commands/cloud/base'
-
-module  Chamber
-module  Commands
-module  Cloud
-class   Clear < Chamber::Commands::Cloud::Base
-  def call
-    chamber.to_environment.each_key do |key|
-      next unless adapter.environment_variables.has_key?(key)
-
-      if dry_run
-        shell.say_status 'remove', key, :blue
-      else
-        shell.say_status 'remove', key, :green
-
-        adapter.remove_environment_variable(key)
-      end
-    end
-  end
-end
-end
-end
-end

data/lib/chamber/commands/cloud/compare.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require 'chamber/commands/cloud/base'
-require 'chamber/commands/comparable'
-require 'chamber/commands/securable'
-
-module  Chamber
-module  Commands
-module  Cloud
-class   Compare < Chamber::Commands::Cloud::Base
-  include Chamber::Commands::Securable
-  include Chamber::Commands::Comparable
-
-  protected
-
-  def first_settings_data
-    ::JSON.pretty_generate(securable_environment_variables)
-  end
-
-  def second_settings_data
-    ::JSON.pretty_generate(adapter.environment_variables)
-  end
-end
-end
-end
-end

data/lib/chamber/commands/cloud/pull.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-require 'json'
-require 'chamber/commands/cloud/base'
-
-module  Chamber
-module  Commands
-module  Cloud
-class   Pull < Chamber::Commands::Cloud::Base
-  attr_accessor :target_file
-
-  def initialize(into:, **args)
-    super
-
-    self.target_file = into
-  end
-
-  def call
-    if target_file
-      shell.create_file(target_file,
-                        ::JSON.pretty_generate(adapter.environment_variables))
-    else
-      adapter.environment_variables
-    end
-  end
-end
-end
-end
-end

data/lib/chamber/commands/cloud/push.rb

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-require 'chamber/commands/cloud/base'
-require 'chamber/commands/securable'
-require 'chamber/keys/decryption'
-
-module  Chamber
-module  Commands
-module  Cloud
-class   Push < Chamber::Commands::Cloud::Base
-  include Chamber::Commands::Securable
-
-  attr_accessor :keys
-
-  def initialize(keys:, **args)
-    super(**args)
-
-    self.keys = keys
-  end
-
-  def call
-    environment_variables = if keys
-                              Keys::Decryption
-                                .new(rootpath:   chamber.configuration.rootpath,
-                                     namespaces: chamber.configuration.namespaces)
-                                .as_environment_variables
-                            else
-                              securable_environment_variables
-                            end
-
-    environment_variables.each do |key, value|
-      if dry_run
-        shell.say_status 'push', key, :blue
-      else
-        shell.say_status 'push', key, :green
-
-        adapter.add_environment_variable(key, value)
-      end
-    end
-  end
-end
-end
-end
-end

data/lib/chamber/commands/travis/secure.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-require 'chamber/commands/base'
-require 'chamber/commands/travis'
-require 'chamber/commands/securable'
-
-module  Chamber
-module  Commands
-module  Travis
-class   Secure < Chamber::Commands::Base
-  include Chamber::Commands::Travis
-  include Chamber::Commands::Securable
-
-  def call
-    securable_environment_variables.each do |key, value|
-      if dry_run
-        shell.say_status 'encrypt', key, :blue
-      else
-        command = first_environment_variable?(key) ? '--override' : '--append'
-
-        shell.say_status 'encrypt', key, :green
-        travis_encrypt("#{command} #{key}=#{value}")
-      end
-    end
-  end
-
-  protected
-
-  def first_environment_variable?(key)
-    @first_environment_key ||= securable_environment_variables.first[0]
-
-    @first_environment_key == key
-  end
-end
-end
-end
-end