naught 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 890ad068bee3a49dddd992e4c9b5187d4b8c7f2e
-  data.tar.gz: f2349e58df72fd26f6e00f0d0b70f98e77439cdd
+  metadata.gz: 429858c6dc05004904b5c95c8e536587996175fb
+  data.tar.gz: 06ac8cf2ac0868e8b9d12d9cc15ee2c93c30428d
 SHA512:
-  metadata.gz: 1ff56002a0c9051c16852efe538d1799a14eb7480154515e8a907408e380b1717a8fe393b8936f775f1053684e32c41641a075461f09a48f8ef68e3c5e573c06
-  data.tar.gz: 4eb1d18c75d4ac998207152005bd20807a15bd68f24b83213b4842ab5185d4c023fd9e09c441c2a148c5274b000a7b194c383337ce68b2583bca2307f50ae0a5
+  metadata.gz: 53cc9f5fc1b17d678163f02c7d61e967895a21afb01a93bcddc68963654e036051cfd303eb492f11da7d1b6e67508ccaf8ebe40ee2b45ec0d3884cec11ce123f
+  data.tar.gz: 1bb2ba430a1be17b50394c2ea2f3e035fec669d4b014c61726cfad653f55c1f42217534d1f920bd9d9cb62096ebb574abe8da0f8017e86d6739a5accb1579277

data/.rubocop.yml

@@ -1,74 +1,65 @@
-AllCops:
-  Includes:
-    - 'Gemfile'
-    - 'Rakefile'
-    - 'naught.gemspec'
-
-# Avoid long parameter lists
-ParameterLists:
-  Max: 4
-  CountKeywordArgs: true
+Lint/NestedMethodDefinition:
+  Enabled: false
 
-ClassLength:
-  Max: 144 # TODO: Lower to 100
+Metrics/BlockNesting:
+  Max: 2
 
-MethodLength:
+Metrics/LineLength:
+  AllowURI: true
+  Max: 93 # TODO: Lower to 80
+
+Metrics/MethodLength:
   CountComments: false
-  Max: 21  # TODO: Lower to 15
+  Max: 21 # TODO: Lower to 15
 
-# Avoid more than `Max` levels of nesting.
-BlockNesting:
-  Max: 2
+Metrics/ParameterLists:
+  Max: 4
+  CountKeywordArgs: true
+
+Style/AccessModifierIndentation:
+  EnforcedStyle: outdent
+
+Style/ClassVars:
+  Enabled: false
 
-# Align with the style guide.
-CollectionMethods:
+Style/CollectionMethods:
+  Enabled: true
   PreferredMethods:
     map:      'collect'
+    map!:     'collect!'
     reduce:   'inject'
     find:     'detect'
     find_all: 'select'
 
-# Limit line length
-LineLength:
+Style/Documentation:
   Enabled: false
 
-# Disable documentation checking until a class needs to be documented once
-Documentation:
-  Enabled: false
+Style/DotPosition:
+  EnforcedStyle: trailing
 
-# Enforce Ruby 1.8-compatible hash syntax
-HashSyntax:
-  EnforcedStyle: hash_rockets
-
-# No spaces inside hash literals
-SpaceInsideHashLiteralBraces:
-  EnforcedStyle: no_space
-
-# Allow dots at the end of lines
-DotPosition:
+Style/DoubleNegation:
   Enabled: false
 
-# Don't require magic comment at the top of every file
-Encoding:
+Style/EachWithObject:
   Enabled: false
 
-EmptyLinesAroundAccessModifier:
-  Enabled: true
-
-# Align ends correctly
-EndAlignment:
-  AlignWith: variable
+Style/Encoding:
+  Enabled: false
 
-# Indentation of when/else
-CaseIndentation:
-  IndentWhenRelativeTo: end
-  IndentOneStep: false
+Style/HashSyntax:
+  EnforcedStyle: hash_rockets
 
-Lambda:
+Style/Lambda:
   Enabled: false
 
-MethodName:
+Style/MethodName:
   Enabled: false
 
-ClassVars:
-  Enabled: false
+Style/RaiseArgs:
+  EnforcedStyle: compact
+
+Style/SpaceInsideHashLiteralBraces:
+  EnforcedStyle: no_space
+
+Style/TrailingComma:
+  EnforcedStyleForMultiline: 'comma'

data/.travis.yml

@@ -1,20 +1,24 @@
-before_install:
-  - gem update --system 2.1.11
-  - gem --version
-bundler_args: --without development
+before_install: gem update bundler
+bundler_args: --without development --retry=3 --jobs=3
+cache: bundler
+env:
+  global:
+    - JRUBY_OPTS="$JRUBY_OPTS --debug"
 language: ruby
 rvm:
   - 1.8.7
-  - 1.9.2
   - 1.9.3
   - 2.0.0
