rio 0.3.8 → 0.3.9

data/lib/rio/if/yaml.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,21 +23,20 @@
 #
 # 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
   module IF
-    module YAML #:nodoc: all
+    module YAML
       #def file() target.file end
       #def dir() target.dir end
       
@@ -51,7 +50,7 @@ module RIO
       # +lines+ is the default.
       #
       # The YAML extension distingishes between items selected using
-      # Rio#records, Rio#rows and Rio#lines. Rio returns objects loaded via
+      # IF::GrandeStream#records, IF::GrandeStream#rows and IF::GrandeStream#lines. Rio returns objects loaded via
       # YAML#load when +records+ is used; returns the YAML text as a String
       # when +rows+ is used; and returns lines as Strings as normal when
       # +lines+ is used.  +records+ is the default. In yaml-mode,
@@ -93,53 +92,28 @@ module RIO
       #  }
       #  rio('afile.yaml').yaml.dump(anobject)
       #
-      # The YAML extension changes the way the grande copy operators interpret
-      # their argument. Rio#< (copy-from) and Rio#<< (append-from) treat an
-      # array as an array of objects which are converted using their #to_yaml
-      # method before writing.
       #
-      #  rio('afile.yaml').yaml < [obj1, obj2, obj3]
-      #
-      # Because of this, copying an ::Array must be done like this:
-      #
-      #  rio('afile.yaml').yaml < [anarray]
-      #
-      # If their argument is a Rio or ::IO it is iterate through as normal,
-      # with each record converted using its to_yaml method.
-      #
-      # For all other objects, the result of their +to_yaml+ operator is
-      # simply written.
-      #
-      #  rio('afile.yaml').yaml < anobject
-      #
-      # Rio#> (copy-to) and Rio#>> (append-to) will fill an array with with
-      # all selected YAML documents in the Rio. For non-arrays, the yaml text
-      # is copied. (This may change if a useful reasonable alternative can be
-      # found) rio('afile.yaml').yaml > anarray # load all YAML documents from
-      # 'afile.yaml'
-      #
-      # Single objects can be written using Rio#putrec (aliased to Rio#putobj
-      # and Rio#dump)
+      # Single objects can be written using IF::Grande#putrec (aliased to IF::YAML#putobj
+      # and IF::YAML#dump)
       #
       #  rio('afile.yaml').yaml.putobj(anobject)
       #
-      # Single objects can be loaded using Rio#getrec (aliase to Rio#getobj
-      # and Rio#load)
+      # Single objects can be loaded using IF::Grande#getrec (aliase to IF::Grande#getobj
+      # and IF::YAML#load)
       #
       #  anobject = rio('afile.yaml').yaml.getobj
       #
-      # Note that other than this redefinition of what a record is and how the
-      # copy operators interpret their argument, a Rio in yaml-mode is just
+      # A Rio in yaml-mode is just
       # like any other Rio. And all the things you can do with any Rio come
-      # for free.  They can be iterated over using #each and read into an
-      # array using #[] just like any other Rio. All the selection criteria
+      # for free.  They can be iterated over using IF::Grande#each and read into an
+      # array using IF::Grande#[] just like any other Rio. All the selection criteria
       # are identical also.
       #
       # Get the first three objects into an array:
       #
       #  array_of_objects = rio('afile.yaml').yaml[0..2]
       #
-      # Iterate over only YAML documents that are a kind_of ::Hash use:
+      # Iterate over only YAML documents that are a kind_of ::Hash:
       #
       #  rio('afile.yaml').yaml(::Hash) {|ahash| ...} 
       #
@@ -200,7 +174,7 @@ module RIO
       # Calls YAML.dump, leaving the Rio open.
       def putobj(obj) target.putobj(obj); self end
 
-      # Dumps an object to a Rio as with Rio#putobj, and closes the Rio.
+      # Dumps an object to a Rio as with IF::YAML#putobj, and closes the Rio.
       #
       #  rio('afile.yaml').yaml.putobj!(anobject)
       #
@@ -210,7 +184,7 @@ module RIO
       #
       def putobj!(obj) target.putobj!(obj); self end
 
-      # Alias for Rio#putobj!
+      # Alias for IF::YAML#putobj!
       def dump(obj) target.dump(obj); self end
 
     end

data/lib/rio/ioh.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 'fileutils'
@@ -99,9 +98,12 @@ module RIO
         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,:each_line,:gets,:getc,
+                              :each,:each_byte,:gets,:getc,
                               :read,:readlines,:readline,:sysread,
                               :<<,:print,:printf,:putc,:write,:syswrite,
                               :pos,:pos=,:lineno,:lineno=,

data/lib/rio/iomode.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>
 
 
 
@@ -81,9 +80,7 @@ module RIO
       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 allows_both?() @mode[-1,1] == '+' end
       def creates?() primarily_append? || primarily_write? end
     end
     class Str < Base
@@ -92,6 +89,21 @@ module RIO
   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

@@ -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/notsupported'
@@ -45,7 +44,7 @@ module RIO
 end
 
 module RIO
-  module IOS
+  module IOS #:nodoc: all
     module Fail  #:nodoc: all
       def notsupported(sym) 
         raise RIO::Exception::NotSupported,RIO::Exception::NotSupported.emsg(sym,self)

data/lib/rio/ios/generic.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/notsupported'
@@ -59,7 +58,7 @@ module RIO
 end
 
 module RIO
-  module IOS
+  module IOS #:nodoc: all
     class Generic  #:nodoc: all
       def initialize(el,m='r')
       end

data/lib/rio/ios/mode.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>
 
 
 require 'rio/exception/notsupported'
 
 module RIO
-  module IOS
+  module IOS #:nodoc: all
     class Mode #:nodoc: all
       def initialize(mode_string)
         @str = mode_string

data/lib/rio/ios/null.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,28 +23,27 @@
 #
 # 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/notsupported'
 require 'rio/ios/mode'
 module RIO
-  module IOS
+  module IOS #:nodoc: all
     module Methods
     end
   end
 end
 module RIO
-  module IOS
+  module IOS #:nodoc: all
     module Exception
       class NotDuplex < RIO::Exception::Base
       end
@@ -53,7 +52,7 @@ module RIO
 end
 
 module RIO
-  module IOS
+  module IOS #:nodoc: all
     class Null  #:nodoc: all
       def initialize(el=nil,m='r') 
         @lineno = 0

data/lib/rio/iowrap.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 'fileutils'

data/lib/rio/kernel.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/def'
@@ -43,7 +42,6 @@ module Kernel
     RIO::Rio.rio(*args,&block)
   end
   module_function :rio
-  alias :io :rio
 end
 
 module RIO 

data/lib/rio/local.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>