minitest-spec-rails 3.1.2 → 4.3.0

data/.travis.yml

@@ -1,9 +1,12 @@
 rvm:
   - 1.8.7
   - 1.9.3
-before_install:
-  - gem update --system 1.8.25
-  - gem install bundler
-  - bundle --version
-before_script:
-  - bundle install
+gemfile:
+  - gemfiles/rails30.gemfile
+  - gemfiles/rails31.gemfile
+  - gemfiles/rails32.gemfile
+  - gemfiles/rails40.gemfile
+matrix:
+  exclude:
+    - rvm: 1.8.7
+      gemfile: gemfiles/rails40.gemfile

data/Appraisals

@@ -0,0 +1,17 @@
+
+appraise 'rails30' do
+  gem 'rails', '~> 3.0.0'
+end
+
+appraise 'rails31' do
+  gem 'rails', '~> 3.1.0'
+end
+
+appraise 'rails32' do
+  gem 'rails', '~> 3.2.0'
+end
+
+appraise 'rails40' do
+  gem 'rails', :github => 'rails/rails'
+end
+

data/CHANGELOG.md

@@ -1,17 +1,8 @@
 
-## v3.1.2
+## v4.3.0
 
-* Register non ActiveRecord::Base classes correctly. Thanks @mptre.
-
-
-## v3.1.1
-
-* Only use a TU shim for Ruby 1.8. See README for info.
-
-
-## v3.1.0
-
-* Reborn and back! Fully supports Rails 2.3.
+* All new MiniTest::Spec for Rails!!! Tested to the hilt!!!
+* Track MiniTest's major/minior version number.
 
 
 ## v3.0.7

data/Gemfile

@@ -1,6 +1,4 @@
-source 'https://rubygems.org'
+source :rubygems
 
 gemspec
 
-gem 'minitest-spec-rails-tu-shim' if RUBY_VERSION < '1.9'
-

data/README.md

@@ -3,8 +3,117 @@
 
 # Make Rails Use MiniTest::Spec!
 
-Always read the latest:
 
-https://github.com/metaskills/minitest-spec-rails#for-rails-23
+Rails 4 was on its way to using MiniTest::Spec as the superclass for ActiveSupport::TestCase. But in one of many reversals, the work was [pulled by this commit](http://github.com/rails/rails/commit/b22c527e65a41da59dbfcb078968069c6fae5086). DHH says that [Rails is omakase](http://david.heinemeierhansson.com/2012/rails-is-omakase.html) and I am cool with that. But since Ruby is wide open for us to change it and we are free in DHH's words to "freedom patch" what we see fit, we can fix Rails.
 
+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)
+
+
+## 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!
+
+```ruby
+gem 'minitest-spec-rails'
+```
+
+
+## Test Styles
+
+This <a href="http://cheat.errtheblog.com/s/minitest">cheat sheet</a> shows both the MiniTest::Unit assertions along with the MiniTest::Spec assertion syntax. Remember, MiniTest::Spec is build on top of MiniTest::Unit which is a Test::Unit replacement. That means you can mix and match styles as you upgrade from Test::Unit to a more modern style. For example, both of these would work in MiniTest::Spec and are interchangeable.
+
+```ruby
+# MiniTest::Unit Assertion Style:
+assert_equal 100, foo
+
+# MiniTest::Spec Assertion Style:
+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.
+
+```ruby
+require 'test_helper'
+class UserTest < ActiveSupport::TestCase
+  let(:user_ken)   { User.create! :email => 'ken@metaskills.net' }
+  it 'works' do
+    user_ken.must_be_instance_of User
+  end
+end
+```
+
+```ruby
+require 'test_helper'
+describe User do
+  # This will work too.
+end
+```
+
+Just for reference, here is a full list of each of Rails test case classes and the matching describe alternative if one exists. Remember, names are important when using the describe syntax. So you can not have a mailer named `FooBar` and expect it to work with the outer describe spec style since there is no way to map the spec type based on an existing naming convention.
+
+```ruby
+# Model Test
+class UserTest < ActiveSupport::TestCase
+end
+describe User do
+end
+
+# Controller Test
+class UsersControllerTest < ActionController::TestCase
+end
+describe UsersController do
+end
+
+# Integration Tests - Must use subclass style!
+class IntegrationTest < ActionDispatch::IntegrationTest
+end
+
+# Mailer Test
+class UserMailerTest < ActionMailer::TestCase
+end
+describe UserMailer do
+end
+
+# View Helper Test
+class UsersHelperTest < ActionView::TestCase
+end
+describe UsersHelper do
+end
+```
+  
+
+
+## Gotchas
+
+If you are upgrading from Test::Unit, there are a few missing assertions that have been renamed or are no longer available within MiniTest.
+
+* The method `assert_raise` is renamed `assert_raises`.
+* There is no method `assert_nothing_raised`. There are good reasons for this on [Ryan's blog entry](http://blog.zenspider.com/blog/2012/01/assert_nothing_tested.html).
+
+If you are using minitest-spec-rails with Rails 3.0, then your controller or mailer tests will need to use the `tests` interface for the test to be setup correct within sub `describe` blocks. I think this is a bug with `class_attribute` within Rails 3.0. Rails 3.1 and higher does not exhibit this problem.
+
+
+## Contributing
+
+The minitest-spec-rails gem is fully tested from Rails 3.0 to 4 and upward. We run our tests on [Travis CI](http://travis-ci.org/metaskills/minitest-spec-rails) in both Ruby 1.8 and 1.9. If you detect a problem, open up a github issue or fork the repo and help out. After you fork or clone the repository, the following commands will get you up and running on the test suite. 
+
+```shell
+$ bundle install
+$ bundle exec rake appraisal:setup
+$ bundle exec rake appraisal test
+```
+
+We use the [appraisal](https://github.com/thoughtbot/appraisal) gem from Thoughtbot to help us generate the individual gemfiles for each Rails version and to run the tests locally against each generated Gemfile. The `rake appraisal test` command actually runs our test suite against all Rails versions in our `Appraisal` file. If you want to run the tests for a specific Rails version, use `rake -T` for a list. For example, the following command will run the tests for Rails 3.2 only.
+
+```shell
+$ 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/Rakefile

