ruby-nuggets 0.2.1.246 → 0.2.2.247

data/README

@@ -2,7 +2,7 @@
 
 == VERSION
 
-This documentation refers to ruby-nuggets version 0.2.1
+This documentation refers to ruby-nuggets version 0.2.2
 
 
 == DESCRIPTION

data/lib/nuggets/io/modes.rb

@@ -0,0 +1,123 @@
+#--
+###############################################################################
+#                                                                             #
+# A component of ruby-nuggets, some extensions to the Ruby programming        #
+# language.                                                                   #
+#                                                                             #
+# Copyright (C) 2007-2008 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@uni-koeln.de>                                    #
+#                                                                             #
+# ruby-nuggets is free software; you can redistribute it and/or modify it     #
+# under the terms of the GNU General Public License as published by the Free  #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# ruby-nuggets is distributed in the hope that it will be useful, but WITHOUT #
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or       #
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for    #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU General Public License along     #
+# with ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.              #
+#                                                                             #
+###############################################################################
+#++
+
+class IO
+
+  # Inspired by Martin DeMello, [ruby-talk:307782] -- thx ;-)
+
+  class << self
+
+    alias_method :original_read, :read
+
+    # call-seq:
+    #   IO.read(name, [length [, offset]]) => aString
+    #   IO.read(name, binary = false) { |io| ... } => anObject
+    #
+    # Opens +name+ with mode +r+. NOTE: With no associated block,
+    # acts like the original IO::read, not like IO::new.
+    def read(name, *args, &block)
+      return original_read(name, *args) unless block
+
+      case args.size
+        when 0
+          # ok
+        when 1
+          case binary = args.first
+            when true, false, nil
+              # ok
+            else
+              raise TypeError, "wrong argument type #{binary.class} (expected boolean)"
+          end
+        else
+          raise ArgumentError, "wrong number of arguments (#{args.size + 1} for 1-2)"
+      end
+
+      open_with_mode(name, 'r', binary, &block)
+    end
+
+    # call-seq:
+    #   IO.write(name, binary = false) => anIO
+    #   IO.write(name, binary = false) { |io| ... } => anObject
+    #
+    # Opens +name+ with mode +w+.
+    def write(name, binary = false, &block)
+      open_with_mode(name, 'w', binary, &block)
+    end
+
+    # call-seq:
+    #   IO.append(name, binary = false) => anIO
+    #   IO.append(name, binary = false) { |io| ... } => anObject
+    #
+    # Opens +name+ with mode +a+.
+    def append(name, binary = false, &block)
+      open_with_mode(name, 'a', binary, &block)
+    end
+
+    # call-seq:
+    #   IO.read_write(name, binary = false) => anIO
+    #   IO.read_write(name, binary = false) { |io| ... } => anObject
+    #
+    # Opens +name+ with mode <tt>r+</tt>.
+    def read_write(name, binary = false, &block)
+      open_with_mode(name, 'r+', binary, &block)
+    end
+
+    # call-seq:
+    #   IO.write_read(name, binary = false) => anIO
+    #   IO.write_read(name, binary = false) { |io| ... } => anObject
+    #
+    # Opens +name+ with mode <tt>w+</tt>.
+    def write_read(name, binary = false, &block)
+      open_with_mode(name, 'w+', binary, &block)
+    end
+
+    # call-seq:
+    #   IO.append_read(name, binary = false) => anIO
+    #   IO.append_read(name, binary = false) { |io| ... } => anObject
+    #
+    # Opens +name+ with mode <tt>a+</tt>.
+    def append_read(name, binary = false, &block)
+      open_with_mode(name, 'a+', binary, &block)
+    end
+
+    private
+
+    # Just a helper to DRY things up.
+    def open_with_mode(name, mode, binary = false, &block)
+      mode << 'b' if binary
+      open(name, mode, &block)
+    end
+
+  end
+
+end
+
+if $0 == __FILE__
+  # File.read(__FILE__) { |f| ... }
+  # File.write(__FILE__) { |f| ... }
+  # File.append(__FILE__) { |f| ... }
+end

data/lib/nuggets/version.rb

@@ -4,7 +4,7 @@ module Nuggets
 
     MAJOR = 0
     MINOR = 2
-    TINY  = 1
+    TINY  = 2
 
     class << self
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-nuggets
 version: !ruby/object:Gem::Version 
-  version: 0.2.1.246
+  version: 0.2.2.247
 platform: ruby
 authors: 
 - Jens Wille
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-06-24 00:00:00 +02:00
+date: 2008-07-10 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
@@ -27,6 +27,7 @@ files:
 - lib/nuggets/all.rb
 - lib/nuggets/version.rb
 - lib/nuggets/io/agrep.rb
+- lib/nuggets/io/modes.rb
 - lib/nuggets/file/which.rb
 - lib/nuggets/integer/factorial.rb
 - lib/nuggets/integer/to_binary_s.rb
@@ -70,15 +71,15 @@ has_rdoc: true
 homepage: http://prometheus.rubyforge.org/ruby-nuggets
 post_install_message: 
 rdoc_options: 
-- --line-numbers
+- --all
 - --main
 - README
+- --line-numbers
 - --inline-source
 - --title
 - ruby-nuggets Application documentation
 - --charset
 - UTF-8
-- --all
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -96,7 +97,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: prometheus
-rubygems_version: 1.1.1
+rubygems_version: 1.2.0
 signing_key: 
 specification_version: 2
 summary: Some extensions to the Ruby programming language.