andand 1.1.1 → 1.2.0

data/History.txt

@@ -6,3 +6,5 @@
   * fixed specifications
 * 3 minor enhancement
   * tap is now a synonym for me
+* 4 minor enhancement
+  * Object#dont

data/lib/andand.rb

@@ -36,6 +36,16 @@ module AndAnd
     
     alias :tap :me
     
+    def dont (p = nil)
+      if block_given?
+        self
+      elsif p
+        self
+      else
+        MockReturningMe.new(self)
+      end
+    end
+    
   end
   
 end

data/lib/andand/version.rb

@@ -1,8 +1,8 @@
 module Andand #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 1
-    MINOR = 1
-    TINY  = 1
+    MINOR = 2
+    TINY  = 0
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/website/index.html

@@ -33,7 +33,7 @@
     <h1>Object#andand</h1>
     <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/andand"; return false'>
       <p>Get Version</p>
-      <a href="http://rubyforge.org/projects/andand" class="numbers">1.1.1</a>
+      <a href="http://rubyforge.org/projects/andand" class="numbers">1.2.0</a>
     </div>
     <h1>&#x2192; &#8216;andand&#8217;</h1>
 
@@ -105,16 +105,38 @@ list_of_lists.detect { ...elided... }.andand.inject(42) { ...elided ... }
         =&gt; [2, 4, 6, 8]
 </pre>
 
-	<h2>Demonstration of usage</h2>
+	<h3>Doctor, it hurts when I do that</h3>
 
 
-	<p>See above.</p>
+	<p><strong>Don&#8217;t do that!</strong></p>
 
 
+	<p>The popular use case for Object#tap is poor man&#8217;s debugging:</p>
+
+
+<pre>
+    blah.sort.grep( /foo/ ).tap { |xs| p xs }.map { |x| x.blah }
+</pre>Perhaps you want to remove the tap, you can delete it:
+
+<pre>
+    blah.sort.grep( /foo/ ).tap { |xs| p xs }.map { |x| x.blah }
+</pre>Or, you can change it to <code>.dont</code>:
+
+<pre>
+    blah.sort.grep( /foo/ ).dont { |xs| p xs }.map { |x| x.blah }
+</pre>Like <code>.andand</code> and <code>.tap</code>, <code>.dont</code> works with arbitrary methods, not just blocks:
+
+<pre>
+    (1..10).to_a.reverse!
+        =&gt; [10, 9, 8, 7, 6, 5, 4, 3, 2, 1]
+    (1..10).dont.to_a.reverse!
+        =&gt; [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+</pre>
+
 	<h2>A little more background</h2>
 
 
-	<p><a href="http://weblog.raganwald.com/2008/01/objectandand-objectme-in-ruby.html">Object#andand &#38; Object#me in Ruby</a></p>
+	<p><a href="http://weblog.raganwald.com/2008/01/objectandand-objectme-in-ruby.html">Object#andand &#38; Object#me in Ruby</a> explains the original motivations, as well as providing links to similar implementations you may want to consider. A few people have pointed out that Object#andand is similar to Haskell&#8217;s <code>Maybe</code> monad. <a href="http://blog.pretheory.com/arch/2008/02/the_maybe_monad_in_ruby.php">The Maybe Monad in Ruby</a> is a good introduction for Ruby programmers.</p>
 
 
 	<h2>How to submit patches</h2>
@@ -132,12 +154,18 @@ list_of_lists.detect { ...elided... }.andand.inject(42) { ...elided ... }
 	<p>This code is free to use under the terms of the <a href="http://en.wikipedia.org/wiki/MIT_License"><span class="caps">MIT</span> license</a>.</p>
 
 
+	<h2>Shout Out</h2>
+
+
+	<p><a href="http://mcommons.com/">Mobile Commons</a>. Huge.</p>
+
+
 	<h2>Contact</h2>
 
 
 	<p>Comments are welcome. Send an email to <a href="mailto:raganwald+rubyforge@gmail.com">Reginald Braithwaite</a>.</p>
     <p class="coda">
-      <a href="http://weblog.raganwald.com">Reginald Braithwaite</a>, 10th February 2008<br>
+      <a href="http://weblog.raganwald.com">Reginald Braithwaite</a>, 15th February 2008<br>
       Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
     </p>
 </div>

data/website/index.txt

@@ -57,14 +57,35 @@ Ruby 1.9 introduces "Object#tap":http://moonbase.rydia.net/mental/blog/programmi
 	[1, 2, 3, 4, 5].tap.pop.map { |n| n * 2 }
     	=> [2, 4, 6, 8]
 </pre>
-				
-h2. Demonstration of usage
 
-See above.
+h3. Doctor, it hurts when I do that
+
+*Don't do that!*
+
+The popular use case for Object#tap is poor man's debugging:
+
+<pre>
+	blah.sort.grep( /foo/ ).tap { |xs| p xs }.map { |x| x.blah }
+</pre>Perhaps you want to remove the tap, you can delete it:
+
+<pre>
+	blah.sort.grep( /foo/ ).tap { |xs| p xs }.map { |x| x.blah }
+</pre>Or, you can change it to @.dont@:
+
+<pre>
+	blah.sort.grep( /foo/ ).dont { |xs| p xs }.map { |x| x.blah }
+</pre>Like @.andand@ and @.tap@, @.dont@ works with arbitrary methods, not just blocks:
+
+<pre>
+	(1..10).to_a.reverse!
+	    => [10, 9, 8, 7, 6, 5, 4, 3, 2, 1]
+	(1..10).dont.to_a.reverse!
+	    => [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+</pre>
 
 h2. A little more background
 
-"Object#andand & Object#me in Ruby":http://weblog.raganwald.com/2008/01/objectandand-objectme-in-ruby.html
+"Object#andand & Object#me in Ruby":http://weblog.raganwald.com/2008/01/objectandand-objectme-in-ruby.html explains the original motivations, as well as providing links to similar implementations you may want to consider. A few people have pointed out that Object#andand is similar to Haskell's @Maybe@ monad. "The Maybe Monad in Ruby":http://blog.pretheory.com/arch/2008/02/the_maybe_monad_in_ruby.php is a good introduction for Ruby programmers.
 
 h2. How to submit patches
 
@@ -76,6 +97,10 @@ h2. License
 
 This code is free to use under the terms of the "MIT license":http://en.wikipedia.org/wiki/MIT_License. 
 
+h2. Shout Out
+
+"Mobile Commons":http://mcommons.com/. Huge.
+
 h2. Contact
 
 Comments are welcome. Send an email to "Reginald Braithwaite":mailto:raganwald+rubyforge@gmail.com.

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: andand
 version: !ruby/object:Gem::Version 
-  version: 1.1.1
-date: 2008-02-10 00:00:00 -05:00
+  version: 1.2.0
+date: 2008-02-15 00:00:00 -05:00
 summary: adds guarded method invocation to Ruby
 require_paths: 
 - lib