rio 0.3.3 → 0.3.4

data/ChangeLog

@@ -1,4 +1,229 @@
 ------------------------------------------------------------------------
+r97 | kit | 2005-09-06 16:51:50 -0700 (Tue, 06 Sep 2005) | 1 line
+Changed paths:
+   M /rio/trunk/doc/ANNOUNCE
+   M /rio/trunk/doc/RELEASE_NOTES
+   M /rio/trunk/lib/rio/base.rb
+   M /rio/trunk/lib/rio/entrysel.rb
+   M /rio/trunk/lib/rio/grande.rb
+   M /rio/trunk/lib/rio/if/grande_stream.rb
+   D /rio/trunk/lib/rio/if/methods.rb
+   M /rio/trunk/lib/rio/if.rb
+   M /rio/trunk/test/tc/temp.rb
+   M /rio/trunk/test/tc/tempdir.rb
+
+Prepare for Release
+------------------------------------------------------------------------
+r95 | kit | 2005-09-06 15:36:32 -0700 (Tue, 06 Sep 2005) | 1 line
+Changed paths:
+   M /rio/trunk/Rakefile
+
+Rakefile modified
+------------------------------------------------------------------------
+r94 | kit | 2005-09-06 15:28:19 -0700 (Tue, 06 Sep 2005) | 1 line
+Changed paths:
+   M /rio/trunk/lib/rio/base.rb
+   A /rio/trunk/lib/rio/construct.rb
+   M /rio/trunk/lib/rio/if/path.rb
+   M /rio/trunk/lib/rio/if/temp.rb
+   M /rio/trunk/lib/rio/if/test.rb
+   M /rio/trunk/lib/rio/impl/path.rb
+   A /rio/trunk/lib/rio/ops/construct.rb
+   M /rio/trunk/lib/rio/ops/create.rb
+   M /rio/trunk/lib/rio/ops/either.rb
+   M /rio/trunk/lib/rio/ops/path.rb
+   M /rio/trunk/lib/rio/state.rb
+   M /rio/trunk/lib/rio/version.rb
+   M /rio/trunk/lib/rio.rb
+   A /rio/trunk/test/tc/skiplines.rb
+
+skip tests and new constructor methods
+------------------------------------------------------------------------
+r93 | kit | 2005-09-05 20:22:06 -0700 (Mon, 05 Sep 2005) | 1 line
+Changed paths:
+   M /rio/trunk/lib/rio/context/stream.rb
+   M /rio/trunk/lib/rio/if/grande.rb
+   M /rio/trunk/lib/rio/if/grande_stream.rb
+   M /rio/trunk/lib/rio/if/methods.rb
+   M /rio/trunk/lib/rio/ops/dir.rb
+   M /rio/trunk/lib/rio/ops/stream/input.rb
+   M /rio/trunk/test/tc/all.rb
+   M /rio/trunk/test/tc/skip.rb
+
+skip lines, and document skip
+------------------------------------------------------------------------
+r92 | kit | 2005-09-05 13:32:45 -0700 (Mon, 05 Sep 2005) | 1 line
+Changed paths:
+   A /rio/trunk/lib/rio/context/skip.rb
+   A /rio/trunk/lib/rio/if/grande_entry.rb
+   A /rio/trunk/lib/rio/if/grande_stream.rb
+   A /rio/trunk/test/tc/copysymlink.rb
+   A /rio/trunk/test/tc/skip.rb
+
+skip
+------------------------------------------------------------------------
+r91 | kit | 2005-09-05 13:29:28 -0700 (Mon, 05 Sep 2005) | 1 line
+Changed paths:
+   M /rio/trunk/lib/rio/context/dir.rb
+   M /rio/trunk/lib/rio/dir.rb
+   M /rio/trunk/lib/rio/entrysel.rb
+   M /rio/trunk/lib/rio/grande.rb
+   M /rio/trunk/lib/rio/if/dir.rb
+   M /rio/trunk/lib/rio/if/fileordir.rb
+   M /rio/trunk/lib/rio/if/grande.rb
+   M /rio/trunk/lib/rio/if/methods.rb
+   M /rio/trunk/lib/rio/if/path.rb
+   M /rio/trunk/lib/rio/if/stream.rb
+   M /rio/trunk/lib/rio/if.rb
+   M /rio/trunk/lib/rio/match.rb
+   M /rio/trunk/lib/rio/ops/dir.rb
+   M /rio/trunk/lib/rio/ops/either.rb
+   M /rio/trunk/lib/rio.rb
+   M /rio/trunk/test/tc/all.rb
+   A /rio/trunk/test/tc/selnosel.rb
+
+selection changes; documentation corrections
+------------------------------------------------------------------------
+r90 | kit | 2005-09-03 10:26:43 -0700 (Sat, 03 Sep 2005) | 1 line
+Changed paths:
+   M /rio/trunk/doc/RELEASE_NOTES
+   M /rio/trunk/lib/rio/context/dir.rb
+   M /rio/trunk/lib/rio/context/methods.rb
+   M /rio/trunk/lib/rio/context/stream.rb
+   D /rio/trunk/lib/rio/cxdir.rb
+   M /rio/trunk/lib/rio/dir.rb
+   M /rio/trunk/lib/rio/doc/HOWTO.rb
+   M /rio/trunk/lib/rio/doc/INTRO.rb
+   M /rio/trunk/lib/rio/doc/SYNOPSIS.rb
+   M /rio/trunk/lib/rio/entrysel.rb
+   M /rio/trunk/lib/rio/file.rb
+   M /rio/trunk/lib/rio/grande.rb
+   M /rio/trunk/lib/rio/if/csv.rb
+   M /rio/trunk/lib/rio/if/dir.rb
+   M /rio/trunk/lib/rio/if/grande.rb
+   M /rio/trunk/lib/rio/if/methods.rb
+   M /rio/trunk/lib/rio/ops/dir.rb
+   M /rio/trunk/lib/rio/ops/either.rb
+   M /rio/trunk/lib/rio/ops/stream/input.rb
+   M /rio/trunk/misc/addsrcheaders.rb
+   M /rio/trunk/misc/mktoc.rb
+   M /rio/trunk/test/mswin32.rb
+   M /rio/trunk/test/tc/all.rb
+   M /rio/trunk/test/tc/nolines.rb
+   M /rio/trunk/test/tc/noqae.rb
+
+fixed selection issues, phase one
+------------------------------------------------------------------------
+r89 | kit | 2005-08-30 09:10:34 -0700 (Tue, 30 Aug 2005) | 1 line
+Changed paths:
+   M /rio/trunk/doc/RELEASE_NOTES
+
+Documentation
+------------------------------------------------------------------------
+r88 | kit | 2005-08-29 19:33:43 -0700 (Mon, 29 Aug 2005) | 1 line
+Changed paths:
+   M /rio/trunk/doc/RELEASE_NOTES
+   M /rio/trunk/lib/rio/doc/INTRO.rb
+   M /rio/trunk/lib/rio/entrysel.rb
+   M /rio/trunk/lib/rio/if/grande.rb
+   M /rio/trunk/lib/rio/if/methods.rb
+   M /rio/trunk/lib/rio/matchrecord.rb
+
+selection using arrays (logical AND)
+------------------------------------------------------------------------
+r87 | kit | 2005-08-29 17:11:58 -0700 (Mon, 29 Aug 2005) | 1 line
+Changed paths:
+   M /rio/trunk/lib/rio/constructor.rb
+   M /rio/trunk/lib/rio/rl/builder.rb
+   M /rio/trunk/test/tc/riorl.rb
+
+allow symbols in the constructor; documentation
+------------------------------------------------------------------------
+r86 | kit | 2005-08-29 08:41:48 -0700 (Mon, 29 Aug 2005) | 1 line
+Changed paths:
+   M /rio/trunk/lib/rio/cp.rb
+   M /rio/trunk/lib/rio/doc/HOWTO.rb
+   M /rio/trunk/lib/rio/doc/INTRO.rb
+   M /rio/trunk/lib/rio/doc/MISC.rb
+   M /rio/trunk/lib/rio/filter/closeoneof.rb
+   M /rio/trunk/lib/rio/if/dir.rb
+   M /rio/trunk/lib/rio/if/grande.rb
+   M /rio/trunk/lib/rio/if/methods.rb
+   M /rio/trunk/lib/rio/if/stream.rb
+   M /rio/trunk/lib/rio/ops/stream/read.rb
+   M /rio/trunk/lib/rio/rl/builder.rb
+   M /rio/trunk/lib/rio/stream/open.rb
+   M /rio/trunk/test/tc/copy-from.rb
+   M /rio/trunk/test/tc/copy-to.rb
+   M /rio/trunk/test/tc/copydir.rb
+   M /rio/trunk/test/tc/csv.rb
+   M /rio/trunk/test/tc/csv2.rb
+   M /rio/trunk/test/tc/misc.rb
+   M /rio/trunk/test/tc/overload.rb
+   M /rio/trunk/test/tc/symlink.rb
+   M /rio/trunk/test/tc/symlink0.rb
+   M /rio/trunk/test/tc/testcase.rb
+
+removed #slurp in favor of #contents
+------------------------------------------------------------------------
+r85 | kit | 2005-08-26 13:02:42 -0700 (Fri, 26 Aug 2005) | 1 line
+Changed paths:
+   M /rio/trunk/README
+   M /rio/trunk/test/runtests_gem.rb
+
+Documented rubygems installation
+------------------------------------------------------------------------
+r84 | kit | 2005-08-26 12:07:17 -0700 (Fri, 26 Aug 2005) | 1 line
+Changed paths:
+   M /rio/trunk/lib/rio/arycopy.rb
+   M /rio/trunk/lib/rio/cp.rb
+   M /rio/trunk/lib/rio/if/basic.rb
+   M /rio/trunk/lib/rio/if/grande.rb
+   M /rio/trunk/lib/rio/if/path.rb
+   M /rio/trunk/lib/rio/ops/path.rb
+   M /rio/trunk/lib/rio/rl/base.rb
+   M /rio/trunk/lib/rio/state.rb
+   M /rio/trunk/test/tc/copy.rb
+   M /rio/trunk/test/tc/misc.rb
+   M /rio/trunk/test/tc/overload.rb
+
+removed copy, added (copy|append)_(to|from), changed + and =~ to use to_str
+------------------------------------------------------------------------
+r83 | kit | 2005-08-25 14:23:54 -0700 (Thu, 25 Aug 2005) | 1 line
+Changed paths:
+   M /rio/trunk/README
+   M /rio/trunk/lib/rio/doc/INTRO.rb
+   M /rio/trunk/lib/rio/doc/SYNOPSIS.rb
+   M /rio/trunk/lib/rio/if/dir.rb
+
+Documentation
+------------------------------------------------------------------------
+r82 | kit | 2005-08-24 09:06:42 -0700 (Wed, 24 Aug 2005) | 1 line
+Changed paths:
+   M /rio/trunk/doc/ANNOUNCE
+   M /rio/trunk/ex/colx.rb
+   M /rio/trunk/ex/passwd_report.rb
+   M /rio/trunk/ex/riocat
+   M /rio/trunk/ex/riogunzip
+   M /rio/trunk/ex/riogzip
+   A /rio/trunk/ex/rioprompt.rb
+   D /rio/trunk/lib/rio/context/chomp.rb
+   M /rio/trunk/lib/rio/context/methods.rb
+   M /rio/trunk/lib/rio/context.rb
+   D /rio/trunk/lib/rio/filter/chomp.rb
+   A /rio/trunk/lib/rio/filter.rb
+   A /rio/trunk/lib/rio/prompt.rb
+   M /rio/trunk/lib/rio/state.rb
+   M /rio/trunk/lib/rio/stream.rb
+
+chomp and strip
+------------------------------------------------------------------------
+r81 | kit | 2005-08-23 11:57:02 -0700 (Tue, 23 Aug 2005) | 1 line
+Changed paths:
+   M /rio/trunk/lib/rio/doc/INTRO.rb
+
+Documentation
+------------------------------------------------------------------------
 r79 | kit | 2005-08-19 17:01:44 -0700 (Fri, 19 Aug 2005) | 1 line
 Changed paths:
    M /rio/trunk/doc/ANNOUNCE

