rfortune 0.2.0 → 0.2.1

data/CHANGELOG.rdoc

@@ -1,5 +1,10 @@
 == Changelog
 
+=== 0.2.1 (2009-12-12)
+
+* Added class method 'random_fortune'. Usable with or without block.
+* Added 'each' block
+
 === 0.2.0 (2009-12-07)
 
 * Added summation (+)

data/README.rdoc

@@ -14,9 +14,10 @@ gem install rfortune
 
 == SYNOPSIS:
 
-To instantiate a RFortune you have to give the relative path to a
-cookie jar file as an argument. If there is no such file relative to the
-current directory it will be searched beneath /usr/share/games/fortunes.
+To instantiate RFortune you have to give the relative path to a cookie
+jar file as an argument. If there is no argument given or no such file
+a new one will be created. File paths can be specified relative or
+absolute or as the name of a file from beneath /usr/share/games/forunes.
 
   cookies = RFortune.new 'cookie_jar_file'
 
@@ -24,6 +25,10 @@ To get a random cookie from the jar simply do:
 
   cookies.random
 
+== Links
+
+WP: Fortune[http://en.wikipedia.org/wiki/Fortune_(Unix)]
+
 == Copyright
 
 Copyright (c) 2009 Helge Rausch. See LICENSE for details.

data/lib/rfortune.rb

@@ -109,7 +109,7 @@ class RFortune
 
   # Depricated, alias for to_a
   def all
-    
+
     to_a
 
   end
@@ -146,5 +146,61 @@ class RFortune
 
   end
 
+  # Calls block once for each cookie, passing that cookie as a parameter. 
+  def each
+
+    @cookies.each { |c| yield c }
+
+  end
+
+  # Returns a random fortune from fortune's fortunes. If a block is
+  # given it passes one fortune per iteration to the block. Infinite.
+  # That means FOREVER! So be careful!
+  # Takes 'false' as an argument if you'd like to include offensive
+  # fortunes.
+  def self.random_fortune( no_offense = true )
+
+    cookie_jars = []
+
+    Dir.foreach( FORTUNES_PATH ) { |filename|
+
+      cookie_jars += [ filename ] if filename.match( /\A.*\.u8\Z/ )
+
+    }
+
+    unless no_offense
+
+      Dir.foreach( FORTUNES_PATH + 'off/' ) { |filename|
+
+	cookie_jars += [ 'off/' + filename ] if filename.match( /\.u8\Z/ )
+
+      }
+
+    end
+
+    if block_given?
+
+      fortunes = RFortune.new
+
+      cookie_jars.each { |jar|
+
+	fortunes += RFortune.new( jar )
+
+      }
+
+      begin
+
+	yield fortunes.random
+
+      end while true
+
+    else 
+
+      RFortune.new( FORTUNES_PATH + cookie_jars[ rand( cookie_jars.size ) ] ).random
+
+    end
+
+  end
+
 end
 

data/test/test_rfortune.rb

@@ -72,5 +72,41 @@ class RFortuneTest < Test::Unit::TestCase
 
   end
 
+  def test_each
+
+    cookies = RFortune.new + [ 'foo', 'bar' ]
+
+    cookies.each { |c|
+
+      assert_match /\A(foo|bar)\Z/, c, 'Block for \'each\' method'
+
+    }
+
+  end
+
+  def test_random_fortune
+
+    # Get regular fortune
+    assert_equal String, RFortune.random_fortune.class, 'Try to get a random fortune from fortune\'s fortunes'
+
+    # Include offensive fortunes
+    assert_equal String, RFortune.random_fortune( false ).class, 'Try to get a random fortune from fortune\'s fortunes'
+
+    # From block
+    i = 0
+
+    RFortune.random_fortune { |fortune|
+     
+      assert_equal String, fortune.class, 'Try to get fortunes using a block.'
+    
+      break if i == 3
+
+      i += 1
+
+    }
+
+
+  end
+
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rfortune
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors: 
 - Helge Rausch
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-07 00:00:00 +01:00
+date: 2009-12-12 00:00:00 +01:00
 default_executable: 
 dependencies: []
 
@@ -21,7 +21,6 @@ extensions: []
 
 extra_rdoc_files: 
 - README.rdoc
-- TODO.rdoc
 - CHANGELOG.rdoc
 files: 
 - lib/rfortune.rb
@@ -29,7 +28,6 @@ files:
 - test/test_rfortune.rb
 - LICENSE
 - README.rdoc
-- TODO.rdoc
 - VERSION
 has_rdoc: true
 homepage: http://github.com/tsujigiri/rfortune

data/TODO.rdoc

@@ -1,2 +0,0 @@
-== TODO
-