micron 0.5.0

data/lib/micron/test_case/lifecycle_hooks.rb

@@ -0,0 +1,74 @@
+
+module Micron
+  class TestCase
+    module LifecycleHooks
+      ##
+      # Runs before every test, after setup. This hook is meant for
+      # libraries to extend minitest. It is not meant to be used by
+      # test developers.
+      #
+      # See #before_setup for an example.
+
+      def after_setup
+      end
+
+      ##
+      # Runs before every test, before setup. This hook is meant for
+      # libraries to extend minitest. It is not meant to be used by
+      # test developers.
+      #
+      # As a simplistic example:
+      #
+      #   module MyMinitestPlugin
+      #     def before_setup
+      #       super
+      #       # ... stuff to do before setup is run
+      #     end
+      #
+      #     def after_setup
+      #       # ... stuff to do after setup is run
+      #       super
+      #     end
+      #
+      #     def before_teardown
+      #       super
+      #       # ... stuff to do before teardown is run
+      #     end
+      #
+      #     def after_teardown
+      #       # ... stuff to do after teardown is run
+      #       super
+      #     end
+      #   end
+      #
+      #   class MiniTest::Unit::TestCase
+      #     include MyMinitestPlugin
+      #   end
+
+      def before_setup
+      end
+
+      ##
+      # Runs after every test, before teardown. This hook is meant for
+      # libraries to extend minitest. It is not meant to be used by
+      # test developers.
+      #
+      # See #before_setup for an example.
+
+      def before_teardown
+      end
+
+      ##
+      # Runs after every test, after teardown. This hook is meant for
+      # libraries to extend minitest. It is not meant to be used by
+      # test developers.
+      #
+      # See #before_setup for an example.
+
+      def after_teardown
+      end
+
+    end # LifecycleHooks
+
+  end # TestCase
+end # Micron

data/lib/micron/test_case/redir_logging.rb

@@ -0,0 +1,85 @@
+
+require "logging"
+
+module Micron
+  class TestCase
+    module RedirLogging
+
+      # Send logging to stdout for duration of test
+      def before_setup
+        super
+        logger = self.class.redir_logger
+        return if logger.nil?
+
+        @_old_log_appenders = logger.appenders
+        @_old_log_additive  = logger.additive
+        @_old_log_level     = logger.level
+
+        logger.clear_appenders
+        logger.additive = false
+        logger.level    = :debug
+
+        # add original appenders which do not point to stdout, and our custom
+        # $stdout appender
+        logger.add_appenders(@_old_log_appenders.reject{ |a| a.kind_of? Logging::Appenders::Stdout })
+        logger.add_appenders("stdout_test")
+      end
+
+      # Restore appenders
+      def after_teardown
+        super
+        logger = self.class.redir_logger
+        return if logger.nil?
+        logger.clear_appenders
+        logger.add_appenders(@_old_log_appenders)
+        logger.additive = @_old_log_additive
+        logger.level    = @_old_log_level
+      end
+
+      def self.included(receiver)
+        receiver.extend(ClassMethods)
+      end
+
+      module ClassMethods
+        attr_writer :redir_logger
+
+        # Search up the TestCase hierarchy for a redir_logger
+        def redir_logger
+          return @redir_logger if !@redir_logger.nil?
+          return superclass.redir_logger if superclass.respond_to? :redir_logger
+          nil
+        end
+      end
+
+    end
+  end
+end
+
+# A simple subclass of the Stdout appender which writes to whatever
+# $stdout is currently pointing to
+module Logging::Appenders
+  class StdoutTest < Stdout
+    def canonical_write( str )
+      return self if @io.nil?
+      str = str.force_encoding(encoding) if encoding and str.encoding != encoding
+      # STDOUT.puts "writing log to $stdout: #{str}"
+      # STDOUT.puts "$stdout is currently #{$stdout.inspect}"
+      $stdout.syswrite str
+      self
+    rescue StandardError => err
+      self.level = :off
+      ::Logging.log_internal {"appender #{name.inspect} has been disabled"}
+      ::Logging.log_internal(-2) {err}
+    end
+  end
+end
+
+# Configure test appender
+Logging::Appenders::StdoutTest.new( 'stdout_test',
+  :auto_flushing => true,
+  :layout => Logging.layouts.pattern(
+    :pattern => '%.1l, [%d] %5l -- %c: %m\n',
+    :color_scheme => 'bright'
+  )
+)
+

data/lib/micron/test_case/teardown_coverage.rb

