mspec 1.0.0

data/lib/mspec/guards/extensions.rb

@@ -0,0 +1,12 @@
+require 'mspec/guards/guard'
+
+class ExtensionsGuard < SpecGuard
+end
+
+class Object
+  def extended_on(*args)
+    g = ExtensionsGuard.new(*args)
+    yield if g.yield?
+    g.unregister
+  end
+end

data/lib/mspec/guards/guard.rb

@@ -0,0 +1,120 @@
+require 'mspec/runner/mspec'
+require 'mspec/runner/actions/tally'
+
+unless defined?(RUBY_NAME) and RUBY_NAME
+  if defined?(RUBY_ENGINE) and RUBY_ENGINE
+    RUBY_NAME = RUBY_ENGINE
+    if defined?(ARG0)
+      RUBY_CLI = /rubinius|rbx/.match(ARG0) ? "shotgun/rubinius" : ARG0
+    else
+      RUBY_CLI = RUBY_NAME
+    end
+  else
+    require 'rbconfig'
+    RUBY_NAME = Config::CONFIG["RUBY_INSTALL_NAME"] || Config::CONFIG["ruby_install_name"]
+    RUBY_CLI  = RUBY_NAME
+  end
+end
+
+class SpecGuard
+  def self.register
+    unless @registered
+      @tally = TallyAction.new
+      @tally.register
+      MSpec.register :finish, self
+      @registered = true
+    end
+  end
+
+  def self.unregister
+    @tally.unregister if @tally
+  end
+
+  def self.finish
+    print "\n#{self.class}\n#{@tally.format}\n"
+  end
+
+  def initialize(*args)
+    @args = args
+  end
+
+  def yield?(invert=false)
+    if MSpec.report_mode?
+      self.class.register
+      MSpec.register :before, self
+      return true
+    elsif MSpec.verify_mode?
+      self.class.register
+      MSpec.register :after, self
+      return true
+    end
+    return match? ^ invert
+  end
+
+  def ===(other)
+    true
+  end
+
+  def before(state)
+  end
+
+  def after(state)
+  end
+
+  def unregister
+    MSpec.unregister :before, self
+    MSpec.unregister :after, self
+    MSpec.unregister :exclude, self
+    self.class.unregister
+  end
+
+  def implementation?(*args)
+    args.any? do |name|
+      !!case name
+      when :rbx, :rubinius
+        RUBY_NAME =~ /^rbx/
+      when :ruby
+        RUBY_NAME =~ /^ruby/
+      when :ruby18
+        RUBY_NAME =~ /^ruby(1.8)?/ and RUBY_VERSION =~ /^1.8/
+      when :ruby19
+        RUBY_NAME =~ /^ruby(1.9)?/ and RUBY_VERSION =~ /^1.9/
+      when :jruby
+        RUBY_NAME =~ /^jruby/
+      else
+        false
+      end
+    end
+  end
+
+  def windows?(sym, key)
+    sym == :windows && !!key.match(/(mswin|mingw)/)
+  end
+
+  def platform?(*args)
+    args.any? do |platform|
+      if platform != :java && RUBY_PLATFORM.match('java') && os?(platform)
+        true
+      else
+        RUBY_PLATFORM.match(platform.to_s) || windows?(platform, RUBY_PLATFORM)
+      end
+    end
+  end
+
+  def wordsize?(size)
+    size == 8 * 1.size
+  end
+
+  def os?(*oses)
+    require 'rbconfig'
+    oses.any? do |os|
+      host_os = Config::CONFIG['host_os'] || RUBY_PLATFORM
+      host_os.downcase!
+      host_os.match(os.to_s) || windows?(os, host_os)
+    end
+  end
+
+  def match?
+    implementation?(*@args) or platform?(*@args)
+  end
+end

data/lib/mspec/guards/noncompliance.rb

@@ -0,0 +1,12 @@
+require 'mspec/guards/guard'
+
+class NonComplianceGuard < SpecGuard
+end
+
+class Object
+  def deviates_on(*args)
+    g = NonComplianceGuard.new(*args)
+    yield if g.yield?
+    g.unregister
+  end
+end

data/lib/mspec/guards/platform.rb

@@ -0,0 +1,38 @@
+require 'mspec/guards/guard'
+
+class PlatformGuard < SpecGuard
+  def initialize(*args)
+    if args.last.is_a?(Hash)
+      @options, @platforms = args.last, args[0..-2]
+    else
+      @options, @platforms = {}, args
+    end
+  end
+
+  def match?
+    match = @platforms.empty? ? true : platform?(*@platforms)
+    @options.each do |key, value|
+      case key
+      when :os
+        match &&= os?(*value)
+      when :wordsize
+        match &&= wordsize? value
+      end
+    end
+    match
+  end
+end
+
+class Object
+  def platform_is(*args)
+    g = PlatformGuard.new(*args)
+    yield if g.yield?
+    g.unregister
+  end
+
+  def platform_is_not(*args)
+    g = PlatformGuard.new(*args)
+    yield if g.yield? true
+    g.unregister
+  end
+end

data/lib/mspec/guards/quarantine.rb

@@ -0,0 +1,15 @@
+require 'mspec/guards/guard'
+
+class QuarantineGuard < SpecGuard
+  def match?
+    false
+  end
+end
+
+class Object
+  def quarantine!
+    g = QuarantineGuard.new
+    yield if g.yield?
+    g.unregister
+  end
+end

data/lib/mspec/guards/runner.rb

@@ -0,0 +1,30 @@
+require 'mspec/guards/guard'
+
+class RunnerGuard < SpecGuard
+  def match?
+    @args.any? do |runner|
+      case runner
+      when :mspec
+        ENV['MSPEC_RUNNER'] == '1'
+      when :rspec
+        ENV['RSPEC_RUNNER'] == '1' or Object.const_defined?(:Spec)
+      else
+        false
+      end
+    end
+  end
+end
+
+class Object
+  def runner_is(*args)
+    g = RunnerGuard.new(*args)
+    yield if g.yield?
+    g.unregister
+  end
+
+  def runner_is_not(*args)
+    g = RunnerGuard.new(*args)
+    yield if g.yield? true
+    g.unregister
+  end
+end

data/lib/mspec/guards/superuser.rb

@@ -0,0 +1,15 @@
+require 'mspec/guards/guard'
+
+class SuperUserGuard < SpecGuard
+  def match?
+    Process.euid == 0
+  end
+end
+
+class Object
+  def as_superuser
+    g = SuperUserGuard.new
+    yield if g.yield?
+    g.unregister
+  end
+end

data/lib/mspec/guards/support.rb

@@ -0,0 +1,12 @@
+require 'mspec/guards/guard'
+
+class SupportedGuard < SpecGuard
+end
+
+class Object
+  def not_supported_on(*args)
+    g = SupportedGuard.new(*args)
+    yield if g.yield? true
+    g.unregister
+  end
+end

data/lib/mspec/guards/version.rb

@@ -0,0 +1,40 @@
+require 'mspec/guards/guard'
+
+class VersionGuard < SpecGuard
+  def initialize(version)
+    case version
+    when String
+      @version = to_v version
+    when Range
+      a = to_v version.first
+      b = to_v version.last
+      @version = version.exclude_end? ? a...b : a..b
+    end
+  end
+
+  def to_v(str)
+    major, minor, tiny, patch = str.split "."
+    ("1%02d%02d%02d%04d" % [major, minor, tiny, patch].map { |x| x.to_i }).to_i
+  end
+
+  def ruby_version
+    to_v("#{RUBY_VERSION}.#{RUBY_PATCHLEVEL}")
+  end
+
+  def match?
+    case @version
+    when Integer
+      ruby_version >= @version
+    when Range
+      @version.include? ruby_version
+    end
+  end
+end
+
+class Object
+  def ruby_version_is(*args)
+    g = VersionGuard.new(*args)
+    yield if g.yield?
+    g.unregister
+  end
+end

data/lib/mspec/helpers.rb

@@ -0,0 +1,6 @@
+require 'mspec/helpers/bignum'
+require 'mspec/helpers/flunk'
+require 'mspec/helpers/io'
+require 'mspec/helpers/scratch'
+require 'mspec/helpers/tmp'
+require 'mspec/helpers/const_lookup'

data/lib/mspec/helpers/bignum.rb

@@ -0,0 +1,5 @@
+class Object
+  def bignum_value(plus=0)
+    0x8000_0000_0000_0000 + plus
+  end
+end

data/lib/mspec/helpers/const_lookup.rb

@@ -0,0 +1,5 @@
+module Kernel
+  def const_lookup(c)
+    c.split('::').inject(Object) { |k,n| k.const_get n }
+  end
+end

data/lib/mspec/helpers/flunk.rb

@@ -0,0 +1,5 @@
+class Object
+  def flunk
+    Expectation.fail_with "This example", "is a failure"
+  end
+end

data/lib/mspec/helpers/io.rb

