env_parser 0.8.0 → 1.3.1

data/docs/js/app.js

@@ -120,6 +120,49 @@ function summaryToggle() {
   } else { localStorage.summaryCollapsed = "expand"; }
 }
 
+function constantSummaryToggle() {
+  $('.constants_summary_toggle').click(function(e) {
+    e.preventDefault();
+    localStorage.summaryCollapsed = $(this).text();
+    $('.constants_summary_toggle').each(function() {
+      $(this).text($(this).text() == "collapse" ? "expand" : "collapse");
+      var next = $(this).parent().parent().nextAll('dl.constants').first();
+      if (next.hasClass('compact')) {
+        next.toggle();
+        next.nextAll('dl.constants').first().toggle();
+      }
+      else if (next.hasClass('constants')) {
+        var list = $('<dl class="constants compact" />');
+        list.html(next.html());
+        list.find('dt').each(function() {
+           $(this).addClass('summary_signature');
+           $(this).text( $(this).text().split('=')[0]);
+          if ($(this).has(".deprecated").length) {
+             $(this).addClass('deprecated');
+          };
+        });
+        // Add the value of the constant as "Tooltip" to the summary object
+        list.find('pre.code').each(function() {
+          console.log($(this).parent());
+          var dt_element = $(this).parent().prev();
+          var tooltip = $(this).text();
+          if (dt_element.hasClass("deprecated")) {
+             tooltip = 'Deprecated. ' + tooltip;
+          };
+          dt_element.attr('title', tooltip);
+        });
+        list.find('.docstring, .tags, dd').remove();
+        next.before(list);
+        next.toggle();
+      }
+    });
+    return false;
+  });
+  if (localStorage.summaryCollapsed == "collapse") {
+    $('.constants_summary_toggle').first().click();
+  } else { localStorage.summaryCollapsed = "expand"; }
+}
+
 function generateTOC() {
   if ($('#filecontents').length === 0) return;
   var _toc = $('<ol class="top"></ol>');
@@ -128,6 +171,7 @@ function generateTOC() {
   var counter = 0;
   var tags = ['h2', 'h3', 'h4', 'h5', 'h6'];
   var i;
+  var curli;
   if ($('#filecontents h1').length > 1) tags.unshift('h1');
   for (i = 0; i < tags.length; i++) { tags[i] = '#filecontents ' + tags[i]; }
   var lastTag = parseInt(tags[0][1], 10);
@@ -147,15 +191,25 @@ function generateTOC() {
     }
     if (thisTag > lastTag) {
       for (i = 0; i < thisTag - lastTag; i++) {
-        var tmp = $('<ol/>'); toc.append(tmp); toc = tmp;
+        if ( typeof(curli) == "undefined" ) {
+          curli = $('<li/>');
+          toc.append(curli);
+        }
+        toc = $('<ol/>');
+        curli.append(toc);
+        curli = undefined;
       }
     }
     if (thisTag < lastTag) {
-      for (i = 0; i < lastTag - thisTag; i++) toc = toc.parent();
+      for (i = 0; i < lastTag - thisTag; i++) {
+        toc = toc.parent();
+        toc = toc.parent();
+      }
     }
     var title = $(this).attr('toc-title');
     if (typeof(title) == "undefined") title = $(this).text();
-    toc.append('<li><a href="#' + this.id + '">' + title + '</a></li>');
+    curli =$('<li><a href="#' + this.id + '">' + title + '</a></li>'); 
+    toc.append(curli);
     lastTag = thisTag;
   });
   if (!show) return;
@@ -232,6 +286,16 @@ function mainFocus() {
   setTimeout(function() { $('#main').focus(); }, 10);
 }
 
+function navigationChange() {
+  // This works around the broken anchor navigation with the YARD template.
+  window.onpopstate = function() {
+    var hash = window.location.hash;
+    if (hash !== '' && $(hash)[0]) {
+      $(hash)[0].scrollIntoView();
+    }
+  };
+}
+
 $(document).ready(function() {
   navResizer();
   navExpander();
@@ -241,8 +305,10 @@ $(document).ready(function() {
   searchFrameButtons();
   linkSummaries();
   summaryToggle();
+  constantSummaryToggle();
   generateTOC();
   mainFocus();
+  navigationChange();
 });
 
 })();

