minitest-matchers_vaccine 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4e677b775a9ec040f8d9d706b2452d21170435f2
+  data.tar.gz: f4ba7684cad0e2bbaf7d88fc851a81bd0d07de83
+SHA512:
+  metadata.gz: 41cffe4d9b92720a6663f0295f6ad8eb4742292bead75e859b4630a8845d6c66c027fe9c59c806e6ccadcace2d3286befa3a7331a045988842e0d387cc08602b
+  data.tar.gz: f2fbf63c98625915e1c31b817c0e85366b8c134630c874cd9295a47a3d11ad6485778c5b2b792319f43093429fb49f3fe842e0aae81e1a2278011b73e2a6c188

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Ryan McGeary
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,130 @@
+# Minitest::MatchersVaccine [![Gem Version](http://img.shields.io/gem/v/minitest-matchers_vaccine.svg)](https://rubygems.org/gems/minitest-matchers_vaccine) [![Build Status](https://secure.travis-ci.org/rmm5t/minitest-matchers_vaccine.svg)](http://travis-ci.org/rmm5t/minitest-matchers_vaccine) [![Code Climate](http://img.shields.io/codeclimate/github/rmm5t/minitest-matchers_vaccine.svg)](https://codeclimate.com/github/rmm5t/minitest-matchers_vaccine)
+
+Adds matcher support to minitest without all the other RSpec-style expectation
+_infections_.
+
+Using matchers with RSpec-style expectations requires that we _infect_ the
+objects that we are testing with new methods. Matcher implementations are
+typically overkill, but there are a lot of good testing libraries that still
+insist on standardizing on matchers. These matchers still have some value, and
+this gem tries to extract that value with straight-forward assertions that
+adhere to the matcher spec.
+
+**Why not use
+[minitest-matchers](https://github.com/wojtekmach/minitest-matchers)?** This
+gem is actually heavily inspired by and based upon the assertions in
+minitest-matchers; however, everything else that minitest-matchers brings to
+the table is unnecessary unless you're bent on a true RSpec-style syntax.
+
+## How You Can Help
+
+**If you like this project, please help. [Donate via Gittip][gittip] or [buy me a coffee with Bitcoin][bitcoin].**<br>
+[![Gittip](http://img.shields.io/gittip/rmm5t.svg)][gittip]
+[![Bitcoin](http://img.shields.io/badge/bitcoin-buy%20me%20a%20coffee-brightgreen.svg)][bitcoin]
+
+**[Bitcoin][bitcoin]**: `1rmm5tv6f997JK5bLcGbRCZyVjZUPkQ2m`<br>
+[![Bitcoin Donation][bitcoin-qr-small]][bitcoin-qr-big]
+
+## Need Help?
+
+**You can [book a session with me on Codementor][codementor].**<br>
+[![Book a Codementor session](http://img.shields.io/badge/codementor-book%20a%20session-orange.svg)][codementor]
+
+[gittip]: https://www.gittip.com/rmm5t/ "Donate to rmm5t for open source!"
+[bitcoin]: https://blockchain.info/address/1rmm5tv6f997JK5bLcGbRCZyVjZUPkQ2m "Buy rmm5t a coffee for open source!"
+[bitcoin-scheme]: bitcoin:1rmm5tv6f997JK5bLcGbRCZyVjZUPkQ2m?amount=0.01&label=Coffee%20to%20rmm5t%20for%20Open%20Source "Buy rmm5t a coffee for open source!"
+[bitcoin-qr-small]: http://chart.apis.google.com/chart?cht=qr&chs=150x150&chl=bitcoin%3A1rmm5tv6f997JK5bLcGbRCZyVjZUPkQ2m%3Famount%3D0.01%26label%3DCoffee%2520to%2520rmm5t%2520for%2520Open%2520Source
+[bitcoin-qr-big]: http://chart.apis.google.com/chart?cht=qr&chs=500x500&chl=bitcoin%3A1rmm5tv6f997JK5bLcGbRCZyVjZUPkQ2m%3Famount%3D0.01%26label%3DCoffee%2520to%2520rmm5t%2520for%2520Open%2520Source
+[codementor]: https://www.codementor.io/rmm5t?utm_campaign=profile&utm_source=button-rmm5t&utm_medium=shields "Book a session with rmm5t on Codementor!"
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem "minitest-matchers_vaccine"
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install minitest-matchers_vaccine
+
+## Usage
+
+Includes both `assert_must` and `assert_wont` assertions, but also includes
+`must` and `wont` facilitator assertions that automatically default to
+using the current `subject` method or `@subject` instance variable.
+
+**NOTE:** This gem does not allow matchers to be used with an expectation
+  syntax. Let's avoid infecting the objects we're testing.
+
+### MiniTest::Test
+
+```ruby
+class UserTest < Minitest::Test
+  def setup
+    @subject = User.new
+  end
+
+  def test_fields_and_associations
+    must have_db_column :name
+    must belong_to :account
+    assert_must have_many(:widgets), @subject
+  end
+
+  def test_validations
+    must have_valid(:email).when("a@a.com", "foo@bar.com", "dave@abc.io")
+    wont have_valid(:email).when(nil, "foo", "foo@bar", "@bar.com")
+  end
+
+  # Works with matchers in other libs
+  def test_stripping
+    assert_must strip_attribute(:name), User.new
+  end
+end
+```
+
+### MiniTest::Spec
+
+```ruby
+describe User do
+  subject { User.new }
+
+  # Works with shoulda-matchers
+  it "should have fields and association" do
+    must have_db_column :name
+    must belong_to :account
+    must have_many :widgets
+  end
+
+  # Works with valid_attribute
+  it "should validate" do
+    must have_valid(:email).when("a@a.com", "foo@bar.com", "dave@abc.io")
+    wont have_valid(:email).when(nil, "foo", "foo@bar", "@bar.com")
+  end
+
+  # Works with matchers in other libs
+  it "should strip attributes" do
+    must strip_attribute :name
+  end
+end
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/rmm5t/minitest-matchers_vaccine/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+## Credits
+
+The idea was originally inspired by the assertions implementation in [minitest-matchers](https://github.com/wojtekmach/minitest-matchers).
+
+## License
+
+Copyright (c) 2014 Ryan McGeary released under the [MIT
+license](http://en.wikipedia.org/wiki/MIT_License)

data/lib/minitest/matchers_vaccine/version.rb

@@ -0,0 +1,5 @@
+module Minitest
+  module MatchersVaccine
+    VERSION = "1.0.0"
+  end
+end

data/lib/minitest/matchers_vaccine.rb

@@ -0,0 +1,86 @@
+require "minitest/matchers_vaccine/version"
+
+# Borrowed and modified from minitest-matchers, but we don't need all the
+# other RSpec-style expectation "infections."
+module MiniTest
+  module Assertions
+    ##
+    # Passes if matcher.matches?(subject) returns true
+    #
+    # Example:
+    #
+    #   def test_validations
+    #     assert_must be_valid, @user
+    #   end
+    def assert_must(matcher, subject, msg = nil)
+      msg = message(msg) do
+        if matcher.respond_to? :failure_message
+          matcher.failure_message # RSpec 3.x, 1.1
+        else
+          matcher.failure_message_for_should # RSpec 2.x, 1.2
+        end
+      end
+
+      assert matcher.matches?(subject), msg
+    end
+
+    ##
+    # Facilitator to assert_must for use with minitest-spec. If no subject
+    # given, defaults to matching against the current `subject` or the
+    # instance variable `@subject`.
+    #
+    # Example:
+    #
+    #   subject { Order.new }
+    #
+    #   it "should have associations" do
+    #     must belong_to :account
+    #     must have_many :line_items
+    #   end
+    def must(matcher, subject = @subject || subject, msg = nil)
+      assert_must matcher, subject, msg
+    end
+
+    ##
+    # Passes if matcher.matches?(subject) returns false
+    #
+    # Example:
+    #
+    #   def test_validations
+    #     assert_wont be_valid, @user
+    #   end
+    def assert_wont(matcher, subject, msg = nil)
+      msg = message(msg) do
+        if matcher.respond_to? :failure_message_when_negated # RSpec 3.x
+          matcher.failure_message_when_negated # RSpec 3.x
+        elsif matcher.respond_to? :failure_message_for_should_not
+          matcher.failure_message_for_should_not # RSpec 2.x, 1.2
+        else
+          matcher.negative_failure_message # RSpec 1.1
+        end
+      end
+
+      if matcher.respond_to? :does_not_match?
+        assert matcher.does_not_match?(subject), msg
+      else
+        refute matcher.matches?(subject), msg
+      end
+    end
+
+    ##
+    # Facilitator to assert_wont for use with minitest-spec. If no subject
+    # given, defaults to matching against the current `subject` or the
+    # instance variable `@subject`.
+    #
+    # Example:
+    #
+    #   subject { User.new }
+    #
+    #   it "should validate" do
+    #     wont have_valid(:email).when("foo", "foo@bar", "@bar.com")
+    #   end
+    def wont(matcher, subject = @subject || subject, msg = nil)
+      assert_wont matcher, subject, msg
+    end
+  end
+end

data/test/matchers_test.rb

@@ -0,0 +1,131 @@
+require "minitest/autorun"
+require "minitest/matchers_vaccine"
+
+module InstanceOf
+  def be_instance_of klass
+    Matcher.new klass
+  end
+
+  class Matcher
+    def initialize klass
+      @klass = klass
+    end
+
+    def description
+      "be instance of #{@klass}"
+    end
+
+    def matches? subject
+      @subject = subject
+      @subject.instance_of? @klass
+    end
+
+    def failure_message
+      "expected to " + description
+    end
+
+    def failure_message_when_negated
+      "expected not to " + description
+    end
+  end
+end
+
+describe "#assert_must" do
+  include InstanceOf
+
+  it "should be capable of passing" do
+    assert_equal true, assert_must(be_instance_of(Array), [:hello])
+    assert_equal true, assert_must(be_instance_of(String), "hello")
+  end
+
+  it "should be capable of failing" do
+    assert_raises(Minitest::Assertion) { assert_must(be_instance_of(String), [:hello]) }
+    assert_raises(Minitest::Assertion) { assert_must(be_instance_of(Array), "hello") }
+  end
+end
+
+describe "#assert_wont" do
+  include InstanceOf
+
+  it "should be capable of passing" do
+    assert_equal false, assert_wont(be_instance_of(String), [:hello])
+    assert_equal false, assert_wont(be_instance_of(Array), "hello")
+  end
+
+  it "should be capable of failing" do
+    assert_raises(Minitest::Assertion) { assert_wont(be_instance_of(Array), [:hello]) }
+    assert_raises(Minitest::Assertion) { assert_wont(be_instance_of(String), "hello") }
+  end
+end
+
+describe "#must" do
+  include InstanceOf
+
+  describe "given a subject" do
+    subject { [:hello] }
+
+    it "should be capable of passing" do
+      assert_equal true, must(be_instance_of(Array))
+    end
+
+    it "should be capable of failing" do
+      assert_raises(Minitest::Assertion) { must be_instance_of String }
+    end
+  end
+
+  describe "given a @subject" do
+    before do
+      @subject = "hello"
+    end
+
+    it "should be capable of passing" do
+      assert_equal true, must(be_instance_of(String))
+    end
+
+    it "should be capable of failing" do
+      assert_raises(Minitest::Assertion) { must be_instance_of Array }
+    end
+  end
+
+  describe "without a subject" do
+    it "should error" do
+      assert_raises(NameError) { must be_instance_of Array }
+    end
+  end
+end
+
+describe "#wont" do
+  include InstanceOf
+
+  describe "given a subject" do
+    subject { [:hello] }
+
+    it "should be capable of passing" do
+      assert_equal false, wont(be_instance_of(String))
+    end
+
+    it "should be capable of failing" do
+      assert_raises(Minitest::Assertion) { wont be_instance_of Array }
+    end
+  end
+
+  describe "given a @subject" do
+    before do
+      @subject = "hello"
+    end
+
+    it "should be capable of passing" do
+      assert_equal false, wont(be_instance_of(Array))
+    end
+
+    it "should be capable of failing" do
+      assert_raises(Minitest::Assertion) { wont be_instance_of String }
+    end
+  end
+
+  describe "without a subject" do
+    it "should error" do
+      assert_raises(NameError) { wont be_instance_of Array }
+    end
+  end
+end

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: minitest-matchers_vaccine
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Ryan McGeary
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Adds matcher support to minitest without all the other RSpec-style expectation
+  "infections."
+email:
+- ryan@mcgeary.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/minitest/matchers_vaccine.rb
+- lib/minitest/matchers_vaccine/version.rb
+- test/matchers_test.rb
+homepage: https://github.com/rmm5t/minitest-matchers_vaccine
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Adds support for RSpec-style matchers to minitest.
+test_files:
+- test/matchers_test.rb