RubyGems - rio - Versions diffs - 0.3.8 → 0.3.9 - Mend

rio 0.3.8 → 0.3.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (223) hide show

data/README +18 -12
data/Rakefile +57 -87
data/build_doc.rb +19 -17
data/doc/ANNOUNCE +3 -32
data/doc/RELEASE_NOTES +4 -5
data/doc/RIOIS +215 -0
data/doc/generators/template/html/rio.css +428 -0
data/doc/generators/template/html/rio.rb +18 -389
data/doc/generators/template/html/ugly.rb +130 -0
data/doc/pkg_def.rb +66 -0
data/ex/catcsv.rb +64 -0
data/ex/colx.rb +8 -0
data/ex/findinruby +15 -0
data/ex/findruby +14 -0
data/ex/passwd_report.rb +8 -0
data/ex/prompt.rb +25 -0
data/ex/rgb.txt.gz +0 -0
data/ex/riocat +42 -0
data/ex/riogunzip +31 -0
data/ex/riogzip +24 -0
data/ex/rioprompt.rb +10 -0
data/ex/targz2zip +17 -0
data/ex/tonl +10 -0
data/lib/rio.rb +16 -10
data/lib/rio/abstract_method.rb +3 -4
data/lib/rio/argv.rb +3 -4
data/lib/rio/arycopy.rb +3 -4
data/lib/rio/assert.rb +3 -4
data/lib/rio/base.rb +3 -4
data/lib/rio/callstr.rb +3 -4
data/lib/rio/const.rb +3 -4
data/lib/rio/construct.rb +3 -4
data/lib/rio/constructor.rb +12 -8
data/lib/rio/context.rb +15 -30
data/lib/rio/context/autoclose.rb +3 -4
data/lib/rio/context/copying.rb +3 -4
data/lib/rio/context/cxx.rb +3 -4
data/lib/rio/context/dir.rb +3 -4
data/lib/rio/context/gzip.rb +3 -4
data/lib/rio/context/methods.rb +16 -5
data/lib/rio/context/skip.rb +3 -4
data/lib/rio/context/stream.rb +42 -5
data/lib/rio/cp.rb +7 -7
data/lib/rio/def.rb +3 -4
data/lib/rio/dir.rb +3 -4
data/lib/rio/doc.rb +4 -5
data/lib/rio/doc/EXAMPLES.rb +299 -0
data/lib/rio/doc/HOWTO.rb +3 -4
data/lib/rio/doc/INTRO.rb +86 -105
data/lib/rio/doc/OPTIONAL.rb +4 -5
data/lib/rio/doc/SYNOPSIS.rb +7 -6
data/lib/rio/entrysel.rb +21 -23
data/lib/rio/exception.rb +3 -4
data/lib/rio/exception/copy.rb +3 -4
data/lib/rio/exception/notimplemented.rb +57 -0
data/lib/rio/exception/notsupported.rb +3 -4
data/lib/rio/exception/open.rb +3 -4
data/lib/rio/exception/state.rb +3 -4
data/lib/rio/ext.rb +47 -13
data/lib/rio/ext/csv.rb +4 -5
data/lib/rio/ext/if.rb +45 -0
data/lib/rio/ext/mp3info.rb +80 -0
data/lib/rio/ext/splitlines.rb +253 -0
data/lib/rio/ext/yaml.rb +9 -5
data/lib/rio/ext/yaml/doc.rb +133 -0
data/lib/rio/ext/yaml/tie.rb +149 -0
data/lib/rio/ext/zipfile.rb +23 -4
data/lib/rio/ext/zipfile/fs.rb +116 -0
data/lib/rio/ext/zipfile/rl.rb +251 -0
data/lib/rio/ext/zipfile/rootdir.rb +117 -0
data/lib/rio/ext/zipfile/state.rb +161 -0
data/lib/rio/ext/zipfile/wrap.rb +204 -0
data/lib/rio/factory.rb +235 -27
data/lib/rio/file.rb +4 -4
data/lib/rio/filter.rb +3 -4
data/lib/rio/filter/closeoneof.rb +3 -4
data/lib/rio/filter/gzip.rb +9 -4
data/lib/rio/fs/base.rb +3 -4
data/lib/rio/fs/impl.rb +4 -5
data/lib/rio/fs/native.rb +3 -4
data/lib/rio/fs/stream.rb +3 -4
data/lib/rio/fs/url.rb +3 -4
data/lib/rio/ftp/conncache.rb +19 -5
data/lib/rio/ftp/dir.rb +3 -4
data/lib/rio/ftp/fs.rb +30 -24
data/lib/rio/grande.rb +27 -7
data/lib/rio/handle.rb +3 -4
data/lib/rio/if.rb +19 -15
data/lib/rio/if/basic.rb +7 -7
data/lib/rio/if/csv.rb +5 -6
data/lib/rio/if/dir.rb +120 -114
data/lib/rio/if/file.rb +52 -44
data/lib/rio/if/fileordir.rb +217 -211
data/lib/rio/if/grande.rb +674 -644
data/lib/rio/if/grande_entry.rb +321 -313
data/lib/rio/if/grande_stream.rb +653 -553
data/lib/rio/if/internal.rb +3 -4
data/lib/rio/if/path.rb +425 -426
data/lib/rio/if/rubyio.rb +681 -0
data/lib/rio/if/string.rb +42 -5
data/lib/rio/if/temp.rb +3 -4
data/lib/rio/if/test.rb +245 -238
data/lib/rio/if/yaml.rb +15 -41
data/lib/rio/ioh.rb +7 -5
data/lib/rio/iomode.rb +19 -7
data/lib/rio/ios/fail.rb +4 -5
data/lib/rio/ios/generic.rb +4 -5
data/lib/rio/ios/mode.rb +4 -5
data/lib/rio/ios/null.rb +6 -7
data/lib/rio/iowrap.rb +3 -4
data/lib/rio/kernel.rb +3 -5
data/lib/rio/local.rb +3 -4
data/lib/rio/match.rb +3 -4
data/lib/rio/matchrecord.rb +3 -4
data/lib/rio/no_warn.rb +3 -4
data/lib/rio/nullio.rb +3 -4
data/lib/rio/open3.rb +4 -5
data/lib/rio/ops/construct.rb +3 -4
data/lib/rio/ops/create.rb +11 -6
data/lib/rio/ops/dir.rb +19 -8
data/lib/rio/ops/either.rb +6 -5
data/lib/rio/ops/file.rb +3 -4
data/lib/rio/ops/path.rb +14 -35
data/lib/rio/ops/stream.rb +3 -4
data/lib/rio/ops/stream/input.rb +4 -7
data/lib/rio/ops/stream/output.rb +3 -4
data/lib/rio/ops/stream/read.rb +6 -5
data/lib/rio/ops/stream/write.rb +3 -4
data/lib/rio/ops/symlink.rb +3 -4
data/lib/rio/path.rb +22 -18
data/lib/rio/path/reset.rb +4 -5
data/lib/rio/piper.rb +3 -4
data/lib/rio/piper/cp.rb +3 -4
data/lib/rio/prompt.rb +10 -5
data/lib/rio/rectype.rb +5 -5
data/lib/rio/rl/base.rb +17 -71
data/lib/rio/rl/builder.rb +14 -38
data/lib/rio/rl/chmap.rb +66 -0
data/lib/rio/rl/fs2url.rb +82 -0
data/lib/rio/rl/ioi.rb +4 -4
data/lib/rio/rl/path.rb +44 -122
data/lib/rio/rl/pathmethods.rb +19 -8
data/lib/rio/rl/uri.rb +137 -60
data/lib/rio/rl/withpath.rb +295 -0
data/lib/rio/scheme/aryio.rb +3 -4
data/lib/rio/scheme/cmdio.rb +3 -4
data/lib/rio/scheme/cmdpipe.rb +4 -4
data/lib/rio/scheme/fd.rb +3 -4
data/lib/rio/scheme/ftp.rb +7 -7
data/lib/rio/scheme/http.rb +4 -5
data/lib/rio/scheme/null.rb +3 -4
data/lib/rio/scheme/path.rb +3 -4
data/lib/rio/scheme/stderr.rb +3 -4
data/lib/rio/scheme/stdio.rb +3 -4
data/lib/rio/scheme/strio.rb +3 -4
data/lib/rio/scheme/sysio.rb +3 -4
data/lib/rio/scheme/tcp.rb +3 -4
data/lib/rio/scheme/temp.rb +6 -6
data/lib/rio/state.rb +18 -46
data/lib/rio/state/error.rb +3 -4
data/lib/rio/stream.rb +4 -4
data/lib/rio/stream/base.rb +3 -4
data/lib/rio/stream/duplex.rb +3 -4
data/lib/rio/stream/open.rb +3 -8
data/lib/rio/symantics.rb +3 -4
data/lib/rio/tempdir.rb +2 -2
data/lib/rio/to_rio.rb +3 -4
data/lib/rio/to_rio/all.rb +3 -4
data/lib/rio/to_rio/array.rb +4 -5
data/lib/rio/to_rio/io.rb +4 -5
data/lib/rio/to_rio/object.rb +4 -5
data/lib/rio/to_rio/string.rb +4 -5
data/lib/rio/uri/file.rb +41 -5
data/lib/rio/util.rb +3 -4
data/lib/rio/version.rb +4 -5
data/setup.rb +368 -339
data/test/bin/list_dir.rb +1 -1
data/test/ftp/anon_misc.rb +13 -1
data/test/ftp/anon_special.rb +6 -6
data/test/ftp/anon_write.rb +10 -3
data/test/ftp/ftp2ftp.rb +2 -2
data/test/ftp/testdef.rb +9 -6
data/test/http/all.rb +3 -0
data/test/http/copy-from-http.rb +140 -0
data/test/lib/temp_server.rb +44 -0
data/test/runalltests.rb +3 -1
data/test/runhttp.rb +12 -0
data/test/runhttptests.rb +1 -1
data/test/runtests.rb +41 -3
data/test/tc/abs.rb +9 -5
data/test/tc/all.rb +9 -4
data/test/tc/base.rb +1 -1
data/test/tc/base2.rb +87 -0
data/test/tc/{methods.rb → clone.rb} +72 -50
data/test/tc/closeoncopy.rb +13 -2
data/test/tc/copy-dir-samevar.rb +91 -0
data/test/tc/dir_iter.rb +0 -1
data/test/tc/empty.rb +6 -2
data/test/tc/expand_path.rb +36 -54
data/test/tc/ext.rb +42 -18
data/test/tc/gzip.rb +30 -3
data/test/tc/likeio.rb +5 -1
data/test/tc/line_record_row.rb +51 -0
data/test/tc/noqae.rb +71 -70
data/test/tc/path_parts.rb +175 -0
data/test/tc/programs_util.rb +3 -3
data/test/tc/rename.rb +4 -5
data/test/tc/riorl.rb +9 -7
data/test/tc/skip.rb +35 -6
data/test/tc/skiplines.rb +34 -5
data/test/tc/split.rb +8 -50
data/test/tc/splitlines.rb +65 -0
data/test/tc/splitpath.rb +83 -0
data/test/tc/testcase.rb +1 -1
data/test/tc/truncate.rb +39 -0
data/test/tc/yaml.rb +9 -8
metadata +261 -207
data/ChangeLog +0 -1418
data/VERSION +0 -1
data/lib/rio/doc/MISC.rb +0 -259
data/lib/rio/if/stream.rb +0 -680
data/lib/rio/impl/path.rb +0 -87
data/test/tc/copy-from-http.rb +0 -89