data/docs/method_list.html

@@ -4,9 +4,9 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta charset="utf-8" />
     
-      <link rel="stylesheet" href="css/full_list.css" type="text/css" media="screen" charset="utf-8" />
+      <link rel="stylesheet" href="css/full_list.css" type="text/css" media="screen" />
     
-      <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
+      <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" />
     
 
     
@@ -54,13 +54,21 @@
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="EnvParser.html#define_type-class_method" title="EnvParser.define_type (method)">define_type</a></span>
+      <span class='object_link'><a href="EnvParser.html#autoregister-class_method" title="EnvParser.autoregister (method)">autoregister</a></span>
       <small>EnvParser</small>
     </div>
   </li>
   
 
   <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="EnvParser.html#define_type-class_method" title="EnvParser.define_type (method)">define_type</a></span>
+      <small>EnvParser</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="top-level-namespace.html#filename-instance_method" title="#filename (method)">#filename</a></span>
       <small>Top Level Namespace</small>
@@ -68,7 +76,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="EnvParser.html#parse-class_method" title="EnvParser.parse (method)">parse</a></span>
       <small>EnvParser</small>
@@ -76,7 +84,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="EnvParser.html#register-class_method" title="EnvParser.register (method)">register</a></span>
       <small>EnvParser</small>

data/docs/top-level-namespace.html

@@ -6,15 +6,15 @@
 <title>
   Top Level Namespace
   
-    &mdash; Documentation by YARD 0.9.11
+    &mdash; Documentation by YARD 0.9.26
   
 </title>
 
-  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/style.css" type="text/css" />
 
-  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/common.css" type="text/css" />
 
-<script type="text/javascript" charset="utf-8">
+<script type="text/javascript">
   pathId = "";
   relpath = '';
 </script>
@@ -162,12 +162,12 @@
       <pre class="lines">
 
 
-315</pre>
+3</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/env_parser.rb', line 315</span>
+      <pre class="code"><span class="info file"># File 'lib/env_parser/types.rb', line 3</span>
 