-  - 2.1.0
-  - jruby
+  - 2.1
+  - 2.2
+  - jruby-9000
   - jruby-head
-  - rbx
+  - rbx-2
   - ruby-head
 matrix:
   allow_failures:
     - rvm: jruby-head
+    - rvm: rbx-2
     - rvm: ruby-head
   fast_finish: true
+sudo: false

data/Changelog.md

@@ -1,3 +1,9 @@
+## 1.1.0
+
+  - [Make it possible to supply an example object to mimic, with no class.](https://github.com/avdi/naught/commit/df2b62c027812760ce200177ce056929b5aea339)
+  - [Define implicit conversion for to_hash](https://github.com/avdi/naught/commit/e20dc472d3bc71ba927d6ddb0fb0032e1646df77)
+  - [Define implicit conversion for to_int](https://github.com/avdi/naught/commit/d32d4ea32a9a847bffd6cf18f480bdfaaf7a3641)
+
 ## 1.0.0
 
   - [Replace `::BasicObject` with `Naught::BasicObject`](https://github.com/avdi/naught/commit/8defad0bf9eb65e33054bf0a6e9c625c87c3e6df)

data/Gemfile

@@ -6,13 +6,12 @@ gemspec
 gem 'rake'
 
 group :development do
-  platforms :ruby_19, :ruby_20, :ruby_21 do
+  platforms :ruby_19, :ruby_20, :ruby_21, :ruby_22 do
     gem 'guard'
     gem 'guard-bundler'
     gem 'guard-rspec'
   end
   gem 'pry'
-  gem 'pry-rescue'
 end
 
 group :test do
@@ -20,12 +19,7 @@ group :test do
   gem 'json', :platforms => [:jruby, :rbx, :ruby_18, :ruby_19]
   gem 'libnotify'
   gem 'mime-types', '~> 1.25', :platforms => [:jruby, :ruby_18]
+  gem 'rest-client', '~> 1.6.0', :platforms => [:jruby, :ruby_18]
   gem 'rspec', '>= 2.14'
-  gem 'rubocop', '>= 0.16', :platforms => [:ruby_19, :ruby_20, :ruby_21]
-end
-
-platforms :rbx do
-  gem 'racc'
-  gem 'rubinius-coverage', '~> 2.0'
-  gem 'rubysl', '~> 2.0'
+  gem 'rubocop', '~> 0.34.0', :platforms => [:ruby_19, :ruby_20, :ruby_21, :ruby_22]
 end

data/Guardfile

@@ -3,13 +3,13 @@ guard 'bundler' do
   watch(/^.+\.gemspec/)
 end
 
-guard :rspec, cli: '-fs --color --order rand' do
+guard :rspec, :cli => '-fs --color --order rand' do
   watch(%r{^spec/.+_spec\.rb$})
-  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
-  watch('spec/spec_helper.rb')  { "spec" }
+  watch(%r{^lib/(.+)\.rb$})    { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb') { 'spec' }
 end
 
-guard 'ctags-bundler', emacs: true, src_path: ["lib", "spec/support"] do
-  watch(/^(lib|spec\/support)\/.*\.rb$/)
+guard 'ctags-bundler', :emacs => true, :src_path => ['lib', 'spec/support'] do
+  watch(%r{^(lib|spec/support)/.*\.rb$})
   watch('Gemfile.lock')
 end

data/README.markdown

@@ -1,7 +1,16 @@
-[![Build Status](https://travis-ci.org/avdi/naught.png?branch=master)](https://travis-ci.org/avdi/naught)
-[![Code Climate](https://codeclimate.com/github/avdi/naught.png)](https://codeclimate.com/github/avdi/naught)
-[![Coverage Status](https://coveralls.io/repos/avdi/naught/badge.png?branch=master)](https://coveralls.io/r/avdi/naught?branch=master)
-[![Gem Version](https://badge.fury.io/rb/naught.png)](http://badge.fury.io/rb/naught)
+[![Gem Version](https://badge.fury.io/rb/naught.svg)][gem]
+[![Build Status](https://travis-ci.org/avdi/naught.svg?branch=master)][travis]
+[![Dependency Status](https://gemnasium.com/avdi/naught.svg)][gemnasium]
+[![Code Climate](https://codeclimate.com/github/avdi/naught/badges/gpa.svg)][codeclimate]
+[![Coverage Status](https://coveralls.io/repos/avdi/naught/badge.svg?branch=master&service=github)][coveralls]
+[![Inline docs](http://inch-ci.org/github/avdi/naught.svg?branch=master)][docs]
+
+[gem]: https://rubygems.org/gems/naught
+[travis]: https://travis-ci.org/avdi/naught
+[gemnasium]: https://gemnasium.com/avdi/naught
+[codeclimate]: https://codeclimate.com/github/avdi/naught
+[coveralls]: https://coveralls.io/github/avdi/naught?branch=master
+[docs]: http://inch-ci.org/github/avdi/naught
 
 A quick intro to Naught
 -------------------------
@@ -205,6 +214,25 @@ end
 # >> Yep, checks out!
 ```
 
+#### My objects are unique and special snowflakes, with new methods added to them at runtime. How are you gonna mimic *that*, hotshot?
+
+So long as you can create an object to serve as an example, Naught can copy the interface of that object (both the methods defined by its class, and its singleton methods).
+
+```ruby
+require "naught"
+require "logging"
+
+log = Logging.logger["test"]
+log.info
+
+NullLog = Naught.build do |config|
+  config.mimic example: log
+end
+
+null_log = NullLog.new
+null_log.info                  # => nil
+```
+
 #### What about predicate methods? You know, the ones that end with question marks? Shouldn't they return `false` instead of `nil`?
 
 Sure, if you'd like.
@@ -397,7 +425,7 @@ gem install naught
 Requirements
 --------------
 
--   Ruby 1.9
+-   Ruby
 
 Contributing
 --------------
@@ -417,6 +445,10 @@ This isn't the first Ruby Null Object library. Others to check out include:
  - [NullAndVoid](https://github.com/jfelchner/null_and_void)
  - [BlankSlate](https://github.com/saturnflyer/blank_slate)
 
+The Book
+--------
+
+If you've read this far, you might be interested in the short ebook, [*Much Ado About Naught*](https://shiprise.dpdcart.com/cart/add?product_id=64334&method_id=66165), I (Avdi) wrote as I developed this library. It's a fun exploration of Ruby metaprogramming techniques as applied to writing a Ruby gem. You can [read the introduction here](http://devblog.avdi.org/introduction-to-much-ado-about-naught/).
 
 Further reading
 -----------------
@@ -434,3 +466,9 @@ Further reading
 -   [Null Objects and
     Falsiness](http://devblog.avdi.org/2011/05/30/null-objects-and-falsiness/),
     by Avdi Grimm
+
+Libraries Using Naught
+-----------------------
+
+-   [ActiveNull](https://github.com/Originate/active_null) Null Model support for ActiveRecord.
+-   [Twitter](https://github.com/sferik/twitter) A Ruby interface to the Twitter API.

data/Rakefile

@@ -5,7 +5,7 @@ RSpec::Core::RakeTask.new(:spec)
 
 begin
   require 'rubocop/rake_task'
-  Rubocop::RakeTask.new
+  RuboCop::RakeTask.new
 rescue LoadError
   task :rubocop do
     $stderr.puts 'Rubocop is disabled'

data/lib/naught/basic_object.rb

@@ -4,11 +4,11 @@ module Naught
     end
   else
     class BasicObject #:nodoc:
-      keep = %w[
+      keep = %w(
         ! != == __id__ __send__ equal? instance_eval instance_exec
         method_missing singleton_method_added singleton_method_removed
         singleton_method_undefined
-      ]
+      )
       instance_methods.each do |method_name|
         undef_method(method_name) unless keep.include?(method_name)
       end

data/lib/naught/conversions.rb

@@ -16,7 +16,7 @@ module Naught
       when :nothing_passed, *@@null_equivs
         @@null_class.get(:caller => caller(1))
       else
-        fail ArgumentError, "#{object.inspect} is not null!"
+        fail(ArgumentError.new("#{object.inspect} is not null!"))
       end
     end
 
@@ -36,7 +36,7 @@ module Naught
       object = yield if block_given?
       case object
       when NullObjectTag, *@@null_equivs
-        fail ArgumentError, "Null value: #{object.inspect}"
+        fail(ArgumentError.new("Null value: #{object.inspect}"))
       else
         object
       end

data/lib/naught/null_class_builder.rb

@@ -2,12 +2,13 @@ require 'naught/basic_object'
 require 'naught/conversions'
 
 module Naught
-  class NullClassBuilder
+  class NullClassBuilder # rubocop:disable ClassLength
     # make sure this module exists
     module Commands
     end
 
     attr_accessor :base_class, :inspect_proc, :interface_defined
+    alias_method :interface_defined?, :interface_defined
 
     def initialize
       @interface_defined = false
@@ -17,10 +18,6 @@ module Naught
       define_basic_methods
     end
 
-    def interface_defined?
-      !!@interface_defined
-    end
-
     def customize(&customization_block)
       return unless customization_block
       customization_module.module_exec(self, &customization_block)
@@ -34,7 +31,7 @@ module Naught
       @null_equivalents ||= [nil]
     end
 
-    def generate_class
+    def generate_class # rubocop:disable AbcSize
       respond_to_any_message unless interface_defined?
       generation_mod    = Module.new
       customization_mod = customization_module # get a local binding
@@ -63,32 +60,6 @@ module Naught
       null_class
     end
 
-    def method_missing(method_name, *args, &block)
-      command_name = command_name_for_method(method_name)
-      if Commands.const_defined?(command_name)
-        command_class = Commands.const_get(command_name)
-        command_class.new(self, *args, &block).call
-      else
-        super
-      end
-    end
-
-    if RUBY_VERSION >= '1.9'
-      def respond_to_missing?(method_name, include_private = false)
-        command_name = command_name_for_method(method_name)
-        Commands.const_defined?(command_name) || super
-      rescue NameError
-        super
-      end
-    else
-      def respond_to?(method_name, include_private = false)
-        command_name = command_name_for_method(method_name)
-        Commands.const_defined?(command_name) || super
-      rescue NameError
-        super
-      end
-    end
-
     ############################################################################
     # Builder API
     #
@@ -124,7 +95,39 @@ module Naught
       send(@stub_strategy, subject, name)
     end
 
-    private
+    def method_missing(method_name, *args, &block)
+      command_name = command_name_for_method(method_name)
+      if Commands.const_defined?(command_name)
+        command_class = Commands.const_get(command_name)
+        command_class.new(self, *args, &block).call
+      else
+        super
+      end
+    end
+
+    if RUBY_VERSION >= '1.9'
+      def respond_to_missing?(method_name, include_private = false)
+        respond_to_definition(method_name, include_private, :respond_to_missing?)
+      end
+    else
+      def respond_to?(method_name, include_private = false)
+        respond_to_definition(method_name, include_private, :respond_to?)
+      end
+    end
+
+  private
+
+    def respond_to_definition(method_name, include_private, respond_to_method_name)
+      command_name = command_name_for_method(method_name)
+      Commands.const_defined?(command_name) ||
+        super_duper(respond_to_method_name, method_name, include_private)
+    rescue NameError
+      super_duper(respond_to_method_name, method_name, include_private)
+    end
+
+    def super_duper(method_name, *args)
+      self.class.superclass.send(method_name, *args)
+    end
 
     def define_basic_methods
       define_basic_instance_methods

data/lib/naught/null_class_builder/command.rb

@@ -8,8 +8,7 @@ module Naught
       end
 
       def call
-        fail NotImplementedError,
-             'Method #call should be overriden in child classes'
+        fail(NotImplementedError.new('Method #call should be overriden in child classes'))
       end
 
       def defer(options = {}, &block)

data/lib/naught/null_class_builder/commands/define_explicit_conversions.rb

@@ -1,13 +1,17 @@
 require 'forwardable'
 require 'naught/null_class_builder/command'
 
-module Naught::NullClassBuilder::Commands
-  class DefineExplicitConversions < ::Naught::NullClassBuilder::Command
-    def call
-      defer do |subject|
-        subject.module_eval do
-          extend Forwardable
-          def_delegators :nil, :to_a, :to_c, :to_f, :to_h, :to_i, :to_r, :to_s
+module Naught
+  class NullClassBuilder
+    module Commands
+      class DefineExplicitConversions < ::Naught::NullClassBuilder::Command
+        def call
+          defer do |subject|
+            subject.module_eval do
+              extend Forwardable
+              def_delegators :nil, :to_a, :to_c, :to_f, :to_h, :to_i, :to_r, :to_s
+            end
+          end
         end
       end
     end

data/lib/naught/null_class_builder/commands/define_implicit_conversions.rb

@@ -1,16 +1,28 @@
 require 'naught/null_class_builder/command'
 
-module Naught::NullClassBuilder::Commands
-  class DefineImplicitConversions < ::Naught::NullClassBuilder::Command
-    def call
-      defer do |subject|
-        subject.module_eval do
-          def to_ary
-            []
-          end
+module Naught
+  class NullClassBuilder
+    module Commands
+      class DefineImplicitConversions < ::Naught::NullClassBuilder::Command
+        def call
+          defer do |subject|
+            subject.module_eval do
+              def to_ary
+                []
+              end
+
+              def to_hash
+                {}
+              end
+
+              def to_int
+                0
+              end
 
-          def to_str
-            ''
+              def to_str
+                ''
+              end
+            end
           end
         end
       end

data/lib/naught/null_class_builder/commands/impersonate.rb

@@ -1,8 +1,12 @@
-module Naught::NullClassBuilder::Commands
-  class Impersonate < Naught::NullClassBuilder::Commands::Mimic
-    def initialize(builder, class_to_impersonate, options = {})
-      super
-      builder.base_class = class_to_impersonate
+module Naught
+  class NullClassBuilder
+    module Commands
+      class Impersonate < Naught::NullClassBuilder::Commands::Mimic
+        def initialize(builder, class_to_impersonate, options = {})
+          super
+          builder.base_class = class_to_impersonate
+        end
+      end
     end
   end
 end

data/lib/naught/null_class_builder/commands/mimic.rb

@@ -1,37 +1,55 @@
 require 'naught/basic_object'
 require 'naught/null_class_builder/command'
 
-module Naught::NullClassBuilder::Commands
-  class Mimic < Naught::NullClassBuilder::Command
-    attr_reader :class_to_mimic, :include_super
+module Naught
+  class NullClassBuilder
+    module Commands
+      class Mimic < Naught::NullClassBuilder::Command
+        NULL_SINGLETON_CLASS = (class << Object.new; self; end)
+
+        attr_reader :class_to_mimic, :include_super, :singleton_class
+
+        def initialize(builder, class_to_mimic_or_options, options = {})
+          super(builder)
+
+          if class_to_mimic_or_options.is_a?(Hash)
+            options          = class_to_mimic_or_options.merge(options)
+            instance         = options.fetch(:example)
+            @singleton_class = (class << instance; self; end)
+            @class_to_mimic  = instance.class
+          else
+            @singleton_class = NULL_SINGLETON_CLASS
+            @class_to_mimic  = class_to_mimic_or_options
+          end
+          @include_super = options.fetch(:include_super) { true }
+
+          builder.base_class   = root_class_of(@class_to_mimic)
+          class_to_mimic       = @class_to_mimic
+          builder.inspect_proc = lambda { "<null:#{class_to_mimic}>" }
+          builder.interface_defined = true
+        end
 
-    def initialize(builder, class_to_mimic, options = {})
-      super(builder)
+        def call
+          defer do |subject|
+            methods_to_stub.each do |method_name|
+              builder.stub_method(subject, method_name)
+            end
+          end
+        end
 
-      @class_to_mimic = class_to_mimic
-      @include_super = options.fetch(:include_super) { true }
+      private
 
-      builder.base_class   = root_class_of(class_to_mimic)
-      builder.inspect_proc = lambda { "<null:#{class_to_mimic}>" }
-      builder.interface_defined = true
-    end
+        def root_class_of(klass)
+          klass.ancestors.include?(Object) ? Object : Naught::BasicObject
+        end
 
-    def call
-      defer do |subject|
-        methods_to_stub.each do |method_name|
-          builder.stub_method(subject, method_name)
+        def methods_to_stub
+          methods_to_mimic =
+            class_to_mimic.instance_methods(include_super) |
+            singleton_class.instance_methods(false)
+          methods_to_mimic - Object.instance_methods
         end
       end
     end
-
-    private
-
-    def root_class_of(klass)
-      klass.ancestors.include?(Object) ? Object : Naught::BasicObject
-    end
-
-    def methods_to_stub
-      class_to_mimic.instance_methods(include_super) - Object.instance_methods
-    end
   end
 end

data/lib/naught/null_class_builder/commands/pebble.rb

@@ -12,9 +12,8 @@ module Naught
         def call
           defer do |subject|
             subject.module_exec(@output) do |output|
-
-              define_method(:method_missing) do |method_name, *args, &block|
-                pretty_args = args.collect(&:inspect).join(', ').gsub("\"", "'")
+              define_method(:method_missing) do |method_name, *args|
+                pretty_args = args.collect(&:inspect).join(', ').tr("\"", "'")
                 output.puts "#{method_name}(#{pretty_args}) from #{parse_caller}"
                 self
               end

data/lib/naught/null_class_builder/commands/predicates_return.rb

@@ -1,42 +1,44 @@
 require 'naught/null_class_builder/command'
 
-module Naught::NullClassBuilder::Commands
-  class PredicatesReturn < Naught::NullClassBuilder::Command
-    def initialize(builder, return_value)
-      super(builder)
-      @predicate_return_value = return_value
-    end
+module Naught
+  class NullClassBuilder
+    module Commands
+      class PredicatesReturn < Naught::NullClassBuilder::Command
+        def initialize(builder, return_value)
+          super(builder)
+          @predicate_return_value = return_value
+        end
 
-    def call
-      defer do |subject|
-        define_method_missing(subject)
-        define_predicate_methods(subject)
-      end
-    end
+        def call
+          defer do |subject|
+            define_method_missing(subject)
+            define_predicate_methods(subject)
+          end
+        end
 
-    private
+      private
 
-    def define_method_missing(subject)
-      subject.module_exec(@predicate_return_value) do |return_value|
-        if subject.method_defined?(:method_missing)
-          original_method_missing = instance_method(:method_missing)
-          define_method(:method_missing) do |method_name, *args, &block|
-            if method_name.to_s.end_with?('?')
-              return_value
-            else
-              original_method_missing.bind(self).call(method_name, *args, &block)
+        def define_method_missing(subject)
+          subject.module_exec(@predicate_return_value) do |return_value|
+            next unless subject.method_defined?(:method_missing)
+            original_method_missing = instance_method(:method_missing)
+            define_method(:method_missing) do |method_name, *args, &block|
+              if method_name.to_s.end_with?('?')
+                return_value
+              else
+                original_method_missing.bind(self).call(method_name, *args, &block)
+              end
             end
           end
         end
-      end
-    end
 
-    def define_predicate_methods(subject)
-      subject.module_exec(@predicate_return_value) do |return_value|
-        instance_methods.each do |method_name|
-          if method_name.to_s.end_with?('?')
-            define_method(method_name) do |*|
-              return_value
+        def define_predicate_methods(subject)
+          subject.module_exec(@predicate_return_value) do |return_value|
+            instance_methods.each do |method_name|
+              next unless method_name.to_s.end_with?('?')
+              define_method(method_name) do |*|
+                return_value
+              end
             end
           end
         end

data/lib/naught/null_class_builder/commands/singleton.rb

@@ -1,20 +1,24 @@
 require 'naught/null_class_builder/command'
 
-module Naught::NullClassBuilder::Commands
-  class Singleton < Naught::NullClassBuilder::Command
-    def call
-      defer(:class => true) do |subject|
-        require 'singleton'
-        subject.module_eval do
-          include ::Singleton
+module Naught
+  class NullClassBuilder
+    module Commands
+      class Singleton < Naught::NullClassBuilder::Command
+        def call
+          defer(:class => true) do |subject|
+            require 'singleton'
+            subject.module_eval do
+              include ::Singleton
 
-          def self.get(*)
-            instance
-          end
+              def self.get(*)
+                instance
+              end
 
-          %w(dup clone).each do |method_name|
-            define_method method_name do
-              self
+              %w(dup clone).each do |method_name|
+                define_method method_name do
+                  self
+                end
+              end
             end
           end
         end

data/lib/naught/null_class_builder/commands/traceable.rb

@@ -1,17 +1,21 @@
 require 'naught/null_class_builder/command'
 
-module Naught::NullClassBuilder::Commands
-  class Traceable < Naught::NullClassBuilder::Command
-    def call
-      defer do |subject|
-        subject.module_eval do
-          attr_reader :__file__, :__line__
+module Naught
+  class NullClassBuilder
+    module Commands
+      class Traceable < Naught::NullClassBuilder::Command
+        def call
+          defer do |subject|
+            subject.module_eval do
+              attr_reader :__file__, :__line__
 
-          def initialize(options = {})
-            range = (RUBY_VERSION.to_f == 1.9 && RUBY_PLATFORM != 'java') ? 4 : 3
-            backtrace = options.fetch(:caller) { Kernel.caller(range) }
-            @__file__, line, _ = backtrace[0].split(':')
-            @__line__ = line.to_i
+              def initialize(options = {})
+                range = (RUBY_VERSION.to_f == 1.9 && RUBY_PLATFORM != 'java') ? 4 : 3
+                backtrace = options.fetch(:caller) { Kernel.caller(range) }
+                @__file__, line = backtrace[0].split(':')
+                @__line__ = line.to_i
+              end
+            end
           end
         end
       end

data/lib/naught/version.rb

@@ -1,3 +1,3 @@
 module Naught
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

data/naught.gemspec

@@ -8,14 +8,14 @@ Gem::Specification.new do |spec|
   spec.version       = Naught::VERSION
   spec.authors       = ['Avdi Grimm']
   spec.email         = ['avdi@avdi.org']
-  spec.description   = %q{Naught is a toolkit for building Null Objects}
+  spec.description   = 'Naught is a toolkit for building Null Objects'
   spec.summary       = spec.description
   spec.homepage      = 'https://github.com/avdi/naught'
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files`.split($INPUT_RECORD_SEPARATOR)
-  spec.executables   = spec.files.grep(/^bin\//) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(/^(test|spec|features)\//)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
   spec.add_development_dependency 'bundler', '~> 1.3'

data/spec/base_object_spec.rb

@@ -1,7 +1,6 @@
 require 'spec_helper'
 
 describe 'null object with a custom base class' do
-
   subject(:null) { custom_base_null_class.new }
 
   let(:custom_base_null_class) do
@@ -10,11 +9,11 @@ describe 'null object with a custom base class' do
     end
   end
 
-  it 'respond to base class methods' do
+  it 'responds to base class methods' do
     expect(null.methods).to be_an Array
   end
 
-  it 'respond to unknown methods' do
+  it 'responds to unknown methods' do
     expect(null.foo).to be_nil
   end
 

data/spec/basic_null_object_spec.rb

@@ -31,5 +31,4 @@ describe 'basic null object' do
   it 'aliases .new to .get' do
     expect(null_class.get.class).to be(null_class)
   end
-
 end

data/spec/blackhole_spec.rb

@@ -3,9 +3,7 @@ require 'spec_helper'
 describe 'black hole null object' do
   subject(:null) { null_class.new }
   let(:null_class) do
-    Naught.build do |b|
-      b.black_hole
-    end
+    Naught.build(&:black_hole)
   end
 
   it 'returns self from arbitray method calls' do

data/spec/explicit_conversions_spec.rb

@@ -2,9 +2,7 @@ require 'spec_helper.rb'
 
 describe 'explicitly convertable null object' do
   let(:null_class) do
-    Naught.build do |b|
-      b.define_explicit_conversions
-    end
+    Naught.build(&:define_explicit_conversions)
   end
   subject(:null) { null_class.new }
 

data/spec/functions/maybe_spec.rb

@@ -12,7 +12,7 @@ describe 'Maybe()' do
     expect(Maybe(null)).to be(null)
   end
 
-  specify 'given anything in null_equivalents, return a null object' do
+  specify 'given anything in null_equivalents, returns a null object' do
     expect(Maybe('').class).to be(ConvertableNull)
   end
 
@@ -23,7 +23,7 @@ describe 'Maybe()' do
   end
 
   it 'generates null objects with useful trace info' do
-    null, line = Maybe(), __LINE__
+    null, line = Maybe(), __LINE__ # rubocop:disable ParallelAssignment
     expect(null.__file__).to eq(__FILE__)
     expect(null.__line__).to eq(line)
   end

data/spec/functions/null_spec.rb

@@ -16,7 +16,7 @@ describe 'Null()' do
     expect(Null(null)).to be(null)
   end
 
-  specify 'given anything in null_equivalents, return a null object' do
+  specify 'given anything in null_equivalents, returns a null object' do
     expect(Null('').class).to be(ConvertableNull)
   end
 
@@ -26,9 +26,8 @@ describe 'Null()' do
   end
 
   it 'generates null objects with useful trace info' do
-    null, line = Null(), __LINE__
+    null, line = Null(), __LINE__ # rubocop:disable ParallelAssignment
     expect(null.__file__).to eq(__FILE__)
     expect(null.__line__).to eq(line)
   end
-
 end

data/spec/implicit_conversions_spec.rb

@@ -3,9 +3,7 @@ require 'spec_helper'
 describe 'implicitly convertable null object' do
   subject(:null) { null_class.new }
   let(:null_class) do
-    Naught.build do |b|
-      b.define_implicit_conversions
-    end
+    Naught.build(&:define_implicit_conversions)
   end
   it 'implicitly splats the same way an empty array does' do
     a, b = null
@@ -18,8 +16,13 @@ describe 'implicitly convertable null object' do
   it 'implicitly converts to an empty array' do
     expect(null.to_ary).to eq([])
   end
+  it 'implicitly converts to an empty hash' do
+    expect(null.to_hash).to eq({})
+  end
+  it 'implicitly converts to zero' do
+    expect(null.to_int).to eq(0)
+  end
   it 'implicitly converts to an empty string' do
     expect(null.to_str).to eq('')
   end
-
 end

data/spec/mimic_spec.rb

@@ -3,31 +3,20 @@ require 'logger'
 
 describe 'null object mimicking a class' do
   class User
-    def login
-      'bob'
-    end
+    attr_reader :login
   end
 
   module Authorizable
-    def authorized_for?(object)
-      true
-    end
+    def authorized_for?(_); end
   end
 
   class LibraryPatron < User
     include Authorizable
+    attr_reader :name
 
-    def member?
-      true
-    end
-
-    def name
-      'Bob'
-    end
+    def member?; end
 
-    def notify_of_overdue_books(titles)
-      puts 'Notifying...'
-    end
+    def notify_of_overdue_books(_); end
   end
 
   subject(:null) { mimic_class.new }
@@ -78,6 +67,24 @@ describe 'null object mimicking a class' do
       expect(null).to_not respond_to(:login)
     end
   end
+
+  describe 'with an instance as example' do
+    let(:mimic_class) do
+      milton = LibraryPatron.new
+      def milton.stapler; end
+      Naught.build do |b|
+        b.mimic :example => milton
+      end
+    end
+
+    it 'responds to method defined only on the example instance' do
+      expect(null).to respond_to(:stapler)
+    end
+
+    it 'responds to method defined on the class of the instance' do
+      expect(null).to respond_to(:member?)
+    end
+  end
 end
 
 describe 'using mimic with black_hole' do
@@ -89,7 +96,7 @@ describe 'using mimic with black_hole' do
     end
   end
 
-  def self.it_behaves_like_a_black_hole_mimic
+  shared_examples_for 'a black hole mimic' do
     it 'returns self from mimicked methods' do
       expect(null.info).to equal(null)
       expect(null.error).to equal(null)
@@ -101,7 +108,7 @@ describe 'using mimic with black_hole' do
     end
   end
 
-  it_behaves_like_a_black_hole_mimic
+  it_should_behave_like 'a black hole mimic'
 
   describe '(reverse order)' do
     let(:mimic_class) do
@@ -111,7 +118,6 @@ describe 'using mimic with black_hole' do
       end
     end
 
-    it_behaves_like_a_black_hole_mimic
+    it_should_behave_like 'a black hole mimic'
   end
-
 end

data/spec/naught_spec.rb

@@ -2,13 +2,7 @@ require 'spec_helper'
 
 describe 'null object impersonating another type' do
   class Point
-    def x
-      23
-    end
-
-    def y
-      42
-    end
+    attr_reader :x, :y
   end
 
   subject(:null) { impersonation_class.new }
@@ -37,14 +31,12 @@ describe 'traceable null object' do
     null_object_and_line.first
   end
   let(:null_object_and_line) do
-    obj, line = trace_null_class.new, __LINE__
+    obj, line = trace_null_class.new, __LINE__ # rubocop:disable ParallelAssignment
     [obj, line]
   end
   let(:instantiation_line) { null_object_and_line.last }
   let(:trace_null_class) do
-    Naught.build do |b|
-      b.traceable
-    end
+    Naught.build(&:traceable)
   end
 
   it 'remembers the file it was instantiated from' do
@@ -60,7 +52,7 @@ describe 'traceable null object' do
   end
 
   it 'can accept custom backtrace info' do
-    obj, line = make_null, __LINE__
+    obj, line = make_null, __LINE__ # rubocop:disable ParallelAssignment
     expect(obj.__line__).to eq(line)
   end
 end
@@ -91,11 +83,11 @@ end
 TestNull = Naught.build
 
 describe 'a named null object class' do
-  it 'has named ancestor modules', :pending => rubinius? do
+  it 'has named ancestor modules' do
     expect(TestNull.ancestors[0..2].collect(&:name)).to eq([
-        'TestNull',
-        'TestNull::Customizations',
-        'TestNull::GeneratedMethods'
-      ])
+      'TestNull',
+      'TestNull::Customizations',
+      'TestNull::GeneratedMethods',
+    ])
   end
 end

data/spec/predicate_spec.rb

@@ -9,11 +9,11 @@ describe 'a null object with predicates_return(false)' do
   end
 
   it 'responds to predicate-style methods with false' do
-    expect(null.too_much_coffee?).to eq(false)
+    expect(null.too_much_coffee?).to be(false)
   end
 
   it 'responds to other methods with nil' do
-    expect(null.foobar).to eq(nil)
+    expect(null.foobar).to be(nil)
   end
 
   describe '(black hole)' do
@@ -25,7 +25,7 @@ describe 'a null object with predicates_return(false)' do
     end
 
     it 'responds to predicate-style methods with false' do
-      expect(null.too_much_coffee?).to eq(false)
+      expect(null.too_much_coffee?).to be(false)
     end
 
     it 'responds to other methods with self' do
@@ -42,7 +42,7 @@ describe 'a null object with predicates_return(false)' do
     end
 
     it 'responds to predicate-style methods with false' do
-      expect(null.too_much_coffee?).to eq(false)
+      expect(null.too_much_coffee?).to be(false)
     end
 
     it 'responds to other methods with self' do
@@ -51,13 +51,8 @@ describe 'a null object with predicates_return(false)' do
   end
 
   class Coffee
-    def black?
-      true
-    end
-
-    def origin
-      'Ethiopia'
-    end
+    attr_reader :origin
+    def black?; end
   end
 
   describe '(mimic)' do
@@ -69,7 +64,7 @@ describe 'a null object with predicates_return(false)' do
     end
 
     it 'responds to predicate-style methods with false' do
-      expect(null.black?).to eq(false)
+      expect(null.black?).to be(false)
     end
 
     it 'responds to other methods with nil' do

data/spec/singleton_null_object_spec.rb

@@ -2,13 +2,11 @@ require 'spec_helper'
 
 describe 'singleton null object' do
   subject(:null_class) do
-    Naught.build do |b|
-      b.singleton
-    end
+    Naught.build(&:singleton)
   end
 
   it 'does not respond to .new' do
-    expect { null_class.new }.to raise_error
+    expect { null_class.new }.to raise_error(NoMethodError)
   end
 
   it 'has only one instance' do

data/spec/spec_helper.rb

@@ -1,12 +1,14 @@
 GEM_ROOT = File.expand_path('../../', __FILE__)
 $LOAD_PATH.unshift File.join(GEM_ROOT, 'lib')
 
-if ENV['TRAVIS']
-  require 'coveralls'
-  Coveralls.wear!
-else
-  require 'simplecov'
-  SimpleCov.start
+require 'simplecov'
+require 'coveralls'
+
+SimpleCov.formatters = [SimpleCov::Formatter::HTMLFormatter, Coveralls::SimpleCov::Formatter]
+
+SimpleCov.start do
+  add_filter '/spec/'
+  minimum_coverage(97.7)
 end
 
 require 'naught'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: naught
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Avdi Grimm
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-26 00:00:00.000000000 Z
+date: 2015-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -98,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.1
+rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
 summary: Naught is a toolkit for building Null Objects