@@ -1,6 +1,7 @@
 require 'rubygems'
 require 'bundler/gem_tasks'
 require 'rake/testtask'
+require 'appraisal'
 
 Rake::TestTask.new   do |t|
   t.libs = ['lib','test']
@@ -9,3 +10,10 @@ Rake::TestTask.new   do |t|
 end
 
 task :default => :test
+
+desc "Setup Appraisal."
+task 'appraisal:setup' do
+  Rake::Task['appraisal:cleanup'].invoke
+  Rake::Task['appraisal:gemfiles'].invoke
+  Rake::Task['appraisal:install'].invoke
+end

data/gemfiles/rails30.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source :rubygems
+
+gem "rails", "~> 3.0.0"
+
+gemspec :path=>"../"

data/gemfiles/rails30.gemfile.lock

@@ -0,0 +1,94 @@
+PATH
+  remote: /Users/kencollins/Repositories/minitest-spec-rails
+  specs:
+    minitest-spec-rails (4.3.0)
+      minitest (~> 4.3)
+      rails (>= 3.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    abstract (1.0.0)
+    actionmailer (3.0.19)
+      actionpack (= 3.0.19)
+      mail (~> 2.2.19)
+    actionpack (3.0.19)
+      activemodel (= 3.0.19)
+      activesupport (= 3.0.19)
+      builder (~> 2.1.2)
+      erubis (~> 2.6.6)
+      i18n (~> 0.5.0)
+      rack (~> 1.2.5)
+      rack-mount (~> 0.6.14)
+      rack-test (~> 0.5.7)
+      tzinfo (~> 0.3.23)
+    activemodel (3.0.19)
+      activesupport (= 3.0.19)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activerecord (3.0.19)
+      activemodel (= 3.0.19)
+      activesupport (= 3.0.19)
+      arel (~> 2.0.10)
+      tzinfo (~> 0.3.23)
+    activeresource (3.0.19)
+      activemodel (= 3.0.19)
+      activesupport (= 3.0.19)
+    activesupport (3.0.19)
+    appraisal (0.5.1)
+      bundler
+      rake
+    arel (2.0.10)
+    builder (2.1.2)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    i18n (0.5.0)
+    json (1.7.6)
+    mail (2.2.19)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.19)
+    minitest (4.4.0)
+    minitest-emoji (1.0.0)
+    polyglot (0.3.3)
+    rack (1.2.7)
+    rack-mount (0.6.14)
+      rack (>= 1.0.0)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rails (3.0.19)
+      actionmailer (= 3.0.19)
+      actionpack (= 3.0.19)
+      activerecord (= 3.0.19)
+      activeresource (= 3.0.19)
+      activesupport (= 3.0.19)
+      bundler (~> 1.0)
+      railties (= 3.0.19)
+    railties (3.0.19)
+      actionpack (= 3.0.19)
+      activesupport (= 3.0.19)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.4)
+    rake (10.0.3)
+    rdoc (3.12)
+      json (~> 1.4)
+    sqlite3 (1.3.7)
+    thor (0.14.6)
+    treetop (1.4.12)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.35)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  appraisal
+  minitest-emoji
+  minitest-spec-rails!
+  rails (~> 3.0.0)
+  rake
+  sqlite3

data/gemfiles/rails31.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source :rubygems
+
+gem "rails", "~> 3.1.0"
+
+gemspec :path=>"../"

data/gemfiles/rails31.gemfile.lock

