rio 0.3.7 → 0.3.8

data/lib/rio/ios/mode.rb

@@ -0,0 +1,61 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 2006 Christopher Kleckner
+# All rights reserved
+#
+# This file is part of the Rio library for ruby.
+#
+# Rio 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 2 of the License, or
+# (at your option) any later version.
+#
+# Rio 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 Rio; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+# =============================================================================== 
+#++
+#
+# To create the documentation for Rio run the command
+#  ruby build_doc.rb
+# from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Rio
+#
+# <b>Rio is pre-alpha software. 
+# The documented interface and behavior is subject to change without notice.</b>
+
+
+require 'rio/exception/notsupported'
+
+module RIO
+  module IOS
+    class Mode #:nodoc: all
+      def initialize(mode_string)
+        @str = mode_string
+      end
+      def to_s() @str end
+      def can_write?
+        @str =~ /^[aw]/ or @str =~ /\+/
+      end
+      def can_read?
+        @str =~ /^r/ or @str =~ /\+/
+      end
+      def appends?
+        @str =~ /^a/
+      end
+      def =~(re)
+        re =~ @str
+      end
+    end
+  end
+end

data/lib/rio/ios/null.rb

@@ -0,0 +1,120 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 2006 Christopher Kleckner
+# All rights reserved
+#
+# This file is part of the Rio library for ruby.
+#
+# Rio 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 2 of the License, or
+# (at your option) any later version.
+#
+# Rio 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 Rio; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+# =============================================================================== 
+#++
+#
+# To create the documentation for Rio run the command
+#  ruby build_doc.rb
+# from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Rio
+#
+# <b>Rio is pre-alpha software. 
+# The documented interface and behavior is subject to change without notice.</b>
+
+
+require 'rio/exception/notsupported'
+require 'rio/ios/mode'
+module RIO
+  module IOS
+    module Methods
+    end
+  end
+end
+module RIO
+  module IOS
+    module Exception
+      class NotDuplex < RIO::Exception::Base
+      end
+    end
+  end
+end
+
+module RIO
+  module IOS
+    class Null  #:nodoc: all
+      def initialize(el=nil,m='r') 
+        @lineno = 0
+        @open = true
+        @mode = Mode.new(m)
+        @pos = 0
+      end
+      require 'rio/ios/fail'
+      include Fail
+                                                                             
+      def <<(obj) self end
+      def binmode() self end
+      def close() @open = false end
+      def close_read() raise Exception::NotDuplex end
+      def close_write()  raise Exception::NotDuplex end
+      def closed?() not @open end
+      def each(sep_string=$/,&block) self end
+      def each_line(sep_string=$/,&block) self end
+      def each_byte(sep_string=$/,&block) self end
+      def eof?() true end
+      #def fcntl(integer_cmd,arg) notsupported(:fcntl) end
+      #def fileno() notsupported(:fileno) end
+      #def to_i() notsupported(:to_i) end
+      def flush() nil end
+      def fsync() nil end
+      def getc() nil end
+      def gets(sep_string=$/) nil end
+      #def ioctl(integer_cmd,arg) notsupported(:ioctl) end
+      def tty?() false end
+      def isatty() tty? end
+      def lineno() @lineno end
+      def lineno=(a) @lineno = a; lineno() end
+      #def pid() notsupported(:pid) end
+      def pos() 0 end
+      def tell() pos() end
+      def pos=(v) @pos = v; pos end
+      def print(*objs) nil end
+      def printf(format,*objs) nil end
+      def putc(obj) nil end
+      def puts(*objs) nil end
+      def read(length=nil,*args) length.nil? ? "" : nil end
+      def readchar() raise EOFError end
+      def readline(sep_string=$/) raise EOFError end
+      def readlines(sep_string=$/) [] end
+      def readpartial(maxlen,*args)  raise EOFError end
+      def reopen(*args) self end
+      def rewind() 0 end
+      def seek(amount,whence) 0 end
+      #def stat() notsupported(:stat) end
+      #def sync() notsupported(:sync) end
+      #def sync=(v) notsupported(:sync=) end
+      #def sysread() notsupported(:sysread) end
+      #def sysseek() notsupported(:sysseek) end
+      #def syswrite() notsupported(:syswrite) end
+      #def ungetc() notsupported(:ungetc) end
+      def write(str) str.length end
+      
+      def callstr(func,*args)
+        self.class.to_s+'['+self.to_s+']'+'.'+func.to_s+'('+args.join(',')+')'
+      end
+      
+    end
+  end
+end

data/lib/rio/iowrap.rb

@@ -0,0 +1,129 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 2006 Christopher Kleckner
+# All rights reserved
+#
+# This file is part of the Rio library for ruby.
+#
+# Rio 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 2 of the License, or
+# (at your option) any later version.
+#
+# Rio 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 Rio; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+# =============================================================================== 
+#++
+#
+# To create the documentation for Rio run the command
+#  ruby build_doc.rb
+# from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Rio
+#
+# <b>Rio is pre-alpha software. 
+# The documented interface and behavior is subject to change without notice.</b>
+
+
+#require 'fileutils'
+
+module RIO
+  module IOWrap #:nodoc: all
+    class Base
+      attr :ios
+      def initialize(ios)
+        @ios = ios
+      end
+      def initialize_copy(other)
+        super
+        @ios = other.ios.clone unless other.ios.nil?
+      end
+      def callstr(func,*args)
+        self.class.to_s+'['+self.to_s+']'+'.'+func.to_s+'('+args.join(',')+')'
+      end
+      def handle() @ios end
+      def open?() not closed? end
+    end
+    class Stream < Base
+      attr_reader :eof
+      def initialize(ios)
+        @eof = false
+        @closed = false
+        super
+      end
+      def close()
+        @closed = true
+        handle.close 
+      end
+      def closed?() 
+        @closed
+      end
+      def eof?() @eof end
+
+      def each(*args,&block)
+        rtn = handle.each(*args,&block)
+        @eof = true
+        rtn
+      end
+      alias :each_line :each
+      def gets(*args)
+        @eof = true unless ans = handle.gets(*args)
+        ans
+      end
+      def getc(*args)
+        @eof = true unless ans = handle.getc(*args)
+        ans
+      end
+      def readlines(*args)
+        rtn = handle.readlines(*args)
+        @eof = true
+        rtn
+      end
+      def readline(*args)
+        begin
+          return handle.readline
+        rescue EOFError
+          @eof = true
+          raise
+        end
+      end
+      def read(*args)
+        @eof = true unless ans = handle.read(*args)
+        ans
+      end
+      def sysread(*args)
+        @eof = true unless ans = handle.sysread(*args)
+        ans
+      end
+#       extend Forwardable
+#       def_instance_delegators(:handle,
+#                               :binmode,
+#                               :stat,
+#                               :rewind,
+#                               :<<,:print,:printf,:puts,:putc,:write,:syswrite,
+#                               :pos,:pos=,:lineno,:lineno=,
+#                               :fileno,
+#                               :close_read,:close_write,
+#                               :fsync,:sync,:sync=,:fcntl,:ioctl)
+
+      #def puts(*args)
+      #  handle.puts(*args)
+      #end
+      def method_missing(sym,*args,&block)
+        #p callstr('method_missing',sym,*args)
+        handle.__send__(sym,*args,&block)
+      end
+    end
+  end
+end
+__END__

data/lib/rio/kernel.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading
@@ -35,9 +35,9 @@
 # The documented interface and behavior is subject to change without notice.</b>
 
 
+require 'rio/def'
 
 module Kernel
-  require 'rio'
   # Shortcut for RIO.rio
   def rio(*args,&block) # :yields: self
     RIO::Rio.rio(*args,&block)
@@ -45,3 +45,12 @@ module Kernel
   module_function :rio
   alias :io :rio
 end
+
+module RIO 
+  # See also: RIO::Doc::SYNOPSIS; RIO::Doc::INTRO; RIO::Doc::HOWTO.
+  class Rio < Base #:doc:
+    undef_method(:rio)
+  end
+end
+
+require 'rio'

data/lib/rio/local.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading

data/lib/rio/match.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading
@@ -44,7 +44,7 @@ module RIO
         case cx['ss_type']
         when nil
           keys[0]
-       else
+        else
           cx['ss_type']
         end
       end

data/lib/rio/matchrecord.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading

data/lib/rio/no_warn.rb

@@ -0,0 +1,50 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 2006 Christopher Kleckner
+# All rights reserved
+#
+# This file is part of the Rio library for ruby.
+#
+# Rio 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 2 of the License, or
+# (at your option) any later version.
+#
+# Rio 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 Rio; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+# =============================================================================== 
+#++
+#
+# To create the documentation for Rio run the command
+#  ruby build_doc.rb
+# from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Rio
+#
+# <b>Rio is pre-alpha software. 
+# The documented interface and behavior is subject to change without notice.</b>
+
+
+module RIO
+  # Based on a suggestion posted by Andrew L. Johnson to comp.lang.ruby
+  def no_warn
+    begin
+      verbose = $VERBOSE
+      $VERBOSE = nil
+      yield
+    ensure
+      $VERBOSE = verbose
+    end
+  end
+  module_function :no_warn
+end

data/lib/rio/{arrayio.rb → nullio.rb}

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading
@@ -43,7 +43,7 @@ module RIO
     end
 
   end
-  class AIOMode #:nodoc: all
+  class NullIOMode #:nodoc: all
     def initialize(mode_string)
       @str = mode_string
     end
@@ -61,39 +61,17 @@ module RIO
       re =~ @str
     end
   end
-  class AIOH  #:nodoc: all
-    attr_accessor :array,:lineno,:mode,:ln
-    def initialize(a,m)
-      @array = a || []
-      @mode = AIOMode.new(m)
-      @lineno = 0
-      @ln = 0
-    end
-  end
-
-  class ArrayIO  #:nodoc: all
+  class NullIO  #:nodoc: all
     def initialize(a=nil,m='r')
 #      p "#{callstr('initialize',a,m)} hnd=#{@hnd.inspect}"
-      raise ArgumentError,"ArrayIO.new() requires an array but got #{a.inspect}" unless a.kind_of?(::Array)
-      a = a.array if a.kind_of?(ArrayIO)
-      @hnd = AIOH.new(a,m)
-      _open(@hnd.mode)
-    end
-    def array() @hnd.array end
-    def array=(a) @hnd.array = a end
-    def lineno() @hnd.lineno end
-    def lineno=(a) @hnd.lineno = a end
-    def to_a() array.dup end
-
-    def _open(m)
-      @hnd.mode = AIOMode.new(m.to_s)
-      @hnd.ln = 0
-#      p m.to_s,@hnd.mode.to_s,@hnd.array
-      @hnd.array.clear if @hnd.mode.to_s =~ /^w/
-      @hnd.ln = @hnd.array.size if @hnd.mode.to_s =~ /^a/
+      @lineno = 0
+      @open = true
+      @mode = NullIOMode.new(m)
     end
+    def lineno() @lineno end
+    def lineno=(a) @lineno = a end
     def self.open(a=nil,m='r',&block)
-      rtn = io = self.class.new(a,m)
+      rtn = io = new(a,m)
       if block_given?
         rtn = yield(io)
         io.close
@@ -105,89 +83,72 @@ module RIO
     def fsync() nil end
     def isatty() false end
     def tty?() false end
-    def pos() @hnd.ln end
-    def pos=(n) @hnd.ln = n end
+    def pos() 0 end
+    def pos=(n) 0 end
 
-    def readchar() raise NotSupportedException,NotSupportedException.emsg('readchar',self) end
-    def read() raise NotSupportedException,NotSupportedException.emsg('read',self) end
-    def getc() raise NotSupportedException,NotSupportedException.emsg('getc',self) end
+    def readchar() nil end
+    def read() nil end
+    def getc() nil end
 
     def closed?
-      @hnd.ln.nil?
-    end
-    def close_read
-      @hnd.ln = @hnd.lineno = nil
-    end
-    def close_write
-      @hnd.ln = nil
+      not @open
     end
     def close
-      close_read
-      close_write
+      @open = false
     end
     def eof?()
-      raise IOError,"ArrayIO is not open for reading" unless @hnd.mode.can_read?
-      @hnd.ln >= @hnd.array.size
+      true
     end
     def each_line(sep_string=$/,&block) 
-      while line = gets(sep_string)
-        yield(line)
-      end
       self
     end
+    def each_byte(sep_string=$/,&block) 
+      nil
+    end
+    def fcntl(integer_cmd,arg)
+      raise NotSupportedException,NotSupportedException.emsg('fcntl',self)
+    end
+    def ioctl(integer_cmd,arg)
+      raise NotSupportedException,NotSupportedException.emsg('fcntl',self)
+    end
     alias each each_line
     def gets(sep_string=$/)
-      raise IOError,"ArrayIO is not open for reading" unless @hnd.mode.can_read?
-      return nil if @hnd.ln >= @hnd.array.size
-      str = nil
-      if sep_string.nil?
-        str = @hnd.array[@hnd.ln...@hnd.array.size].join('')
-        @hnd.lineno += @hnd.array.size - @hnd.ln
-        @hnd.ln = @hnd.array.size
-      else
-        str = @hnd.array[@hnd.ln]
-        @hnd.lineno += 1
-        @hnd.ln += 1
-      end
-      $_ = str
+      raise IOError,"NullIO is not open for reading" unless @mode.can_read?
+      nil
     end
     def readline(sep_string=$/)
-      raise EOFError unless str = gets(sep_string)
-      str
+      raise EOFError
     end
     
     def readlines(sep_string=$/)
-      ary = []
-      until eof?
-        ary.push(gets(sep_string))
-      end
-      ary
+      []
     end
     def rewind
-      @hnd.ln = @hnd.lineno = 0
+      @lineno = 0
     end
     def print(*objs)
-      raise IOError,"ArrayIO is not open for writing" unless @hnd.mode.can_write?
-      if objs.empty?
-        @hnd.array[@hnd.ln] = $_
-        @hnd.ln += 1
-      else
-        for obj in objs
-          @hnd.array[@hnd.ln] = obj.to_s
-          @hnd.ln += 1
-        end
-      end
+      raise IOError,"NullIO is not open for writing" unless @mode.can_write?
+      nil
+    end
+    def close_read(*objs)
+      raise IOError,"NullIO is not a duplex stream"
+      nil
+    end
+    def close_write(*objs)
+      raise IOError,"NullIO is not a duplex stream"
       nil
     end
     def <<(obj)
-      print(obj.to_s)
       self
     end
     def puts(*objs)
-      for obj in objs
-        print(obj.to_s.chomp + $/)
-      end
+      nil
+    end
+    def write(string)
+      print(string)
+      string.size
     end
+    def binmode() nil end
     def printf(fmt,*args)
       print(sprintf(fmt,*args))
     end

data/lib/rio/open3.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading