minitest-stately 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8a4c3d450336f7408db315d24711c8fef8817c1e
+  data.tar.gz: 650c0031d535b36c429ba5988406ce07e3a36306
+SHA512:
+  metadata.gz: 37b34454ad059078bd7215b2ac23e651dc9617e3962effc15daa091412e4f16d3b924844ce597ba75379676fa8b71a99edc82b09d55c54581f6e45024e7df282
+  data.tar.gz: 09bb894ba6d9350194625a86090987979f1a5d6946a6262e28f6f7c9377ab2a47e97d9fdde2076ef32c65ac4a62b585f5a8c204c22b9a6c106db4706d525ff81

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 2.1.2
+  - 2.0.0
+  - 1.9.3
+  - jruby-19mode
+  - jruby-head
+  - rbx-2.2.7

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in minitest-stately.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Jason R. Clark
+
+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,65 @@
+# Minitest::Stately
+[![Gem Version](https://badge.fury.io/rb/minitest-stately.png)](http://badge.fury.io/rb/minitest-stately)
+[![Build Status](https://api.travis-ci.org/jasonrclark/minitest-stately.png)](https://travis-ci.org/jasonrclark/minitest-stately)
+[![Code Climate](https://codeclimate.com/github/jasonrclark/minitest-stately.png)](https://codeclimate.com/github/jasonrclark/hometown)
+[![Coverage Status](https://coveralls.io/repos/jasonrclark/minitest-stately/badge.png)](https://coveralls.io/r/jasonrclark/hometown)
+
+Find leaking state between tests
+
+## Requirements
+Minitest 5.x is required for Minitest::Stately to work properly.
+
+Tests are run against MRI 1.9.3 through 2.1.2, JRuby 1.7 (latest) and head, and
+Rubinius 2.x (latest).
+
+Ruby 1.8.7 and REE are not supported. Sorry retro-Ruby fans!
+
+## Installation
+
+    $ gem install minitest-stately
+
+## Usage
+
+### Minitest::Stately.watch
+Early in your test run (typically from `test_helper.rb`), call to set up the
+conditions to watch for changes in. The condition block is run immediately to
+set a default value, and then run and compared after each test executes to look
+for changes.
+
+```
+# Watch for freshly started threads
+Minitest::Stately.watch("condition name") do
+  Thread.list.count
+end
+```
+
+If there are changes during the test run for a condition, you'll see output
+like the following:
+
+```
+******************************
+Minitest::Stately Changes!!!
+******************************
+Minitest::StatelyPluginTest#test_again: $boo changed from '0' to '1'
+Minitest::StatelyPluginTest#test_defined: $boo changed from '1' to '2'
+```
+
+
+### Minitest::Stately.run
+Minitest::Stately can also register `run` blocks to be executed after each
+test. This can be useful for clearing out leaked state between all tests in a
+suite.
+
+```
+Minitest::Stately.run do
+  $silly_global_state = nil
+end
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/minitest-stately/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

data/Rakefile

@@ -0,0 +1,12 @@
+require "bundler/gem_tasks"
+
+require 'rake/testtask'
+
+task :default => :test
+
+Rake::TestTask.new do |test|
+  test.verbose = true
+  test.libs << "test"
+  test.libs << "lib"
+  test.test_files = FileList['test/**/*_test.rb']
+end

data/lib/minitest/stately/reporter.rb

@@ -0,0 +1,17 @@
+module Minitest
+  module Stately
+    class Reporter < Minitest::Reporter
+      def initialize(options={})
+        super(options.delete(:io) || $stdout, options)
+      end
+
+      def record(result)
+        Minitest::Stately.watcher.record(result)
+      end
+
+      def report
+        io.puts(Minitest::Stately.watcher.report)
+      end
+    end
+  end
+end

data/lib/minitest/stately/version.rb

@@ -0,0 +1,5 @@
+module Minitest
+  module Stately
+    VERSION = "0.1.0"
+  end
+end

data/lib/minitest/stately/watcher.rb

@@ -0,0 +1,64 @@
+module Minitest
+  module Stately
+    class Watcher
+      def initialize
+        @watch   = {}
+        @run     = []
+
+        @results = {}
+        @report  = []
+      end
+
+      def watch(name, &blk)
+        @watch[name]  = blk
+        @results[blk] = blk.call
+      end
+
+      def run(&blk)
+        @run << blk
+      end
+
+      def record(result)
+        record_changes(result)
+        run_blocks()
+      end
+
+      def record_changes(result)
+        @watch.each do |name, blk|
+          value = blk.call
+          if value_changed?(blk, value)
+            @report << message(result, name, blk, value)
+          end
+          @results[blk] = value
+        end
+      end
+
+      def run_blocks()
+        @run.each do |blk|
+          blk.call
+        end
+      end
+
+      def value_changed?(blk, value)
+        @results[blk] != value
+      end
+
+      def message(result, name, blk, value)
+        "#{result.class.name}\##{result.name}: #{name} changed from '#{@results[blk]}' to '#{value}'"
+      end
+
+      HEADER = <<-EOS
+
+******************************
+Minitest::Stately Changes!!!
+******************************
+EOS
+
+      def report
+        return "" if @report.empty?
+
+        HEADER + @report.join("\n") + "\n\n"
+      end
+    end
+  end
+end

data/lib/minitest/stately_plugin.rb

@@ -0,0 +1,24 @@
+require 'minitest/stately/reporter'
+require 'minitest/stately/watcher'
+
+module Minitest
+  module Stately
+    @watcher = Watcher.new
+
+    def self.watcher
+      @watcher
+    end
+
+    def self.watch(name, &blk)
+      @watcher.watch(name, &blk)
+    end
+
+    def self.run(&blk)
+      @watcher.run(&blk)
+    end
+  end
+
+  def self.plugin_stately_init(options)
+    self.reporter.reporters << Minitest::Stately::Reporter.new
+  end
+end

data/minitest-stately.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'minitest/stately/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "minitest-stately"
+  spec.version       = Minitest::Stately::VERSION
+  spec.authors       = ["Jason R. Clark"]
+  spec.email         = ["jason@jasonrclark.net"]
+  spec.summary       = %q{Find leaking state between tests}
+  spec.description   = %q{Find and clear leaking state between individual test executions}
+  spec.homepage      = "http://github.com/jasonrclark/minitest-stately"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency 'minitest', '~> 5.0', '>= 5.0.0'
+
+  spec.add_development_dependency "bundler",   "~> 1.6"
+  spec.add_development_dependency "rake",      "~> 10.2"
+  spec.add_development_dependency "coveralls", "~> 0.7"
+end

data/test/minitest/stately/watcher_test.rb

@@ -0,0 +1,65 @@
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "test_helper"))
+require 'minitest/stately/watcher'
+
+module Minitest
+  module Stately
+    class WatcherTest < Minitest::Test
+      def setup
+        @watcher = Watcher.new
+      end
+
+      def test_watcher_no_change
+        @boo = 1
+        @watcher.watch("@boo") do
+          @boo
+        end
+
+        @watcher.record(self)
+        assert_empty @watcher.report
+      end
+
+      def test_watcher_change_from_initial_default
+        @boo = 1
+        @watcher.watch("@boo") do
+          @boo
+        end
+
+        @boo += 1
+        @watcher.record(self)
+
+        assert_changes(name, 1, 2)
+      end
+
+      def test_multiple_changes
+        @boo = 1
+        @watcher.watch("@boo") do
+          @boo
+        end
+
+        @boo += 1
+        @watcher.record(self)
+
+        @boo += 1
+        @watcher.record(self)
+
+        assert_changes(name, 1, 2)
+        assert_changes(name, 2, 3)
+      end
+
+      def test_run
+        @boo = 1
+        @watcher.run do
+          @boo = nil
+        end
+
+        @watcher.record(self)
+        assert_nil @boo
+      end
+
+      def assert_changes(name, old, new)
+        assert_includes @watcher.report, name
+        assert_includes @watcher.report, "'#{old}' to '#{new}'"
+      end
+    end
+  end
+end

data/test/minitest/stately_plugin_test.rb

@@ -0,0 +1,25 @@
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "test_helper"))
+require 'minitest/stately_plugin'
+
+$boo = 0
+Minitest::Stately.watch("$boo") do
+  $boo
+end
+
+Minitest::Stately.run do
+  $clear_me = nil
+end
+
+class Minitest::StatelyPluginTest < Minitest::Test
+  def test_defined
+    assert_nil $clear_me
+    $boo += 1
+    $clear_me = true
+  end
+
+  def test_again
+    assert_nil $clear_me
+    $boo += 1
+    $clear_me = true
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,7 @@
+if ENV["CI"]
+  require 'coveralls'
+  Coveralls.wear!
+end
+
+gem 'minitest'
+require 'minitest/autorun'

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification
+name: minitest-stately
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jason R. Clark
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-12 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'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.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: '10.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.2'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+description: Find and clear leaking state between individual test executions
+email:
+- jason@jasonrclark.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/minitest/stately/reporter.rb
+- lib/minitest/stately/version.rb
+- lib/minitest/stately/watcher.rb
+- lib/minitest/stately_plugin.rb
+- minitest-stately.gemspec
+- test/minitest/stately/watcher_test.rb
+- test/minitest/stately_plugin_test.rb
+- test/test_helper.rb
+homepage: http://github.com/jasonrclark/minitest-stately
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+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: Find leaking state between tests
+test_files:
+- test/minitest/stately/watcher_test.rb
+- test/minitest/stately_plugin_test.rb
+- test/test_helper.rb
+has_rdoc: