mischacks 0.0.6

data/COPYING

@@ -0,0 +1,13 @@
+Copyright © 2009 Johan Kiviniemi
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/History.txt

@@ -0,0 +1,25 @@
+=== UNRELEASED / UNRELEASED
+
+* Update README.
+* Test best_datasync more thoroughly.
+
+=== 0.0.5 / 2009-06-28
+
+* Implement IO#best_datasync, have overwrite use it.
+
+=== 0.0.4 / 2009-06-28
+
+* Implement overwrite, a method to safely replace a file.
+* Update README.
+* Move exception printing from sh to catching_exit.
+
+=== 0.0.3 / 2009-06-28
+
+* Rename checking_exit_status as fork_and_check to make it clear it forks.
+* Add catching_exit, which is now used by the do_and_exit methods.
+* Pass a fallthrough exit status to do_and_exit.
+
+=== 0.0.2 / 2009-06-28
+
+* Initial release
+

data/Manifest.txt

@@ -0,0 +1,9 @@
+COPYING
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/mischacks.rb
+mischacks.gemspec
+spec/mischacks_spec.rb
+spec/spec_helper.rb

data/README.txt

@@ -0,0 +1,119 @@
+= MiscHacks
+
+* http://johan.kiviniemi.name/software/mischacks/
+
+== DESCRIPTION:
+
+Miscellaneous methods that may or may not be useful.
+
+sh:: Safely pass untrusted parameters to sh scripts.
+
+fork_and_check:: Run a block in a forked process and raise an exception if the
+process returns a non-zero value.
+
+do_and_exit, do_and_exit!:: Run a block. If the block does not run exit!, a
+successful exec or equivalent, run exit(1) or exit!(1) ourselves. Useful to
+make sure a forked block either runs a successful exec or dies.
+
+Any exceptions from the block are printed to standard error.
+
+overwrite:: Safely replace a file. Writes to a temporary file and then moves it
+over the old file.
+
+tempname_for:: Generates an unique temporary path based on a filename. The
+generated filename resides in the same directory as the original one.
+
+try_n_times:: Retries a block of code until it succeeds or a maximum number of
+attempts (default 10) is exceeded.
+
+Exception#to_formatted_string:: Returns a string that looks like how Ruby would
+dump an uncaught exception.
+
+IO#best_datasync:: Tries fdatasync, falling back to fsync, falling back to
+flush.
+
+== FEATURES/PROBLEMS:
+
+The sh method is only safe if your sh script is safe. If unsure, add double
+quotation marks around all variable references ("$1", "$foo", "$@"), and never,
+ever use an untrusted variable as a command.
+
+== SYNOPSIS:
+
+  # sh
+
+  MiscHacks.sh %q{
+    diff -u "$1" "$2" | tr a-z A-Z >"$output"
+  }, '/dev/null', '/etc/motd', :output => 'foo'
+
+  unsafe_str = %q{" 'foo' $(bar) `baz` "}
+  MiscHacks.sh 'printf "%s\n" "$1"', unsafe_str
+
+  # fork_and_check
+
+  # These examples raise MiscHacks::ChildError.
+  MiscHacks.fork_and_check do exit! 42 end
+  MiscHacks.fork_and_check do exec 'sh', '-c', 'exit 42' end
+  MiscHacks.fork_and_check do exec 'failure' end
+
+  # Does not raise an error.
+  MiscHacks.fork_and_check do exit! 0 end
+
+  # do_and_exit
+
+  # Prints foo if there are no failures. If anything fails, raises an
+  # exception.
+  MiscHacks.fork_and_check do
+    MiscHacks.do_and_exit! do
+      exec 'sh', '-c', 'echo foo'
+    end
+  end
+
+  # overwrite
+
+  MiscHacks.overwrite 'myconfig' do |io|
+    io << config.to_yaml
+  end
+
+  # tempname_for
+
+  MiscHacks.tempname_for '/foo/bar/baz'  # => '/foo/bar/.baz.klyce3f517qkh9l'
+
+  # try_n_times
+
+  io = MiscHacks.try_n_times do
+    File.open path, File::RDWR|File::CREAT|File::EXCL
+  end
+
+  # Exception#to_formatted_string
+
+  begin
+    # Do something
+  rescue => e
+    warn e.to_formatted_string
+  end
+
+== REQUIREMENTS:
+
+* POSIX sh
+* A system that implements fork
+
+== INSTALL:
+
+* sudo gem install ion1-mischacks --source http://gems.github.com/
+
+== LICENSE:
+
+Copyright © 2009 Johan Kiviniemi
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/Rakefile

