rio 0.3.1

data/lib/rio/scheme/aryio.rb

@@ -0,0 +1,89 @@
+#--
+# =============================================================================== 
+# 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 'rio/arrayio'
+require 'rio/stream'
+require 'rio/stream/open'
+
+module RIO
+  module AryIO #:nodoc: all
+
+    class RL < RL::IOIBase 
+      RIOSCHEME = 'aryio'
+      RIOPATH = RIO::RL::CHMAP.invert[RIOSCHEME].freeze
+      def initialize(ary=[])
+        #p "#{callstr('initialize',ary.inspect)}"
+        @ary = ary
+      end
+      def open(m,*args)
+        #p "#{callstr('open',m,args.inspect)} ary=#{@ary.inspect}"
+        @ary = args.shift unless args.empty?
+        #p "#{callstr('open',m,args)} ary=#{@ary.inspect}"
+        RIO::ArrayIO.new(@ary,m.to_s,*args)
+      end
+    end
+    module Stream
+      module Ops
+        def array() ioh.array end
+        def array=(p1)
+          ioh.array = p1 
+        end
+      end
+      class Open < RIO::Stream::Open
+        include Ops
+        def input() stream_state('AryIO::Stream::Input') end
+        def output() stream_state('AryIO::Stream::Output') end
+        def inout() stream_state('AryIO::Stream::InOut') 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
+    RESET_STATE = 'AryIO::Stream::Open'
+  end
+end

data/lib/rio/scheme/cmdio.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>
+
+
+module RIO
+  module CmdIO #:nodoc: all
+    require 'rio/rl/ioi'
+    RESET_STATE = 'Stream::Duplex::Open'
+
+    class RL < RL::SysIOBase 
+      RIOSCHEME = 'cmdio'
+      RIOPATH = RIO::RL::CHMAP.invert[RIOSCHEME].freeze
+      def initialize(cmd="")
+        @cmd = cmd
+      end
+      def opaque() 
+        URI.escape(@cmd,RIO::RL::ESCAPE)
+      end
+      def to_s()
+        @cmd
+      end
+      def open(m)
+        ::IO.popen(@cmd,m.to_s)
+      end
+
+      # must be able to process
+      # parse('rio:cmdio',cmd)
+      # parse('rio:cmdio:escaped_cmd')
+      SPLIT_RE = %r|(?:(.+))$|.freeze
+      def self.splitrl(s)
+        sub,opq,whole = split_riorl(s)
+        if bm = SPLIT_RE.match(opq)
+          escaped_cmd = bm[1]
+          cmd = URI.unescape(escaped_cmd)
+          [cmd]
+        end
+      end
+
+    end
+  end
+end

data/lib/rio/scheme/fd.rb

@@ -0,0 +1,65 @@
+#--
+# =============================================================================== 
+# 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 FD #:nodoc: all
+    require 'rio/rl/ioi'
+    RESET_STATE = RL::IOIBase::RESET_STATE
+
+    class RL < RL::SysIOBase
+      RIOSCHEME = 'fd'
+      RIOPATH = RIO::RL::CHMAP.invert[RIOSCHEME].freeze
+      def initialize(fd)
+        @fd = fd
+      end
+      def open(m,*args)
+        ::IO.new(@fd,m.to_s)
+      end
+      def opaque() "#{@fd}" end
+      # must be able to process
+      # parse('rio:fd:<number>')
+      SPLIT_RE = %r|(\d+)$|
+      def self.splitrl(s)
+        sub,opq,whole = split_riorl(s)
+        if bm = SPLIT_RE.match(opq)
+          fd = bm[1].to_i
+          [fd]
+        end
+      end
+    end
+  end
+end

data/lib/rio/scheme/ftp.rb

@@ -0,0 +1,73 @@
+#--
+# =============================================================================== 
+# 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 'net/ftp'
+require 'open-uri'
+require 'rio/ftp/conn'
+
+module RIO
+  module FTP #:nodoc: all
+    RESET_STATE = 'FTP::State::Reset'
+    
+    require 'rio/rl/uri'
+
+    class RL < RIO::RL::URIBase
+      def self.splitrl(s) 
+        sub,opq,whole = split_riorl(s)
+        [whole] 
+      end
+      def to_s() self.url end
+      def scheme() self.uri.scheme end
+      def open(*args)
+        RIO::FTP::Conn.new(@uri)
+      end
+    end
+    module Stream
+      class RL < RIO::RL::URIBase
+        def self.splitrl(s) 
+          sub,opq,whole = split_riorl(s)
+          [whole] 
+        end
+        def to_s() self.url end
+        def scheme() self.uri.scheme end
+        def open(*args)
+          @uri.open
+        end
+      end
+    end
+  end
+end

data/lib/rio/scheme/http.rb

@@ -0,0 +1,81 @@
+#--
+# =============================================================================== 
+# 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 HTTP #:nodoc: all
+    RESET_STATE = 'HTTP::Stream::Open'
+    
+    require 'rio/rl/uri'
+    class RL < RIO::RL::URIBase
+      def self.splitrl(s) 
+        sub,opq,whole = split_riorl(s)
+        [whole] 
+      end
+      def to_s() self.url end
+      def scheme() self.uri.scheme end
+      require 'open-uri'
+      def open(*args)
+        self.uri.open
+      end
+    end
+
+    module Stream
+
+      require 'rio/stream/open'
+      require 'rio/ops/path'
+      class Open < RIO::Stream::Open
+        include Ops::Path::Status
+        include Ops::Path::URI
+        include Ops::Path::Query
+        def input() 
+          self.rl.base = self.ioh.base_uri
+          stream_state('HTTP::Stream::Input') 
+        end
+      end
+
+      require 'rio/stream'
+      class Input < RIO::Stream::Input
+        include Ops::Path::Status
+        include Ops::Path::URI
+        include Ops::Path::Query
+        extend Forwardable
+        def_instance_delegators(:ioh,:meta,:status,:charset,:content_encoding,:content_type,:last_modified,:base_uri)
+      end
+
+    end
+  end 
+end # module RIO

data/lib/rio/scheme/path.rb

@@ -0,0 +1,100 @@
+#--
+# =============================================================================== 
+# 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/path'
+module RIO
+  module Path #:nodoc: all
+    RESET_STATE = RL::PathBase::RESET_STATE
+
+    class RL < RL::PathBase 
+    end
+  end
+  module File
+    RESET_STATE = RL::PathBase::RESET_STATE
+
+    class RL < RL::PathBase 
+      def open(m)
+        ::File.open(self.fspath,m.to_s)
+      end
+    end
+  end
+  module Dir
+    RESET_STATE = RL::PathBase::RESET_STATE
+
+    class RL < RL::PathBase 
+      def open()
+        ::Dir.open(self.fspath)
+      end
+    end
+  end
+  require 'rio/stream'
+  require 'rio/stream/open'
+  require 'rio/ops/symlink'
+  module Path
+    module Stream
+      class Open < RIO::Stream::Open
+        include Ops::Path::Status
+        include Ops::Path::URI
+        include Ops::Path::Query
+        def stream_state(cl)
+          next_state = super
+          next_state.extend(RIO::Ops::Symlink::Existing) if symlink?
+          next_state
+        end
+        def input() stream_state('Path::Stream::Input') end
+        def output() stream_state('Path::Stream::Output') end
+        def inout() stream_state('Path::Stream::InOut') end
+      end
+
+      module Ops
+        include RIO::Ops::Path::Str
+      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