rio 0.3.1

data/lib/rio/scheme/stderr.rb

@@ -0,0 +1,56 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 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
+#  rake rdoc
+# 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
+  module StdErr #:nodoc: all
+    require 'rio/rl/ioi'
+    RESET_STATE = RL::IOIBase::RESET_STATE
+    
+    class RL < RL::SysIOBase 
+      RIOSCHEME = 'stderr'
+      RIOPATH = RIO::RL::CHMAP.invert[RIOSCHEME].freeze
+      def initialize()
+        super($stderr)
+      end
+      def opaque() '' end
+      def open(*args)
+        self.ios = $stderr
+        super()
+      end
+    end
+  end
+end

data/lib/rio/scheme/stdio.rb

@@ -0,0 +1,71 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 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
+#  rake rdoc
+# 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
+  module StdIO #:nodoc: all
+    require 'rio/rl/ioi'
+    RESET_STATE = RL::IOIBase::RESET_STATE
+
+    class RL < RL::SysIOBase 
+      RIOSCHEME = 'stdio'
+      RIOPATH = RIO::RL::CHMAP.invert[RIOSCHEME].freeze
+      attr_reader :scheme
+      def initialize(sch=RIOSCHEME)
+        @scheme = sch
+      end
+      def opaque() '' end
+      require 'rio/iomode'
+      def open(m)
+        case 
+        when m.primarily_read? 
+          @scheme = 'stdin'
+          self.ios = $stdin.clone
+        when m.primarily_write? 
+          @scheme = 'stdout'
+          self.ios = $stdout.clone
+        else 
+          raise ArgumentError,sprintf("Can not %s a %s with mode '%s'",'open',self.class,m)
+        end
+        super()
+      end
+      def close()
+        @scheme = RIOSCHEME
+        self.ios = nil
+      end
+    end
+  end
+end

data/lib/rio/scheme/strio.rb

@@ -0,0 +1,82 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 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
+#  rake rdoc
+# 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/rl/ioi'
+require 'stringio'
+require 'rio/stream'
+require 'rio/stream/open'
+
+module RIO
+  module StrIO #:nodoc: all
+    RESET_STATE = 'StrIO::Stream::Open'
+
+    class RL < RL::IOIBase 
+      RIOSCHEME = 'strio'
+      RIOPATH = RIO::RL::CHMAP.invert[RIOSCHEME].freeze
+      def initialize(str="")
+        @str = str
+      end
+      def open(m,*args)
+        ::StringIO.new(@str,m.to_s,*args)
+      end
+    end
+    module Stream
+      class Open < RIO::Stream::Open
+        def input() stream_state('StrIO::Stream::Input') end
+        def output() stream_state('StrIO::Stream::Output') end
+        def inout() stream_state('StrIO::Stream::InOut') end
+      end
+
+      module Ops
+        def string() ioh.string end
+        def string=(p1) ioh.string = p1 end
+      end
+
+      class Input < RIO::Stream::Input
+        include Ops
+      end
+
+      class Output < RIO::Stream::Output
+        include Ops
+      end
+
+      class InOut < RIO::Stream::InOut
+        include Ops
+      end
+    end
+  end
+end

data/lib/rio/scheme/sysio.rb

@@ -0,0 +1,61 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 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
+#  rake rdoc
+# 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
+  module SysIO #:nodoc: all
+    require 'rio/rl/ioi'
+    RESET_STATE = RL::IOIBase::RESET_STATE
+
+    class RL < RL::SysIOBase
+      RIOSCHEME = 'sysio'
+      RIOPATH = RIO::RL::CHMAP.invert[RIOSCHEME].freeze
+      def opaque() sprintf('0x%08x',self.ios.object_id) end
+      # must be able to process both
+      # parse('rio:sysio',ios)
+      # parse('rio:sysio:0xHEXIOS')
+      SPLIT_RE = %r|0x([0-9a-fA-F]+)$|
+      def self.splitrl(s)
+        sub,opq,whole = split_riorl(s)
+        if bm = SPLIT_RE.match(opq)
+          oid = bm[1].hex
+          ios = ObjectSpace._id2ref(oid)
+          [ios]
+        end
+      end
+    end
+  end
+end

data/lib/rio/scheme/tcp.rb

@@ -0,0 +1,74 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 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
+#  rake rdoc
+# 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/rl/base'
+module RIO
+  module TCP #:nodoc: all
+    RESET_STATE = 'Stream::Duplex::Open'
+    require 'rio/rl/ioi'
+    class RL < RL::IOIBase 
+      RIOSCHEME = 'tcp'.freeze
+      def initialize(host,port)
+        @host = host
+        @port = port
+      end
+      def opaque()
+        sprintf('//%s:%s',@host,@port)
+      end
+      require 'socket'
+      def open(*args)
+        #          @host = 'localhost' if @host.nil? or @host.empty?
+        ::TCPSocket.new(@host || 'localhost',@port)
+      end
+      def to_s() self.url end
+      
+      # must be able to process
+      # parse('rio:tcp',host,port)
+      # parse('rio:tcp://host:port')
+      SPLIT_RE = %r|//([^/:]*):([0-9a-z]+)$|.freeze
+      def self.splitrl(s)
+        sub,opq,whole = split_riorl(s)
+        if bm = SPLIT_RE.match(opq)
+          host = bm[1]
+          port = bm[2]
+          host = nil if host.empty?
+          [host,port]
+        end
+      end
+    end
+  end
+end

data/lib/rio/scheme/tempfile.rb

@@ -0,0 +1,104 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 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
+#  rake rdoc
+# 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
+  module Tempfile #:nodoc: all
+    require 'rio/rl/ioi'
+    require 'rio/scheme/path'
+    RESET_STATE = RL::IOIBase::RESET_STATE
+
+    require 'tmpdir'
+    class RL < RL::IOIBase 
+      RIOSCHEME = 'tempfile'
+      RIOPATH = RIO::RL::CHMAP.invert[RIOSCHEME]
+      DFLT_PREFIX = 'rio'
+      DFLT_TMPDIR = '/tmp' # ::Dir::tmpdir
+      attr_reader :prefix,:tmpdir,:tmprl
+      def initialize(file_prefix=DFLT_PREFIX,temp_dir=DFLT_TMPDIR)
+        @prefix = file_prefix || DFLT_PREFIX
+        @tmpdir = RIO::Path::RL.new(temp_dir || DFLT_TMPDIR)
+        @tmprl = nil
+      end
+      def path()
+        return @tmprl.path unless @tmprl.nil?
+        RIOPATH
+      end
+      def fspath() 
+        return nil if @tmprl.nil?
+        self.class.path_to_fspath(self.path)
+      end
+      def uri()
+        return @tmprl.uri unless @tmprl.nil?
+        nil
+      end
+      def url()
+        return @tmprl.url unless @tmprl.nil?
+        super
+      end
+      def opaque()
+        td = @tmpdir.to_s
+        td += '/' unless td.nil? or td.empty? or (td.ends_with?('/') and td != '/')
+        td+@prefix
+        end
+      def open(mode='ignored',tf=nil,td=nil)
+        require 'tempfile'
+        tf ||= @prefix
+        td ||= @tmpdir
+        hnd = ::Tempfile.new( tf.to_s, td.to_s)
+        @tmprl = RIO::Path::RL.new(RIO::RL::fs2url(hnd.path))
+        hnd
+      end
+      def close()
+        @tmprl = nil
+      end
+      SPLIT_RE = %r|(?:(.*)/)?([^/]*)$|.freeze
+      def self.splitrl(s)
+        sub,opq,whole = split_riorl(s)
+        if opq.nil? or opq.empty?
+          []
+        elsif bm = SPLIT_RE.match(opq)
+          tdir = bm[1] unless bm[1].nil? or bm[1].empty?
+          tpfx = bm[2] unless bm[2].nil? or bm[2].empty?
+          [tpfx,tdir]
+        else
+          []
+        end
+      end
+    end
+  end
+end