inquisitive 3.1.1 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 78b5345c827669dee4928a4907d68799180a7b6a
-  data.tar.gz: 39899a19a8e7701645acc4134d1c1f8d4e7af5a0
+  metadata.gz: 1bf41f9d4ffbed28a841aaab8e093bcd954ec01c
+  data.tar.gz: 489460f2ad128b65ad6f0802619e03fbfaab1034
 SHA512:
-  metadata.gz: 0a8a2423a9dccc219ac6d3dd13fc9d953e827a83cf6aa089e6dec24deaf21e171c73f4e4b130e7472c3c4467ad4cd821bf75450c13f028096df95153f806580a
-  data.tar.gz: aae5568da7e1a36a75adbc0573fa7a2a3c26b2ef543deee13f1c44631870e752e2710d441603004fed126ca2b7bcf419ae82ca38f93d6249ff7542012bc45349
+  metadata.gz: 7c1b287a58cd1553cc9494f44f66a047f0dee425854c07255b770e050073b358564f6e9d55d9733ab18b406301be9005208d3354c1fb117f1fa1da65086ab9b8
+  data.tar.gz: 0de5a6cbb898c07464c96001903c699ea8797d608bf557a1e65ed10b996c7097ee72f3b599404b8baa59d7bc0155c88e5237613c60ea7a03671759506b9f7a0d

data/.travis.yml

@@ -21,6 +21,10 @@ env:
 
 matrix:
   fast_finish: true
+  allow_failures:
+    - rvm: 1.9.3
+    - rvm: jruby # Until it gets up to 2.0.0 syntax
+    - rvm: rbx-2 # Ditto
   exclude:
     - gemfile: Gemfile.ActiveSupport
       env: ""

data/CHANGELOG.md