@@ -0,0 +1,43 @@
+# mischacks – Miscellaneous methods that may or may not be useful
+# Copyright © 2009 Johan Kiviniemi
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__)+'/lib')
+
+require 'rubygems'
+
+require 'rake'
+require 'rake/clean'
+
+task :default => :spec
+
+begin
+  require 'jeweler'
+
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "mischacks"
+    gemspec.summary = "Miscellaneous methods that may or may not be useful"
+    gemspec.description = "sh: Safely pass untrusted parameters to sh scripts.  overwrite: Safely replace a file.  Exception#to_formatted_string: Return a string that looks like how Ruby would dump an uncaught exception."
+    gemspec.email = "devel@johan.kiviniemi.name"
+    gemspec.homepage = "http://johan.kiviniemi.name/software/mischacks/"
+    gemspec.authors = ["Johan Kiviniemi"]
+  end
+
+  Jeweler::GemcutterTasks.new
+
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end
+
+# vim:set et sw=2 sts=2:

data/VERSION

@@ -0,0 +1 @@
+0.0.6

data/lib/mischacks.rb

@@ -0,0 +1,175 @@
+# mischacks – Miscellaneous methods that may or may not be useful
+# Copyright © 2009 Johan Kiviniemi
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+module MiscHacks
+  VERSION = '0.0.5'
+
+  class ChildError < RuntimeError
+    attr_reader :status
+
+    def initialize status
+      @status = Integer status
+      super "Child failed with status #{status}"
+    end
+  end
+
+  def self.sh cmd, *args
+    env = if args.last.is_a? Hash then args.pop else {} end
+
+    fork_and_check do
+      do_and_exit! do
+        env.each_pair do |k, v| ENV[k.to_s] = v.to_s end
+        exec *(%W{sh -e -c #{cmd} sh} + args.map {|a| a.to_s })
+      end
+    end
+
+    nil
+  end
+
+  def self.fork_and_check
+    fork do
+      yield
+    end.tap do |pid|
+      _, status = Process.wait2 pid
+      raise ChildError, status.exitstatus if status.exitstatus != 0
+    end
+
+    nil
+  end
+
+  def self.catching_exit final_proc, fallthrough_status
+    status = fallthrough_status
+
+    begin
+      yield
+    rescue SystemExit => e
+      status = e.status
+    rescue Exception => e
+      warn e.to_formatted_string
+    ensure
+      final_proc.call status
+    end
+
+    status
+  end
+
+  def self.do_and_exit status=1, &block
+    catching_exit method(:exit), status, &block
+  end
+
+  def self.do_and_exit! status=1, &block
+    catching_exit method(:exit!), status, &block
+  end
+
+  def self.overwrite path, mode=nil
+    begin
+      stat = File.stat path
+
+      raise ArgumentError, "Not a file: #{path}",   caller unless stat.file?
+      raise ArgumentError, "Not writable: #{path}", caller unless stat.writable?
+
+      mode ||= stat.mode & 0777
+    rescue Errno::ENOENT
+      stat = nil
+    end
+
+    temppath, io = try_n_times do
+      t  = tempname_for path
+      io = File.open t, File::RDWR|File::CREAT|File::EXCL
+      [t, io]
+    end
+
+    begin
+      ret = yield io
+
+      io.best_datasync
+
+      File.chmod mode, temppath if mode
+
+      File.rename temppath, path
+
+    rescue
+      File.unlink temppath
+      raise
+
+    ensure
+      io.close
+    end
+
+    ret
+  end
+
+  def self.tempname_for path
+    dirname  = File.dirname  path
+    basename = File.basename path
+
+    '%s/.%s.%s%s%s' % [
+      dirname,
+      basename,
+      Time.now.to_i.to_s(36),
+      $$.to_s(36),
+      rand(1<<32).to_s(36)
+    ]
+  end
+
+  def self.try_n_times n=10
+    i = 0
+    begin
+      yield
+    rescue
+      i += 1
+      retry if i < n
+      raise
+    end
+  end
+end
+
+module MiscHacks
+  module ExceptionMixin
+    def to_formatted_string
+      bt   = backtrace.dup
+      head = bt.shift
+      (
+        ["#{head}: #{self} (#{self.class})"] +
+        bt.map do |l| "\tfrom #{l}" end
+      ).map do |l| "#{l}\n" end.join
+    end
+  end
+end
+
+Exception.class_eval do
+  include MiscHacks::ExceptionMixin
+end
+
+module MiscHacks
+  module IOMixin
+    def best_datasync
+      meths = [:fdatasync, :fsync, :flush]
+
+      begin
+        send meths.shift
+      rescue NoMethodError, NotImplementedError
+        retry unless meths.empty?
+        raise
+      end
+    end
+  end
+end
+
+IO.class_eval do
+  include MiscHacks::IOMixin
+end
+
+# vim:set et sw=2 sts=2:

data/spec/mischacks_spec.rb

@@ -0,0 +1,393 @@
+# mischacks – Miscellaneous methods that may or may not be useful
+# Copyright © 2009 Johan Kiviniemi
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+require File.expand_path(File.dirname(__FILE__)+'/spec_helper.rb')
+require 'mischacks'
+
+require 'digest/sha1'
+require 'fileutils'
+require 'set'
+require 'tmpdir'
+
+mh = MiscHacks
+ce = MiscHacks::ChildError
+
+describe mh do
+  describe 'sh' do
+    unsafe_str = %q{" 'foo' $(bar) `baz` "}
+    checksum   = Digest::SHA1.hexdigest unsafe_str
+
+    it "should raise #{ce} on error" do
+      good = ['true', '', 'printf ""']
+      bad  = ['false', 'exit 2', 'return 2']
+
+      bad.each do |c|
+        lambda do mh.sh c end.should raise_error ce
+      end
+
+      good.each do |c|
+        lambda do mh.sh c end.should_not raise_error
+      end
+    end
+
+    it 'should call sh with -e' do
+      lambda do mh.sh 'false; true' end.should raise_error ce
+    end
+
+    it 'should pass normal parameters safely' do
+      test = lambda do |str, sha|
+        mh.sh %q{
+          temp="$(mktemp -t mischacks.XXXXXXXXXX)"
+          trap 'rm -f "$temp"' 0 1 2 13 15
+          printf "%s" "$1" >"$temp"
+          printf "%s *%s\n" "$2" "$temp" | sha1sum -c >/dev/null 2>&1
+        }, str, sha
+      end
+
+      lambda do test.call unsafe_str, checksum end.should_not raise_error
+      lambda do test.call 'foo',      checksum end.should raise_error ce
+    end
+
+    it 'should pass environment variables safely' do
+      test = lambda do |str, sha|
+        mh.sh %q{
+          temp="$(mktemp -t mischacks.XXXXXXXXXX)"
+          trap 'rm -f "$temp"' 0 1 2 13 15
+          printf "%s" "$string" >"$temp"
+          printf "%s *%s\n" "$checksum" "$temp" | sha1sum -c >/dev/null 2>&1
+        }, :string => str, :checksum => sha
+      end
+
+      lambda do test.call unsafe_str, checksum end.should_not raise_error
+      lambda do test.call 'foo',      checksum end.should raise_error ce
+    end
+  end
+
+  describe 'fork_and_check' do
+    it 'should raise an error when child fails' do
+      lambda do mh.fork_and_check do exit  1 end end.should raise_error ce
+      lambda do mh.fork_and_check do exit! 1 end end.should raise_error ce
+
+      lambda do mh.fork_and_check do exit  0 end end.should_not raise_error
+      lambda do mh.fork_and_check do exit! 0 end end.should_not raise_error
+    end
+
+    it 'should handle exec' do
+      lambda do mh.fork_and_check do exec 'false' end end.should raise_error ce
+      lambda do mh.fork_and_check do exec 'true'  end end.should_not raise_error
+    end
+  end
+
+  describe 'catching_exit' do
+    it 'should call final_proc with the fallthrough status when the block does not exit' do
+      [0, 1, 42, 255].each do |i|
+        foo = nil
+        mh.catching_exit(lambda {|status| foo = status }, 2) do end
+        foo.should == 2
+      end
+
+    end
+
+    it 'should call final_proc with the exit status when the block exits' do
+      [0, 1, 42, 255].each do |i|
+        foo = nil
+        mh.catching_exit(lambda {|status| foo = status }, 2) do exit i end
+        foo.should == i
+      end
+    end
+  end
+
+  describe 'do_and_exit' do
+    it 'should have the proper exit status when the block does not exit' do
+      lambda do
+        mh.do_and_exit do end
+        exit 2  # Should never reach this.
+      end.should exit_with 1
+
+      lambda do
+        mh.do_and_exit! do end
+        exit! 2  # Should never reach this.
+      end.should exit_with 1
+
+      [0, 1, 42, 255].each do |i|
+        lambda do
+          mh.do_and_exit i do end
+          exit 2  # Should never reach this.
+        end.should exit_with i
+      end
+
+      [0, 1, 42, 255].each do |i|
+        lambda do
+          mh.do_and_exit! i do end
+          exit! 2  # Should never reach this.
+        end.should exit_with i
+      end
+    end
+
+    it 'should have the proper exit status when the block exits' do
+      [0, 1, 42, 255].each do |i|
+        lambda do
+          mh.do_and_exit do exit i end
+          exit 2  # Should never reach this.
+        end.should exit_with i
+      end
+
+      [0, 1, 42, 255].each do |i|
+        lambda do
+          mh.do_and_exit! do exit! i end
+          exit! 2  # Should never reach this.
+        end.should exit_with i
+      end
+    end
+
+    it 'should handle exec' do
+      [0, 1, 42, 255].each do |i|
+        lambda do
+          mh.do_and_exit! do exec *%W{sh -c #{'exit "$1"'} sh #{i}} end
+          exit! 2  # Should never reach this.
+        end.should exit_with i
+      end
+    end
+
+    it 'should handle exit! and plain exit' do
+      lambda do
+        begin
+          mh.do_and_exit do end
+        rescue SystemExit => e
+          exit 2
+        end
+      end.should exit_with 2
+
+      lambda do
+        begin
+          mh.do_and_exit! do end
+        rescue SystemExit => e
+          exit 2  # Should never reach this.
+        end
+      end.should exit_with 1
+    end
+  end
+
+  describe 'overwrite' do
+    before :all do
+      @dir      = Dir.mktmpdir
+      @file     = "#{@dir}/foo"
+      @content0 = "bar\n"
+      @content1 = "baz\n"
+      @mode0    = 0714
+      @mode1    = 0755
+    end
+
+    after :all do
+      FileUtils.rm_rf @dir
+    end
+
+    it 'should create a fresh file' do
+      mh.overwrite @file do |io|
+        io << @content0
+        File.exists?(@file).should == false
+      end
+      File.read(@file).should == @content0
+    end
+
+    it 'should overwrite a file' do
+      mh.overwrite @file do |io|
+        io << @content1
+        File.read(@file).should == @content0
+      end
+      File.read(@file).should == @content1
+    end
+
+    it 'should retain the mode' do
+      File.chmod @mode0, @file
+      mh.overwrite @file do end
+      (File.stat(@file).mode & 07777).should == @mode0
+    end
+
+    it 'should set the mode' do
+      mh.overwrite @file, @mode1 do end
+      (File.stat(@file).mode & 07777).should == @mode1
+    end
+  end
+
+  describe 'tempname_for' do
+    it 'should generate an unique temporary path' do
+      path = '/foo/bar/baz'
+      tempnames = (0...10).map { mh.tempname_for(path) }.to_set
+
+      # It is very, very unlikely there are duplicates.
+      tempnames.length.should > 8
+
+      tempnames.each do |n|
+        n.should =~ %r{\A/foo/bar/.baz.[a-z0-9]+\z}
+      end
+    end
+  end
+
+  describe 'try_n_times' do
+    it 'should try 10 times' do
+      e = Class.new RuntimeError
+
+      i = 0
+      mh.try_n_times do
+        i += 1
+        42
+      end.should == 42
+      i.should == 1
+
+      i = 0
+      mh.try_n_times do
+        i += 1
+        raise e if i < 10
+        42
+      end.should == 42
+      i.should == 10
+
+      i = 0
+      lambda do
+        mh.try_n_times do
+          i += 1
+          raise e if i < 11
+          42
+        end
+      end.should raise_error e
+      i.should == 10
+    end
+  end
+
+  describe 'ExceptionMixin to_formatted_string' do
+    it 'should return the proper string for an exception' do
+      klass = Class.new RuntimeError
+
+      begin
+        raise klass, 'foo'
+
+      rescue klass => e
+        lines = e.to_formatted_string.split /\n/
+        head  = lines.shift
+
+        e_class_re  = Regexp.quote e.class.to_s
+        e_msg_re    = Regexp.quote e.to_s
+        filename_re = Regexp.quote File.basename(__FILE__)
+
+        head_re = %r{\A.+/#{filename_re}:\d+: #{e_msg_re} \(#{e_class_re}\)\z}
+        head.should match head_re
+
+        lines.length.should == caller.length
+        lines.zip caller do |a, b|
+          a.should == "\tfrom #{b}"
+        end
+      end
+    end
+  end
+
+  describe 'IOMixin best_datasync' do
+    before :all do
+      @dir     = Dir.mktmpdir
+      @file    = "#{@dir}/foo"
+      @content = "f"
+    end
+
+    after :all do
+      FileUtils.rm_rf @dir
+    end
+
+    it 'should flush any buffered data to the OS' do
+      open @file, 'w' do |io|
+        io << @content
+
+        File.read(@file).should == ''
+
+        io.best_datasync
+
+        File.read(@file).should == @content
+      end
+    end
+
+    sync_meths = [:fdatasync, :fsync, :flush]
+
+    sync_meths.length.times do |i|
+      sync_meths_dup = sync_meths.dup
+
+      fails    = sync_meths_dup.shift i
+      succeeds = sync_meths_dup.shift
+      ignored  = sync_meths_dup
+
+      desc = "should call #{succeeds}"
+
+      if fails.empty?
+        desc << " if available"
+      else
+        desc << " if #{fails.join(', ')} unavailable"
+      end
+
+      desc << " (ignoring #{ignored.join(', ')})" unless ignored.empty?
+
+      it desc do
+        [NoMethodError, NotImplementedError].each do |error|
+          open @file, 'w' do |io|
+            fails.each do |meth|
+              if error == NoMethodError
+                io.metaclass.send :undef_method, meth rescue nil
+              else
+                io.should_receive(meth).once.ordered.and_raise error
+              end
+            end
+
+            io.should_receive(succeeds).once.ordered.and_return nil
+
+            ignored.each do |meth|
+              io.should_not_receive(meth)
+            end
+
+            io.best_datasync
+          end
+        end
+      end
+    end
+
+    it "should fail if none of #{sync_meths.join(', ')} are available" do
+      [NoMethodError, NotImplementedError].each do |error|
+        lambda do
+          open @file, 'w' do |io|
+            sync_meths.each do |meth|
+              if error == NoMethodError
+                io.metaclass.send :undef_method, meth rescue nil
+              else
+                io.should_receive(meth).once.ordered.and_raise error
+              end
+            end
+
+            io.best_datasync
+          end
+        end.should raise_error error
+      end
+    end
+
+    it 'should pass other failures through' do
+      lambda do
+        open @file, 'w' do |io|
+          io.should_receive(:fdatasync).once.ordered.and_raise NotImplementedError
+          io.should_receive(:fsync).once.ordered.and_raise IOError
+          io.should_not_receive(:flush)
+
+          io.best_datasync
+        end
+      end.should raise_error IOError
+    end
+  end
+end
+
+# vim:set et sw=2 sts=2:

data/spec/spec_helper.rb

@@ -0,0 +1,50 @@
+# mischacks – Miscellaneous methods that may or may not be useful
+# Copyright © 2009 Johan Kiviniemi
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__)+'/../lib')
+
+require 'mischacks'
+
+class Object
+  def metaclass
+    class << self; self; end
+  end
+end
+
+Spec::Matchers.define :exit_with do |expected|
+  match do |block|
+    @status = 0
+
+    begin
+      MiscHacks.fork_and_check do
+        block.call
+      end
+    rescue MiscHacks::ChildError => e
+      @status = e.status
+    end
+
+    @status.eql? expected
+  end
+
+  failure_message_for_should do |block|
+    "expected exit value #{expected}, got #{@status}"
+  end
+
+  failure_message_for_should do |block|
+    "did not expect exit value #{@status}"
+  end
+end
+
+# vim:set et sw=2 sts=2:

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+name: mischacks
+version: !ruby/object:Gem::Version 
+  version: 0.0.6
+platform: ruby
+authors: 
+- Johan Kiviniemi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-14 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: "sh: Safely pass untrusted parameters to sh scripts.  overwrite: Safely replace a file.  Exception#to_formatted_string: Return a string that looks like how Ruby would dump an uncaught exception."
+email: devel@johan.kiviniemi.name
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.txt
+files: 
+- COPYING
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- VERSION
+- lib/mischacks.rb
+- spec/mischacks_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://johan.kiviniemi.name/software/mischacks/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Miscellaneous methods that may or may not be useful
+test_files: 
+- spec/spec_helper.rb
+- spec/mischacks_spec.rb