FSEvents::Stream#shutdown.

To shut down a stream, the stream should be stopped, invalidated, and released (taken from the example of 'taming the autotest beast with FSEvents').

lib/fsevents/stream.rb

@@ -37,5 +37,11 @@ def release
       OSX.FSEventStreamRelease(stream)
       @stream = nil
     end
+
+    def shutdown
+      stop
+      invalidate
+      release
+    end
   end
 end

spec/stream_spec.rb

@@ -245,6 +245,33 @@
       @stream.stream.should be_nil
     end
   end
+
+  it 'should shut down' do
+    @stream.should respond_to(:shutdown)
+  end
+
+  describe 'when shutting down' do
+    before :each do
+      @stream.stubs(:stop)
+      @stream.stubs(:invalidate)
+      @stream.stubs(:release)
+    end
+
+    it 'should stop' do
+      @stream.expects(:stop)
+      @stream.shutdown
+    end
+
+    it 'should invalidate' do
+      @stream.expects(:invalidate)
+      @stream.shutdown
+    end
+
+    it 'should release' do
+      @stream.expects(:release)
+      @stream.shutdown
+    end
+  end
 end
 
 describe FSEvents::Stream::StreamError do