@@ -0,0 +1,105 @@
+PATH
+  remote: /Users/kencollins/Repositories/minitest-spec-rails
+  specs:
+    minitest-spec-rails (4.3.0)
+      minitest (~> 4.3)
+      rails (>= 3.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.1.10)
+      actionpack (= 3.1.10)
+      mail (~> 2.3.3)
+    actionpack (3.1.10)
+      activemodel (= 3.1.10)
+      activesupport (= 3.1.10)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      i18n (~> 0.6)
+      rack (~> 1.3.6)
+      rack-cache (~> 1.2)
+      rack-mount (~> 0.8.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.0.4)
+    activemodel (3.1.10)
+      activesupport (= 3.1.10)
+      builder (~> 3.0.0)
+      i18n (~> 0.6)
+    activerecord (3.1.10)
+      activemodel (= 3.1.10)
+      activesupport (= 3.1.10)
+      arel (~> 2.2.3)
+      tzinfo (~> 0.3.29)
+    activeresource (3.1.10)
+      activemodel (= 3.1.10)
+      activesupport (= 3.1.10)
+    activesupport (3.1.10)
+      multi_json (>= 1.0, < 1.3)
+    appraisal (0.5.1)
+      bundler
+      rake
+    arel (2.2.3)
+    builder (3.0.4)
+    erubis (2.7.0)
+    hike (1.2.1)
+    i18n (0.6.1)
+    json (1.7.6)
+    mail (2.3.3)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.19)
+    minitest (4.4.0)
+    minitest-emoji (1.0.0)
+    multi_json (1.2.0)
+    polyglot (0.3.3)
+    rack (1.3.9)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-mount (0.8.3)
+      rack (>= 1.0.0)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (3.1.10)
+      actionmailer (= 3.1.10)
+      actionpack (= 3.1.10)
+      activerecord (= 3.1.10)
+      activeresource (= 3.1.10)
+      activesupport (= 3.1.10)
+      bundler (~> 1.0)
+      railties (= 3.1.10)
+    railties (3.1.10)
+      actionpack (= 3.1.10)
+      activesupport (= 3.1.10)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.6)
+    rake (10.0.3)
+    rdoc (3.12)
+      json (~> 1.4)
+    sprockets (2.0.4)
+      hike (~> 1.2)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sqlite3 (1.3.7)
+    thor (0.14.6)
+    tilt (1.3.3)
+    treetop (1.4.12)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.35)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  appraisal
+  minitest-emoji
+  minitest-spec-rails!
+  rails (~> 3.1.0)
+  rake
+  sqlite3

data/gemfiles/rails32.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source :rubygems
+
+gem "rails", "~> 3.2.0"
+
+gemspec :path=>"../"

data/gemfiles/rails32.gemfile.lock

@@ -0,0 +1,104 @@
+PATH
+  remote: /Users/kencollins/Repositories/minitest-spec-rails
+  specs:
+    minitest-spec-rails (4.3.0)
+      minitest (~> 4.3)
+      rails (>= 3.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.2.11)
+      actionpack (= 3.2.11)
+      mail (~> 2.4.4)
+    actionpack (3.2.11)
+      activemodel (= 3.2.11)
+      activesupport (= 3.2.11)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.0)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.2.1)
+    activemodel (3.2.11)
+      activesupport (= 3.2.11)
+      builder (~> 3.0.0)
+    activerecord (3.2.11)
+      activemodel (= 3.2.11)
+      activesupport (= 3.2.11)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.11)
+      activemodel (= 3.2.11)
+      activesupport (= 3.2.11)
+    activesupport (3.2.11)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    appraisal (0.5.1)
+      bundler
+      rake
+    arel (3.0.2)
+    builder (3.0.4)
+    erubis (2.7.0)
+    hike (1.2.1)
+    i18n (0.6.1)
+    journey (1.0.4)
+    json (1.7.6)
+    mail (2.4.4)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.19)
+    minitest (4.4.0)
+    minitest-emoji (1.0.0)
+    multi_json (1.5.0)
+    polyglot (0.3.3)
+    rack (1.4.4)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (3.2.11)
+      actionmailer (= 3.2.11)
+      actionpack (= 3.2.11)
+      activerecord (= 3.2.11)
+      activeresource (= 3.2.11)
+      activesupport (= 3.2.11)
+      bundler (~> 1.0)
+      railties (= 3.2.11)
+    railties (3.2.11)
+      actionpack (= 3.2.11)
+      activesupport (= 3.2.11)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (10.0.3)
+    rdoc (3.12)
+      json (~> 1.4)
+    sprockets (2.2.2)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sqlite3 (1.3.7)
+    thor (0.16.0)
+    tilt (1.3.3)
+    treetop (1.4.12)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.35)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  appraisal
+  minitest-emoji
+  minitest-spec-rails!
+  rails (~> 3.2.0)
+  rake
+  sqlite3