@@ -0,0 +1,13 @@
+class IOStub < String
+  def write(*str)
+    self << str.to_s
+  end
+
+  def print(*str)
+    write(str.to_s + $\.to_s)
+  end
+
+  def puts(*str)
+    write(str.collect { |s| s.to_s.chomp }.concat([nil]).join("\n"))
+  end
+end

data/lib/mspec/helpers/scratch.rb

@@ -0,0 +1,17 @@
+module ScratchPad
+  def self.clear
+    @record = nil
+  end
+
+  def self.record(arg)
+    @record = arg
+  end
+
+  def self.<<(arg)
+    @record << arg
+  end
+
+  def self.recorded
+    @record
+  end
+end

data/lib/mspec/helpers/tmp.rb

@@ -0,0 +1,32 @@
+# The #tmp method provides a similar functionality
+# to that of Dir.tmpdir. This helper can be overridden
+# by different implementations to provide a more useful
+# behavior if needed.
+#
+# Usage in a spec:
+#
+#   File.open(tmp("tags.txt"), "w") { |f| f.puts "" }
+#
+# The order of directories below with "/private/tmp"
+# preceding "/tmp" is significant. On OS X, the directory
+# "/tmp" is a symlink to "private/tmp" with no leading
+# "/". Rather than futzing with what constitutes an
+# absolute path, we just look for "/private/tmp" first.
+
+class Object
+  def tmp(name)
+    unless @spec_temp_directory
+      [ "/private/tmp", "/tmp", "/var/tmp", ENV["TMPDIR"], ENV["TMP"],
+        ENV["TEMP"], ENV["USERPROFILE"] ].each do |dir|
+        if dir and File.directory?(dir) and File.writable?(dir)
+          temp = File.expand_path dir
+          temp = File.readlink temp if File.symlink? temp
+          @spec_temp_directory = temp
+          break
+        end
+      end
+    end
+
+    File.join @spec_temp_directory, name
+  end
+end

data/lib/mspec/matchers.rb

@@ -0,0 +1,16 @@
+require 'mspec/matchers/base'
+require 'mspec/matchers/be_ancestor_of'
+require 'mspec/matchers/be_close'
+require 'mspec/matchers/be_empty'
+require 'mspec/matchers/be_false'
+require 'mspec/matchers/be_kind_of'
+require 'mspec/matchers/be_nil'
+require 'mspec/matchers/be_true'
+require 'mspec/matchers/equal'
+require 'mspec/matchers/eql'
+require 'mspec/matchers/include'
+require 'mspec/matchers/raise_error'
+require 'mspec/matchers/output'
+require 'mspec/matchers/output_to_fd'
+require 'mspec/matchers/complain'
+require 'mspec/matchers/equal_utf16'

data/lib/mspec/matchers/base.rb

@@ -0,0 +1,95 @@
+class PositiveOperatorMatcher
+  def initialize(actual)
+    @actual = actual
+  end
+
+  def ==(expected)
+    unless @actual == expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "to equal #{expected.pretty_inspect}")
+    end
+  end
+
+  def <(expected)
+    unless @actual < expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "to be less than #{expected.pretty_inspect}")
+    end
+  end
+
+  def <=(expected)
+    unless @actual <= expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "to be less than or equal to #{expected.pretty_inspect}")
+    end
+  end
+
+  def >(expected)
+    unless @actual > expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "to be greater than #{expected.pretty_inspect}")
+    end
+  end
+
+  def >=(expected)
+    unless @actual >= expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "to be greater than or equal to #{expected.pretty_inspect}")
+    end
+  end
+
+  def =~(expected)
+    unless @actual =~ expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "to match #{expected.pretty_inspect}")
+    end
+  end
+end
+
+class NegativeOperatorMatcher
+  def initialize(actual)
+    @actual = actual
+  end
+
+  def ==(expected)
+    if @actual == expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "not to equal #{expected.pretty_inspect}")
+    end
+  end
+
+  def <(expected)
+    if @actual < expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "not to be less than #{expected.pretty_inspect}")
+    end
+  end
+
+  def <=(expected)
+    if @actual <= expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "not to be less than or equal to #{expected.pretty_inspect}")
+    end
+  end
+
+  def >(expected)
+    if @actual > expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "not to be greater than #{expected.pretty_inspect}")
+    end
+  end
+
+  def >=(expected)
+    if @actual >= expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "not to be greater than or equal to #{expected.pretty_inspect}")
+    end
+  end
+
+  def =~(expected)
+    if @actual =~ expected
+      Expectation.fail_with("Expected #{@actual.pretty_inspect}",
+                            "not to match #{expected.pretty_inspect}")
+    end
+  end
+end