minitest-spec-rails 4.3.3 → 4.3.4

data/.travis.yml

@@ -1,6 +1,7 @@
 rvm:
   - 1.8.7
   - 1.9.3
+  - ruby-head
 gemfile:
   - gemfiles/rails30.gemfile
   - gemfiles/rails31.gemfile

data/CHANGELOG.md

@@ -1,4 +1,9 @@
 
+## v4.3.4
+
+* Add mini_should support and talk about matchers.
+
+
 ## v4.3.3
 
 * Fix MiniTest::Unit::TestCase hack for Rails 4, ignore in Rails 3.

data/README.md

@@ -9,13 +9,23 @@ Rails 4 was on its way to using MiniTest::Spec as the superclass for ActiveSuppo
 The minitest-spec-rails gem makes it easy to use the MiniTest::Spec DSL within your existing Rails 3 or 4 test suite. It does this by forcing ActiveSupport::TestCase to subclass MiniTest::Spec.
 
 [![Build Status](https://secure.travis-ci.org/metaskills/minitest-spec-rails.png)](http://travis-ci.org/metaskills/minitest-spec-rails)
+[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/metaskills/minitest-spec-rails)
 
 
 ## Usage
 
 Existing or new Rails 3 or 4 applications that use the default Rails testing structure can simply drop in the minitest-spec-gem and start writing their tests in the new spec DSL. Since MinitTest::Spec is built on top of MiniTest::Unit, a replacement for Test::Unit, all of your existing tests will continue to work.
 
-This gem uses no generators and does not require you to write your tests in a new directory or file structure. It is completely different than [minitest-rails](https://github.com/blowmage/minitest-rails) which is setup more like RSpec in the way it bolts on the side of Rails. The goal of this project is to make Rails 3 or 4 applications just work as if rails-core had decided to support MiniTest::Spec. Eventually that day will come and if it does, all your tests will still work! So bundle up and get started!
+### How is this different than MiniTest::Rails?
+
+To start off both Mike Moore (@blowmage) and I have worked together and we both LOVE MiniTest::Spec. Both projects aim to advocate MiniTest and make Rails integration as easy as possible. However, there are a few key differences in our projects. Some of these differences may go away in time too. As always, choose the tool you think fits your needs. So how, is minitest-spec-rails different than [minitest-rails](https://github.com/blowmage/minitest-rails)?
+
+  * We aim to leverage existing Rails test directories and files!
+  * No special test helper and/or generators.
+  * Easy migration path for existing Rails applications.
+  * How we go about freedom patching Rails.
+
+So the goal of this project is to make Rails 3 or 4 applications just work as if rails-core had decided to support MiniTest::Spec all along. We believe that eventually that day will come and when it does, all your tests will still work! So bundle up and get started!
 
 ```ruby
 gem 'minitest-spec-rails'
@@ -34,7 +44,7 @@ assert_equal 100, foo
 foo.must_equal 100
 ```
 
-All existing Rails test cases that subclass ActiveSupport::TestCase will continue to work and I personally suggest that you  still use what I call the subclass convention vs the outer describe test case convention. However either will work.
+All existing Rails test cases that subclass ActiveSupport::TestCase will continue to work and I personally suggest that you still **use the subclass convention** vs the outer describe test case convention. However either will work.
 
 ```ruby
 require 'test_helper'
@@ -86,6 +96,99 @@ end
 ```
 
 
+## Extras
+
+We have baked in a few extra methods behind the scenes to minitest-spec-rails. Most directly support our needs to reflect on described classes, however, they may be useful to you too when meta-programming on top of minitest-spec-rails.
+
+### #described_class
+The `described_class` method is available both via a class method and an instance method in any Rails test case. It is guaranteed to work despite the described level too. This allows class level macros to be build, much like Shoulda. Remember, it can only do this if you follow Rails naming conventions for your tests.
+
+```ruby
+class UserTest < ActiveSupport::TestCase
+  described_class # => User(id: integer, email: string)
+  it 'works here' do
+    described_class # => User(id: integer, email: string)
+  end
+  describe 'and' do
+    it 'works here too' do
+      described_class # => User(id: integer, email: string)
+    end
+  end
+end
+```
+
+### mini_shoulda
+
+If you are migrating away from Shoulda, then minitest-spec-rails' mini_shoulda feature will help. To enable it, set the following configuration in your test environment file.
+
+```ruby
+# In config/environments/test.rb
+config.minitest_spec_rails.mini_shoulda = true
+```
+
+Doing so only enables a few aliases that allow the Shoulda `context`, `should`, and `should_eventually` methods. The following code demonstrates the full features of the mini_shoulda implementation. It basically replaces the shell of [should-context](https://github.com/thoughtbot/shoulda-context) in a few lines of code.
+
+```ruby
+class PostTests < ActiveSupport::TestCase
+  setup    { @post = Post.create! :title => 'Test Title', :body => 'Test body' }
+  teardown { Post.delete_all }
+  should 'work' do
+    @post.must_be_instance_of Post
+  end
+  context 'with a user' do
+    should_eventually 'have a user' do
+      # ...
+    end
+  end
+end
+```
+
+If you are in the assertions provided by shoulda-context like `assert_same_elements`, then you may want to consider copying them [from here](https://github.com/thoughtbot/shoulda-context/blob/master/lib/shoulda/context/assertions.rb) and including them in `MiniTest::Spec` yourself. I personally recommend just replacing these assertions with something more modern. A few examples are below.
+
+```ruby
+assert_same_elements a, b  # From
+a.sort.must_equal b.sort   # To
+
+assert_does_not_contain a, b  # From
+a.wont_include b              # To
+```
+
+### Matchers
+
+If matchers are your thing, I recommend the [minitest-matchers](https://github.com/zenspider/minitest-matchers) gem. For example:
+
+```ruby
+# Basic minitest-matchers features.
+describe Post do
+  include ValidAttribute::Method
+  it "must have validations" do
+    post = Post.new
+    post.must have_valid(:title).when("Good")
+    post.wont have_valid(:title).when("")
+  end
+end
+
+# Using an implicit subject.
+describe Post do
+  subject { Post.new }
+  it { must have_valid(:title).when("Hello") }
+  it { wont have_valid(:title).when("", nil, "Bad") }
+end
+```
+
+Want more? Try out the [valid_attribute](https://github.com/bcardarella/valid_attribute) gem built on top of minitest-matchers.
+
+```ruby
+describe User do
+  subject { User.new }
+  it { must have_valid(:email).when('test@test.com', 'test+spam@gmail.com') }
+  it { wont have_valid(:email).when('fail', 123) }
+  it { must have_valid(:name).when('TestName') }
+  it { wont have_valid(:name).when('Test') }
+end
+```
+
+
 ## Gotchas
 
 ### Assertion Methods
@@ -135,6 +238,5 @@ $ bundle exec rake appraisal:rails32 test
 ```
 
 Our current build status is:
-
 [![Build Status](https://secure.travis-ci.org/metaskills/minitest-spec-rails.png)](http://travis-ci.org/metaskills/minitest-spec-rails)
 

data/gemfiles/rails30.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: /Users/kencollins/Repositories/minitest-spec-rails
   specs:
-    minitest-spec-rails (4.3.2)
+    minitest-spec-rails (4.3.3)
       minitest (~> 4.3)
       rails (>= 3.0)
 

data/gemfiles/rails31.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: /Users/kencollins/Repositories/minitest-spec-rails
   specs:
-    minitest-spec-rails (4.3.2)
+    minitest-spec-rails (4.3.3)
       minitest (~> 4.3)
       rails (>= 3.0)
 

data/gemfiles/rails32.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: /Users/kencollins/Repositories/minitest-spec-rails
   specs:
-    minitest-spec-rails (4.3.2)
+    minitest-spec-rails (4.3.3)
       minitest (~> 4.3)
       rails (>= 3.0)
 

data/lib/minitest-spec-rails/init/mini_shoulda.rb

@@ -0,0 +1,27 @@
+module MiniTestSpecRails
+  module Init
+    module MiniShouldaBehavior
+
+      extend ActiveSupport::Concern
+
+      included do
+        class << self
+          alias :should  :it
+          alias :context :describe
+        end
+        extend ClassMethods
+      end
+
+      module ClassMethods
+
+        def should_eventually(desc)
+          it("should eventually #{desc}") { skip("Should eventually #{desc}") }
+        end
+
+      end
+
+    end
+  end
+end
+
+MiniTest::Spec.send :include, MiniTestSpecRails::Init::MiniShouldaBehavior

data/lib/minitest-spec-rails/railtie.rb

@@ -2,6 +2,7 @@ module MiniTestSpecRails
   class Railtie < ::Rails::Railtie
     
     config.minitest_spec_rails = ActiveSupport::OrderedOptions.new
+    config.minitest_spec_rails.mini_shoulda = false
     
     config.before_initialize do |app| 
       ActiveSupport.on_load(:action_view) do
@@ -19,6 +20,7 @@ module MiniTestSpecRails
 
     initializer 'minitest-spec-rails.after.load_active_support', :after => :load_active_support, :group => :all do |app|
       require 'minitest-spec-rails/init/active_support'
+      require 'minitest-spec-rails/init/mini_shoulda' if app.config.minitest_spec_rails.mini_shoulda
     end
     
   end

data/lib/minitest-spec-rails/version.rb

@@ -1,3 +1,3 @@
 module MiniTestSpecRails
-  VERSION = "4.3.3"
+  VERSION = "4.3.4"
 end

data/test/cases/mini_shoulda_test.rb

@@ -0,0 +1,38 @@
+require 'test_helper_dummy'
+
+class PostTests < ActiveSupport::TestCase
+  
+  i_suck_and_my_tests_are_order_dependent!
+  
+  $teardown_ran = false
+
+  setup do
+    @post = user_post
+  end
+
+  teardown do
+    $teardown_ran = true
+  end
+
+  should 'setup correctly and $teardown_ran should still be false since this is the first test' do
+    @post.must_be_instance_of Post
+    $teardown_ran.must_equal  false
+  end
+
+  should 'teardown correctly' do
+    $teardown_ran.must_equal true
+  end
+
+  should_eventually 'will be skipped' do
+    assert false
+  end
+  
+  context 'level 1' do
+
+    should 'work' do
+      @post.must_be_instance_of Post
+    end
+    
+  end
+
+end

data/test/dummy_app/app/models/post.rb

@@ -0,0 +1,6 @@
+class Post < ActiveRecord::Base
+
+  belongs_to :user
+
+
+end

data/test/dummy_app/app/models/user.rb

@@ -1,3 +1,6 @@
 class User < ActiveRecord::Base
 
+  has_many :posts
+
+
 end

data/test/dummy_app/init.rb

@@ -8,11 +8,13 @@ Bundler.require :default, :development, :test
 module Dummy
   class Application < ::Rails::Application 
 
+    # Basic Engine
     config.root = File.join __FILE__, '..'
     config.cache_store = :memory_store
     config.assets.enabled = false if Rails.version > '3.1'
     config.secret_token = '012345678901234567890123456789'
 
+    # Mimic Test Environment Config.
     config.whiny_nils = true if Rails.version < '4.0'
     config.consider_all_requests_local = true
     config.action_controller.perform_caching = false
@@ -30,6 +32,9 @@ module Dummy
       config.eager_load = true
       config.secret_key_base = '012345678901234567890123456789'
     end
+
+    # Custom
+    config.minitest_spec_rails.mini_shoulda = true
     
   end
 end

data/test/support/shared_test_case_behavior.rb

@@ -7,6 +7,7 @@ module MiniTestSpecRails
       before           { setup_dummy_schema }
       let(:app)        { Dummy::Application }
       let(:user_ken)   { User.create! :email => 'ken@metaskills.net' }
+      let(:user_post)  { Post.create! :title => 'Test Title', :body => 'Test body. Test body.', :user => user_ken}
     end
 
     private
@@ -17,6 +18,10 @@ module MiniTestSpecRails
           create_table :users, :force => true do |t|
             t.string :email
           end
+          create_table :posts, :force => true do |t|
+            t.string  :title, :body
+            t.integer :user_id
+          end
         end
       end
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minitest-spec-rails
 version: !ruby/object:Gem::Version
-  version: 4.3.3
+  version: 4.3.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-18 00:00:00.000000000 Z
+date: 2013-01-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -137,6 +137,7 @@ files:
 - lib/minitest-spec-rails/init/action_mailer.rb
 - lib/minitest-spec-rails/init/action_view.rb
 - lib/minitest-spec-rails/init/active_support.rb
+- lib/minitest-spec-rails/init/mini_shoulda.rb
 - lib/minitest-spec-rails/railtie.rb
 - lib/minitest-spec-rails/util.rb
 - lib/minitest-spec-rails/version.rb
@@ -149,12 +150,14 @@ files:
 - test/cases/action_mailer_test.rb
 - test/cases/action_view_test.rb
 - test/cases/active_support_test.rb
+- test/cases/mini_shoulda_test.rb
 - test/cases/minitest_spec_rails_test.rb
 - test/dummy_app/app/controllers/application_controller.rb
 - test/dummy_app/app/controllers/users_controller.rb
 - test/dummy_app/app/helpers/application_helper.rb
 - test/dummy_app/app/helpers/users_helper.rb
 - test/dummy_app/app/mailers/user_mailer.rb
+- test/dummy_app/app/models/post.rb
 - test/dummy_app/app/models/user.rb
 - test/dummy_app/app/views/users/index.html.erb
 - test/dummy_app/config/database.yml
@@ -185,7 +188,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -310174248579314856
+      hash: 1500693276380796618
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -194,7 +197,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -310174248579314856
+      hash: 1500693276380796618
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -207,12 +210,14 @@ test_files:
 - test/cases/action_mailer_test.rb
 - test/cases/action_view_test.rb
 - test/cases/active_support_test.rb
+- test/cases/mini_shoulda_test.rb
 - test/cases/minitest_spec_rails_test.rb
 - test/dummy_app/app/controllers/application_controller.rb
 - test/dummy_app/app/controllers/users_controller.rb
 - test/dummy_app/app/helpers/application_helper.rb
 - test/dummy_app/app/helpers/users_helper.rb
 - test/dummy_app/app/mailers/user_mailer.rb
+- test/dummy_app/app/models/post.rb
 - test/dummy_app/app/models/user.rb
 - test/dummy_app/app/views/users/index.html.erb
 - test/dummy_app/config/database.yml