-<span class='const'>Dir</span><span class='period'>.</span><span class='id identifier rubyid_glob'>glob</span><span class='lparen'>(</span><span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='id identifier rubyid___dir__'>__dir__</span><span class='comma'>,</span> <span class='qwords_beg'>%w[</span><span class='tstring_content'>env_parser</span><span class='words_sep'> </span><span class='tstring_content'>types</span><span class='words_sep'> </span><span class='tstring_content'>*.rb</span><span class='words_sep'>]</span><span class='rparen'>)</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_filename'>filename</span><span class='op'>|</span> <span class='id identifier rubyid_require_relative'>require_relative</span> <span class='id identifier rubyid_filename'>filename</span> <span class='rbrace'>}</span></pre>
+<span class='const'>Dir</span><span class='period'>.</span><span class='id identifier rubyid_glob'>glob</span><span class='lparen'>(</span><span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='id identifier rubyid___dir__'>__dir__</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>types</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>*.rb</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_filename'>filename</span><span class='op'>|</span> <span class='id identifier rubyid_require_relative'>require_relative</span> <span class='id identifier rubyid_filename'>filename</span> <span class='rbrace'>}</span></pre>
     </td>
   </tr>
 </table>
@@ -178,9 +178,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sun Dec 24 19:33:35 2017 by
+  Generated on Sat Jan  2 17:31:17 2021 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.11 (ruby-2.4.2).
+  0.9.26 (ruby-2.7.2).
 </div>
 
     </div>

data/env_parser.gemspec

@@ -20,10 +20,14 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 1.16'
-  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rspec', '~> 3.0'
   spec.add_development_dependency 'rspec_junit_formatter'
+  spec.add_development_dependency 'rubocop', '1.7'
+  spec.add_development_dependency 'yard'
 
   spec.add_dependency 'activesupport', '>= 5.0.0'
+  spec.add_dependency 'chronic'
+  spec.add_dependency 'chronic_duration'
 end

data/lib/env_parser.rb

@@ -1,61 +1,52 @@
+require 'env_parser/errors'
 require 'env_parser/version'
 require 'active_support/all'
+require 'psych'
 
 ## The EnvParser class simplifies parsing of environment variables as different data types.
 ##
 class EnvParser
-  ## Base exception class for EnvParser.
+  ## The default filename to use for {.autoregister} requests.
   ##
-  class Error < ::StandardError
-  end
-
-  ## Exception class used to indicate parsed values not allowed per a "from_set" option.
-  ##
-  class ValueNotAllowed < Error
-  end
-
-  ## Exception class used to indicate a type has already been defined.
-  ##
-  class TypeAlreadyDefined < Error
-  end
+  AUTOREGISTER_FILE = '.env_parser.yml'.freeze
 
   class << self
-    ## Defines a new type for use as the "as" option on a subsequent `.parse` or `.register` call.
+    ## Defines a new type for use as the "as" option on a subsequent {.parse} or {.register} call.
     ##
     ## @param name [Symbol]
     ##   The name to assign to the type.
     ##
-    ## @option options aliases [Array<Symbol>]
+    ## @option options [Array<Symbol>] aliases
     ##   An array of additional names you'd like to see refer to this same type.
     ##
-    ## @option options if_unset
+    ## @option options if_unset (nil)
     ##   Specifies a "sensible default" to return for this type if the value being parsed (via
-    ##   `.parse` or `.register`) is either unset (`nil`) or blank (`''`). Note this may be
-    ##   overridden by the user via the `.parse`/`.register` "if_unset" option.
+    ##   {.parse} or {.register}) is either unset (`nil`) or blank (`''`). Note this may be
+    ##   overridden by the user via the {.parse}/{.register} "if_unset" option.
     ##
-    ## @yield
+    ## @yield [value]
     ##   A block to act as the parser for the this type. If no block is given, an ArgumentError is
     ##   raised.
     ##
-    ##   When the type defined is used via a `.parse`/`.register` call, this block is invoked with
+    ##   When the type defined is used via a {.parse}/{.register} call, this block is invoked with
     ##   the value to be parsed. Said value is guaranteed to be a non-empty String (the "if_unset"
     ##   check will have already run), but no other assurances as to content are given. The block
     ##   should return the final output of parsing the given String value as the type being defined.
     ##
     ##   If the value given cannot be sensibly parsed into the type defined, the block should raise
-    ##   an EnvParser::ValueNotAllowed exception.
+    ##   an {EnvParser::ValueNotConvertibleError}.
     ##
     ## @return [nil]
     ##   This generates no usable value.
     ##
-    ## @raise [ArgumentError, EnvParser::TypeAlreadyDefined]
+    ## @raise [ArgumentError, EnvParser::TypeAlreadyDefinedError]
     ##
     def define_type(name, options = {}, &parser)
       raise(ArgumentError, 'no parsing block given') unless block_given?
 
       given_types = (Array(name) + Array(options[:aliases])).map(&:to_s).map(&:to_sym)
       given_types.each do |type|
-        raise(TypeAlreadyDefined, "cannot redefine #{type.inspect}") if known_types.key?(type)
+        raise(TypeAlreadyDefinedError, "cannot redefine #{type.inspect}") if known_types.key?(type)
 
         known_types[type] = {
           parser: parser,
@@ -72,12 +63,13 @@ class EnvParser
     ##   The value to parse/interpret. If a String is given, the value will be used as-is. If a
     ##   Symbol is given, the ENV value for the matching string key will be used.
     ##
-    ## @option options as [Symbol]
+    ## @option options [Symbol] as
     ##   The expected return type. A best-effort attempt is made to convert the source String to the
     ##   requested type.
     ##
-    ##   If no "as" option is given (or the "as" value given has not been defined), an ArgumentError
-    ##   exception is raised.
+    ##   If no "as" option is given, an ArgumentError is raised. If the "as" option given is unknown
+    ##   (the given type has not been previously defined via {.define_type}), an
+    ##   {EnvParser::UnknownTypeError} is raised.
     ##
     ## @option options if_unset
     ##   Specifies the default value to return if the given "value" is either unset (`nil`) or blank
@@ -85,43 +77,45 @@ class EnvParser
     ##   change having been made.  If unspecified, the "default" value for `nil`/`''` input will
     ##   depend on the "as" type.
     ##
-    ## @option options from_set [Array, Range]
+    ## @option options [Array, Range] from_set
     ##   Gives a limited set of allowed values (after type conversion). If, after parsing, the final
-    ##   value is not included in the "from_set" list/range, an EnvParser::ValueNotAllowed exception
-    ##   is raised.
+    ##   value is not included in the "from_set" list/range, an {EnvParser::ValueNotAllowedError} is
+    ##   raised.
     ##
     ##   Note that if the "if_unset" option is given and the value to parse is `nil`/`''`, the
     ##   "if_unset" value will be returned, even if it is not part of the "from_set" list/range.
     ##
     ##   Also note that, due to the nature of the lookup, the "from_set" option is only available
     ##   for scalar values (i.e. not arrays, hashes, or other enumerables). An attempt to use the
-    ##   "from_set" option with a non-scalar value will raise an ArgumentError exception.
+    ##   "from_set" option with a non-scalar value will raise an ArgumentError.
     ##
-    ## @option options validated_by [Proc]
-    ##   If given, the "validated_by" proc is called with the parsed value (after type conversion)
+    ## @option options [Proc] validated_by
+    ##   If given, the "validated_by" Proc is called with the parsed value (after type conversion)
     ##   as its sole argument. This allows for user-defined validation of the parsed value beyond
-    ##   what can be enforced by use of the "from_set" option alone. If the proc's return value is
-    ##   `#blank?`, an EnvParser::ValueNotAllowed exception is raised. To accomodate your syntax of
-    ##   choice, this validation proc may be given as a yield block instead.
+    ##   what can be enforced by use of the "from_set" option alone. If the Proc's return value is
+    ##   `#blank?`, an {EnvParser::ValueNotAllowedError} is raised. To accomodate your syntax of
+    ##   choice, this validation Proc may be given as a block instead.
     ##
     ##   Note that this option is intended to provide an inspection mechanism only -- no mutation
-    ##   of the parsed value should occur within the given proc. To that end, the argument passed is
+    ##   of the parsed value should occur within the given Proc. To that end, the argument passed is
     ##   a *frozen* duplicate of the parsed value.
     ##
     ## @yield [value]
-    ##   A block (if given) is treated exactly as the "validated_by" Proc would. Although there is
-    ##   no compelling reason to provide both a "validated_by" proc *and* a validation block, there
-    ##   is no technical limitation preventing this. **If both are given, both validation checks
-    ##   must pass.**
+    ##   A block (if given) is treated exactly as the "validated_by" Proc would.
     ##
-    ## @raise [ArgumentError, EnvParser::ValueNotAllowed]
+    ##   Although there is no compelling reason to provide both a "validated_by" Proc *and* a
+    ##   validation block, there is no technical limitation preventing this. **If both are given,
+    ##   both validation checks must pass.**
+    ##
+    ## @raise [ArgumentError, EnvParser::UnknownTypeError, EnvParser::ValueNotAllowedError]
     ##
     def parse(value, options = {}, &validation_block)
       value = ENV[value.to_s] if value.is_a? Symbol
       value = value.to_s
 
       type = known_types[options[:as]]
-      raise(ArgumentError, "invalid `as` parameter: #{options[:as].inspect}") unless type
+      raise(ArgumentError, 'missing `as` parameter') unless options.key?(:as)
+      raise(UnknownTypeError, "invalid `as` parameter: #{options[:as].inspect}") unless type
 
       return (options.key?(:if_unset) ? options[:if_unset] : type[:if_unset]) if value.blank?
 
@@ -134,9 +128,8 @@ class EnvParser
 
     ## Parses the referenced value and creates a matching constant in the requested context.
     ##
-    ## Multiple calls to "register" may be shortcutted by passing in a Hash with the same keys as
-    ## those in the "from" Hash and each value being the "register" options set for each variable's
-    ## "register" call.
+    ## Multiple calls to {.register} may be shortcutted by passing in a Hash whose keys are the
+    ## variable names and whose values are the options set for each variable's {.register} call.
     ##
     ## <pre>
     ##   ## Example shortcut usage:
@@ -153,40 +146,39 @@ class EnvParser
     ## </pre>
     ##
     ## @param name
-    ##   The name of the value to parse/interpret from the "from" Hash. If the "from" value is ENV,
-    ##   you may give a Symbol and the corresponding String key will be used instead.
+    ##   The name of the value to parse/interpret from the "from" Hash. If the "from" value is
+    ##   `ENV`, you may give a Symbol and the corresponding String key will be used instead.
     ##
-    ## @option options from [Hash]
-    ##   The source Hash from which to pull the value referenced by the "name" key. Defaults to ENV.
+    ## @option options [Hash] from (ENV)
+    ##   The source Hash from which to pull the value referenced by the "name" key.
     ##
-    ## @option options within [Module, Class]
-    ##   The module or class in which the constant should be created. Defaults to Kernel (making it
-    ##   a global constant).
+    ## @option options [Module, Class] within (Kernel)
+    ##   The module or class in which the constant should be created. Creates global constants by
+    ##   default.
     ##
-    ## @option options as [Symbol]
-    ##   See `.parse`.
+    ## @option options [Symbol] as
+    ##   See {.parse}.
     ##
     ## @option options if_unset
-    ##   See `.parse`.
+    ##   See {.parse}.
     ##
-    ## @option options from_set [Array, Range]
-    ##   See `.parse`.
+    ## @option options [Array, Range] from_set
+    ##   See {.parse}.
     ##
-    ## @option options validated_by [Proc]
-    ##   See `.parse`.
+    ## @option options [Proc] validated_by
+    ##   See {.parse}.
     ##
     ## @yield [value]
-    ##   A block (if given) is treated exactly as in `.parse`. Note, however, that a single yield
-    ##   block cannot be used to register multiple constants simultaneously -- each value needing
-    ##   validation must give its own "validated_by" proc.
+    ##   A block (if given) is treated exactly as in {.parse}. Note, however, that a single block
+    ##   cannot be used to register multiple constants simultaneously -- each value needing
+    ##   validation must give its own "validated_by" Proc.
     ##
     ## @raise [ArgumentError]
     ##
     def register(name, options = {}, &validation_block)
-      ## We want to allow for registering multiple variables simultaneously via a single `.register`
-      ## method call.
+      ## Allow for registering multiple variables simultaneously via a single call.
       if name.is_a? Hash
-        raise ArgumentError, 'cannot register multiple values with one yield block' if block_given?
+        raise(ArgumentError, 'cannot register multiple values with one block') if block_given?
         return register_all(name)
       end
 
@@ -202,9 +194,7 @@ class EnvParser
         name = name.to_s
       end
 
-      unless from.is_a?(Hash)
-        raise ArgumentError, "invalid `from` parameter: #{from.class}"
-      end
+      raise ArgumentError, "invalid `from` parameter: #{from.class}" unless from.is_a? Hash
 
       unless within.is_a?(Module) || within.is_a?(Class)
         raise ArgumentError, "invalid `within` parameter: #{within.inspect}"
@@ -217,14 +207,14 @@ class EnvParser
       value
     end
 
-    ## Creates ENV bindings for EnvParser.parse and EnvParser.register proxy methods.
+    ## Creates ENV bindings for {.parse} and {.register} proxy methods.
     ##
     ## The sole difference between these proxy methods and their EnvParser counterparts is that
     ## ENV.parse will interpret any value given as an ENV key (as a String), not the given value
     ## itself.  i.e. ENV.parse('XYZ', ...) is equivalent to EnvParser.parse(ENV['XYZ'], ...)
     ##
     ## @return [ENV]
-    ##   This generates no usable value, so we may as well return ENV for chaining?
+    ##   This generates no usable value.
     ##
     def add_env_bindings
       ENV.instance_eval do
@@ -240,6 +230,47 @@ class EnvParser
       ENV
     end
 
+    ## Reads an "autoregister" file and registers the ENV constants defined therein.
+    ##
+    ## The "autoregister" file is read, parsed as YAML, sanitized for use as a parameter to
+    ## {.register_all}, and then passed along for processing. The return value from that
+    ## {.register_all} call is passed through.
+    ##
+    ## @param filename [String]
+    ##   A path for the autoregister file to parse and process. Defaults to
+    ##   {EnvParser::AUTOREGISTER_FILE} if unset.
+    ##
+    ## @return [Hash]
+    ##   The return value from the {.register_all} call that handles the actual registration.
+    ##
+    ## @raise [EnvParser::AutoregisterFileNotFound, EnvParser::UnparseableAutoregisterSpec]
+    ##
+    def autoregister(filename = nil)
+      filename ||= AUTOREGISTER_FILE
+      autoregister_spec = Psych.load_file(filename)
+
+      autoregister_spec.deep_symbolize_keys!
+      autoregister_spec.transform_values! do |spec|
+        sanitized = spec.slice(:as, :within, :if_unset, :from_set)
+        sanitized[:as] = sanitized[:as].to_sym if sanitized.key? :as
+        sanitized[:within] = sanitized[:within].constantize if sanitized.key? :within
+
+        sanitized
+      end
+
+      register_all autoregister_spec
+
+    ## Psych raises an Errno::ENOENT on file-not-found.
+    ##
+    rescue Errno::ENOENT
+      raise EnvParser::AutoregisterFileNotFound, %(file not found: "#{filename}")
+
+    ## Psych raises a Psych::SyntaxError on unparseable YAML.
+    ##
+    rescue Psych::SyntaxError => e
+      raise EnvParser::UnparseableAutoregisterSpec, "malformed YAML in spec file: #{e.message}"
+    end
+
     private
 
     ## Class instance variable for storing known type data.
@@ -256,7 +287,7 @@ class EnvParser
     ## @return [nil]
     ##   This generates no usable value.
     ##
-    ## @raise [ArgumentError, EnvParser::ValueNotAllowed]
+    ## @raise [ArgumentError, EnvParser::ValueNotAllowedError]
     ##
     def check_for_set_inclusion(value, set: nil)
       if value.respond_to?(:each)
@@ -267,9 +298,7 @@ class EnvParser
         raise ArgumentError, "invalid `from_set` parameter type: #{set.class}"
       end
 
-      raise ValueNotAllowed, 'parsed value not in allowed list/range' unless set.include?(value)
-
-      nil
+      raise(ValueNotAllowedError, 'parsed value not in allowed set') unless set.include?(value)
     end
 
     ## Verifies that the given "value" passes both the "proc" and "block" validations.
@@ -281,18 +310,17 @@ class EnvParser
     ## @return [nil]
     ##   This generates no usable value.
     ##
-    ## @raise [EnvParser::ValueNotAllowed]
+    ## @raise [EnvParser::ValueNotAllowedError]
     ##
     def check_user_defined_validations(value, proc: nil, block: nil)
       immutable_value = value.dup.freeze
-      error = 'parsed value failed user validation'
-      raise ValueNotAllowed, error unless [proc, block].compact.all? { |i| i.call(immutable_value) }
+      all_tests_passed = [proc, block].compact.all? { |i| i.call(immutable_value) }
 
-      nil
+      raise(ValueNotAllowedError, 'parsed value failed user validation') unless all_tests_passed
     end
 
-    ## Receives a list of "register" calls to make, as a Hash keyed with variable names and the
-    ## values being each "register" call's option set.
+    ## Receives a list of {.register} calls to make, as a Hash keyed with variable names and the
+    ## values being each {.register} call's option set.
     ##
     ## @param list [Hash]
     ##
@@ -301,7 +329,7 @@ class EnvParser
     ## @raise [ArgumentError]
     ##
     def register_all(list)
-      raise ArgumentError, "invalid 'list' parameter type: #{list.class}" unless list.is_a?(Hash)
+      raise(ArgumentError, "invalid 'list' parameter type: #{list.class}") unless list.is_a? Hash
 
       list.to_a.each_with_object({}) do |tuple, output|
         output[tuple.first] = register(tuple.first, tuple.second)
@@ -310,6 +338,6 @@ class EnvParser
   end
 end
 
-## Load all files listed in "/lib/env_parser/types".
+## Load predefined types.
 ##
-Dir.glob(File.join(__dir__, %w[env_parser types *.rb])).each { |filename| require_relative filename }
+require 'env_parser/types'