@@ -0,0 +1,170 @@
+Changes to Inquisitive
+======================
+
+> **Please consult this file when upgrading Inquisitive for important information on bugfixes, new features, and backwards incompatible changes.**
+
+Starting with **[2.0.0](#2.0.0)**, Inquisitive follows [symantic versioning](symver.org) to help inform you of the implications of upgrades.
+
+Releases
+--------
+
+[4.0.0]: https://github.com/christhekeele/inquisitive/tree/4.0.0
+
+[2.0.1]: https://github.com/christhekeele/inquisitive/tree/2.0.1
+[2.0.0]: https://github.com/christhekeele/inquisitive/tree/2.0.0
+
+[1.2.0]: https://github.com/christhekeele/inquisitive/tree/f314eaf84f7c3d9a2d56ae684d031dd81d2f7b85
+
+- [4.0.0](#4.0.0)
+- [2.0.0](#2.0.0)
+- [1.2.0](#1.2.0)
+
+4.0.0 - [2015.03.06][4.0.0]
+---------------------------
+
+Inquisitive has seen several new versions since this Changelog has been updated, all aimed at simplifying the codebase and adding a few features I've long desired. These goals have been accomplished with version 4.0.0, so now's as good as time as any to enumerate the changes. It's also a great time to upgrade!
+
+- `ruby-1.9.3`: **support dropped**
+
+  Support for ruby 1.9.3 has been dropped, as it has reached end of life. Syntactically 4.0.0 should still work with 1.9.3, but that's no longer assured and may change. 1.9.3 is still a part of the build matrix but failures are allowed. Refer to the continuous integration to see if it's still viable.
+
+- `Inquisitive::Environment.inquires_about`: **modes dropped**
+
+  Environment inquiry modes no longer exist; all lookups are dynamic. While cached inquiries are about 3 times faster each inquiry takes a fraction of a percent of a millisecond so the speed up is negligible. More importantly, dynamic-by-default follows the principle of least surprise. Between the two there's no reason offer other modes. The option is now silently ignored when declaring inquirers, but your application's behavior may change if you were relying on caching by default.
+
+- `Inquisitive::NilClass`: **null objects now available**
+
+  While `Inquisitive::NilClass`s don't act falsey in boolean checks, they're useful wherever you may have been expecting another Inquisitive object, because they respond to methods like all other Inquisitive objects. It's also a "black hole" object, so it'll return itself on deep inquiries to mock nested inquisitive datastructures:
+
+  ```ruby
+  nillish = Inquisitive::NilClass.new
+  #=> nil
+
+  nillish.nil?
+  #=> true
+  nillish.present?
+  #=> false
+
+  nillish.predicate?
+  #=> false
+  nillish.access
+  #=> nil
+  nillish.deep.access
+  #=> nil
+  nillish.not.access
+  #=> true
+  nillish.exclude.access
+  #=> true
+  nillish.no.access
+  #=> true
+  ```
+
+- `Inquisitive::Hash`: **missing keys return `Inquisitive::NilClass` instances**
+
+  This allows for further method chaining when you anticipate nested datastructures where there aren't any.
+
+- `Inquisitive::Environment.inquires_about`: **default values**
+
+  Environment inquirers can now set default values:
+
+  ```ruby
+  class MyApp
+    extend Inquisitive::Environment
+    inquires_about 'ENV', default: 'production'
+  end
+
+  MyApp.env?
+  #=> true
+  MyApp.env.production?
+  #=> true
+  ```
+
+- `Inquisitive::Environment.inquires_about`: **empty values**
+
+  Environment inquirers without defaults will return `Inquisitive::NilClass` instances for empty environment variables to allow method chains as if you had nested datastructures.
+
+- `Inquisitive::Environment.inquires_about`: **nested hashes**
+
+  You can now construct nested hashes from environment variables with multiple `__`s in their names:
+
+  ```ruby
+  ENV['STUB__API__PROTOCOL']   = 'https'
+  ENV['STUB__API__SUBDOMAINS'] = 'app,web,db'
+  class MyApp
+    extend Inquisitive::Environment
+    inquires_about 'STUB'
+  end
+
+  MyApp.stub
+  #=> {api: {protocol: "https", subdomains: ["app", "web", "db"]}}
+  MyApp.stub.api.protocol.http?
+  #=> false
+  MyApp.stub.api.subdomains.web?
+  #=> true
+  ```
+
+Refer to the documentation in the README.md for a through overview and more examples.
+
+2.0.1 - [2014.09.24][2.0.1]
+---------------------------
+
+### Non-breaking
+
+- `Inquisitive::Environment.truthy`: **helper regex**
+
+  The `truthy` method provides an easy way to handle various command-line representations of truthiness.
+
+
+2.0.0 - [2014.06.19][2.0.0]
+---------------------------
+
+### Breaking
+
+- `Inquisitive::Environment`: **hash detection**
+
+  Previously `inquires_about` needed a special syntax to detect when you want to parse a group of environment variables as a hash. This was accomplished by leaving a trailing `_` in the declaration, such as:
+
+  ```ruby
+  ENV['PREFIX_KEY1'] = "value1"
+  ENV['PREFIX_KEY2'] = "value2"
+  module Mine
+    extend Inquisitive::Environment
+    inquires_about 'PREFIX_'
+  end
+  Mine.prefix
+  #=> { 'key1' => 'value1', 'key2' => 'value2' }
+  ```
+
+  Now it auto-detects hash groupings by looking for a double-`_` in the key itself:
+
+  ```ruby
+  ENV['PREFIX__KEY1'] = "value1"
+  ENV['PREFIX__KEY2'] = "value2"
+  module Mine
+    extend Inquisitive::Environment
+    inquires_about 'PREFIX'
+  end
+  Mine.prefix
+  #=> { 'key1' => 'value1', 'key2' => 'value2' }
+  ```
+
+  Nested hashes (through multiple `__`'s) are not yet supported.
+
+- `Inquisitive::Environment`:  **default modes**
+
+  Previously the default mode was `:dynamic`. This was mostly to prevent unexpected behaviour for newcomers.
+
+  Now `:static` is the default. This is because `Inquisitive::Environment` is meant to be loaded immediately after a boot script that prepares your environment variables, and queried often later. `:static` optimizes to this usecase.
+
+  To reproduce the old behaviour, you must explicitly pass `mode: :dynamic` each to `inquires_about` invocation. Alternatively, `mode: :lazy` might be a viable way to get the benefits of `:static` without refactoring your boot process.
+
+### Non-breaking
+
+- `Inquisitive::Environment`: **cached mode now lazy mode**
+
+  The `:cached` environment mode is now known as `:lazy`. This is backwards compatible because all logic handling modes explicitly checks for `:static` or `:dynamic`, so any other named mode has the same behaviour as `:lazy`.
+
+1.2.0 - [2013.11.21][1.2.0]
+---------------------------
+
+Everything to date.

data/README.md

@@ -196,7 +196,7 @@ stubbed = Inquisitive::Hash.new(
   in: 'development',
   services: %w[database api],
   api: {protocol: 'https', subdomains: %w[app web db]},
-  ignorable: { junk: [ "" ] }
+  ignorable: { junk: [ '' ] }
 )
 #=> {"authentication"=>true,
 #=>  "in"=>"development",
@@ -315,8 +315,12 @@ nillish.present?
 #=> false
 
 
+nillish.predicate?
+#=> false
 nillish.access
 #=> nil
+nillish.deep.access
+#=> nil
 nillish.not.access
 #=> true
 nillish.exclude.access
@@ -325,7 +329,7 @@ nillish.no.access
 #=> true
 ```
 
-**Be warned**: since Ruby doesn't allow subclassing `NilClass` and provides no boolean-coercion mechanism, `Inquisitive::NilClass` **will** appear truthy. I recommend using built-in predicates (`stubbed.authentication? && ...`), presence predicates with ActiveSupport (`stubbed.authentication.present? && ...`), Inquisitive's presence utility (`Inquisitive.present?(stubbed.authentication) && ...`) or nil predicates (`stubbed.authentication.nil? || ...`) in boolean chains. Also note that for `Inquisitive::Hash` access, `stubbed.fetch(:authentication, ...)` behaves as expected.
+**Be warned**: since Ruby doesn't allow subclassing `NilClass` and provides no boolean-coercion interface, `Inquisitive::NilClass` **will** appear truthy. I recommend using built-in predicates (`stubbed.authentication? && ...`), presence predicates with ActiveSupport (`stubbed.authentication.present? && ...`), Inquisitive's presence utility (`Inquisitive.present?(stubbed.authentication) && ...`) or nil predicates (`stubbed.authentication.nil? || ...`) in boolean chains. Also note that for `Inquisitive::Hash` access, `stubbed.fetch(:authentication, ...)` behaves as expected.
 
 
 ### Inquisitive Environment
@@ -335,7 +339,7 @@ nillish.no.access
 #### Strings
 
 ```ruby
-ENV['ENVIRONMENT'] = "development"
+ENV['ENVIRONMENT'] = 'development'
 class MyApp
   extend Inquisitive::Environment
   inquires_about 'ENVIRONMENT'
@@ -354,7 +358,7 @@ MyApp.environment.production?
 Arrays are recognized when environment variables contain commas:
 
 ```ruby
-ENV['SUPPORTED_DATABASES'] = "mysql,postgres,sqlite"
+ENV['SUPPORTED_DATABASES'] = 'mysql,postgres,sqlite'
 class MyApp
   extend Inquisitive::Environment
   inquires_about 'SUPPORTED_DATABASES'
@@ -373,11 +377,11 @@ MyApp.supported_databases.sql_server?
 Hashes are recognized when environment variables names contain double underscores:
 
 ```ruby
-ENV['STUB__AUTHENTICATION'] = 'true'
-ENV['STUB__IN'] = "development"
-ENV['STUB__SERVICES'] = "database,api"
-ENV['STUB__API__PROTOCOL'] = "https"
-ENV['STUB__API__SUBDOMAINS'] = "app,web,db"
+ENV['STUB__AUTHENTICATION']  = 'true'
+ENV['STUB__IN']              = 'development'
+ENV['STUB__SERVICES']        = 'database,api'
+ENV['STUB__API__PROTOCOL']   = 'https'
+ENV['STUB__API__SUBDOMAINS'] = 'app,web,db'
 class MyApp
   extend Inquisitive::Environment
   inquires_about 'STUB'
@@ -401,12 +405,28 @@ MyApp.stub.api.subdomains.web?
 #=> true
 ```
 
+#### Defaults
+
+You can set default values for your environment inquirers.
+
+```ruby
+class MyApp
+  extend Inquisitive::Environment
+  inquires_about 'ENV', default: 'production'
+end
+
+MyApp.env?
+#=> true
+MyApp.env.production?
+#=> true
+```
+
 #### Naming
 
-You can name your environment inquirers with `:with`:
+You can also give your environment inquirers custom names:
 
 ```ruby
-ENV['ENVIRONMENT'] = "development"
+ENV['ENVIRONMENT'] = 'development'
 class MyApp
   extend Inquisitive::Environment
   inquires_about 'ENVIRONMENT', with: :env
@@ -446,11 +466,11 @@ By default such variables will be parsed as an `Inquisitive::String`, so predica
 
 ```ruby
 ENV['STUB_AUTHENTICATION'] = 'false'
-ENV['STUB_REGISTRATION'] = 'true'
+ENV['STUB_REGISTRATION']   = 'true'
 class MyApp
   extend Inquisitive::Environment
   inquires_about 'STUB_AUTHENTICATION', present_if: 'true'
-  inquires_about 'STUB_REGISTRATION', present_if: 'true'
+  inquires_about 'STUB_REGISTRATION',   present_if: 'true'
 end
 
 MyApp.stub_authentication
@@ -468,24 +488,24 @@ This only works on top-level inquirers, so there's no way to get our nested `MyA
 
 The `present_if` check uses `===` under the covers for maximum expressiveness, so you can also use it to match against regexs, classes, and other constructs.
 
-##### Truthy Booleans
+##### Truthy Strings
 
-`Inquisitive::Environment.truthy` contains a regex useful for reading booleans from environment variables.
+`Inquisitive::Environment.truthy` contains a regex useful for trying to read truthy values from string environment variables.
 
 ```ruby
-ENV['NO'] = 'no'
-ENV['YES'] = 'yes'
-ENV['TRUTHY'] = 'TrUe'
-ENV['FALSEY'] = 'FaLsE'
-ENV['BOOLEAN'] = '1'
+ENV['NO']        = 'no'
+ENV['YES']       = 'yes'
+ENV['TRUTHY']    = 'TrUe'
+ENV['FALSEY']    = 'FaLsE'
+ENV['BOOLEAN']   = '1'
 ENV['BOOLENOPE'] = '0'
 class MyCli
   extend Inquisitive::Environment
-  inquires_about 'NO', present_if: truthy
-  inquires_about 'YES', present_if: truthy
-  inquires_about 'TRUTHY', present_if: truthy
-  inquires_about 'FALSEY', present_if: truthy
-  inquires_about 'BOOLEAN', present_if: truthy
+  inquires_about 'NO',        present_if: truthy
+  inquires_about 'YES',       present_if: truthy
+  inquires_about 'TRUTHY',    present_if: truthy
+  inquires_about 'FALSEY',    present_if: truthy
+  inquires_about 'BOOLEAN',   present_if: truthy
   inquires_about 'BOOLENOPE', present_if: truthy
 end
 
@@ -502,37 +522,9 @@ MyApp.falsey?
 MyApp.boolean?
 #=> true
 MyApp.boolenope?
+#=> false
 ```
 
-#### Inquiry mode
-
-Environment inquirers have three configurable modes, defaulting to `:static`.
-
-```ruby
-class MyApp
-  extend Inquisitive::Environment
-  inquires_about 'STUB', mode: %i[dynamic lazy static].sample
-end
-```
-
-- **Dynamic**
-
-    Environment inquiries parse `ENV` on every invocation.
-
-    Use if you're manipulating the environment in between invocations, so `Inquisitive` can pick up on new values, detect changes between string or array notation, and discover new keys for hash notation.
-
-- **Lazy**
-
-    Environment inquiries check `ENV` on their first invocation, and re-use the response in future invocations.
-
-    Use if you're loading the module with environment inquiry methods before you've finished preparing your environment.
-
-- **Static**
-
-    Environment inquiries use the contents of `ENV` at the moment `inquires_about` was invoked.
-
-    Use if your application is well-behaved and doesn't go mucking around with the environment at runtim.
-
 
 
 Contributing

data/inquisitive.gemspec

@@ -3,11 +3,11 @@ lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
-  spec.name          = "inquisitive"
-  spec.version       = "3.1.1"
-  spec.authors       = ["Chris Keele"]
-  spec.email         = ["dev@chriskeele.com"]
-  spec.summary       = "Predicate methods for those curious about their datastructures."
+  spec.name          = 'inquisitive'
+  spec.version       = '4.0.0'
+  spec.authors       = ['Chris Keele']
+  spec.email         = ['dev@chriskeele.com']
+  spec.summary       = 'Predicate methods for those curious about their datastructures.'
   spec.description   = <<-DESC
     Predicate methods for those curious about their datastructures.
 
@@ -18,13 +18,13 @@ Gem::Specification.new do |spec|
     Also allows you to auto-instanciate and read inquisitive datastructures straight
     from your `ENV` hash.
   DESC
-  spec.homepage      = "http://christhekeele.github.io/inquisitive"
-  spec.license       = "MIT"
-  spec.files         = `git ls-files lib README.md LICENSE.md`.split($/)
-  spec.test_files    = `git ls-files test inquisitive.gemspec Gemfile Gemfile.lock Gemfile.ActiveSupport Rakefile .travis.yml .coveralls.yml`.split($/)
-  spec.require_paths = ["lib"]
+  spec.homepage      = 'http://christhekeele.github.io/inquisitive'
+  spec.license       = 'MIT'
+  spec.files         = `git ls-files lib inquisitive.gemspec Gemfile Gemfile.lock Gemfile.ActiveSupport Rakefile CHANGELOG.md README.md LICENSE.md`.split($/)
+  spec.test_files    = `git ls-files test .travis.yml .coveralls.yml`.split($/)
+  spec.require_paths = ['lib']
 
-  spec.add_development_dependency "bundler",   ">= 1.3"
-  spec.add_development_dependency "rake",      ">= 10.0"
-  spec.add_development_dependency "minitest",  ">= 5.0"
+  spec.add_development_dependency 'bundler',   '>= 1.3'
+  spec.add_development_dependency 'rake',      '>= 10.0'
+  spec.add_development_dependency 'minitest',  '>= 5.0'
 end

data/lib/inquisitive.rb

@@ -46,22 +46,6 @@ module Inquisitive
 
   end
 
-private
-
-  module Utils
-
-  private
-
-    def predicate_method?(string)
-      string[-1] == '?'
-    end
-
-    def predication(string)
-      string[0..-2]
-    end
-
-  end
-
 end
 
 require "inquisitive/nil_class"

data/lib/inquisitive/array.rb

@@ -1,3 +1,5 @@
+require 'inquisitive/utils'
+
 module Inquisitive
   class Array < ::Array
     include Inquisitive::Utils

data/lib/inquisitive/environment.rb

@@ -1,3 +1,5 @@
+require 'inquisitive/utils'
+
 module Inquisitive
   module Environment
     include Inquisitive::Utils
@@ -8,44 +10,27 @@ module Inquisitive
 
     def inquires_about(env_var, opts={})
 
-      env_accessor = opts.fetch(:with, env_var.downcase[/(.*?)(?=(?:_$|$))/])
-      @__env_accessors__ ||= HashWithIndifferentAccess.new
-      @__env_accessors__[env_accessor] = env_var
-
-      mode = Inquisitive[ opts.fetch(:mode, :static).to_s ]
+      env_accessor = opts.fetch(:with, env_var.downcase[/(.*?)(?=(?:_$|$))/]).to_sym
+      env_presence = :"#{env_accessor}?"
+      env_default  = opts[:default]
+      present_if = opts[:present_if]
 
-      if mode.dynamic?
-
-        define_singleton_method :"#{env_accessor}" do
-          Inquisitive[Parser[@__env_accessors__[__method__]]]
+      define_singleton_method env_presence do |opts={with_default: true}|
+        !!(opts[:with_default] and env_default) || if present_if
+          present_if === Inquisitive[Parser[env_var]]
+        else
+          Inquisitive.present? Inquisitive[Parser[env_var]]
         end
+      end
 
-      else
-
-        @__cached_env__ ||= HashWithIndifferentAccess.new
-        @__cached_env__[env_accessor] = Inquisitive[Parser[env_var]] if mode.static?
-
-        define_singleton_method :"#{env_accessor}" do
-          if @__cached_env__.has_key? __method__
-            @__cached_env__[__method__]
+      define_singleton_method env_accessor do
+        Inquisitive[
+          if send env_presence, with_default: false
+            Parser[env_var]
           else
-            @__cached_env__[__method__] = Inquisitive[Parser[@__env_accessors__[__method__]]]
+            env_default
           end
-        end
-
-      end
-
-      present_if = opts.fetch(:present_if, nil)
-
-      @__env_presence__ ||= HashWithIndifferentAccess.new
-      @__env_presence__["#{env_accessor}?"] = present_if if present_if
-
-      define_singleton_method :"#{env_accessor}?" do
-        if @__env_presence__.has_key? __method__
-          @__env_presence__[__method__] === send(predication(__method__))
-        else
-          Inquisitive.present? send(predication(__method__))
-        end
+        ]
       end
 
     end
@@ -56,7 +41,7 @@ module Inquisitive
       class << self
 
         def [](var_name)
-          result = if ENV.has_key? var_name
+          result = if ENV.has_key? var_name.to_s
 
             env_var = ENV[var_name]
             if env_var.include? ','

data/lib/inquisitive/hash.rb

@@ -1,3 +1,5 @@
+require 'inquisitive/utils'
+
 module Inquisitive
   class Hash < HashWithIndifferentAccess
     include Inquisitive::Utils
@@ -24,8 +26,10 @@ module Inquisitive
       else
         if block_given?
           yield(key)
-        else
+        elsif default
           default
+        else
+          raise KeyError, "key not found: #{key}"
         end
       end
     end

data/lib/inquisitive/nil_class.rb

@@ -1,3 +1,5 @@
+require 'inquisitive/utils'
+
 module Inquisitive
   class NilClass
     include Inquisitive::Utils
@@ -38,9 +40,9 @@ module Inquisitive
     def respond_to_missing?(method_name, include_private = false)
       true # nil.respond_to? method_name or predicate_method? method_name
     end
-    def method_missing(method_name, *arguments)
+    def method_missing(method_name, *arguments, &block)
       if nil.respond_to? method_name
-        nil.send method_name, *arguments
+        nil.send method_name, *arguments, &block
       elsif predicate_method? method_name
         presence
       else

data/lib/inquisitive/string.rb

@@ -1,3 +1,5 @@
+require 'inquisitive/utils'
+
 module Inquisitive
   class String < ::String
     include Inquisitive::Utils

data/lib/inquisitive/utils.rb

@@ -0,0 +1,17 @@
+module Inquisitive
+
+  module Utils
+
+  private
+
+    def predicate_method?(string)
+      string[-1] == '?'
+    end
+
+    def predication(string)
+      string[0..-2]
+    end
+
+  end
+
+end

data/test/inquisitive/combinatorial_environment_test.rb

@@ -16,6 +16,7 @@ class InquisitiveCombinatorialEnvironmentTest < EnvironmentTest
   end
   def teardown
     super
+    ENV.delete 'NIL_OBJECT'
     ENV.delete 'STRING'
     ENV.delete 'ARRAY'
     ENV.delete 'HASH__NOTHING'
@@ -42,46 +43,40 @@ class InquisitiveCombinatorialEnvironmentTest < EnvironmentTest
 
 end
 
-%w[dynamic lazy static].each do |mode|
-  %w[nil_object string array hash].each do |type|
+%w[nil_object string array hash].each do |type|
 
-    Inquisitive.const_set(
-      :"Inquisitive#{mode.capitalize}#{type.split('_').map(&:capitalize).join}EnvironmentTest",
-      Class.new(InquisitiveCombinatorialEnvironmentTest) do
+  Inquisitive.const_set(
+    :"Inquisitive#{type.split('_').map(&:capitalize).join}EnvironmentTest",
+    Class.new(InquisitiveCombinatorialEnvironmentTest) do
 
-        class << self
-          attr_accessor :mode, :type
-        end
+      class << self
+        attr_accessor :type
+      end
 
-        def setup
-          super
-          @mode = Inquisitive[self.class.mode]
-          @type = Inquisitive[self.class.type]
-          App.inquires_about @type.upcase, mode: @mode
-        end
+      def setup
+        super
+        @type = Inquisitive[self.class.type]
+        App.inquires_about @type.upcase
+      end
 
-        def nil_object
-          App.nil_object
-        end
-        def string
-          App.string
-        end
-        def array
-          App.array
-        end
-        def hash
-          App.hash
-        end
+      def nil_object
+        App.nil_object
+      end
+      def string
+        App.string
+      end
+      def array
+        App.array
+      end
+      def hash
+        App.hash
+      end
 
-        include CombinatorialEnvironmentTests
+      include CombinatorialEnvironmentTests
 
-      end
-    ).tap do |klass|
-      klass.mode = mode
-      klass.type = type
-    end.send :include, Object.const_get(:"#{type.split('_').map(&:capitalize).join}Tests")
-    # Mixes in type-specific tests to ensure lookup behaves normally
-    #  when accessed through the modes of App getters
+    end
+  ).tap do |klass|
+    klass.type = type
+  end.send :include, Object.const_get(:"#{type.split('_').map(&:capitalize).join}Tests")
 
-  end
 end

data/test/inquisitive/environment_test.rb

@@ -12,39 +12,60 @@ class InquisitiveEnvironmentTest < EnvironmentTest
     assert App.respond_to? :name_not_specified
   end
 
-  def test_default_mode_of_static
-    ENV['DEFAULTS_TO'] = 'static'
-    App.inquires_about 'DEFAULTS_TO'
-    ENV['DEFAULTS_TO'] = 'lazy'
-    assert App.defaults_to.static?
-    ENV['DEFAULTS_TO'] = 'dynamic'
-    assert App.defaults_to.static?
-  end
-
   def test_custom_string_presence
-    ENV['AUTHORIZABLE'] = 'false'
     App.inquires_about 'AUTHORIZABLE', present_if: 'true'
+    ENV['AUTHORIZABLE'] = 'false'
     refute App.authorizable?
+    ENV['AUTHORIZABLE'] = 'true'
+    assert App.authorizable?
   end
 
   def test_custom_regex_presence
-    ENV['AUTHORIZABLE'] = 'not at all'
     App.inquires_about 'AUTHORIZABLE', present_if: /yes/
+    ENV['AUTHORIZABLE'] = 'false'
     refute App.authorizable?
+    ENV['AUTHORIZABLE'] = 'yes'
+    assert App.authorizable?
   end
 
   def test_custom_class_presence
-    ENV['AUTHORIZABLE'] = 'not at all'
     App.inquires_about 'AUTHORIZABLE', present_if: Array
+    ENV['AUTHORIZABLE'] = 'false'
     refute App.authorizable?
+    ENV['AUTHORIZABLE'] = 'false,schmalse'
+    assert App.authorizable?
   end
 
   %w[true True TrUe TRUE yes Yes YeS YES 1].each do |truthy_var|
     define_method :"test_truthy_var_#{truthy_var}" do
-      ENV['TRUTHY'] = truthy_var
       App.inquires_about 'TRUTHY', present_if: App.truthy
+      ENV['TRUTHY'] = 'false'
+      refute App.truthy?
+      ENV['TRUTHY'] = truthy_var
       assert App.truthy?
     end
   end
 
+  def test_default_accessor_for_missing
+    App.inquires_about 'MISSING_WITH_DEFAULT', default: 'default'
+    assert_equal 'default', App.missing_with_default
+  end
+
+  def test_default_predicate_for_missing
+    App.inquires_about 'MISSING_WITH_DEFAULT', default: 'default'
+    assert App.missing_with_default?
+  end
+
+  def test_default_accessor_for_existing
+    App.inquires_about 'EXISTING_WITH_DEFAULT', default: 'default'
+    ENV['EXISTING_WITH_DEFAULT'] = @raw_string
+    assert_equal @raw_string, App.existing_with_default
+  end
+
+  def test_default_predicate_for_existing
+    App.inquires_about 'EXISTING_WITH_DEFAULT', default: 'default'
+    ENV['EXISTING_WITH_DEFAULT'] = @raw_string
+    assert App.existing_with_default?
+  end
+
 end

data/test/inquisitive/utils_test.rb

@@ -0,0 +1,26 @@
+require 'test_helper'
+
+class UtilsTest
+  Utils = Module.new.extend Inquisitive::Utils
+
+  def test_found_symbol_predicate_method_helper
+    assert Utils.send(:predicate_method?, :foo?)
+  end
+  def test_found_string_predicate_method_helper
+    assert Utils.send(:predicate_method?, "foo?")
+  end
+  def test_missing_symbol_predicate_method_helper
+    refute Utils.send(:predicate_method?, :foo)
+  end
+  def test_missing_string_predicate_method_helper
+    refute Utils.send(:predicate_method?, "foo")
+  end
+
+  def test_symbol_predication_helper
+    assert_equal Utils.send(:predication, :foo?),  'foo'
+  end
+  def test_string_predication_helper
+    assert_equal Utils.send(:predication, "foo?"), 'foo'
+  end
+
+end

data/test/inquisitive_test.rb

@@ -1,7 +1,6 @@
 require 'test_helper'
 
 class InquisitiveTest < Test
-  Utils = Module.new.extend Inquisitive::Utils
   HashWithIndifferentAccess ||= Inquisitive::HashWithIndifferentAccess
 
   def setup
@@ -146,26 +145,14 @@ class InquisitiveTest < Test
     refute Inquisitive.present?({})
   end
 
-####
-# UTILS
-##
-  def test_found_symbol_predicate_method_helper
-    assert Utils.send :predicate_method?, :foo?
-  end
-  def test_found_string_predicate_method_helper
-    assert Utils.send :predicate_method?, "foo?"
-  end
-  def test_missing_symbol_predicate_method_helper
-    refute Utils.send :predicate_method?, :foo
-  end
-  def test_missing_string_predicate_method_helper
-    refute Utils.send :predicate_method?, "foo"
+  def test_presence_predication
+    assert_throws :predicated do
+      object = Object.new
+      def object.present?
+        throw :predicated
+      end
+      Inquisitive.present? object
+    end
   end
 
-  def test_symbol_predication_helper
-    assert_equal Utils.send(:predication, :foo?),  'foo'
-  end
-  def test_string_predication_helper
-    assert_equal Utils.send(:predication, "foo?"), 'foo'
-  end
 end

data/test/shared/combinatorial_environment_tests.rb

@@ -14,18 +14,9 @@ module CombinatorialEnvironmentTests
     )
   end
 
-  def test_changing_variable_after_definition
-    App.inquires_about @type.upcase, mode: @mode, with: :precache
-    test = @mode.static? ? :assert_equal : :refute_equal
-    precache = App.precache
-    send :"change_#{@type}_variable"
-    send test, App.send(@type), precache
-  end
-
-  def test_changing_variable_after_invocation
-    test = @mode.dynamic? ? :assert_change : :refute_change
-    monitor = -> { App.send(@type) }
-    send test, monitor do
+  def test_changing_variable
+    App.inquires_about @type.upcase, with: :changeable
+    assert_change ->{ App.changeable } do
       send :"change_#{@type}_variable"
     end
   end

data/test/shared/hash_tests.rb

@@ -42,13 +42,24 @@ module HashTests
     assert_instance_of Inquisitive::Hash, hash[:nested]
   end
 
-  def test_hash_fetch_implicit_nil
+  def test_hash_fetch_missing
+    assert_raises KeyError do
+      hash.fetch(:nothing)
+    end
+  end
+  def test_hash_fetch_implicit_nil_with_default_value
     assert_equal hash.fetch(:missing_key, @default_value), @default_value
   end
-  def test_hash_fetch_explicit_nil
+  def test_hash_fetch_explicit_nil_with_default_value
     assert_equal hash.fetch(:nothing, @default_value), @default_value
   end
-  def test_hash_present_value
+  def test_hash_fetch_implicit_nil_with_default_block
+    assert_equal hash.fetch(:missing_key){@default_value}, @default_value
+  end
+  def test_hash_fetch_explicit_nil_with_default_block
+    assert_equal hash.fetch(:nothing){@default_value}, @default_value
+  end
+  def test_hash_fetch_present_value
     assert_equal hash.fetch(:in), @raw_string
   end
 

data/test/shared/nil_object_tests.rb

@@ -13,6 +13,15 @@ module NilObjectTests
   def test_nil_object_miss
     refute nil_object.anything_else?
   end
+  def test_nil_object_presence_predicate
+    refute nil_object.present?
+  end
+  def test_nil_object_presence_predicate_negataive
+    assert nil_object.not.present?
+  end
+  def test_nil_object_presence_predicate_double_negataive
+    refute nil_object.not.not.present?
+  end
 
   def test_nil_object_string_interface
     string = nil_object

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inquisitive
 version: !ruby/object:Gem::Version
-  version: 3.1.1
+  version: 4.0.0
 platform: ruby
 authors:
 - Chris Keele
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-03 00:00:00.000000000 Z
+date: 2015-03-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -69,6 +69,7 @@ extra_rdoc_files: []
 files:
 - ".coveralls.yml"
 - ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - Gemfile.ActiveSupport
 - LICENSE.md
@@ -82,6 +83,7 @@ files:
 - lib/inquisitive/hash_with_indifferent_access.rb
 - lib/inquisitive/nil_class.rb
 - lib/inquisitive/string.rb
+- lib/inquisitive/utils.rb
 - test/inquisitive/array_test.rb
 - test/inquisitive/combinatorial_environment_test.rb
 - test/inquisitive/environment_test.rb
@@ -89,6 +91,7 @@ files:
 - test/inquisitive/hash_with_indifferent_access_test.rb
 - test/inquisitive/nil_object_test.rb
 - test/inquisitive/string_test.rb
+- test/inquisitive/utils_test.rb
 - test/inquisitive_test.rb
 - test/shared/array_tests.rb
 - test/shared/combinatorial_environment_tests.rb
@@ -123,10 +126,6 @@ summary: Predicate methods for those curious about their datastructures.
 test_files:
 - ".coveralls.yml"
 - ".travis.yml"
-- Gemfile
-- Gemfile.ActiveSupport
-- Rakefile
-- inquisitive.gemspec
 - test/inquisitive/array_test.rb
 - test/inquisitive/combinatorial_environment_test.rb
 - test/inquisitive/environment_test.rb
@@ -134,6 +133,7 @@ test_files:
 - test/inquisitive/hash_with_indifferent_access_test.rb
 - test/inquisitive/nil_object_test.rb
 - test/inquisitive/string_test.rb
+- test/inquisitive/utils_test.rb
 - test/inquisitive_test.rb
 - test/shared/array_tests.rb
 - test/shared/combinatorial_environment_tests.rb