inquisitive 2.0.1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ae129b66c1055352e43e907ac246009511ef0cd2
-  data.tar.gz: 4cc0713d97d9ed273f904a186bd12cc2d8bdf8b3
+  metadata.gz: 80d236d855c6c33b3ec287fcd2c3a302388608f3
+  data.tar.gz: bd301adffafcbc757db422e5e0adeb780a06b5e4
 SHA512:
-  metadata.gz: 82aa740e308e0cc964700818ce3ea10446a90c586788ea8e856102a89ec00676a23ccfb60de5b3670ef48333c720e6dc20cc6c15ff66a3b46e854579eb76f368
-  data.tar.gz: b6d575e5815e3ee08fb6c933779604288f5a6995f6ad7d03ac78f01f3fbf91a6b766b45169fad54fdf2463d401aeafda30701f53643da9919891b0ed3d450b96
+  metadata.gz: e19cf79e18d77f23a58ee9c6dfc6d87af7262e4fd828f271e9cfe3694c67b38d11ea6c10764a14b6483ce037accac1491348a9a25ef6351c5d7332b6f0cd1d6a
+  data.tar.gz: 5e287d046ac747a2f27391bb6c38046b33c3123c93e953546948a06d16500cacde4629fcb77b66c39cfee4941eebb8e1d8df6ba7e4ca41ae6313d7c5989cadd3

data/.travis.yml

@@ -4,10 +4,11 @@ rvm:
   - 1.9.3
   - 2.0.0
   - 2.1
+  - 2.2
   - ruby-head
   - rbx-2
   - jruby
-  
+
 gemfile:
   - Gemfile
   - Gemfile.ActiveSupport
@@ -20,10 +21,6 @@ env:
 
 matrix:
   fast_finish: true
-  allow_failures:
-    - rvm: rbx-2
-    - rvm: jruby
-    - rvm: ruby-head
   exclude:
     - gemfile: Gemfile.ActiveSupport
       env: ""
@@ -33,7 +30,7 @@ matrix:
       env: "activesupport=4.1.1"
     - gemfile: Gemfile
       env: "activesupport=master"
-    
+
 branches:
   except:
     - gh-pages

data/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2013 Chris Keele
+Copyright (c) 2013-2015 Chris Keele
 ------------------------------
 
 MIT License

data/README.md

@@ -4,6 +4,7 @@ Inquisitive
 > **Predicate methods for those curious about their datastructures.**
 
 
+
 Synopsis
 --------
 
@@ -14,10 +15,12 @@ It also allows you to auto-instanciate and read inquisitive datastructures strai
 Inquisitive will try to use ActiveSupport's `HashWithIndifferentAccess`, but if that cannot be found it will bootstrap itself with a minimal, well-tested version extracted from ActiveSupport 4.0.
 
 
+
 Status
 ------
 
-[status]: https://travis-ci.org/christhekeele/inquisitive
+[status]:   https://travis-ci.org/christhekeele/inquisitive
+[coverage]: https://rawgit.com/christhekeele/inquisitive/master/coverage/index.html
 
 [version]:       https://rubygems.org/gems/inquisitive/versions
 [version-image]: https://badge.fury.io/rb/inquisitive@2x.svg
@@ -38,12 +41,13 @@ Status
 
 [![Version][version-image]][version] [![Quality][quality-image]][quality] [![Dependencies][dependencies-image]][dependencies]
 
-|          :thumbsup:        |   [Continuous Integration][status]  |                 Test Coverage            |
+|          :thumbsup:        |   [Continuous Integration][status]  |           [Test Coverage][coverage]      |
 |:--------------------------:|:-----------------------------------:|:----------------------------------------:|
 | [Master][master]           | ![Build Status][master-status]      | ![Coverage Status][master-coverage]      |
 | [Development][development] | ![Build Status][development-status] | ![Coverage Status][development-coverage] |
 
 
+
 Installation
 ------------
 
@@ -61,9 +65,11 @@ $ gem install inquisitive
 ```
 
 
+
 Usage
 -----
 
+
 ### String
 
 `Inquisitive::String` tests equality:
@@ -77,6 +83,7 @@ environment.not.development?
 #=> false
 ```
 
+
 ### Array
 
 `Inquisitive::Array` tests inclusion:
@@ -92,6 +99,7 @@ supported_databases.exclude.sql_server?
 #=> true
 ```
 
+
 ### Hash
 
 `Inquisitive::Hash` provides struct-like access to its values, wrapped in other inquisitive objects:
@@ -101,11 +109,13 @@ stubbed = Inquisitive::Hash.new(
   authentication: true,
   in: 'development',
   services: %w[database api],
+  api: {protocol: 'https', subdomains: %w[app web db]},
   ignorable: { junk: [ "" ] }
 )
 #=> {"authentication"=>true,
 #=>  "in"=>"development",
 #=>  "services"=>["database", "api"],
+#=>  "api"=>{"protocol"=>"https", "subdomains"=>["app", "web", "db"]},
 #=>  "ignorable"=>{"junk"=>[""]}}
 
 stubbed.authentication?
@@ -114,6 +124,8 @@ stubbed.registration?
 #=> false
 stubbed.services?
 #=> true
+stubbed.api?
+#=> true
 stubbed.ignorable?
 #=> false
 
@@ -121,10 +133,18 @@ stubbed.in.development?
 #=> true
 stubbed.in.production?
 #=> false
+
 stubbed.services.database?
 #=> true
 stubbed.services.sidekiq?
 #=> false
+
+stubbed.api.protocol?
+#=> true
+stubbed.api.protocol.http?
+#=> false
+stubbed.api.domains.web?
+#=> true
 ```
 
 `Inquisitive::Hash` also allows negation with the `no` method:
@@ -143,6 +163,56 @@ config.no.api?
 #=> true
 ```
 
+Empty keys and nil values become instances of `Inquisitive::NilClass`, which is a black-hole null object that respects the Inquisitive interface, allowing you to inquire on non-existant nested datastructures as if there was one there, negated methods included:
+
+```ruby
+stubbed = Inquisitive::Hash.new
+#=> {}
+
+# We can query it as if we assumed we had:
+#=> {"authentication"=>true,
+#=>  "in"=>"development",
+#=>  "services"=>["database", "api"],
+#=>  "api"=>{"protocol"=>"https", "subdomains"=>["app", "web", "db"]}}
+
+stubbed.authentication?
+#=> false
+stubbed.registration?
+#=> false
+stubbed.services?
+#=> false
+stubbed.api?
+#=> false
+stubbed.ignorable?
+#=> false
+stubbed.no.ignorable?
+#=> true
+
+stubbed.in.development?
+#=> false
+stubbed.in.production?
+#=> false
+stubbed.in.not.production?
+#=> true
+
+stubbed.services.database?
+#=> false
+stubbed.services.sidekiq?
+#=> false
+stubbed.services.exclude.sidekiq?
+#=> true
+
+stubbed.api.protocol?
+#=> false
+stubbed.api.no.protocol?
+#=> true
+stubbed.api.protocol.http?
+#=> false
+stubbed.api.domains.web?
+#=> false
+```
+
+
 ### Inquisitive Environment
 
 `Inquisitive::Environment` can be used in your modules and classes to more easily interrogate `ENV` variables with inquisitive objects:
@@ -151,59 +221,69 @@ config.no.api?
 
 ```ruby
 ENV['ENVIRONMENT'] = "development"
-class MyGame
+class MyApp
   extend Inquisitive::Environment
   inquires_about 'ENVIRONMENT'
 end
 
-MyGame.environment
+MyApp.environment
 #=> "development"
-MyGame.environment.development?
+MyApp.environment.development?
 #=> true
-MyGame.environment.production?
+MyApp.environment.production?
 #=> false
 ```
 
 #### Arrays
 
+Arrays are recognized when environment variables contain commas:
+
 ```ruby
 ENV['SUPPORTED_DATABASES'] = "mysql,postgres,sqlite"
-class MyGame
+class MyApp
   extend Inquisitive::Environment
   inquires_about 'SUPPORTED_DATABASES'
 end
 
-MyGame.supported_databases
+MyApp.supported_databases
 #=> ["mysql", "postgres", "sqlite"]
-MyGame.supported_databases.sqlite?
+MyApp.supported_databases.sqlite?
 #=> true
-MyGame.supported_databases.sql_server?
+MyApp.supported_databases.sql_server?
 #=> false
 ```
 
 #### Hashes
 
+Hashes are recognized when environment variables names contain double underscores:
+
 ```ruby
 ENV['STUB__AUTHENTICATION'] = 'true'
 ENV['STUB__IN'] = "development"
 ENV['STUB__SERVICES'] = "database,api"