@@ -0,0 +1,13 @@
+
+module Micron
+  class TestCase
+
+    module TeardownCoverage
+      def before_teardown
+        super
+        EasyCov.checkpoint
+      end
+    end
+
+  end
+end

data/lib/micron/util/ex.rb

@@ -0,0 +1,23 @@
+
+module Micron
+  module Util
+    module Ex
+
+      # Utility method for converting Exceptions to Strings
+      #
+      # @param [Exception] ex
+      # @param [Boolean] include_backtrace
+      #
+      # @return [String]
+      def dump_ex(ex, include_backtrace=false)
+        name = ex.respond_to?(:name) ? ex.name : ex.class.to_s
+        s = "<#{name}> #{ex.message}"
+        if include_backtrace then
+          s += "\n  " + filter_backtrace(ex.backtrace).join("\n  ")
+        end
+        return s
+      end
+
+    end
+  end
+end

data/lib/micron/util/io.rb

@@ -0,0 +1,54 @@
+
+module Micron
+  module Util
+    module IO
+
+      # Captures $stdout and $stderr into strings:
+      #
+      #   out, err = capture_io do
+      #     puts "Some info"
+      #     warn "You did a bad thing"
+      #   end
+      #
+      #   assert_match %r%info%, out
+      #   assert_match %r%bad%, err
+      #
+      # NOTE: For efficiency, this method uses StringIO and does not
+      # capture IO for subprocesses. Use #capture_subprocess_io for
+      # that.
+      def capture_io
+        require 'stringio'
+
+        captured_stdout, captured_stderr = StringIO.new, StringIO.new
+
+        # synchronize do
+          orig_stdout, orig_stderr = $stdout, $stderr
+          $stdout, $stderr         = captured_stdout, captured_stderr
+
+          begin
+            yield
+          ensure
+            $stdout = orig_stdout
+            $stderr = orig_stderr
+          end
+
+        # end
+
+        return captured_stdout.string, captured_stderr.string
+      end
+
+      # Dispose of STDOUT/STDERR
+      #
+      # @param [Array<IO>] out
+      # @param [Array<IO>] err
+      def dispose_io(out, err)
+        STDOUT.reopen out.last
+        out.last.close
+        STDERR.reopen err.last
+        err.last.close
+        STDOUT.sync = STDERR.sync = true
+      end
+
+    end
+  end
+end

data/lib/micron/util/thread_dump.rb

@@ -0,0 +1,29 @@
+
+module Micron
+  module Util
+    module ThreadDump
+
+      # Setup thread dump signal
+      def trap_thread_dump
+        # print a thread dump on SIGALRM
+        # kill -ALRM <pid>
+        Signal.trap 'SIGALRM' do
+          File.open(File.join(ENV["MICRON_PATH"], "#{$$}.threads.txt"), "w+") do |f|
+            f.puts
+            f.puts "=== micron thread dump: #{Time.now} ==="
+            f.puts
+            Thread.list.each do |thread|
+              f.puts "Thread-#{thread.object_id}" + (thread[:name] ? ": " + thread[:name] : "")
+              f.puts thread.backtrace.join("\n    \\_ ")
+              f.puts "-"
+              f.puts
+            end
+            f.puts "=== end micron thread dump ==="
+            f.puts
+          end
+        end
+      end
+
+    end
+  end
+end

data/micron.gemspec

