wishdev-rio 0.4.3.1

data/lib/rio/if.rb

@@ -0,0 +1,64 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005,2006,2007 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.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
+# * RIO::Rio
+#
+
+
+module RIO
+  class Rio
+    require 'rio/if/csv'
+    include RIO::IF::CSV
+    require 'rio/if/yaml'
+    include RIO::IF::YAML
+  end
+end
+
+require 'rio/if/internal'
+require 'rio/if/basic'
+
+module RIO
+  class Rio
+    require 'rio/if/grande'
+    require 'rio/if/grande_entry'
+    require 'rio/if/grande_stream'
+    
+    require 'rio/if/test'
+    require 'rio/if/path'
+    require 'rio/if/fileordir'
+    require 'rio/if/file'
+    require 'rio/if/dir'
+    require 'rio/if/rubyio'
+    require 'rio/if/temp'
+    require 'rio/if/string'
+  end
+end

data/lib/rio/ioh.rb

@@ -0,0 +1,162 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005,2006,2007 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.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
+# * RIO::Rio
+#
+
+
+#require 'fileutils'
+
+module RIO
+  module IOH #:nodoc: all
+    class Base
+      attr :ios
+      def initialize(ios,*args)
+        @ios = ios
+      end
+      def initialize_copy(other)
+        #p callstr('ioh:initialize_copy',other)
+        super
+        #p @ios
+        @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 :iostack
+      attr_accessor :hindex
+      def initialize(iosp,*args)
+        super
+        @iostack = [@ios]
+        @hindex = -1
+      end
+      def initialize_copy(*args)
+        #p callstr('ioh_stream:initialize_copy',*args)
+        super
+        @iostack = @iostack.map { |io| io.nil? || io.equal?(@ios) ? io : io.clone }
+      end
+      def copy_blksize() 
+        if @ios.respond_to? :stat
+          sz = @ios.stat.blksize
+          sz = nil if sz.nil? || sz == 0
+        end
+        sz || 512 
+      end
+
+      def handle() @iostack[@hindex] end
+      def close()  handle.close unless self.closed? end
+      def closed?() handle.nil? or handle.closed? end
+      def eof?() closed? or handle.eof? end
+      def copy_stream(dst)
+        #p callstr('copy_stream',dst)
+        blksize = _stream_blksize(handle,dst)
+        until handle.eof?
+          dst.print(handle.read(blksize))
+        end
+        self
+      end
+      def puts(*args)
+        handle.puts(*args)
+      end
+      def each_bytes(nb,&block)
+        until handle.eof?
+          break unless s = handle.read(nb)
+          yield s
+        end
+        self
+      end
+      def each_line(*args,&block)
+        handle.each_line(*args,&block)
+      end
+      extend Forwardable
+      def_instance_delegators(:handle,:binmode,:stat,:rewind,
+                              :each,:each_byte,:gets,:getc,
+                              :read,:readlines,:readline,:sysread,
+                              :<<,:print,:printf,:putc,:write,:syswrite,
+                              :pos,:pos=,:lineno,:lineno=,
+                              :fileno,
+                              :close_read,:close_write,
+                              :fsync,:sync,:sync=,:fcntl,:ioctl)
+
+      def method_missing(sym,*args,&block)
+        #p callstr('method_missing',sym,*args)
+        handle.__send__(sym,*args,&block)
+      end
+      DEFAULT_BLKSIZE = 1024
+      def _stream_blksize(*streams)
+        sizes = []
+        streams.each do |s|
+          next unless s.kind_of?(::IO)
+          next unless s.respond_to?(:stat)
+          size = _stat_blksize(s.stat)
+          sizes << size if size
+        end
+        sizes.min || DEFAULT_BLKSIZE
+      end
+      def _stat_blksize(st)
+        s = st.blksize
+        return nil unless s
+        return nil if s == 0
+        s
+      end
+    end
+    class Dir < Base
+      def close
+        #p "#{callstr('close')} ios=#{@ios}"
+        unless @ios.nil?
+          @ios.close
+          @ios = nil
+        end
+      end
+      def closed?() @ios.nil? end
+      def each(&block)
+        while filename = handle.read
+          yield filename
+        end
+      end
+      def each0(&block)
+        handle.each { |filename|
+          yield filename
+        }
+      end
+      extend Forwardable
+      def_instance_delegators(:handle,
+                              :read,
+                              :pos,:pos=,:tell,:seek,:rewind)
+    end
+  end
+end
+__END__

data/lib/rio/iomode.rb

@@ -0,0 +1,109 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005,2006,2007 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.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
+# * RIO::Rio
+#
+
+
+
+require 'rio/abstract_method'
+
+module RIO
+  module Mode #:nodoc: all
+    class Base
+      attr_reader :mode
+      protected :mode
+      
+      def initialize(arg)
+        if arg.kind_of? self.class
+          copy(arg)
+        else
+          @mode = arg
+        end
+      end
+      
+      def copy(other)
+        @mode = other.mode
+      end
+      
+      def to_s() @mode.to_s end
+
+      abstract_method :primarily_read?, :primarily_write?, :allows_both?, :creates?
+
+      def read_only?()
+        allows_read? and !allows_write?
+      end
+      def write_only?()
+        !allows_read? and allows_read?
+      end
+      def allows_read?()
+        primarily_read? or allows_both?
+      end
+      def allows_write?()
+        primarily_write? or allows_both?
+      end
+      extend Forwardable
+      def_instance_delegators(:@mode,:=~,:==,:===)
+    end
+  end
+  module Mode
+    module StrMethods
+      def primarily_read?() @mode[0,1] == 'r' end
+      def primarily_write?() @mode[0,1] == 'w' or primarily_append? end
+      def primarily_append?() @mode[0,1] == 'a' end
+      def allows_both?() @mode[-1,1] == '+' end
+      def creates?() primarily_append? || primarily_write? end
+    end
+    class Str < Base
+      include StrMethods
+    end
+  end
+  module Mode
+    class Int < Base
+      def primarily_read?() 
+#        (@mode&File::RDONLY || (@mode&File::RDWR && ~(@mode&File::TRUNC)))
+      end
+      def primarily_write?() 
+#        @mode&File::WRONLY || (@mode&File::RDWR && @mode&File::TRUNC) || primarily_append? 
+      end
+      def primarily_append?() 
+#        @mode&File::APPEND
+      end
+      def allows_both?()
+#        @mode[1,-1] == '+'
+      end
+      def creates?() 
+        # primarily_append? || primarily_write? 
+      end
+    end
+  end
+end

data/lib/rio/ios/fail.rb

@@ -0,0 +1,106 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005,2006,2007 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.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
+# * RIO::Rio
+#
+
+
+require 'rio/exception/notsupported'
+
+module RIO
+  module IOS
+    module Methods
+    end
+  end
+end
+
+module RIO
+  module IOS #:nodoc: all
+    module Fail  #:nodoc: all
+      def notsupported(sym) 
+        raise RIO::Exception::NotSupported,RIO::Exception::NotSupported.emsg(sym,self)
+      end
+                                                                             
+      def <<(obj) notsupported(:<<) end
+      def binmode() notsupported(:binmode) end
+      def close() notsupported(:close) end
+      def close_read() notsupported(:close_read) end
+      def close_write() notsupported(:close_write) end
+      def closed?() notsupported(:closed?) end
+      def each(sep_string=$/,&block) notsupported(:each) end
+      def each_line(sep_string=$/,&block) notsupported(:each_line) end
+      def each_byte(sep_string=$/,&block) notsupported(:each_byte) end
+      def eof?() notsupported(:eof?) end
+      def fcntl(integer_cmd,arg) notsupported(:fcntl) end
+      def fileno() notsupported(:fileno) end
+      def to_i() notsupported(:to_i) end
+      def flush() notsupported(:flush) end
+      def fsync() notsupported(:fsync) end
+      def getc() notsupported(:getc) end
+      def gets(sep_string=$/) notsupported(:gets) end
+      def ioctl(integer_cmd,arg) notsupported(:ioctl) end
+      def isatty() notsupported(:isatty) end
+      def tty?() notsupported(:tty?) end
+      def lineno() notsupported(:lineno) end
+      def lineno=(a) notsupported(:lineno=) end
+      def pid() notsupported(:pid) end
+      def pos() notsupported(:pos) end
+      def tell() notsupported(:tell) end
+      def pos=(v) notsupported(:pos=) end
+      def print(*objs) notsupported(:print) end
+      def printf(format,*objs) notsupported(:printf) end
+      def putc(obj) notsupported(:putc) end
+      def puts(*objs) notsupported(:puts) end
+      def read(*args) notsupported(:read) end
+      def readchar() notsupported(:readchar) end
+      def readline(sep_string=$/) notsupported(:readline) end
+      def readlines(sep_string=$/) notsupported(:readlines) end
+      def readpartial(maxlen,*args)  notsupported(:readpartial) end
+      def reopen(*args) notsupported(:reopen) end
+      def rewind() notsupported(:rewind) end
+      def seek() notsupported(:seek) 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) notsupported(:write) end
+      
+      def callstr(func,*args)
+        self.class.to_s+'['+self.to_s+']'+'.'+func.to_s+'('+args.join(',')+')'
+      end
+      
+    end
+  end
+end

data/lib/rio/ios/generic.rb

@@ -0,0 +1,119 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005,2006,2007 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.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
+# * RIO::Rio
+#
+
+
+require 'rio/exception/notsupported'
+
+module RIO
+  class GenericIOMode #: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
+
+module RIO
+  module IOS #:nodoc: all
+    class Generic  #:nodoc: all
+      def initialize(el,m='r')
+      end
+      
+      def <<(obj) self end
+      def binmode() self end
+      def close() nil end
+      def close_read() nil end
+      def close_write() nil end
+      def closed?() true end
+      def each(sep_string=$/,&block) self end
+      def each_line(sep_string=$/,&block) self end
+      def each_byte(sep_string=$/,&block) nil end
+      def eof?() true end
+      def fcntl(integer_cmd,arg) nil end
+      def fileno() nil end
+      def to_i() nil end
+      def flush() self end
+      def fsync() nil end
+      def getc() nil end
+      def gets(sep_string=$/) nil end
+      def ioctl(integer_cmd,arg) nil end
+      def isatty() false end
+      def tty?() false end
+      def lineno() 0 end
+      def lineno=(a) nil end
+      def pid() nil end
+      def pos() nil end
+      def tell() nil end
+      def pos=(v) self.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(*args) nil end
+      def readchar() nil end
+      def readline(sep_string=$/) nil end
+      def readlines(sep_string=$/) [] end
+      def readpartial(maxlen,*args)  end
+      def reopen(*args) self end
+      def rewind() 0 end
+      def seek() 0 end
+      def stat() nil end
+      def sync() nil end
+      def sync=(v) nil end
+      def sysread() 0 end
+      def sysseek() 0 end
+      def syswrite() 0 end
+      def ungetc() nil end
+      def write(str) 0 end
+      
+      def callstr(func,*args)
+        self.class.to_s+'['+self.to_s+']'+'.'+func.to_s+'('+args.join(',')+')'
+      end
+      
+    end
+  end
+end