-class MyGame
+ENV['STUB__API__PROTOCOL'] = "https"
+ENV['STUB__API__SUBDOMAINS'] = "app,web,db"
+class MyApp
   extend Inquisitive::Environment
   inquires_about 'STUB'
 end
 
-MyGame.stub.authentication?
+MyApp.stub.authentication?
 #=> true
-MyGame.stub.registration?
+MyApp.stub.registration?
 #=> false
-MyGame.stub.in.development?
+MyApp.stub.in.development?
 #=> true
-MyGame.stub.in.production?
+MyApp.stub.in.production?
 #=> false
-MyGame.stub.services.exclude.sidekiq?
+MyApp.stub.services.exclude.sidekiq?
 #=> true
-MyGame.stub.services.sidekiq?
+MyApp.stub.services.sidekiq?
+#=> false
+MyApp.stub.api.protocol.http?
 #=> false
+MyApp.stub.api.subdomains.web?
+#=> true
 ```
 
 #### Naming
@@ -212,100 +292,16 @@ You can name your environment inquirers with `:with`:
 
 ```ruby
 ENV['ENVIRONMENT'] = "development"
-class MyGame
+class MyApp
   extend Inquisitive::Environment
   inquires_about 'ENVIRONMENT', with: :env
 end
 
-MyGame.env
+MyApp.env
 #=> "development"
-MyGame.env.development?
-#=> true
-MyGame.env.production?
-#=> false
-```
-
-#### Presence
-
-Environment inquirers can have explicit presence checks, circumventing a common pitfall when reasoning about environment variables. Borrowing from the example above:
-
-```ruby
-ENV['STUB__AUTHENTICATION'] = 'false'
-class MyGame
-  extend Inquisitive::Environment
-  inquires_about 'STUB'
-end
-
-MyGame.stub.authentication
-#=> "false"
-MyGame.stub.authentication?
+MyApp.env.development?
 #=> true
-MyGame.stub.authentication.true?
-#=> false
-```
-
-It's common to use the presence of environment variables as runtime booleans. This is frequently done by setting the environment variable to the string `"true"` when you want it to be true, and not at all otherwise. As demonstrated, this pattern can lead to ambiguity when the string is other values.
-
-By default such variables will be parsed as an `Inquisitive::String`, so predicate methods will return true whatever their contents, as long as they exist. You can bind the predicate method tighter to an explicit value if you prefer:
-
-```ruby
-ENV['STUB_AUTHENTICATION'] = 'false'
-ENV['STUB_REGISTRATION'] = 'true'
-class MyGame
-  extend Inquisitive::Environment
-  inquires_about 'STUB_AUTHENTICATION', present_if: 'true'
-  inquires_about 'STUB_REGISTRATION', present_if: 'true'
-end
-
-MyGame.stub_authentication
-#=> "false"
-MyGame.stub_authentication?
-#=> false
-
-MyGame.stub_registration
-#=> "true"
-MyGame.stub_registration?
-#=> true
-```
-
-This only works on top-level inquirers, so there's no way to get our nested `MyGame.stubbed.authentication?` to behave as expected (currently).
-
-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
-
-`Inquisitive::Environment.truthy` contains a regex useful for reading booleans from environment variables.
-
-```ruby
-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 'BOOLENOPE', present_if: truthy
-end
-
-MyGame.no?
-#=> false
-MyGame.yes?
-#=> true
-
-MyGame.truthy?
-#=> true
-MyGame.falsey?
-#=> false
-
-MyGame.boolean?
-#=> true
-MyGame.boolenope?
+MyApp.env.production?
 #=> false
 ```
 
@@ -314,7 +310,7 @@ MyGame.boolenope?
 Environment inquirers have three configurable modes, defaulting to `:static`.
 
 ```ruby
-class MyGame
+class MyApp
   extend Inquisitive::Environment
   inquires_about 'STUB', mode: %i[dynamic lazy static].sample
 end
@@ -336,7 +332,8 @@ end
 
     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 runtime.
+    Use if your application is well-behaved and doesn't go mucking around with the environment at runtim.
+
 
 
 Contributing

data/Rakefile

@@ -7,6 +7,17 @@ Rake::TestTask.new do |t|
 end
 task default: :test
 
-task :console do
-  `pry -I lib -r inquisitive.rb`
+desc "Open a pry console preloaded with this library"
+task console: 'console:pry'
+
+namespace :console do
+
+  task :pry do
+    sh "bundle exec pry -I lib -r inquisitive.rb"
+  end
+
+  task :irb do
+    sh "bundle exec irb -I lib -r inquisitive.rb"
+  end
+
 end

data/inquisitive.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = "inquisitive"
-  spec.version       = "2.0.1"
+  spec.version       = "3.0.0"
   spec.authors       = ["Chris Keele"]
   spec.email         = ["dev@chriskeele.com"]
   spec.summary       = "Predicate methods for those curious about their datastructures."
@@ -18,11 +18,10 @@ Gem::Specification.new do |spec|
     Also allows you to auto-instanciate and read inquisitive datastructures straight
     from your `ENV` hash.
   DESC
-  spec.homepage      = "https://github.com/rawsugar/inquisitive"
+  spec.homepage      = "http://christhekeele.github.io/inquisitive"
   spec.license       = "MIT"
-
-  spec.files         = `git ls-files`.split($/)
-  spec.test_files    = spec.files.grep(%r{^(test)/})
+  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.add_development_dependency "bundler",   ">= 1.3"

data/lib/inquisitive.rb

@@ -10,16 +10,18 @@ module Inquisitive
 
     def present?(object)
       case object
-      when ::String
+      when ::String, String
         not object.empty?
-      when ::Array
+      when ::Array, Array
         object.any? do |value|
           Inquisitive.present? value
         end
-      when ::Hash
+      when ::Hash, Hash
         object.values.any? do |value|
           Inquisitive.present? value
         end
+      when ::NilClass, NilClass
+        false
       else
         !!object
       end
@@ -39,6 +41,7 @@ private
 
 end
 
+require "inquisitive/nil_class"
 require "inquisitive/string"
 require "inquisitive/array"
 unless Object.const_defined? :HashWithIndifferentAccess

data/lib/inquisitive/array.rb

@@ -1,12 +1,16 @@
 module Inquisitive
   class Array < ::Array
     include Inquisitive
-    attr_accessor :negated, :array
 
+    attr_accessor :negated
     def exclude
       self.dup.tap{ |a| a.negated = !a.negated }
     end
 
+    def === other
+      other.class == Class and other == ::Array or super
+    end
+
   private
 
     def respond_to_missing?(method_name, include_private = false)

data/lib/inquisitive/environment.rb

@@ -2,10 +2,6 @@ module Inquisitive
   module Environment
     include Inquisitive
 
-    def truthy
-      /true|yes|1/i
-    end
-
     def inquires_about(env_var, opts={})
 
       env_accessor = opts.fetch(:with, env_var.downcase[/(.*?)(?=(?:_$|$))/])
@@ -35,19 +31,6 @@ module Inquisitive
 
       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
 
   private
@@ -56,7 +39,7 @@ module Inquisitive
       class << self
 
         def [](var_name)
-          if ENV.has_key? var_name
+          result = if ENV.has_key? var_name
 
             env_var = ENV[var_name]
             if env_var.include? ','
@@ -67,14 +50,15 @@ module Inquisitive
 
           elsif env_vars = can_find_env_keys_from(var_name)
 
-            env_vars.reduce({}) do |hash, key|
-              hash[key_for(key, var_name)] = Inquisitive[Parser[key]]
-              hash
+            Hash[].tap do |hash|
+              env_vars.each do |key|
+                set_hash_value_of hash, key
+              end
             end
 
-          else
-            ""
           end
+
+          replace_empty result
         end
 
         def can_find_env_keys_from(var_name)
@@ -88,8 +72,26 @@ module Inquisitive
           end
         end
 
-        def key_for(env_key, var_name)
-          env_key.gsub("#{var_name}__", '').downcase
+        def set_hash_value_of(hash, var)
+          keypath = var.split('__').map(&:downcase)
+          keypath.shift
+          hash.tap do |hash|
+            keypath.reduce(hash) do |namespace, key|
+              namespace[key] = if key == keypath.last
+                replace_empty Inquisitive[Parser[var]]
+              else
+                if namespace[key].respond_to? :store
+                  namespace[key]
+                else
+                  Hash.new
+                end
+              end
+            end
+          end
+        end
+
+        def replace_empty(value)
+          value == "" or value.nil? ? NilClass.new(nil) : value
         end
 
       end

data/lib/inquisitive/hash.rb

@@ -11,6 +11,10 @@ module Inquisitive
       super(Inquisitive[value], options)
     end
 
