shared_tests 0.0.1 → 0.0.2

data/Readme.md

@@ -0,0 +1,85 @@
+# Shared tests
+
+Shared tests is a minimal DSL for Test::Unit that let's you assert the behavior shared by your objects
+easily, using a little pattern and a commodity DSL.
+
+## Installation
+
+   gem install shared_tests
+
+## Usage
+
+You want to test this behavior shared by some of your objects.
+
+```ruby
+module ProgrammingMotherfucker
+  def what_am_i?
+    "a programming motherfucker"
+  end
+end
+```
+
+Your Hacker and SysAdmin instances are programming motherfuckers.
+
+```ruby
+class Hacker
+  include ProgrammingMotherfucker
+end
+
+class SysAdmin
+  include ProgrammingMotherfucker
+end
+```
+
+To test it first the little pattern: declare the shared behavior test examples inside a module,
+the trick here is to add the `Tests` word as the end of the module name.
+
+```ruby
+module ProgrammingMotherfuckerTests
+# write your tests as usual
+  def test_is_a_programming_motherfucker?
+    assert @me.what_am_i? == "a programming motherfucker"
+  end
+end
+```
+
+Now you can assert that a hacker is a programming motherfucker,
+
+```ruby
+class HackerTest < Test::Unit::TestCase
+  include SharedTests # include the shared_tests support
+
+  assert_shared_tests :of => :programming_motherfucker do
+  # this is the setup of the shared tests
+    @me = Hacker.new
+  end
+end
+```
+
+and sysadmins also,
+
+```ruby
+class SysAdminTest < Test::Unit::TestCase
+  include SharedTests
+
+  # or you can use the shorter version
+  assert_tests :of => :programming_motherfucker do
+    @me = SysAdmin.new
+  end
+end
+```
+
+## TODO
+
+* make it use Minitest
+* allow to use @variables names in the setups different that those inside ProgrammingMotherfuckerTests
+* Travis integration
+* collect my programming motherfucker tshirt :-)
+
+## Thanks
+
+* [Jorge Días](https://github.com/diasjorge) for useful tips.
+
+## License
+
+Do something good for mankind license. A good will action would be awesome, a happy thought will do.

data/lib/shared_tests.rb

@@ -7,16 +7,16 @@ module SharedTests
   end
 
   module InstanceMethods
-
     def assert_shared_tests(options = {}, &block)
       shared_test = options.delete(:of)
       include "#{shared_test.to_s.camelize}Tests".constantize
 
       define_method(:setup) do
         super()
-        instance_eval(&block)
+        instance_eval &block
       end
     end
+    alias_method :assert_tests, :assert_shared_tests
 
   end
 end

data/lib/shared_tests/version.rb

@@ -1,3 +1,3 @@
 module SharedTests
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/test/shared_tests_test.rb

@@ -3,7 +3,7 @@ require File.expand_path(File.dirname(__FILE__) + '/../lib/shared_tests')
 
 # shared behavior we want to test
 module ProgrammingMotherfucker
-  def who_am_i?
+  def what_am_i?
     "a programming motherfucker"
   end
 end
@@ -13,14 +13,19 @@ class Hacker
   include ProgrammingMotherfucker
 end
 
+# so are sys admin instances
+class SysAdmin
+  include ProgrammingMotherfucker
+end
+
 # declaring the shared behavior test examples
 module ProgrammingMotherfuckerTests
   def test_is_a_programming_motherfucker?
-    assert @me.who_am_i? == "a programming motherfucker"
+    assert @me.what_am_i? == "a programming motherfucker"
   end
 end
 
-# and the hacker tests
+# the hacker tests
 class HackerTest < Test::Unit::TestCase
   include SharedTests
 
@@ -28,3 +33,13 @@ class HackerTest < Test::Unit::TestCase
     @me = Hacker.new
   end
 end
+
+# the sysadmin tests
+class SysAdminUsesShortHandTest < Test::Unit::TestCase
+  include SharedTests
+
+  # using short hand
+  assert_tests :of => :programming_motherfucker do
+    @me = SysAdmin.new
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: shared_tests
 version: !ruby/object:Gem::Version 
-  hash: 29
+  hash: 27
   prerelease: 
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - Joaquin Rivera Padron
@@ -45,6 +45,7 @@ files:
 - Gemfile
 - Gemfile.lock
 - Rakefile
+- Readme.md
 - lib/shared_tests.rb
 - lib/shared_tests/version.rb
 - shared_tests.gemspec