data/README

@@ -50,6 +50,14 @@ If you don't have rake installed, get it.
 Until you do, you may want to try
   ruby setup.rb
 
+Rio is also available as a gem. If you have rubygems installed use:
+  gem install rio
+
+To use Rio as a rubygem:
+  require 'rubygems'
+  require 'rio'
+
+
 To build the documentation without rake, try
  rdoc --op doc/rdoc -m RIO::Doc::SYNOPSIS README lib/rio/doc/*.rb lib/rio.rb lib/rio/if/*.rb lib/rio/kernel.rb
  
@@ -61,5 +69,9 @@ To read the documentation without running rdoc, read the files:
 * lib/rio/doc/HOWTO.rb
 * lib/rio/if/*.rb
 
+Project:: http://rubyforge.org/projects/rio/
+Documentation:: http://rio.rubyforge.org/
+Bugs:: http://rubyforge.org/tracker/?group_id=821
+Email:: rio4ruby@rubyforge.org
 
 

data/Rakefile

@@ -125,7 +125,7 @@ end
 #  rio(ZIP_DIR) << rio('pkg').files['*.tgz','*.tar.gz','*.zip','*.gem']
 #end
 task :ziparc do |var|
-  require 'rio/kernel'
+  require 'rio'
   #$trace_states = true
   rio(ZIP_DIR) < rio('pkg').files['*.tgz','*.tar.gz','*.zip','*.gem']
 end

data/VERSION

@@ -1 +1 @@
-0.3.3
+0.3.4

data/doc/ANNOUNCE

@@ -1,98 +1,187 @@
-For your perusal -- Rio 0.3.2
+New and Improved -- Rio 0.3.4
 
 == Overview
 
 Rio is a Ruby I/O convenience class wrapping much of the functionality
-of IO, File and Dir. Rio also uses Pathname, FileUtils, Tempfile,
-StringIO, OpenURI, Zlib, and CSV to provide similar functionality using
-a simple consistent interface. In addition to forwarding the interfaces
-provided by IO, File, and Dir to an appropriate object, Rio provides
-a "grande" interface that allows many common application-level I/O and
+of IO, File and Dir. Rio also uses FileUtils, Tempfile, StringIO,
+OpenURI, Zlib, and CSV to provide similar functionality using a simple
+consistent interface. In addition to forwarding the interfaces
+provided by IO, File, and Dir to an appropriate object, Rio provides a
+"grande" interface that allows many common application-level I/O and
 file-system tasks to be expressed succinctly.
 
-== New for version 0.3.3
-* Expanded support and documentation for CSV files
-  Examples:
-  * Copy, changing the separator to a semicolon
-     rio('comma.csv').csv > rio('semicolon.csv').csv(';')
-  * Iterate through a file with each line parsed into an array
-     rio('afile.csv').csv { |array_of_fields| ...}
-  * Create an array of arrays of selected fields
-     array_of_arrays = rio('afile.csv').csv.columns(1..3,7).to_a
-  * 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('report).csv("\t")
+== SYNOPSIS
 
-Project:: http://rubyforge.org/projects/rio/
-Documentation:: http://rio.rubyforge.org/
-Bugs:: http://rubyforge.org/tracker/?group_id=821
+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| ... }
 
-         
-== New for version 0.3.2
+Iterate over only the _dot_ files in a directory
+ rio('adir').files(/^\./) { |entrio| ... }
 
-* Based on a suggestion by Wybo Decker and code attributed to Nobu Nokada, 
-  Rio now supports temporary directories in addition to temporary files.
-* Bug fixes
-* More tests and documentation.
+Iterate over the files in a directory and its subdirectories, skipping
+'.svn' and 'CVS' directories
 
+ rio('adir').norecurse(/^\.svn$/,'CVS').files { |entrio| ... }
 
-== Version 0.3.1
+Create an array of the .rb entries in a directory
+ anarray = rio('adir')['*.rb']
 
-A Rio is and can manipulate:
-* a path
-* the string representing that path
-* the file, directory, web-page, or IO object to which that path refers
-* the object created by opening that file or directory.
+Create an array of the .rb entries in a directory and its
+subdirectories.
+ anarray = rio('adir').all['*.rb']
 
-A Rio open itself, closes itself and selects its mode based on how it
-used and the object referenced.
+Iterate over the .rb files in a directory and its subdirectories
+ rio('adir').all.files('*.rb') { |entrio| ... }
 
-== Grande interface
+Iterate over the non-empty, non-comment chomped lines of a file
+ rio('afile').chomp.skip.lines(:empty?,/^\s*#/) { |line| ... }
 
-With the grande interface you can:
+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 
 
-Copy...
- rio('afile') > astring                    # a file into a string
- rio('afile') < astring                    # a string into a file
- rio('afile') > anarray                    # lines of a file into array
- rio('afile') < anarray                    # an array into a file
- rio('afile') > rio('another_file')        # a file into another file
- rio('adir') > rio('another_directory')    # a directory into another
- rio('http://rubydoc.org/') > rio('afile') # a web page into a file
+Prompt for input and return what was typed
+ ans = rio(?-).print("Type Something: ").chomp.gets 
 
-Iterate...
- rio('adir').entries { |entrio| ... }      # over directory entries
- rio('adir').files { |entrio| ... }        # over only files
- rio('adir').dirs { |entrio| ... }         # over only directories
- rio('afile').lines { |line| ... }         # over lines in a file
+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 an array...
- rio('adir').files[]                       # of files
- rio('adir').dirs[]                        # of directories
- rio('afile').lines[]                      # of lines
+Create a symbolic link 'asymlink' in 'adir' which refers to
+'adir/afile'
+ rio('adir/afile').symlink('adir/asymlink')
 
-Whether copying, iterating or returning an array
-Rio provides common input manipulations
+Copy a CSV file, changing the separator to a semicolon
+ rio('comma.csv').csv > rio('semicolon.csv').csv(';')
 
- rio('afile').chomp > anarray              # chomped lines to an array
- anarray = rio('afile').chomp[]            # same thing
- rio('afile.gz').gzip > rio('afile')       # ungzip a file
- rio('afile.gz').gzip < rio('afile')       # gzip a file
- rio('afile.gz').chomp { |line| ...}       # iterate chomped lines
+Iterate through a CSVfile with each line parsed into an array
+ rio('afile.csv').csv { |array_of_fields| ...}
 
-Whether copying, iterating or returning an array
-Rio provides simple input selection
+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")
 
- rio('afile').lines(0..9) > rio('file2')   # the first 10 lines
- rio('afile').lines(/Rio/) { |line| ...}   # lines containing 'Rio'
- anarray = rio('adir').files['*.rb']       # ruby files
+== New for version 0.3.4
 
-Manipulation and selection methods can be combined
+* New Grande Selection parameter.
 
- rio('afile').gzip.lines(/Rio/) > astring  # 'Rio' lines from gz file
- anarray = rio('afile').chomp[0..9]        # first 10 lines chomped
+  A major weakness of Rio's selection methods (lines, files, etc.)
+  has always been that it only implemented a logical OR.
 
-Many more examples and documentation at http://rio.rubyforge.org/
+   rio('afile').lines(0..10,/Rio/) {...}
+  iterates through lines that are in the range 0..10 OR 
+  contain 'Rio'.
+
+   rio('adir').files(:executable?,'*.rb') {...}
+  iterates through files that are executable OR match '*.rb'
+
+  Selecting files that matched both required using a proc.
+   rio('adir').files(proc{ |f| f.executable? and f.fnmatch?('*.rb')}) {...}
+
+  Rio's grande selection methods will now accept an array of conditions
+  which must all be matched, in order to be selected. A logical AND.
+
+   rio('adir').files([:executable?,'*.rb']) {...}
+  
+  The array, of course, need not be the only paramter. 
+
+   rio('adir').files('*.exe',[:executable?,'*.rb']) {...}
+
+  selects .exe files and .rb files that are executable.
+
+* Renamed some of grande rejection methods. 
+  (based on a suggestion by Gavin Sinclair)
+   nolines => skiplines
+   nofiles => skipfiles
+  etc.
+
+* New skip() grande method
+   rio('afile').skip.lines(/Rio/)       # same as skiplines(/Rio/)
+   rio('afile').lines(/Rio/).skip(0..9) # lines with 'Rio', exclude 
+                                        # the first ten lines
+
+* Alternative syntaxes for creating Rios that have no path.
+   rio(?-)          # create a Rio refering to stdio
+   rio(:stdio)      # same thing.
+   rio.stdio        # same thing
+   RIO.stdio        # ditto
+   RIO::Rio.stdio   # once again
+
+* From Pathname added
+  * root?
+  * mountpoint?
+  * realpath
+  * cleanpath
+
+* Removed Rio#slurp in favor of Rio#contents.
+
+* Added aliases for the copy operators. (suggested by Dave Burt)
+   * copy_to >
+   * append_to >>
+   * copy_from <
+   * append_from <<
+
+* Bug fixes and corrections    
+  
+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, Christopher Kleckner. All rights reserved
@@ -101,4 +190,4 @@ Copyright (c) 2005, Christopher Kleckner. All rights reserved
 Rio is released under the GNU General Public License
 (http://www.gnu.org/licenses/gpl.html)
 
--Christopher Kleckner 
+-Christopher Kleckner