+    def === other
+      other.class == Class and other == ::Hash or super
+    end
+
   private
 
     def dup
@@ -27,10 +31,8 @@ module Inquisitive
         else
           false
         end ^ negated
-      elsif has_key? method_name
-        self[method_name]
       else
-        super
+        Inquisitive[self[method_name]]
       end
     end
 

data/lib/inquisitive/nil_class.rb

@@ -0,0 +1,48 @@
+module Inquisitive
+  class NilClass
+    include Inquisitive
+
+    def initialize(object=nil); end
+
+    attr_accessor :negated
+    def not
+      self.dup.tap{ |s| s.negated = !s.negated }
+    end
+    alias_method :exclude, :not
+    alias_method :no, :not
+
+    undef_method :nil?, :inspect, :to_s
+
+  # Since we can't subclass NilClass
+  #  (it has no allocate method)
+  #  we fake its identity.
+    def instance_of?(klass)
+      klass == ::NilClass or super
+    end
+    alias_method :kind_of?, :instance_of?
+    alias_method :is_a?, :instance_of?
+
+    def == other
+      other.nil?
+    end
+    def === other
+      other.class == Class and other == ::NilClass or super
+    end
+
+  private
+
+    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)
+      if nil.respond_to? method_name
+        nil.send method_name, *arguments
+      elsif predicate_method? method_name
+        false ^ negated
+      else
+        self
+      end
+    end
+
+  end
+end

data/lib/inquisitive/string.rb

@@ -7,6 +7,10 @@ module Inquisitive
       self.dup.tap{ |s| s.negated = !s.negated }
     end
 
+    def === other
+      other.class == Class and other == ::String or super
+    end
+
   private
 
     def respond_to_missing?(method_name, include_private = false)

data/test/inquisitive/combinatorial_environment_test.rb

@@ -4,22 +4,31 @@ class InquisitiveCombinatorialEnvironmentTest < EnvironmentTest
 
   def setup
     super
+    ENV['NIL_OBJECT'] = @raw_nil_object
     ENV['STRING'] = @raw_string
     ENV['ARRAY'] = @raw_array.join(',')
+    ENV['HASH__NOTHING'] = @raw_hash[:nothing]
     ENV['HASH__AUTHENTICATION'] = @raw_hash[:authentication].to_s
     ENV['HASH__IN'] = @raw_hash[:in]
     ENV['HASH__DATABASES'] = @raw_hash[:databases].join(',')
+    ENV['HASH__NESTED__KEY'] = @raw_hash[:nested][:key]
+    ENV['HASH__NESTED__ARRAY'] = @raw_hash[:nested][:array].join(',')
   end
   def teardown
     super
     ENV.delete 'STRING'
     ENV.delete 'ARRAY'
+    ENV.delete 'HASH__NOTHING'
     ENV.delete 'HASH__AUTHENTICATION'
     ENV.delete 'HASH__IN'
     ENV.delete 'HASH__DATABASES'
+    ENV.delete 'HASH__NESTED__KEY'
     ENV.delete 'HASH__SOMETHING_NEW'
   end
 
+  def change_nil_object_variable
+    ENV['NIL_OBJECT'] = 'something_new'
+  end
   def change_string_variable
     ENV['STRING'] = 'something_new'
   end
@@ -33,10 +42,10 @@ class InquisitiveCombinatorialEnvironmentTest < EnvironmentTest
 end
 
 %w[dynamic lazy static].each do |mode|
-  %w[string array hash].each do |type|
+  %w[nil_object string array hash].each do |type|
 
     Inquisitive.const_set(
-      :"Inquisitive#{mode.capitalize}#{type.capitalize}EnvironmentTest",
+      :"Inquisitive#{mode.capitalize}#{type.split('_').map(&:capitalize).join}EnvironmentTest",
       Class.new(InquisitiveCombinatorialEnvironmentTest) do
 
         class << self
@@ -50,6 +59,9 @@ end
           App.inquires_about @type.upcase, mode: @mode
         end
 
+        def nil_object
+          App.nil_object
+        end
         def string
           App.string
         end
@@ -66,7 +78,7 @@ end
     ).tap do |klass|
       klass.mode = mode
       klass.type = type
-    end.send :include, Object.const_get(:"#{type.capitalize}Tests")
+    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
 

data/test/inquisitive/environment_test.rb

@@ -2,15 +2,6 @@ require 'test_helper'
 
 class InquisitiveEnvironmentTest < EnvironmentTest
 
