grumpy_old_man 0.1.0

data/Gemfile

@@ -0,0 +1,5 @@
+source :rubygems
+
+group :test do
+  gem "rspec"
+end

data/Gemfile.lock

@@ -0,0 +1,18 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    rspec (2.11.0)
+      rspec-core (~> 2.11.0)
+      rspec-expectations (~> 2.11.0)
+      rspec-mocks (~> 2.11.0)
+    rspec-core (2.11.1)
+    rspec-expectations (2.11.2)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.11.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rspec

data/README.md

@@ -0,0 +1,74 @@
+# Asserts for RSpec
+
+GrumpyOldMan is an RSpec shim that provides old school assert methods.
+
+![Grumpy Old Man GEM](http://hopsoft.github.com/grumpy_old_man/images/clint-eastwood.jpg)
+
+It adds the following methods to RSpec without compromising any of RSpecs awesomeness.
+
+* `assert`
+* `assert_equal`
+* `assert_raise`
+
+Yes you really can have your cake and eat it too!
+
+---
+
+I love several things about RSpec.
+
+* Its beautiful output from the test runner
+* Its declarative approach to writing tests... well at least the outer wrapper e.g. `describe Thing it 'should do stuff'`
+
+I lament the fact that the rest of RSpec is an over engineered solution to a simple problem.
+`assert true`
+
+---
+
+My contention is that its better to write tests in the same manner you write the app.
+This approach does away with the context switching between app syntax and a wonky DSL confined to the test suite.
+
+It also lowers the barrier to entry.
+
+Consider the following example from the RSpec docs.
+
+```ruby
+expect(order.total).to eq(Money.new(5.55, :USD))
+```
+
+Rewritten with GrumpyOldMan.
+```ruby
+assert order.total == Money.new(5.55, :USD)
+# or ...
+assert_equal order.total, Money.new(5.55, :USD)
+```
+
+Asserts allow me to write code that more closely resembles the app logic itself... which feels more natural.
+
+## Usage
+
+Simply include GrumpyOldMan in your spec/test like so.
+
+```ruby
+describe Thing
+  include GrumpyOldMan
+
+  it "should feel good" do
+    assert true
+  end
+
+  it "should be balanced" do
+    assert_equal true, true
+  end
+
+  it "should be exceptional" do
+    assert_raise(Exception) { raise }
+  end
+
+end
+```
+
+You might not agree, but I'm sticking with my old fashioned assert.
+
+**Now get off my lawn!**
+
+<a href="https://github.com/hopsoft/grumpy_old_man"><img style="position: fixed; top: 0; right: 0; border: 0; z-index: 9999;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png" alt="Fork me on GitHub"></a>

data/lib/grumpy_old_man.rb

@@ -0,0 +1,51 @@
+# An RSpec shim that provides old school assert methods.
+# My contention is that its better to write tests in the same fashion that you write the app.
+# This approach is faster since it does away with the need to context switch
+# between app logic and a wonky DSL provided by the test suite.
+# The barrier to entry is also lower for the unitiated RSpec user.
+#
+# Consider the following example from the RSpec docs.
+#   expect(order.total).to eq(Money.new(5.55, :USD))
+#
+# Rewritten with GrumpyOldMan.
+#   assert_equal order.total, Money.new(5.55, :USD)
+#
+# The traditional assert allows me to write the same style of code in both the app and my tests.
+# This feels much more natural to me. You might not agree, but I'm sticking to my old fashioned assert.
+module GrumpyOldMan
+
+  # A simple assert for RSpec so folks don't have to learn a wonky DSL
+  # and monkeypatched object methods that eventually boil down to a basic "assert" anyway.
+  #
+  # @example
+  #   assert(true)
+  #
+  # @example
+  #   assert { true.to_s == "true" }
+  #
+  # @param [Object] arg An optional arg to assert as equal to true.
+  def assert(arg=nil)
+    if block_given?
+      assert_equal(yield, true)
+    else
+      assert_equal(arg, true)
+    end
+  end
+
+  # A basic assert helper that tests for Object equality.
+  # Tests for object equivalence rather than object identity since this is sufficient for 99.9% of tests.
+  #
+  # @param [Objecct] obj The Object to compare.
+  # @param [Objecct] expected The expected value.
+  def assert_equal(obj, expected)
+    obj.should == expected
+  end
+
+  # A basic assert helper that ensures an Error was raised.
+  # @param [Class] ex The expected Exception class.
+  def assert_raise(ex, &block)
+    Proc.new(&block).should raise_error(ex)
+  end
+
+end
+

data/spec/grumpy_old_man_spec.rb

@@ -0,0 +1,21 @@
+require File.join(File.dirname(__FILE__), "..", "lib", "grumpy_old_man")
+
+describe RSpec do
+  # we eat our dog food
+  include GrumpyOldMan
+
+  it "should support assert with GrumpyOldMan" do
+    assert self.respond_to? :assert
+  end
+
+  it "should support assert_equal with GrumpyOldMan" do
+    assert_equal true, self.respond_to?(:assert)
+  end
+
+  it "should support assert_raise with GrumpyOldMan" do
+    assert self.respond_to?(:assert_raise)
+    assert_raise(Exception) { raise }
+  end
+
+end
+

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: grumpy_old_man
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Nathan Hopkins
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-21 00:00:00.000000000 Z
+dependencies: []
+description: ! "    Do you like RSpec's delcarative describe statements but hate its
+  wonky DSL that monkey patches BasicObject?\n    Do you want to write tests without
+  learning all of RSpec's matchers and expectations?\n    Do you prefer simple asserts
+  in your test suite?\n    Welcome home my friend, GrumpyOldMan is for you.\n"
+email:
+- natehop@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/grumpy_old_man.rb
+- Gemfile
+- Gemfile.lock
+- README.md
+- spec/grumpy_old_man_spec.rb
+homepage: https://github.com/hopsoft/grumpy_old_man
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Asserts for RSpec.
+test_files: []