rio 0.4.0 → 0.4.1

data/COPYING

@@ -338,3 +338,4 @@ proprietary programs.  If your program is a subroutine library, you may
 consider it more useful to permit linking proprietary applications with the
 library.  If this is what you want to do, use the GNU Library General
 Public License instead of this License.
+

data/README

@@ -20,13 +20,14 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 
 = Rio - Ruby I/O Facilitator
 
-fa-cil-i-tate:  To make easy or easier [http://www.thefreedictionary.com/facilitate]
+fa-cil-i-tate:  To make easy or easier 
 
-Rio is a facade for most of the standard ruby classes that deal with I/O;
-providing a simple, intuitive, succinct interface to the functionality
-provided by IO, File, Dir, Pathname, FileUtils, Tempfile, StringIO, OpenURI
-and others. Rio also provides an application level interface which allows many
-common I/O idioms to be expressed succinctly.
+Rio is a facade for most of the standard ruby classes that deal with
+I/O; providing a simple, intuitive, succinct interface to the
+functionality provided by IO, File, Dir, Pathname, FileUtils,
+Tempfile, StringIO, OpenURI and others. Rio also provides an
+application level interface which allows many common I/O idioms to be
+expressed succinctly.
 
 ==== Building the documentation
 
@@ -36,9 +37,10 @@ from the distribution directory.
 
 Then point your browser at the 'doc/rdoc' directory.
 
-The RDoc template file included with this distribution contains some RDoc hacks
-that overcomes some of RDoc's weaknesses and makes the documentation *much* more
-usable. It is inadvisable to build the RDoc documentation without these.
+The RDoc template file included with this distribution contains some
+RDoc hacks that overcomes some of RDoc's weaknesses and makes the
+documentation *much* more usable. It is inadvisable to build the RDoc
+documentation without these.
 
 
 ===== Suggested Reading

data/Rakefile

@@ -48,7 +48,7 @@ SVN_REPOSITORY_URL = [SVN_REPOSITORY_ROOT,'trunk/rio'].join('/')
  
 require 'doc/pkg_def'
 
-ZIP_DIR = "/zip/ruby/rio"
+ZIP_DIR = "/loc/zip/ruby/rio"
 
 
 # The default task is run if rake is given no explicit arguments.

data/doc/#RIOIS#

@@ -0,0 +1,216 @@
+Rio IS
+
+=== EASY
+
+Anything that does I/O is a Rio:
+
+File:	   
+ rio('aflile')
+Directory: 
+ rio('adir')
+Web Page:  
+ rio('http://ahost/adir/afile')
+Any IO:    
+ rio(any_io)
+
+... much more
+
+Makes common tasks easy
+
+ rio('afile') > rio('copy of afile')
+ rio('adir') > rio('copy of adir')
+ rio('gzipped_file.gz').gzip > rio('ungzipped_file')
+ chomped_lines = rio('afile').chomp[]
+
+... much more
+
+=== Powerful
+
+ rb_files= rio('adir').files['*.rb']
+ rb_files_including_those_in_subdirectories = rio('adir').all.files['*.rb']
+ lines = rio('afile').chomp[0..9] # first 10 lines chomped
+ lines = rio('afile.gz').gzip.chomp[0..9] # from gzipped file
+ lines = rio('ftp://ahost/afile.gz').gzip.chomp[0..9] # on ftp server
+
+... much more
+
+=== Consistent
+
+To iterate, add a block: 
+ rio('afile').lines(/regular_expression/) { |line| ... }
+ rio('adir').files('
+To return an array, use a subscript: 
+ rio('afile').lines[/regular_expression/]
+To copy use the copy-operator: 
+ rio('afile').lines(/regular_expression/) > rio('destination_file')
+
+
+
+
+
+= Rio - Ruby I/O Facilitator
+
+fa-cil-i-tate:  To make easy or easier [http://thefreedictionary.com]
+
+== Overview
+
+Rio is a facade for most of the standard ruby classes that deal with
+I/O; providing a simple, intuitive, succinct interface to the
+functionality provided by IO, File, Dir, Pathname, FileUtils,
+Tempfile, StringIO, OpenURI and others. Rio also provides an
+application level interface which allows many common I/O idioms to be
+expressed succinctly.
+
+== New
+
+Enhanced support for FTP file-systems. All of Rio's most powerful
+idioms are now supported seamlessly on FTP servers.
+
+ # copy a file from or to an FTP server
+ rio('ftp://ahost/adir/afile') > rio('localfile') # server -> local file
+ rio('ftp://ahost/adir/afile') < rio('localfile') # local file -> server
+
+ # copy an entire directory structure from or to an FTP server
+ rio('ftp://ahost/adir') > rio('localdir') # server -> local directory
+ rio('ftp://ahost/adir') < rio('localdir') # local directory -> server
+
+All of Rio's grande selection and filtering options are available for
+files and directories on FTP servers.
+
+ # create a gzipped copy of a web page on an ftp server
+ rio('ftp://ftphost/f.html.gz').gzip < rio('http://httphost/f.html')
+
+ # dump the first 10 lines of a gzipped log file on an FTP server to stdout
+ rio('ftp://ftphost/logfile.txt').lines(0...10) > ?-
+
+ # iterate through the entries of a directory on an FTP server
+ rio('ftp://ftphost/adir').entries { |entrio| ... }
+
+ # get an array of all .rb files on an ftp server
+ rb_files = rio('ftp://ftphost/').all.files['*.rb']
+
+
+== SYNOPSIS
+
+For the following assume:
+ astring = ""
+ anarray = []
+
+Copy or append a file to a string
+ rio('afile') > astring      # copy
+ rio('afile') >> astring     # append
+
+Copy or append a string to a file
+ rio('afile') < astring      # copy
+ rio('afile') << astring     # append
+
+Copy or append the lines of a file to an array
+ rio('afile') > anarray     
+ rio('afile') >> anarray
+ 
+Copy or append a file to another file
+ rio('afile') > rio('another_file')  
+ rio('afile') >> rio('another_file') 
+
+Copy a file to a directory
+ rio('adir') << rio('afile')
+
+Copy a directory structure to another directory
+ rio('adir') >> rio('another_directory')
+
+Copy a web-page to a file
+ rio('http://rubydoc.org/') > rio('afile')
+
+Ways to get the chomped lines of a file into an array
+ anarray = rio('afile').chomp[]         # subscript operator
+ rio('afile').chomp > anarray           # copy-to operator
+ anarray = rio('afile').chomp.to_a      # to_a
+ anarray = rio('afile').chomp.readlines # IO#readlines
+ 
+Copy a gzipped file un-gzipping it
+ rio('afile.gz').gzip > rio('afile')
+
+Copy a plain file, gzipping it
+ rio('afile.gz').gzip < rio('afile')
+
+Copy a file from a ftp server into a local file un-gzipping it
+ rio('ftp://host/afile.gz').gzip > rio('afile')
+
+Iterate over the entries in a directory
+ rio('adir').entries { |entrio| ... }
+
+Iterate over only the files in a directory
+ rio('adir').files { |entrio| ... }
+
+Iterate over only the .rb files in a directory
+ rio('adir').files('*.rb') { |entrio| ... }
+
+Iterate over .rb files but not symlinks to .rb files
+ rio('adir').files('*.rb').skip(:symlink?) { |entrio| ... }
+
+Iterate over only the _dot_ files in a directory
+ rio('adir').files(/^\./) { |entrio| ... }
+
+Iterate over the files in a directory and its subdirectories, skipping
+'.svn' and 'CVS' directories
+
+ rio('adir').norecurse(/^\.svn$/,'CVS').files { |entrio| ... }
+
+Create an array of the .rb entries in a directory
+ anarray = rio('adir')['*.rb']
+
+Create an array of the .rb entries in a directory and its
+subdirectories.
+ anarray = rio('adir').all['*.rb']
+
+Iterate over the .rb files in a directory and its subdirectories
+ rio('adir').all.files('*.rb') { |entrio| ... }
+
+Iterate over the non-empty, non-comment chomped lines of a file
+ rio('afile').chomp.skip.lines(:empty?,/^\s*#/) { |line| ... }
+
+Copy the output of th ps command into an array, skipping the header
+line and the ps command entry
+ rio(?-,'ps -a').skip.lines(0,/ps$/) > anarray 
+
+Prompt for input and return what was typed
+ ans = rio(?-).print("Type Something: ").chomp.gets 
+
+Change the extension of all .htm files in a directory and its
+subdirectories to .html
+ rio('adir').rename.all.files('*.htm') do |htmfile|
+   htmfile.extname = '.html'
+ end
+
+Create a symbolic link 'asymlink' in 'adir' which refers to
+'adir/afile'
+ rio('adir/afile').symlink('adir/asymlink')
+
+Copy a CSV file, changing the separator to a semicolon
+ rio('comma.csv').csv > rio('semicolon.csv').csv(';')
+
+Iterate through a CSVfile with each line parsed into an array
+ rio('afile.csv').csv { |array_of_fields| ...}
+
+Create a tab separated file of accounts in a UNIX passwd file,
+listing only the username, uid, and realname fields
+ rio('/etc/passwd').csv(':').columns(0,2,4) > rio('rpt').csv("\t")
+
+Pipe multiple commands
+ rio('afile') | rio(?-,'acmd') | 'another_cmd' | ?-
+
+== Contact
+
+Project:: http://rubyforge.org/projects/rio/
+Documentation:: http://rio.rubyforge.org/
+Bugs:: http://rubyforge.org/tracker/?group_id=821
+Email:: rio4ruby@rubyforge.org
+
+== Copyright
+Copyright (c) 2005,2006,2007 Christopher Kleckner. All rights reserved
+
+== License
+Rio is released under the GNU General Public License
+(http://www.gnu.org/licenses/gpl.html)
+
+-Christopher Kleckner 

data/doc/ANNOUNCE

@@ -1,20 +1,21 @@
-Rio 0.4.0
+Rio 0.4.1
 
 = Rio - Ruby I/O Facilitator
 
+fa-cil-i-tate: To make easy or easier.
+
 == Overview
 
-Rio is a facade for most of the standard ruby classes that deal with I/O;
-providing a simple, intuitive, succinct interface to the functionality
-provided by IO, File, Dir, Pathname, FileUtils, Tempfile, StringIO, OpenURI
-and others. Rio also provides an application level interface which allows many
-common I/O idioms to be expressed succinctly.
+Rio is a facade for most of the standard ruby classes that deal with
+I/O; providing a simple, intuitive, succinct interface to the
+functionality provided by IO, File, Dir, Pathname, FileUtils,
+Tempfile, StringIO, OpenURI and others. Rio also provides an
+application level interface which allows many common I/O idioms to be
+expressed succinctly.
 
 
 == SYNOPSIS
 
-fa-cil-i-tate:  To make easy or easier [http://www.thefreedictionary.com/facilitate]
-
 For the following assume:
  astring = ""
  anarray = []
@@ -23,7 +24,7 @@ Iterate over the .rb files in a directory.
  rio('adir').files('*.rb') { |entrio| ... }
 
 Return an array of the .rb files in a directory.
- rio('adir').files['*.rb']
+ anarray = rio('adir').files['*.rb']
 
 Copy the .rb files in a directory.to another directory.
  rio('adir').files('*.rb') > rio('another_directory')
@@ -31,8 +32,9 @@ Copy the .rb files in a directory.to another directory.
 Iterate over the .rb files in a directory and its subdirectories.
  rio('adir').all.files('*.rb') { |entrio| ... }
 
-Return an array of the .rb files in a directory and its subdirectories.
- rio('adir').all.files['*.rb']
+Return an array of the .rb files in a directory and its
+subdirectories.
+ anarray = rio('adir').all.files['*.rb']
 
 Copy or append a file to a string
  rio('afile') > astring      # copy
@@ -79,8 +81,8 @@ Return selected lines of a file as an array
  rio('adir').lines[0..3,/re/]  # or both
  
 Iterate over selected chomped lines of a file
- rio('adir').chomp.lines(0..3) { |aline| ... }       # a range of lines
- rio('adir').chomp.lines(/re/) { |aline| ... }       # by regular expression
+ rio('adir').chomp.lines(0..3) { |aline| ... } # a range of lines
+ rio('adir').chomp.lines(/re/) { |aline| ... } # by regular expression
 
 Return selected chomped lines of a file as an array
  rio('adir').chomp[0..3]  # a range of lines
@@ -104,19 +106,22 @@ Put the first 10 chomped lines of a gzipped file into an array
 Copy lines 0 and 3 thru 5 of a gzipped file on an ftp server to stdout
  rio('ftp://host/afile.gz').gzip.lines(0,3..5) > ?-
 
-Return an array of files in a directory and its subdirectories, without descending into .svn directories. 
+Return an array of files in a directory and its subdirectories,
+without descending into .svn directories.
  rio('adir').norecurse(/^\.svn$/).files[]
 
 Iterate over the non-empty, non-comment chomped lines of a file
  rio('afile').chomp.skip(:empty?,/^\s*#/) { |line| ... }
 
-Copy the output of th ps command into an array, skipping the header line and the ps command entry
+Copy the output of th ps command into an array, skipping the header
+line and the ps command entry
  rio(?-,'ps -a').skiplines(0,/ps$/) > anarray 
 
 Prompt for input and return what was typed
  ans = rio(?-).print("Type Something: ").chomp.gets 
 
-Change the extension of all .htm files in a directory and its subdirectories to .html
+Change the extension of all .htm files in a directory and its
+subdirectories to .html
  rio('adir').rename.all.files('*.htm') do |htmfile|
    htmfile.extname = '.html'
  end
@@ -140,6 +145,7 @@ Project:: http://rubyforge.org/projects/rio/
 Documentation:: http://rio.rubyforge.org/
 Bugs:: http://rubyforge.org/tracker/?group_id=821
 Email:: rio4ruby@rubyforge.org
+Blog:: http://rio4ruby.blogspot.com
 
 == Copyright
 Copyright (c) 2005,2006,2007 Christopher Kleckner. All rights reserved

data/doc/RELEASE_NOTES

@@ -1,12 +1,13 @@
 === Rio - Ruby I/O Facilitator
 
-Rio is a facade for most of the standard ruby classes that deal with I/O;
-providing a simple, intuitive, succinct interface to the functionality
-provided by IO, File, Dir, Pathname, FileUtils, Tempfile, StringIO, OpenURI
-and others. Rio also provides an application level interface which allows many
-common I/O idioms to be expressed succinctly.
+Rio is a facade for most of the standard ruby classes that deal with
+I/O; providing a simple, intuitive, succinct interface to the
+functionality provided by IO, File, Dir, Pathname, FileUtils,
+Tempfile, StringIO, OpenURI and others. Rio also provides an
+application level interface which allows many common I/O idioms to be
+expressed succinctly.
 
-fa-cil-i-tate:  To make easy or easier [http://www.thefreedictionary.com/facilitate]
+fa-cil-i-tate:  To make easy or easier.
 
 To create the documentation for Rio run the command
   ruby build_doc.rb
@@ -20,12 +21,18 @@ Suggested Reading
 * RIO::Doc::HOWTO
 * RIO::Rio
 
+== New for version 0.4.1
+* Bug fixes to better handle file system paths with URI special
+  characters.
+* Other bug fixes.
+
 == New for version 0.4.0
 * Alpha. 
 
 
 == New for version 0.3.9
-* Bug fixes, code cleanup, 
+* Bug fixes, code cleanup. 
+* See Rio#split
 
 
 == New for version 0.3.8

data/lib/rio/doc/EXAMPLES.rb

@@ -205,8 +205,8 @@ or an actual IO operation. When an IO operation is called the Range
 will be used to limit processing to the first ten records. For
 example:
 
- rio('afile').lines(0...10).each { |line| ... } # block will be called for the first 10 records
- rio('afile').lines(0...10).to_a                # the first 10 records will be returned in an array
+ rio('afile').lines(0...10) { |line| ... }      # block will be called for the first 10 records
+ rio('afile').lines[0...10]                     # the first 10 records will be returned in an array
  rio('afile').lines(0...10) > rio('acopy')      # the first 10 records will be copied to 'acopy'
 
 "But wait", you say, "In our original example the range was an

data/lib/rio/doc/INTRO.rb

@@ -40,8 +40,6 @@ module Doc
 
 = Rio - Ruby I/O Facilitator
 
-fa-cil-i-tate:  To make easy or easier [http://www.thefreedictionary.com/facilitate]
-
 Rio is a facade for most of the standard ruby classes that deal with I/O;
 providing a simple, intuitive, succinct interface to the functionality
 provided by IO, File, Dir, Pathname, FileUtils, Tempfile, StringIO, OpenURI

data/lib/rio/doc/OPTIONAL.rb

@@ -52,7 +52,7 @@ Please read the following first:
 * RIO::Doc::HOWTO
 * RIO::Rio
 
-= Rio Optional Componants
+= Rio Optional Components
 
 This document describes various optional Rio components, that must be
 explicitly 'required' to be available. These are not included in

data/lib/rio/doc/SYNOPSIS.rb

@@ -51,7 +51,7 @@ module Doc #:doc:
 
 = Rio - Ruby I/O Facilitator
 
-fa-cil-i-tate:  To make easy or easier [http://www.thefreedictionary.com/facilitate]
+fa-cil-i-tate:  To make easy or easier.
 
 Rio is a facade for most of the standard ruby classes that deal with I/O;
 providing a simple, intuitive, succinct interface to the functionality

data/lib/rio/factory.rb

@@ -257,6 +257,7 @@ module RIO
     end
 
     def subscheme_module(sch)
+      #p "subscheme_module(#{sch})"
       @ss_module[sch] ||= case sch
                           when 'file','path'
                             require 'rio/scheme/path'