-  def test_missing_variable_responses
-    App.inquires_about 'DOES_NOT_EXIST', with: :exists
-    assert_equal "", App.exists
-  end
-  def test_missing_variable_predicates
-    App.inquires_about 'DOES_NOT_EXIST', with: :exists
-    refute App.exists?
-  end
-
   def test_autonaming_of_inquirers
     App.inquires_about 'NAME_NOT_SPECIFIED'
     assert App.respond_to? :name_not_specified
@@ -25,30 +16,4 @@ class InquisitiveEnvironmentTest < EnvironmentTest
     assert App.defaults_to.static?
   end
 
-  def test_custom_string_presence
-    ENV['AUTHORIZABLE'] = 'false'
-    App.inquires_about 'AUTHORIZABLE', present_if: 'true'
-    refute App.authorizable?
-  end
-
-  def test_custom_regex_presence
-    ENV['AUTHORIZABLE'] = 'not at all'
-    App.inquires_about 'AUTHORIZABLE', present_if: /yes/
-    refute App.authorizable?
-  end
-
-  def test_custom_class_presence
-    ENV['AUTHORIZABLE'] = 'not at all'
-    App.inquires_about 'AUTHORIZABLE', present_if: Array
-    refute 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
-      assert App.truthy?
-    end
-  end
-
 end

data/test/inquisitive/nil_object_test.rb

@@ -0,0 +1,11 @@
+require 'test_helper'
+
+class NilObjectTest < Test
+
+  def nil_object
+    Inquisitive::NilClass.new
+  end
+
+  include NilObjectTests
+
+end

data/test/inquisitive_test.rb

@@ -19,9 +19,6 @@ class InquisitiveTest < Test
 ####
 # CONVERSION
 ##
-  def test_converted_nil_equality
-    assert_equal Inquisitive[nil], nil
-  end
   def test_converted_false_equality
     assert_equal Inquisitive[false], false
   end
@@ -41,22 +38,45 @@ class InquisitiveTest < Test
     assert_equal Inquisitive[@object], @object
   end
 
+  def test_converted_nil_object_ancestry
+    assert_kind_of NilClass, Inquisitive[nil]
+    assert Inquisitive[nil] === NilClass
+  end
+  def test_converted_nil_object_instanciation
+    assert_kind_of Inquisitive::NilClass, Inquisitive[nil]
+  end
+  def test_converted_nil_object_equality
+    assert_equal Inquisitive[nil], @raw_nil_object
+  end
+
+  def test_converted_string_ancestry
+    assert_kind_of String, Inquisitive[@raw_string]
+    assert Inquisitive[@raw_string] === String
+  end
   def test_converted_string_instanciation
-    assert_instance_of Inquisitive::String, Inquisitive[@raw_string]
+    assert_kind_of Inquisitive::String, Inquisitive[@raw_string]
   end
   def test_converted_string_equality
     assert_equal Inquisitive[@raw_string], @raw_string
   end
 
+  def test_converted_array_ancestry
+    assert_kind_of Array, Inquisitive[@raw_array]
+    assert Inquisitive[@raw_array] === Array
+  end
   def test_converted_array_instanciation
-    assert_instance_of Inquisitive::Array, Inquisitive[@raw_array]
+    assert_kind_of Inquisitive::Array, Inquisitive[@raw_array]
   end
   def test_converted_array_equality
     assert_equal Inquisitive[@raw_array], @raw_array
   end
 
+  def test_converted_hash_ancestry
+    assert_kind_of Hash, Inquisitive[@raw_hash]
+    assert Inquisitive[@raw_hash] === Hash
+  end
   def test_converted_hash_instanciation
-    assert_instance_of Inquisitive::Hash, Inquisitive[@raw_hash]
+    assert_kind_of Inquisitive::Hash, Inquisitive[@raw_hash]
   end
   def test_converted_hash_equality
     assert_equal Inquisitive[@raw_hash], HashWithIndifferentAccess.new(@raw_hash)

data/test/shared/array_tests.rb

@@ -2,27 +2,28 @@ module ArrayTests
   def test_array_value_type
     assert_instance_of Inquisitive::Array, array
   end
+
   def test_array_match
     assert array.postgres?
   end
   def test_array_miss
     refute array.sql_server?
   end
+
   def test_array_negative_match
     assert array.exclude.sql_server?
   end
   def test_array_negative_miss
     refute array.exclude.postgres?
   end