@@ -0,0 +1,97 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: micron 0.5.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "micron"
+  s.version = "0.5.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Chetan Sarva"]
+  s.date = "2013-10-14"
+  s.description = "An extremely minimal unit test library for Ruby"
+  s.email = "chetan@pixelcop.net"
+  s.executables = ["micron"]
+  s.files = [
+    "Gemfile",
+    "Gemfile.lock",
+    "Rakefile",
+    "VERSION",
+    "bin/micron",
+    "lib/micron.rb",
+    "lib/micron/app.rb",
+    "lib/micron/app/options.rb",
+    "lib/micron/assertion.rb",
+    "lib/micron/fork_runner.rb",
+    "lib/micron/minitest.rb",
+    "lib/micron/proc_runner.rb",
+    "lib/micron/rake.rb",
+    "lib/micron/reporter.rb",
+    "lib/micron/reporter/console.rb",
+    "lib/micron/reporter/coverage.rb",
+    "lib/micron/runner.rb",
+    "lib/micron/runner/backtrace_filter.rb",
+    "lib/micron/runner/clazz.rb",
+    "lib/micron/runner/clazz19.rb",
+    "lib/micron/runner/debug.rb",
+    "lib/micron/runner/exception_info.rb",
+    "lib/micron/runner/fork_worker.rb",
+    "lib/micron/runner/forking_clazz.rb",
+    "lib/micron/runner/liveness_checker.rb",
+    "lib/micron/runner/liveness_checker/ping.rb",
+    "lib/micron/runner/liveness_checker/pong.rb",
+    "lib/micron/runner/method.rb",
+    "lib/micron/runner/parallel_clazz.rb",
+    "lib/micron/runner/proc_clazz.rb",
+    "lib/micron/runner/process_reaper.rb",
+    "lib/micron/runner/shim.rb",
+    "lib/micron/runner/test_file.rb",
+    "lib/micron/test_case.rb",
+    "lib/micron/test_case/assertions.rb",
+    "lib/micron/test_case/lifecycle_hooks.rb",
+    "lib/micron/test_case/redir_logging.rb",
+    "lib/micron/test_case/teardown_coverage.rb",
+    "lib/micron/util/ex.rb",
+    "lib/micron/util/io.rb",
+    "lib/micron/util/thread_dump.rb",
+    "micron.gemspec"
+  ]
+  s.homepage = "http://github.com/chetan/micron"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "2.1.5"
+  s.summary = "Minimal unit tests for Ruby"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<easycov>, [">= 0"])
+      s.add_runtime_dependency(%q<hitimes>, [">= 0"])
+      s.add_runtime_dependency(%q<colorize>, [">= 0"])
+      s.add_development_dependency(%q<yard>, ["~> 0.8"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.1"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<minitest>, ["~> 4.0"])
+    else
+      s.add_dependency(%q<easycov>, [">= 0"])
+      s.add_dependency(%q<hitimes>, [">= 0"])
+      s.add_dependency(%q<colorize>, [">= 0"])
+      s.add_dependency(%q<yard>, ["~> 0.8"])
+      s.add_dependency(%q<bundler>, ["~> 1.1"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<minitest>, ["~> 4.0"])
+    end
+  else
+    s.add_dependency(%q<easycov>, [">= 0"])
+    s.add_dependency(%q<hitimes>, [">= 0"])
+    s.add_dependency(%q<colorize>, [">= 0"])
+    s.add_dependency(%q<yard>, ["~> 0.8"])
+    s.add_dependency(%q<bundler>, ["~> 1.1"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<minitest>, ["~> 4.0"])
+  end
+end
+

metadata

@@ -0,0 +1,184 @@
+--- !ruby/object:Gem::Specification
+name: micron
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Chetan Sarva
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: easycov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: hitimes
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  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'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: An extremely minimal unit test library for Ruby
+email: chetan@pixelcop.net
+executables:
+- micron
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- Rakefile
+- VERSION
+- bin/micron
+- lib/micron.rb
+- lib/micron/app.rb
+- lib/micron/app/options.rb
+- lib/micron/assertion.rb
+- lib/micron/fork_runner.rb
+- lib/micron/minitest.rb
+- lib/micron/proc_runner.rb
+- lib/micron/rake.rb
+- lib/micron/reporter.rb
+- lib/micron/reporter/console.rb
+- lib/micron/reporter/coverage.rb
+- lib/micron/runner.rb
+- lib/micron/runner/backtrace_filter.rb
+- lib/micron/runner/clazz.rb
+- lib/micron/runner/clazz19.rb
+- lib/micron/runner/debug.rb
+- lib/micron/runner/exception_info.rb
+- lib/micron/runner/fork_worker.rb
+- lib/micron/runner/forking_clazz.rb
+- lib/micron/runner/liveness_checker.rb
+- lib/micron/runner/liveness_checker/ping.rb
+- lib/micron/runner/liveness_checker/pong.rb
+- lib/micron/runner/method.rb
+- lib/micron/runner/parallel_clazz.rb
+- lib/micron/runner/proc_clazz.rb
+- lib/micron/runner/process_reaper.rb
+- lib/micron/runner/shim.rb
+- lib/micron/runner/test_file.rb
+- lib/micron/test_case.rb
+- lib/micron/test_case/assertions.rb
+- lib/micron/test_case/lifecycle_hooks.rb
+- lib/micron/test_case/redir_logging.rb
+- lib/micron/test_case/teardown_coverage.rb
+- lib/micron/util/ex.rb
+- lib/micron/util/io.rb
+- lib/micron/util/thread_dump.rb
+- micron.gemspec
+homepage: http://github.com/chetan/micron
+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.1.5
+signing_key: 
+specification_version: 4
+summary: Minimal unit tests for Ruby
+test_files: []