data/lib/rio/if/internal.rb CHANGED

@@ -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/if/path.rb CHANGED

@@ -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,441 +23,440 @@
 #
 # 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
-  class Rio
-    # Returns the path for the Rio, which is defined differently for different types of Rios.
-    #
-    # For Rios representing paths on the underlying file system this is an alias
-    # Rio#fspath. For Rios with paths that are not on the file system this is an
-    # alias for Rio#urlpath.
-    #
-    # Otherwise this returns nil.
-    #
-    def path(*args) target.path(*args) end
-    # For resources that have a absolute URL (RFC1738) representation,
-    # this returns a string containing that representation.
-    # For objects that do not this returns a RIORL (a descriptive pseudo-URL).
-    #
-    #  rio('/var/www/')                  #=> "file:///var/www/"
-    #  rio('http://rio.rubyforge.org/')  #=> "http://rio.rubyforge.org"
-    #
-    def to_url() target.to_url end
-    # For resources that have a URL (RFC1738) representation, this returns a
-    # URI object referencing it.  Otherwise this raises NoMethodError.
-    #
-    #  rio('http://rubyforge.org/').to_uri     #=> <URI::HTTP:0x818bd84 URL:http://rubyforge.org/>
-    #  rio('adir/afile').to_uri                #=> <URI::Generic:0x817d288 URL:adir/afile>
-    #
-    def to_uri() target.to_uri end
-    # Returns the path for the Rio on the underlying file system
-    # Returns nil if the Rio is not on the filesystem (i.e. stdin: or http: Rios)
-    def fspath() target.fspath() end
-    # Returns the path portion of the URL representation of the rio
-    # Returns nil if the Rio URL has no path (i.e. stdin: or http: Rios)
-    def urlpath() target.urlpath() end
-    # Proxy for File#expand_path
-    #
-    # Converts a pathname to an absolute pathname.
-    # Relative paths are referenced from the current working directory of the process
-    # unless dir_string is given, in which case it will be used as the starting point.
-    # The given pathname may start with a ``~��, which expands to the process owner�s
-    # home directory (the environment variable HOME must be set correctly).
-    # ``~user�� expands to the named user�s home directory.
-    #
-    # Returns a Rio representing the returned path
-    #
-    #
-    def expand_path(*args) target.expand_path(*args) end
-    # Returns a new rio with a path equal to the absolute path of this rio
-    #
-    #  rio('/tmp').chdir
-    #  rio('afile').abs # => rio('/tmp/afile')
-    def abs(*args) target.abs(*args)  end
-    # Returns a new rio with a path equal to the relative path from _other_
-    #  rio('/tmp/afile').rel('/tmp')   #=> rio('afile')
-    #  rio('zippy/afile').rel('zippy') #=> rio('afile')
-    #
-    def rel(other=nil) target.rel(other)  end
-    # Returns a new Rio whose path is the base path that is used by
-    # Rio#abs to create an absolute Rio from a relative one.
-    #
-    #  rio('/tmp').chdir
-    #  rio('afile').base # => rio('/tmp/')
-    #
-    # See Rio#abs.
-    #
-    def base() target.base()  end
-    # Sets the string that the Rio considers an extension. The value will be used by
-    # subsequent calls to Rio#basename. If called with no arguments resets its value
-    # to the value returned by File#extname. Returns the Rio
-    #  ario = rio('afile.txt')
-    #  ario.ext('.txt').basename        #=> rio('afile')
-    #  ario.ext('.zip').basename        #=> rio('afile.txt')
-    #  ario.ext.basename                #=> rio('afile')
-    #  ario.ext('').basename            #=> rio('afile.txt')
-    # See also Rio#ext,Rio#ext?,Rio#filename,
-    #
-    def ext(arg=nil) target.ext(arg); self end
-    # Identical to Rio#ext('')
-    # See Rio#ext
-    #  ario.basename                  #=> rio('afile')
-    #  ario.noext.basename            #=> rio('afile.txt')
-    #
-    def noext() target.noext(); self end
-    # Returns the value of the Rio's 'ext' variable
-    # This defaults to the value returned by Rio#extname and may be set by either calling Rio#ext
-    # or by passing an argument Rio#basename
-    # See also Rio#basename, Rio#ext, Rio#extname, Rio#noext
-    #
-    #  ario = rio('afile.txt')
-    #  ario.ext?                        #=> '.txt'
-    #  ario.ext('.txt').basename        #=> rio('afile')
-    #  ario.ext?                        #=> '.txt'
-    #  ario.ext('.zip').basename        #=> rio('afile.txt')
-    #  ario.ext?                        #=> '.zip'
-    #  ario.basename('.tar')            #=> rio('afile.txt')
-    #  ario.ext?                        #=> '.tar'
-    #  ario.ext.basename                #=> rio('afile')
-    #  ario.ext?                        #=> '.txt'
-    #  ario.noext.basename              #=> rio('afile.txt')
-    #  ario.ext?                        #=> ''
-    #
-    def ext?() target.ext?() end
-    # Similar to File#basename
-    #
-    # Returns a Rio whose path is that returned by File#basename when passed the path
-    # of a rio and the value returned by File#extname. This differs from the behaviour
-    # of File#basename.
-    #  File.basename('afile.txt')                           #=> 'afile.txt'
-    #  File.basename('afile.txt',File.extname('afile.txt')) #=> 'afile'
-    #  rio('afile.txt').basename                            #=> rio('afile')
-    #  rio('afile.txt').basename('.txt')                    #=> same thing
-    #  rio('afile.txt').ext('.txt').basename                #=> same thing
-    # See also Rio#ext,Rio#ext?,Rio#filename,
-    def basename(*args) target.basename(*args) end
-    # Calls File#dirname
-    #
-    # Returns a new Rio referencing the directory portion of a Rio.
-    #    rio('/tmp/zippy.txt').dirname   #=> rio('/tmp')
-    #
-    def dirname(*args) target.dirname(*args) end
-    # Calls File#extname
-    #
-    # Returns a String containing the path's extension
-    #    rio('/tmp/zippy.txt').extname   #=> rio('.txt')
-    #
-    def extname(*args) target.extname(*args) end
-    # Returns a new Rio with all path information stripped away. This is similar to
-    # Rio#basename, except that it always includes an extension if one exists
-    #
-    #  rio('apath/afile.txt').filename #=> rio('afile.txt')
-    #
-    def filename() target.filename() end
-    # Replace the part of the path returned by Rio#extname. If in +rename+
-    # mode, also renames the referenced filesystem object.
-    #
-    # Returns the extension
-    #
-    #   ario = rio('dirA/dirB/afile.rb')
-    #   ario.extname = '.txt'          # rio('dirC/bfile.txt')
-    #
-    #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
-    #
-    # See Rio#extname, Rio#rename
-    #
-    def extname=(arg) target.extname = arg end
-    # Replace the part of the path returned by Rio#basename. If in +rename+
-    # mode, also renames the referenced filesystem object.
-    #
-    # Returns the new value of +basename+
-    #
-    #   ario = rio('dirA/dirB/afile.rb')
-    #   ario.dirname = 'dirC'          # rio('dirC/afile.rb')
-    #   ario.basename = 'bfile'        # rio('dirC/bfile.rb')
-    #   ario.extname = '.txt'          # rio('dirC/bfile.txt')
-    #   ario.filename = 'cfile.rb'     # rio('dirC/cfile.rb')
-    #
-    #   rio('adir/afile.txt').rename.filename = 'bfile.rb' # adir/afile.txt => adir/bfile.rb
-    #   rio('adir/afile.txt').rename.basename = 'bfile'    # adir/afile.txt => adir/bfile.txt
-    #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
-    #   rio('adir/afile.txt').rename.dirname =  'b/c'      # adir/afile.txt => b/c/afile.txt
-    #
-    # See Rio#basename, Rio#rename
-    #
-    def basename=(arg) target.basename = arg end
-    # Replace the part of the path returned by Rio#dirname. If in +rename+
-    # mode, also renames the referenced filesystem object.
-    #
-    # Returns the new value of +dirname+
-    #
-    #   ario = rio('dirA/dirB/afile.rb')
-    #   ario.dirname = 'dirC'          # rio('dirC/afile.rb')
-    #   ario.basename = 'bfile'        # rio('dirC/bfile.rb')
-    #   ario.extname = '.txt'          # rio('dirC/bfile.txt')
-    #   ario.filename = 'cfile.rb'     # rio('dirC/cfile.rb')
-    #
-    #   rio('adir/afile.txt').rename.filename = 'bfile.rb' # adir/afile.txt => adir/bfile.rb
-    #   rio('adir/afile.txt').rename.basename = 'bfile'    # adir/afile.txt => adir/bfile.txt
-    #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
-    #   rio('adir/afile.txt').rename.dirname =  'b/c'      # adir/afile.txt => b/c/afile.txt
-    #
-    # See Rio#dirname, Rio#rename
-    #
-    def dirname=(arg) target.dirname  = arg end
-    # Replace the part of the path returned by Rio#filename. If in +rename+
-    # mode, also renames the referenced filesystem object.
-    #
-    # Returns the new value of +filename+
-    #
-    #   ario = rio('dirA/dirB/afile.rb')
-    #   ario.dirname = 'dirC'          # rio('dirC/afile.rb')
-    #   ario.basename = 'bfile'        # rio('dirC/bfile.rb')
-    #   ario.extname = '.txt'          # rio('dirC/bfile.txt')
-    #   ario.filename = 'cfile.rb'     # rio('dirC/cfile.rb')
-    #
-    #   rio('adir/afile.txt').rename.filename = 'bfile.rb' # adir/afile.txt => adir/bfile.rb
-    #   rio('adir/afile.txt').rename.basename = 'bfile'    # adir/afile.txt => adir/bfile.txt
-    #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
-    #   rio('adir/afile.txt').rename.dirname =  'b/c'      # adir/afile.txt => b/c/afile.txt
-    #
-    # See Rio#filename, Rio#rename
-    #
-    def filename=(arg) target.filename = arg end
-    # Creates new Rio by adding args as additional directory components like File#join.
-    #
-    #   ario = rio('adir')
-    #   brio = rio('b')
-    #   crio = ario.join(brio)    #=> rio('adir/b')
-    #
-    #   ario = rio('adir')
-    #   ario.join('b','c','d')    #=> rio('ario/b/c/d')
-    #
-    # See also Rio#/
-    def join(*args) target.join(*args) end
-    # Creates an array of Rios, one for each path element.
-    # (Note that this behavior differs from File#split.)
-    #
-    #  rio('a/b/c').split   #=> [rio('a'),rio('b'),rio('c')]
-    #
-    # The array returned is extended with a +to_rio+ method,
-    # which will put the parts back together again.
-    #
-    #  ary = rio('a/b/c').split   #=> [rio('a'),rio('b'),rio('c')]
-    #  ary.to_rio           #=> rio('a/b/c')
-    #
-    #  ary = rio('a/b/c').split   #=> [rio('a'),rio('b'),rio('c')]
-    #  ary[1] = rio('d')
-    #  ary.to_rio           #=> rio('a/d/c')
-    #
-    # See also Rio#join, Rio#/
-    def split() target.split() end
-    # Subdirectory operator.
-    #
-    # Effectively the same as Rio#join(arg)
-    #
-    #   a = rio('a')
-    #   b = rio('b')
-    #   c = a/b          #=> rio('a/b')
-    #
-    #   ario = rio('adir')
-    #   ario/'afile.rb'           #=> rio('ario/afile.rb')
-    #   ario/'b'/'c'/'d'          #=> rio('ario/b/c/d')
-    #
-    #   ario = rio('adir')
-    #   ario /= 'afile.rb'           #=> rio('ario/afile.rb')
-    #
-    def /(arg) target / arg end
-    # Create a Rio referencing Rio#to_str + arg.to_str
-    #
-    #  rio('afile') + '-0.1'   #=> rio('afile-0.1')
-    #
-    def +(arg) target + arg end
-    # Create a new Rio referencing the result of applying String#sub to the value returned by
-    # Rio#to_s. So:
-    #
-    #  ario.sub(re,string)
-    # is equivelent to
-    #  rio(ario.to_s.sub(re,string))
-    #
-    def sub(re,string) target.sub(re,string) end
-    # Create a new Rio referencing the result of applying String#gsub to the value returned by
-    # Rio#to_s. So:
-    #
-    #  ario.gsub(re,string)
-    # is equivelent to
-    #  rio(ario.to_s.gsub(re,string))
-    #
-    def gsub(re,string) target.gsub(re,string) end
-    # Rio#catpath!
-    #
-    #
-    #def catpath!(*args) target.catpath!(*args); self end
-    # Rio#catpath
-    #
-    #
-    #def catpath(*args) target.catpath(*args) end
-    # Changes a Rio inplace by adding args as additional directory components like Rio#join,
-    #
-    def join!(*args) target.join!(*args); self end
-    # Rio#rootpath
-    #
-    #
-    def rootpath(*args) # :nodoc:
-      target.rootpath(*args)
+  module IF
+    module Path
+      # Returns the path for the Rio, which is defined differently for different types of Rios.
+      #
+      # For Rios representing paths on the underlying file system this is an alias
+      # IF::Path#fspath. For Rios with paths that are not on the file system this is an
+      # alias for IF::Path#urlpath.
+      #
+      # Otherwise this returns nil.
+      #
+      def path(*args) target.path(*args) end
+      # For resources that have a absolute URL (RFC1738) representation,
+      # this returns a string containing that representation.
+      # For objects that do not this returns a RIORL (a descriptive pseudo-URL).
+      #
+      #  rio('/var/www/')                  #=> "file:///var/www/"
+      #  rio('http://rio.rubyforge.org/')  #=> "http://rio.rubyforge.org"
+      #
+      def to_url() target.to_url end
+      # For resources that have a URL (RFC1738) representation, this returns a
+      # URI object referencing it.  Otherwise this raises NoMethodError.
+      #
+      #  rio('http://rubyforge.org/').to_uri     #=> <URI::HTTP:0x818bd84 URL:http://rubyforge.org/>
+      #  rio('adir/afile').to_uri                #=> <URI::Generic:0x817d288 URL:adir/afile>
+      #
+      def to_uri() target.to_uri end
+      # Returns the path for the Rio on the underlying file system
+      # Returns nil if the Rio is not on the filesystem (i.e. stdin: or http: Rios)
+      def fspath() target.fspath() end
+      # Returns the path portion of the URL representation of the rio
+      # Returns nil if the Rio URL has no path (i.e. stdin: or http: Rios)
+      def urlpath() target.urlpath() end
+      # Calls File#expand_path
+      #
+      #
+      # Converts a pathname to an absolute pathname.
+      # Relative paths are referenced from the current working directory of the process
+      # unless dir_string is given, in which case it will be used as the starting point.
+      # The given pathname may start with a ``~��, which expands to the process owner�s
+      # home directory (the environment variable HOME must be set correctly).
+      # ``~user�� expands to the named user�s home directory.
+      #
+      # Returns a Rio representing the returned path
+      #
+      #
+      def expand_path(*args) target.expand_path(*args) end
+      # Returns a new rio with a path equal to the absolute path of this rio
+      #
+      #  rio('/tmp').chdir
+      #  rio('afile').abs # => rio('/tmp/afile')
+      def abs(*args) target.abs(*args)  end
+      # Returns a new rio with a path equal to the relative path from _other_
+      #  rio('/tmp/afile').rel('/tmp')   #=> rio('afile')
+      #  rio('zippy/afile').rel('zippy') #=> rio('afile')
+      #
+      def rel(other=nil) target.rel(other)  end
+      # Returns a new Rio whose path is the base path that is used by
+      # IF::Path#abs to create an absolute Rio from a relative one.
+      #
+      #  rio('/tmp').chdir
+      #  rio('afile').base # => rio('/tmp/')
+      #
+      # See IF::Path#abs.
+      #
+      def base() target.base()  end
+      # Sets the string that the Rio considers an extension. The value will be used by
+      # subsequent calls to IF::Path#basename. If called with no arguments resets its value
+      # to the value returned by File#extname. Returns the Rio.
+      #
+      #  ario = rio('afile.tar.gz')
+      #  ario.ext?                        #=> '.ext'
+      #  ario.basename                    #=> rio('afile.tar')
+      #  ario.ext('.tar.gz').basename     #=> rio('afile')
+      #  ario.ext?                        #=> '.tar.gz'
+      #
+      #  ario = rio('afile.txt')
+      #  ario.ext('.txt').basename        #=> rio('afile')
+      #  ario.ext('.zip').basename        #=> rio('afile.txt')
+      #  ario.ext.basename                #=> rio('afile')
+      #  ario.ext('').basename            #=> rio('afile.txt')
+      #
+      # See also IF::Path#ext?,IF::Path#noext,IF::Path#basename,
+      #
+      def ext(arg=nil) target.ext(arg); self end
+      # Identical to IF::Path#ext('')
+      #
+      #  ario.basename                  #=> rio('afile')
+      #  ario.noext.basename            #=> rio('afile.txt')
+      #
+      # See also IF::Path#ext
+      #
+      def noext() target.noext(); self end
+      # Returns the value of the Rio's 'ext' variable
+      # This defaults to the value returned by IF::Path#extname and may be set by either calling IF::Path#ext
+      # or by passing an argument IF::Path#basename
+      # See also IF::Path#basename, IF::Path#ext, IF::Path#extname, IF::Path#noext
+      #
+      #  ario = rio('afile.txt')
+      #  ario.ext?                        #=> '.txt'
+      #  ario.ext('.txt').basename        #=> rio('afile')
+      #  ario.ext?                        #=> '.txt'
+      #  ario.ext('.zip').basename        #=> rio('afile.txt')
+      #  ario.ext?                        #=> '.zip'
+      #  ario.basename('.tar')            #=> rio('afile.txt')
+      #  ario.ext?                        #=> '.tar'
+      #  ario.ext.basename                #=> rio('afile')
+      #  ario.ext?                        #=> '.txt'
+      #  ario.noext.basename              #=> rio('afile.txt')
+      #  ario.ext?                        #=> ''
+      #
+      def ext?() target.ext?() end
+      # Calls File#extname
+      #
+      # Returns a String containing the path's extension
+      #    rio('/tmp/zippy.txt').extname   #=> '.txt'
+      #
+      def extname(*args) target.extname(*args) end
+      # Similar to File#basename
+      #
+      # Returns a Rio whose path is that returned by File#basename when passed the path
+      # of a rio and the value returned by File#extname. This differs from the behaviour
+      # of File#basename.
+      #
+      #  File.basename('afile.txt')                           #=> 'afile.txt'
+      #  File.basename('afile.txt',File.extname('afile.txt')) #=> 'afile'
+      #  rio('afile.txt').basename                            #=> rio('afile')
+      #  rio('afile.txt').basename('.txt')                    #=> same thing
+      #  rio('afile.txt').ext('.txt').basename                #=> same thing
+      #
+      # See also IF::Path#ext,IF::Path#ext?,IF::Path#filename,
+      #
+      def basename(*args) target.basename(*args) end
+      # Calls File#dirname
+      #
+      # Returns a new Rio referencing the directory portion of a Rio.
+      #    rio('/tmp/zippy.txt').dirname   #=> rio('/tmp')
+      #
+      def dirname(*args) target.dirname(*args) end
+      # Returns a new Rio with all path information stripped away. This is similar to
+      # IF::Path#basename, except that it always includes an extension if one exists
+      #
+      #  rio('apath/afile.txt').filename #=> rio('afile.txt')
+      #
+      def filename() target.filename() end
+      # Replace the part of the path returned by IF::Path#extname. If in +rename+
+      # mode, also renames the referenced filesystem object.
+      #
+      # Returns the extension
+      #
+      #   ario = rio('dirA/dirB/afile.rb')
+      #   ario.extname = '.txt'          # rio('dirC/bfile.txt')
+      #
+      #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
+      #
+      # See aslo IF::Path#extname, IF::FileOrDir#rename
+      #
+      def extname=(arg) target.extname = arg end
+      # Replace the part of the path returned by IF::Path#basename. If in +rename+
+      # mode, also renames the referenced filesystem object.
+      #
+      # Returns the new value of +basename+
+      #
+      #   ario = rio('dirA/dirB/afile.rb')
+      #   ario.dirname = 'dirC'          # rio('dirC/afile.rb')
+      #   ario.basename = 'bfile'        # rio('dirC/bfile.rb')
+      #   ario.extname = '.txt'          # rio('dirC/bfile.txt')
+      #   ario.filename = 'cfile.rb'     # rio('dirC/cfile.rb')
+      #
+      #   rio('adir/afile.txt').rename.filename = 'bfile.rb' # adir/afile.txt => adir/bfile.rb
+      #   rio('adir/afile.txt').rename.basename = 'bfile'    # adir/afile.txt => adir/bfile.txt
+      #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
+      #   rio('adir/afile.txt').rename.dirname =  'b/c'      # adir/afile.txt => b/c/afile.txt
+      #
+      # See IF::Path#basename, IF::FileOrDir#rename
+      #
+      def basename=(arg) target.basename = arg end
+      # Replace the part of the path returned by IF::Path#dirname. If in +rename+
+      # mode, also renames the referenced filesystem object.
+      #
+      # Returns the new value of +dirname+
+      #
+      #   ario = rio('dirA/dirB/afile.rb')
+      #   ario.dirname = 'dirC'          # rio('dirC/afile.rb')
+      #   ario.basename = 'bfile'        # rio('dirC/bfile.rb')
+      #   ario.extname = '.txt'          # rio('dirC/bfile.txt')
+      #   ario.filename = 'cfile.rb'     # rio('dirC/cfile.rb')
+      #
+      #   rio('adir/afile.txt').rename.filename = 'bfile.rb' # adir/afile.txt => adir/bfile.rb
+      #   rio('adir/afile.txt').rename.basename = 'bfile'    # adir/afile.txt => adir/bfile.txt
+      #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
+      #   rio('adir/afile.txt').rename.dirname =  'b/c'      # adir/afile.txt => b/c/afile.txt
+      #
+      # See IF::Path#dirname, IF::FileOrDir#rename
+      #
+      def dirname=(arg) target.dirname  = arg end
+      # Replace the part of the path returned by IF::Path#filename. If in +rename+
+      # mode, also renames the referenced filesystem object.
+      #
+      # Returns the new value of +filename+
+      #
+      #   ario = rio('dirA/dirB/afile.rb')
+      #   ario.dirname = 'dirC'          # rio('dirC/afile.rb')
+      #   ario.basename = 'bfile'        # rio('dirC/bfile.rb')
+      #   ario.extname = '.txt'          # rio('dirC/bfile.txt')
+      #   ario.filename = 'cfile.rb'     # rio('dirC/cfile.rb')
+      #
+      #   rio('adir/afile.txt').rename.filename = 'bfile.rb' # adir/afile.txt => adir/bfile.rb
+      #   rio('adir/afile.txt').rename.basename = 'bfile'    # adir/afile.txt => adir/bfile.txt
+      #   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt => adir/afile.rb
+      #   rio('adir/afile.txt').rename.dirname =  'b/c'      # adir/afile.txt => b/c/afile.txt
+      #
+      # See IF::Path#filename, IF::FileOrDir#rename
+      #
+      def filename=(arg) target.filename = arg end
+      # Creates new Rio by adding args as additional directory components like File#join.
+      #
+      #   ario = rio('adir')
+      #   brio = rio('b')
+      #   crio = ario.join(brio)    #=> rio('adir/b')
+      #
+      #   ario = rio('adir')
+      #   ario.join('b','c','d')    #=> rio('ario/b/c/d')
+      #
+      # See also IF::Path#/
+      def join(*args) target.join(*args) end
+      # Returns an array of Rios, one for each path element.
+      # (Note that this behavior differs from File#split.)
+      #
+      #  rio('a/b/c').split   #=> [rio('a'),rio('b'),rio('c')]
+      #
+      # The array returned is extended with a +to_rio+ method,
+      # which will put the parts back together again.
+      #
+      #  ary = rio('a/b/c').split   #=> [rio('a'),rio('b'),rio('c')]
+      #  ary.to_rio           #=> rio('a/b/c')
+      #
+      #  ary = rio('a/b/c').split   #=> [rio('a'),rio('b'),rio('c')]
+      #  ary[1] = rio('d')
+      #  ary.to_rio           #=> rio('a/d/c')
+      #
+      # See also IF::Path#join, IF::Path#/
+      #
+      def splitpath() target.splitpath() end
+      # Subdirectory operator.
+      #
+      # Effectively the same as IF::Path#join(arg)
+      #
+      #   a = rio('a')
+      #   b = rio('b')
+      #   c = a/b                   #=> rio('a/b')
+      #
+      #   ario = rio('adir')
+      #   ario/'afile.rb'           #=> rio('adir/afile.rb')
+      #   ario/'b'/'c'/'d'          #=> rio('adir/b/c/d')
+      #
+      #   ario = rio('adir')
+      #   ario /= 'afile.rb'        #=> rio('adir/afile.rb')
+      #
+      def /(arg)
+        target / arg
+      end
+      # Rio#catpath!
+      #
+      #
+      #def catpath!(*args) target.catpath!(*args); self end
+      # Rio#catpath
+      #
+      #
+      #def catpath(*args) target.catpath(*args) end
+      # Changes a Rio inplace by adding args as additional directory components like IF::Path#join,
+      #
+      def join!(*args) target.join!(*args); self end
+      # IF::GrandeStream#rootpath
+      #
+      #
+      def rootpath(*args) # :nodoc:
+        target.rootpath(*args)
+      end
+      # IF::GrandeStream#root
+      #
+      #
+      ##def root(*args,&block) target.root(*args,&block) end
+      # Rio#cwd
+      #
+      #
+      ##def cwd(*args,&block) target.cwd(*args,&block) end
+      # IF::Grande#getwd
+      #
+      #
+      ##def getwd(*args,&block) target.getwd(*args,&block) end
+      # Returns the scheme for the Rio's URI-like URI#scheme where the Rio is represented
+      # by a standard URI. For Rios that are not represented by standard URIs one of
+      # Rio's non-standard schemes is returned.
+      #
+      #  rio('http://ruby-doc.org/').scheme #=> 'http'
+      #
+      def scheme(*args) target.scheme(*args) end
+      # Calls URI#host for Rios which have a URI. Otherwise raises NoMethodError.
+      #
+      #  rio('http://ruby-doc.org/').host #=> 'ruby-doc'
+      #
+      def host(*args) target.host(*args) end
+      # Calls URI#opaque for Rios which have URI representations. The opaque portion
+      # of a URI is the portion after the colon and before the question-mark beginning
+      # the query.
+      #
+      #  rio('http://example.org/do.cgi?n=1').opaque  #=> '//example.org/do.cgi'
+      #
+      # For Rios that do not have URL representations, returns the same part of
+      # Rio's internal psuedo-URL
+      def opaque(*args) target.opaque(*args) end
+      # Calls URI#merge
+      #
+      # Merges two Rios. URI#merge does not document exactly what merging two URIs means.
+      # This appears to join the paths like <tt>other + path</tt>.
+      # See URI#merge for less information.
+      #
+      def merge(other) target.merge(other)  end
+      # Calls URI#route_from
+      #
+      # Returns a new rio representing the path to this Rio from the perspective of _other_.
+      # URI#route_from requires that absolute URIs be used. IF::Path#route_from does not.
+      #
+      def route_from(other) target.route_from(other)  end
+      # Calls URI#route_to
+      #
+      # Returns a new rio representing the path to _other_ from the perspective of this Rio.
+      # URI#route_to requires that absolute URIs be used. IF::Path#route_to does not.
+      #
+      def route_to(other) target.route_to(other)  end
+      # Calls Pathname#cleanpath
+      #
+      # Returns a new Rio whose path is the clean pathname of +self+ with
+      # consecutive slashes and useless dots
+      # removed.  The filesystem is not accessed.
+      #
+      # If +consider_symlink+ is +true+, then a more conservative algorithm is used
+      # to avoid breaking symbolic linkages.  This may retain more <tt>..</tt>
+      # entries than absolutely necessary, but without accessing the filesystem,
+      # this can't be avoided.  See #realpath.
+      #
+      def cleanpath(consider_symlink=false) target.cleanpath(consider_symlink)  end
+      # Calls Pathname#realpath
+      #
+      # Returns a new Rio whose path is the real (absolute) pathname
+      # of +self+ in the actual filesystem.
+      # The real pathname doesn't contain symlinks or useless dots.
+      #
+      def realpath() target.realpath()  end
     end