+
   def test_array_double_negative_match
     assert array.exclude.exclude.postgres?
   end
   def test_array_double_negative_miss
     refute array.exclude.exclude.sql_server?
   end
-  def test_array_missing_question_mark
-    assert_raises(NoMethodError) { array.postgres }
-  end
+
   def test_array_respond_to
     assert_respond_to array, :postgres?
   end

data/test/shared/combinatorial_environment_tests.rb

@@ -2,14 +2,14 @@ module CombinatorialEnvironmentTests
 
   def test_type_is_parsed_correctly
     assert_kind_of(
-      Object.const_get(:"#{@type.capitalize}"),
+      Object.const_get(:"#{type_const_name}"),
       App.send(@type)
     )
   end
 
   def test_type_is_converted_correctly
     assert_kind_of(
-      Inquisitive.const_get(:"#{@type.capitalize}"),
+      Inquisitive.const_get(:"#{type_const_name}"),
       App.send(@type)
     )
   end
@@ -30,4 +30,10 @@ module CombinatorialEnvironmentTests
     end
   end
 
+private
+
+  def type_const_name
+    @type == 'nil_object' ? 'NilClass' : @type.capitalize
+  end
+
 end

data/test/shared/hash_tests.rb

@@ -1,26 +1,46 @@
 module HashTests
+  def test_hash_value_type
+    assert_instance_of Inquisitive::Hash, hash
+  end
+
   def test_hash_match
     assert hash.authentication?
   end
   def test_hash_miss
     refute hash.registration?
   end
+
+  def test_hash_access_implicit_nil
+    assert_instance_of Inquisitive::NilClass, hash.missing_key
+  end
+  def test_hash_access_explicit_nil
+    assert_instance_of Inquisitive::NilClass, hash.nothing
+  end
+  def test_hash_access_string
+    assert_instance_of Inquisitive::String, hash.in
+  end
+  def test_hash_access_array
+    assert_instance_of Inquisitive::Array, hash.databases
+  end
+  def test_hash_access_hash
+    assert_instance_of Inquisitive::Hash, hash.nested
+  end
+
   def test_hash_negative_match
     assert hash.no.registration?
   end
   def test_hash_negative_miss
     refute hash.no.authentication?
   end
+
   def test_hash_double_negative_match
     assert hash.no.no.authentication?
   end
   def test_hash_double_negative_miss
     refute hash.no.no.registration?
   end
+
   def test_hash_respond_to
     assert_respond_to hash, :authentication?
   end
-  def test_hash_method_missing
-    assert_raises(NoMethodError) { hash.undefined }
-  end
 end

data/test/shared/nil_object_tests.rb

@@ -0,0 +1,56 @@
+module NilObjectTests
+  def test_nil_object_value_type
+    assert_instance_of Inquisitive::NilClass, nil_object
+  end
+
+  def test_nil_object_chains
+    assert_instance_of Inquisitive::NilClass, nil_object.chain
+  end
+
+  def test_nil_object_match
+    assert nil_object.nil?
+  end
+  def test_nil_object_miss
+    refute nil_object.anything_else?
+  end
+
+  def test_nil_object_string_interface
+    string = nil_object
+    refute string.production?
+  end
+  def test_nil_object_string_interface_negative
+    string = nil_object
+    assert string.not.development?
+  end
+  def test_nil_object_string_interface_double_negative
+    string = nil_object
+    refute string.not.not.development?
+  end
+
+  def test_nil_object_array_interface
+    array = nil_object
+    refute array.production?
+  end
+  def test_nil_object_array_interface_negative
+    array = nil_object
+    assert array.exclude.development?
+  end
+  def test_nil_object_array_interface_double_negative
+    array = nil_object
+    refute array.exclude.exclude.development?
+  end
+
+  def test_nil_object_hash_interface
+    hash = nil_object
+    refute hash.production?
+  end
+  def test_nil_object_hash_interface_negative
+    hash = nil_object
+    assert hash.no.development?
+  end
+  def test_nil_object_hash_interface_double_negative
+    hash = nil_object
+    refute hash.no.no.development?
+  end
+
+end

data/test/shared/string_tests.rb

@@ -2,27 +2,28 @@ module StringTests
   def test_string_value_type
     assert_instance_of Inquisitive::String, string
   end
+
   def test_string_match
     assert string.production?
   end
   def test_string_miss
     refute string.development?
   end
+
   def test_string_negative_match
     assert string.not.development?
   end
   def test_string_negative_miss
     refute string.not.production?
   end
+
   def test_string_double_negative_match
     assert string.not.not.production?
   end
   def test_string_double_negative_miss
     refute string.not.not.development?
   end
-  def test_string_missing_question_mark
-    assert_raises(NoMethodError) { string.production }
-  end
+
   def test_string_respond_to
     assert_respond_to string, :development?
   end

data/test/test_helper.rb

@@ -1,8 +1,9 @@
-require "rubygems"
+require 'rubygems'
+require 'pry'
 
 begin
   require 'simplecov'
-  SimpleCov.coverage_dir '.coverage'
+  SimpleCov.coverage_dir 'coverage'
   if ENV['CI']
     require 'coveralls'
     SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
@@ -12,11 +13,10 @@ begin
   end
   SimpleCov.start do
     add_filter "/test"
-    add_filter "/vendor"
   end
 end
 
-require "minitest/autorun"
+require 'minitest/autorun'
 
 class Test < MiniTest::Test
 
@@ -46,12 +46,15 @@ class Test < MiniTest::Test
   end
 
   def setup
+    @raw_nil_object = nil
     @raw_string = 'production'
     @raw_array  = %w[mysql postgres sqlite]
     @raw_hash   = {
+      nothing: @raw_nil_object,
       authentication: true,
       in: @raw_string,
-      databases: @raw_array
+      databases: @raw_array,
+      nested: {key: 'value', array: %w[foo bar]}
     }
   end
 
@@ -71,9 +74,10 @@ class EnvironmentTest < Test
 
 end
 
-require "shared/string_tests"
-require "shared/array_tests"
-require "shared/hash_tests"
-require "shared/combinatorial_environment_tests"
+require 'shared/nil_object_tests'
+require 'shared/string_tests'
+require 'shared/array_tests'
+require 'shared/hash_tests'
+require 'shared/combinatorial_environment_tests'
 
-require "inquisitive"
+require 'inquisitive'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inquisitive
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 3.0.0
 platform: ruby
 authors:
 - Chris Keele
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-24 00:00:00.000000000 Z
+date: 2015-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -68,9 +68,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".coveralls.yml"
-- ".gitignore"
 - ".travis.yml"
-- CHANGELOG.md
 - Gemfile
 - Gemfile.ActiveSupport
 - LICENSE.md
@@ -82,20 +80,23 @@ files:
 - lib/inquisitive/environment.rb
 - lib/inquisitive/hash.rb
 - lib/inquisitive/hash_with_indifferent_access.rb
+- lib/inquisitive/nil_class.rb
 - lib/inquisitive/string.rb
 - test/inquisitive/array_test.rb
 - test/inquisitive/combinatorial_environment_test.rb
 - test/inquisitive/environment_test.rb
 - test/inquisitive/hash_test.rb
 - test/inquisitive/hash_with_indifferent_access_test.rb
+- test/inquisitive/nil_object_test.rb
 - test/inquisitive/string_test.rb
 - test/inquisitive_test.rb
 - test/shared/array_tests.rb
 - test/shared/combinatorial_environment_tests.rb
 - test/shared/hash_tests.rb
+- test/shared/nil_object_tests.rb
 - test/shared/string_tests.rb
 - test/test_helper.rb
-homepage: https://github.com/rawsugar/inquisitive
+homepage: http://christhekeele.github.io/inquisitive
 licenses:
 - MIT
 metadata: {}
@@ -120,15 +121,23 @@ signing_key:
 specification_version: 4
 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
 - test/inquisitive/hash_test.rb
 - test/inquisitive/hash_with_indifferent_access_test.rb
+- test/inquisitive/nil_object_test.rb
 - test/inquisitive/string_test.rb
 - test/inquisitive_test.rb
 - test/shared/array_tests.rb
 - test/shared/combinatorial_environment_tests.rb
 - test/shared/hash_tests.rb
+- test/shared/nil_object_tests.rb
 - test/shared/string_tests.rb
 - test/test_helper.rb

data/.gitignore

@@ -1,18 +0,0 @@
-*.gem
-*.rbc
-.bundle
-.config
-.coverage
-.yardoc
-Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp

data/CHANGELOG.md

@@ -1,80 +0,0 @@
-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
---------
-
-[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
-
-- [2.0.0](#2.0.0)
-- [1.2.0](#1.2.0)
-
-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.