rio 0.3.8 → 0.3.9

data/lib/rio/doc/OPTIONAL.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, 2006 Christopher Kleckner
+# Copyright (c) 2005,2006,2007 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -23,16 +23,15 @@
 #
 # 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.
+# from the distribution directory.
 #
 # Suggested Reading
 # * RIO::Doc::SYNOPSIS
 # * RIO::Doc::INTRO
 # * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
 # * RIO::Rio
 #
-# <b>Rio is pre-alpha software. 
-# The documented interface and behavior is subject to change without notice.</b>
 
 
 module RIO
@@ -107,7 +106,7 @@ This option comprises 4 options
  arguments_as_rios = RIO.ARGV
 
 This option provides a function which converts each element of ruby's
-ARGV into a Rio.  Useful when writing programs that take a list of
+ARGV into a Rio.  Useful when writing a program which takes a list of
 files as its arguments
 
 == RIO.popen3

data/lib/rio/doc/SYNOPSIS.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, 2006 Christopher Kleckner
+# Copyright (c) 2005,2006,2007 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -23,22 +23,21 @@
 #
 # 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.
+# from the distribution directory.
 #
 # Suggested Reading
 # * RIO::Doc::SYNOPSIS
 # * RIO::Doc::INTRO
 # * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
 # * RIO::Rio
 #
-# <b>Rio is pre-alpha software. 
-# The documented interface and behavior is subject to change without notice.</b>
 
 
-:title: Rio
+# :title: Rio
 
 module RIO
-# Copyright (c) 2005, Christopher Kleckner.
+# Copyright (c) 2005,2006,2007 Christopher Kleckner.
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -177,6 +176,8 @@ Create a symbolic link 'asymlink' in 'adir' which refers to 'adir/afile'
 * RIO::Doc::INTRO
 * RIO::Doc::HOWTO
 * RIO::Rio
+* RIO::Doc::EXAMPLES
+* RIO::Doc::OPTIONAL
 
 =end
 module SYNOPSIS #:doc:

data/lib/rio/entrysel.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, 2006 Christopher Kleckner
+# Copyright (c) 2005,2006,2007 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -23,16 +23,15 @@
 #
 # 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.
+# from the distribution directory.
 #
 # Suggested Reading
 # * RIO::Doc::SYNOPSIS
 # * RIO::Doc::INTRO
 # * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
 # * RIO::Rio
 #
-# <b>Rio is pre-alpha software. 
-# The documented interface and behavior is subject to change without notice.</b>
 
 
 require 'rio/abstract_method'
@@ -88,7 +87,7 @@ module RIO
         end
       end
       class Proc < Base
-        def =~(entry) @match_to[entry] end
+        def =~(entry) @match_to[entry.clone] end
       end
       class Symbol < Base
         def =~(entry) entry.__send__(@match_to) end
@@ -167,43 +166,42 @@ module RIO
           @sel = @nosel = nil
           process_entry_sel() if @entry_sel
         end
-        def es_args() 
-          es = @entry_sel
-          es['args']
+        def entry_sel_args() 
+          @entry_sel['args']
         end
         def something_selected?
-          %w[entries files dirs].any? { |k| es_args.has_key?(k) }
+          %w[entries files dirs].any? { |k| entry_sel_args.has_key?(k) }
         end
         def something_skipped?
-          %w[skipentries skipfiles skipdirs].any? { |k| es_args.has_key?(k) }
+          %w[skipentries skipfiles skipdirs].any? { |k| entry_sel_args.has_key?(k) }
         end
         def skip_type(skip_args)
           
         end
         def process_entry_sel()
-          ea = es_args
-          raise RuntimeError, "Internal error: entry_sel_args not set" unless ea
+          sel_args = self.entry_sel_args
+          raise RuntimeError, "Internal error: entry_sel_args not set" unless sel_args
           if something_selected?
             @sel = Match::Entry::Sels.new 
-            @sel << Match::Entry::List.new(:true?,*ea['entries']) if ea.has_key?('entries')
-            @sel << Match::Entry::List.new(:file?,*ea['files']) if ea.has_key?('files')
-            @sel << Match::Entry::List.new(:dir?,*ea['dirs']) if ea.has_key?('dirs')
+            @sel << Match::Entry::List.new(:true?,*sel_args['entries']) if sel_args.has_key?('entries')
+            @sel << Match::Entry::List.new(:file?,*sel_args['files']) if sel_args.has_key?('files')
+            @sel << Match::Entry::List.new(:dir?,*sel_args['dirs']) if sel_args.has_key?('dirs')
           end
           if something_skipped?
             @nosel = Match::Entry::Sels.new 
-            if ea.has_key?('skipentries')
-              @nosel << Match::Entry::List.new(:true?,*ea['skipentries'])
+            if sel_args.has_key?('skipentries')
+              @nosel << Match::Entry::List.new(:true?,*sel_args['skipentries'])
             end
-            if ea.has_key?('skipfiles')
-              @nosel << Match::Entry::List.new(:file?,*ea['skipfiles'])
-              unless ea['skipfiles'].empty? or ea.has_key?('files')
+            if sel_args.has_key?('skipfiles')
+              @nosel << Match::Entry::List.new(:file?,*sel_args['skipfiles'])
+              unless sel_args['skipfiles'].empty? or sel_args.has_key?('files')
                 @sel ||= Match::Entry::Sels.new 
                 @sel << Match::Entry::List.new(:file?)
               end
             end
-            if ea.has_key?('skipdirs')
-              @nosel << Match::Entry::List.new(:dir?,*ea['skipdirs'])
-              unless ea['skipdirs'].empty? or ea.has_key?('dirs')
+            if sel_args.has_key?('skipdirs')
+              @nosel << Match::Entry::List.new(:dir?,*sel_args['skipdirs'])
+              unless sel_args['skipdirs'].empty? or sel_args.has_key?('dirs')
                 @sel ||= Match::Entry::Sels.new 
                 @sel << Match::Entry::List.new(:dir?)
               end

data/lib/rio/exception.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, 2006 Christopher Kleckner
+# Copyright (c) 2005,2006,2007 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -23,16 +23,15 @@
 #
 # 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.
+# from the distribution directory.
 #
 # Suggested Reading
 # * RIO::Doc::SYNOPSIS
 # * RIO::Doc::INTRO
 # * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
 # * RIO::Rio
 #
-# <b>Rio is pre-alpha software. 
-# The documented interface and behavior is subject to change without notice.</b>
 
 
 module RIO

data/lib/rio/exception/copy.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, 2006 Christopher Kleckner
+# Copyright (c) 2005,2006,2007 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -23,16 +23,15 @@
 #
 # 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.
+# from the distribution directory.
 #
 # Suggested Reading
 # * RIO::Doc::SYNOPSIS
 # * RIO::Doc::INTRO
 # * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
 # * RIO::Rio
 #
-# <b>Rio is pre-alpha software. 
-# The documented interface and behavior is subject to change without notice.</b>
 
 
 require 'rio/exception'

data/lib/rio/exception/notimplemented.rb

@@ -0,0 +1,57 @@
+#--
+# =============================================================================== 
+# 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'
+module RIO
+  module Exception  
+    class MethodNotImplemented < ::NotImplementedError #:nodoc: all
+    end
+  end
+end
+
+module RIO
+  module Error  #:nodoc: all
+    module NotImplemented
+      def nodef(*args) 
+        method_name = Kernel.caller[0].match(/(?:.+):in \`(.+)\'$/)[1]
+        class_name = self.class.to_s
+        call_str = "#{class_name}.#{method_name}(#{args.join(',')})"
+        raise(RIO::Exception::MethodNotImplemented, "\n#{call_str} is not implemented\n")
+      end 
+    end
+  end
+end
+

data/lib/rio/exception/notsupported.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, 2006 Christopher Kleckner
+# Copyright (c) 2005,2006,2007 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -23,16 +23,15 @@
 #
 # 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.
+# from the distribution directory.
 #
 # Suggested Reading
 # * RIO::Doc::SYNOPSIS
 # * RIO::Doc::INTRO
 # * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
 # * RIO::Rio
 #
-# <b>Rio is pre-alpha software. 
-# The documented interface and behavior is subject to change without notice.</b>
 
 
 require 'rio/exception'

data/lib/rio/exception/open.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, 2006 Christopher Kleckner
+# Copyright (c) 2005,2006,2007 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -23,16 +23,15 @@
 #
 # 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.
+# from the distribution directory.
 #
 # Suggested Reading
 # * RIO::Doc::SYNOPSIS
 # * RIO::Doc::INTRO
 # * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
 # * RIO::Rio
 #
-# <b>Rio is pre-alpha software. 
-# The documented interface and behavior is subject to change without notice.</b>
 
 
 require 'rio/exception'

data/lib/rio/exception/state.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, 2006 Christopher Kleckner
+# Copyright (c) 2005,2006,2007 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -23,16 +23,15 @@
 #
 # 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.
+# from the distribution directory.
 #
 # Suggested Reading
 # * RIO::Doc::SYNOPSIS
 # * RIO::Doc::INTRO
 # * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
 # * RIO::Rio
 #
-# <b>Rio is pre-alpha software. 
-# The documented interface and behavior is subject to change without notice.</b>
 
 
 require 'rio/exception'

data/lib/rio/ext.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, 2006 Christopher Kleckner
+# Copyright (c) 2005,2006,2007 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -23,19 +23,19 @@
 #
 # 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.
+# from the distribution directory.
 #
 # Suggested Reading
 # * RIO::Doc::SYNOPSIS
 # * RIO::Doc::INTRO
 # * RIO::Doc::HOWTO
+# * RIO::Doc::EXAMPLES
 # * RIO::Rio
 #
-# <b>Rio is pre-alpha software. 
-# The documented interface and behavior is subject to change without notice.</b>
 
 
 require 'rio/ext/csv'
+require 'rio/ext/splitlines'
 require 'rio/ext/yaml'
 #require 'rio/ext/zipfile'
 
@@ -64,12 +64,52 @@ module RIO
   end
 end
 
+module RIO
+  module Ext #:nodoc: all
+    class Extension
+      def initialize(etest,mod)
+        @inc = { 
+          'cx' => mod+'::Cx',
+          'input' => mod+'::Input',
+          'output' => mod+'::Output',
+        }
+      end
+      def add(obj,state)
+        case state
+          when 'Stream::Input' then obj.extend(@inc['input'])
+          when 'Stream::Output' then obj.extend(@inc['output'])
+        end
+      end
+      
+    end
+  end
+end
+module RIO
+  module Ext #:nodoc: all
+    class Extensions
+      def initialize()
+        #@ext
+        @inc = { 
+          'cx' => mod+'::Cx',
+          'input' => mod+'::Input',
+          'output' => mod+'::Output',
+        }
+      end
+      def add(obj)
+        
+      end
+    end
+  end
+end
+
+
 module RIO
   module Ext #:nodoc: all
     OUTPUT_SYMS = Util::build_sym_hash(CSV::Output.instance_methods + YAML::Output.instance_methods)
 
     module Cx
       include CSV::Cx
+      include SplitLines::Cx
       include YAML::Cx
       #include ZipFile::Cx
     end
@@ -77,16 +117,9 @@ module RIO
   module Ext
     module Input
       def add_extensions(obj)
-        #p "add_extensions(#{obj.inspect})"
-        #p obj.ioh
-        if obj.csv?
-          obj.extend(CSV::Input)
-        end
+        obj.extend(CSV::Input) if obj.csv?
+        obj.extend(SplitLines::Input) if obj.splitlines?
         obj.extend(YAML::Input) if obj.yaml?
-#        if obj.zipfile?
-#          require 'rio/ext/zipfile/state'
-#          obj.extend(ZipFile::Input) 
-#        end
         obj
       end
       module_function :add_extensions
@@ -94,6 +127,7 @@ module RIO
     module Output
       def add_extensions(obj)
         obj.extend(CSV::Output) if obj.csv?
+        obj.extend(SplitLines::Output) if obj.splitlines?
         obj.extend(YAML::Output) if obj.yaml?
         obj
       end