-    # Rio#root
-    #
-    #
-    ##def root(*args,&block) target.root(*args,&block) end
-    # Rio#cwd
-    #
-    #
-    ##def cwd(*args,&block) target.cwd(*args,&block) end
-    # Rio#getwd
-    #
-    #
-    ##def getwd(*args,&block) target.getwd(*args,&block) end
-    # Returns the scheme for the Rio's URI-like URI#scheme where the Rio is represented
-    # by a standard URI. For Rios that are not represented by standard URIs one of
-    # Rio's non-standard schemes is returned.
-    #
-    #  rio('http://ruby-doc.org/').scheme #=> 'http'
-    #
-    def scheme(*args) target.scheme(*args) end
-    # Calls URI#host for Rios which have a URI. Otherwise raises NoMethodError.
-    #
-    #  rio('http://ruby-doc.org/').host #=> 'ruby-doc'
-    #
-    def host(*args) target.host(*args) end
-    # Calls URI#opaque for Rios which have URI representations. The opaque portion
-    # of a URI is the portion after the colon and before the question-mark beginning
-    # the query.
-    #
-    #  rio('http://example.org/do.cgi?n=1').opaque  #=> '//example.org/do.cgi'
-    #
-    # For Rios that do not have URL representations, returns the same part of
-    # Rio's internal psuedo-URL
-    def opaque(*args) target.opaque(*args) end
-    # Calls URI#merge
-    #
-    # Merges two Rios. URI#merge does not document exactly what merging two URIs means.
-    # This appears to join the paths like <tt>other + path</tt>.
-    # See URI#merge for less information.
-    #
-    def merge(other) target.merge(other)  end
-    # Calls URI#route_from
-    #
-    # Returns a new rio representing the path to this Rio from the perspective of _other_.
-    # URI#route_from requires that absolute URIs be used. Rio#route_from does not.
-    #
-    def route_from(other) target.route_from(other)  end
-    # Calls URI#route_to
-    #
-    # Returns a new rio representing the path to _other_ from the perspective of this Rio.
-    # URI#route_to requires that absolute URIs be used. Rio#route_to does not.
-    #
-    def route_to(other) target.route_to(other)  end
-    # Calls Pathname#cleanpath
-    #
-    # Returns a new Rio whose path is the clean pathname of +self+ with
-    # consecutive slashes and useless dots
-    # removed.  The filesystem is not accessed.
-    #
-    # If +consider_symlink+ is +true+, then a more conservative algorithm is used
-    # to avoid breaking symbolic linkages.  This may retain more <tt>..</tt>
-    # entries than absolutely necessary, but without accessing the filesystem,
-    # this can't be avoided.  See #realpath.
-    #
-    def cleanpath(consider_symlink=false) target.cleanpath(consider_symlink)  end
-    # Calls Pathname#realpath
-    #
-    # Returns a new Rio whose path is the real (absolute) pathname
-    # of +self+ in the actual filesystem.
-    # The real pathname doesn't contain symlinks or useless dots.
-    #
-    def realpath() target.realpath()  end
+  end
+end
+module RIO
+  class Rio
+    include RIO::IF::Path
   end
 end