win32-open3 0.3.1-x86-mswin32-60 → 0.3.2-x86-mswin32-60

data/CHANGES

@@ -1,75 +1,81 @@
-== 0.3.1 - 23-Jun-2009
-* Updated the license to Artistic 2.0
-* Set the license in the gemspec.
-* Added note regarding 1.9.x in the open3.txt file.
-
-== 0.3.0 - 22-Jun-2009
-* Fixed an issue where the block form of the Open3.popen3 method did not
-  return the exit value.
-* Fixed the version number.
-* Added a test to validate the exit value in block form.
-* Updated the gemspec description.
-
-== 0.2.9 - 8-Mar-2009
-* Fixed a bug within an internal function that could cause an exception.
-  Thanks go to Ross Bunker for the spot and patch.
-* Fixed the release dates for 0.2.7 and 0.2.8 (2009, not 2008).
-
-== 0.2.8 - 27-Feb-2009
-* Fixed a potential bug where nil might be returned instead of an actual
-  Process::Status object. Thanks go to Benny Bach for the spot.
-* The 'test' Rake task now runs the 'clean' task after the fact.
-* Some updates to the README about precompiled binaries.
-
-== 0.2.7 - 11-Jan-2009
-* Fixed a bug that could cause exitstatus to return bogus information. Thanks
-  go to Roman Zawada for the spot.
-* Added a 'build_binary_gem' Rake task.
-* Updates to the gemspec, including the addition of Park Heesob as the primary
-  author in the gemspec.
-* Renamed the test file and the example file.
-
-== 0.2.6 - 1-June-2007
-* Fixed RubyForge bug #20455 (closed IO stream). Thanks go an anonymous user
-  for the spot.
-* Added a Rakefile with tasks for building, testing and installation.
-* Minor updates to the test file.
-* Some minor rdoc improvements.
-
-== 0.2.5 - 8-Dec-2006
-* Added a WIN32_OPEN3_VERSION constant.
-* Fixes and updates to the gemspec.
-* Some internal reorganization.
-* Minor documentation updates and corrections.
-
-== 0.2.4 - 4-Jun-2006
-* Applied a patch for Windows 2000.  Thanks again to John-Mason Shackelford
-  for the patch.
-* Fixed the version number for the last release.
-
-== 0.2.3 - 3-Jun-2006
-* Now sets Process::Status when the block form is used.  Thanks go to
-  Samuel Tesla and John-Mason Shackelford for their patches.
-* Improved error messages.
-* Documentation updated with regards to the block form of the method calls.
-* Some internal reorganization that you don't care about.
-
-== 0.2.2 - 10-Feb-2006
-* Methods now support block form, and all handles are automatically closed
-  at the end of the block (via ensure).
-
-== 0.2.1 - 27-Oct-2005
-* Added a type check in the extconf.rb file and did some type mangling in
-  order to handle rb_pid_t in a backwards compatible way.  In other words,
-  you need this version to work with 1.8.3 or later.
-
-== 0.2.0 - 9-Jan-2005
-* Added the Open4 module and popen4 method.  Thanks go to Aslak Hellesoy for
-  the patch.
-* Added an optional 3rd parameter - the "show" flag.  See docs for details.
-* Made some documentation more rdoc friendly.
-* Moved the "examples" directory to the toplevel directory.
-* Added some information to the README file about possible compiler problems.
-
-== 0.1.0 - 8-Oct-2004
-* Initial release
+== 0.3.2 - 23-Jan-2010
+* Updated the gemspec. The required version is now any version less
+  than 1.9.x. This library is for the 1.8.x branch only.
+* The Rakefile now handles the gem building and installation and some
+  existing tasks were refactored.
+
+== 0.3.1 - 23-Jun-2009
+* Updated the license to Artistic 2.0
+* Set the license in the gemspec.
+* Added note regarding 1.9.x in the open3.txt file.
+
+== 0.3.0 - 22-Jun-2009
+* Fixed an issue where the block form of the Open3.popen3 method did not
+  return the exit value.
+* Fixed the version number.
+* Added a test to validate the exit value in block form.
+* Updated the gemspec description.
+
+== 0.2.9 - 8-Mar-2009
+* Fixed a bug within an internal function that could cause an exception.
+  Thanks go to Ross Bunker for the spot and patch.
+* Fixed the release dates for 0.2.7 and 0.2.8 (2009, not 2008).
+
+== 0.2.8 - 27-Feb-2009
+* Fixed a potential bug where nil might be returned instead of an actual
+  Process::Status object. Thanks go to Benny Bach for the spot.
+* The 'test' Rake task now runs the 'clean' task after the fact.
+* Some updates to the README about precompiled binaries.
+
+== 0.2.7 - 11-Jan-2009
+* Fixed a bug that could cause exitstatus to return bogus information. Thanks
+  go to Roman Zawada for the spot.
+* Added a 'build_binary_gem' Rake task.
+* Updates to the gemspec, including the addition of Park Heesob as the primary
+  author in the gemspec.
+* Renamed the test file and the example file.
+
+== 0.2.6 - 1-June-2007
+* Fixed RubyForge bug #20455 (closed IO stream). Thanks go an anonymous user
+  for the spot.
+* Added a Rakefile with tasks for building, testing and installation.
+* Minor updates to the test file.
+* Some minor rdoc improvements.
+
+== 0.2.5 - 8-Dec-2006
+* Added a WIN32_OPEN3_VERSION constant.
+* Fixes and updates to the gemspec.
+* Some internal reorganization.
+* Minor documentation updates and corrections.
+
+== 0.2.4 - 4-Jun-2006
+* Applied a patch for Windows 2000.  Thanks again to John-Mason Shackelford
+  for the patch.
+* Fixed the version number for the last release.
+
+== 0.2.3 - 3-Jun-2006
+* Now sets Process::Status when the block form is used.  Thanks go to
+  Samuel Tesla and John-Mason Shackelford for their patches.
+* Improved error messages.
+* Documentation updated with regards to the block form of the method calls.
+* Some internal reorganization that you don't care about.
+
+== 0.2.2 - 10-Feb-2006
+* Methods now support block form, and all handles are automatically closed
+  at the end of the block (via ensure).
+
+== 0.2.1 - 27-Oct-2005
+* Added a type check in the extconf.rb file and did some type mangling in
+  order to handle rb_pid_t in a backwards compatible way.  In other words,
+  you need this version to work with 1.8.3 or later.
+
+== 0.2.0 - 9-Jan-2005
+* Added the Open4 module and popen4 method.  Thanks go to Aslak Hellesoy for
+  the patch.
+* Added an optional 3rd parameter - the "show" flag.  See docs for details.
+* Made some documentation more rdoc friendly.
+* Moved the "examples" directory to the toplevel directory.
+* Added some information to the README file about possible compiler problems.
+
+== 0.1.0 - 8-Oct-2004
+* Initial release

data/MANIFEST

@@ -1,11 +1,11 @@
-* CHANGES
-* MANIFEST
-* README
-* Rakefile
-* win32-open3.gemspec
-* doc/open3.txt
-* examples/open3_test.rb
-* ext/extconf.rb
-* ext/win32/open3.c
-* ext/win32/open3.h
+* CHANGES
+* MANIFEST
+* README
+* Rakefile
+* win32-open3.gemspec
+* doc/open3.txt
+* examples/open3_test.rb
+* ext/extconf.rb
+* ext/win32/open3.c
+* ext/win32/open3.h
 * test/test_win32_open3.rb

data/README

@@ -1,62 +1,64 @@
-= Description
-   This library provides an Open3.popen3 implementation for MS Windows.
-
-= Prerequisites
-   Ruby 1.8.2 or later
-   C++ compiler (if building from source).
-   
-= Installation
-   rake test (optional)
-   rake install (non-gem) or rake install_gem (gem)
-   
-= Synopsis
-   require 'win32/open3'
-	
-   Open3.popen3('ver'){ |io_in, io_out, io_err|
-      error = io_err.gets
-      if error
-         puts "Error: " + error.chomp
-         exit
-      end
-      puts "Result: " + io_out.readlines.last.chomp
-   }
-
-= Notes
-   This library is not supported on Windows 95, 98, or ME.
-   This is a stripped down version of Park Heesob's win32_popen library.
-
-= Developer's Notes
-   This is a repackaging of Heesob's win32_popen module. The purpose of the
-   repackaging was to create a unified API between the existing Ruby open3
-   library and this library.
-
-   The popen2 and posix_popen methods are not included in this release. They
-   were originally part of the win32_popen module, but have been left out.
-   They may be added back in at a later date.
-
-   There are a couple of differences in the Windows version for open3 (which
-   also apply to Open4.popen4) - the mode flag and the show flag.  For the
-   mode, you can specify either 't' (text, the default) or 'b' (binary) as a
-   second argument. For the show flag, you can specify either true or false,
-   which will show the console window, or not, depending on the value you
-   pass.  The default is false.
-
-= Known Issues
-   I have noticed that this library (and others) may segfault if you are using
-   the latest version of the Ruby one-click installer and VC++ 7.0 or later.
-   This appears to be an issue between VC++ 6 (which the installer was built
-   with) and VC++ 7.0. Your best solution is to either upgrade your C
-   compiler or to rebuild Ruby from scratch rather than using the installer.
-   
-= Precompiled binaries
-
-   If you do a typical "gem install win32-open3" you will get a precompiled
-   binary appropriate for your platform. If you want to build from source,
-   go the project page and download, download the .zip file, and run the
-   'install' Rake task from the command line.
-   
-= Future Plans
-   Replace the current implementation with a pure Ruby version.
- 
-= More Documentation
-   See the doc/open3.txt file for more details.
+= Description
+  This library provides an Open3.popen3 implementation for MS Windows for
+  the Ruby 1.8.x branch.
+
+= Prerequisites
+  Ruby 1.8.x branch only
+  C++ compiler (if building from source)
+   
+= Installation
+  gem install win32-open3                        # Build and install from source
+  gem install win32-open3 --platform x86-mingw32 # Install the binary gem
+   
+= Synopsis
+  require 'win32/open3'
+	
+  Open3.popen3('ver'){ |io_in, io_out, io_err|
+    error = io_err.gets
+
+    if error
+      puts "Error: " + error.chomp
+      exit
+    end
+
+    puts "Result: " + io_out.readlines.last.chomp
+  }
+
+= Notes
+  This library is not supported on Windows 95, 98, or ME.
+  This is a stripped down version of Park Heesob's win32_popen library.
+
+= Developer's Notes
+  This is a repackaging of Heesob's win32_popen module. The purpose of the
+  repackaging was to create a unified API between the existing Ruby open3
+  library and this library.
+
+  The popen2 and posix_popen methods are not included in this release. They
+  were originally part of the win32_popen module, but have been left out.
+  They may be added back in at a later date.
+
+  There are a couple of differences in the Windows version for open3 (which
+  also apply to Open4.popen4) - the mode flag and the show flag.  For the
+  mode, you can specify either 't' (text, the default) or 'b' (binary) as a
+  second argument. For the show flag, you can specify either true or false,
+  which will show the console window, or not, depending on the value you
+  pass.  The default is false.
+
+= Known Issues
+  I have noticed that this library (and others) may segfault if you are using
+  the latest version of the Ruby one-click installer and VC++ 7.0 or later.
+  This appears to be an issue between VC++ 6 (which the installer was built
+  with) and VC++ 7.0. Your best solution is to either upgrade your C
+  compiler or to rebuild Ruby from scratch rather than using the installer.
+   
+= Precompiled binaries
+  If you do a typical "gem install win32-open3" you will get a precompiled
+  binary appropriate for your platform. If you want to build from source,
+  go the project page and download, download the .zip file, and run the
+  'install' Rake task from the command line.
+   
+= Future Plans
+  Replace the current implementation with a pure Ruby version, if possible.
+ 
+= More Documentation
+  See the doc/open3.txt file for more details.

data/Rakefile

@@ -0,0 +1,98 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rbconfig'
+include Config
+
+make = CONFIG['MAKEFILES'].nil? ? 'nmake' : 'make'
+
+desc 'Install the win32-open3 library'
+task :install => [:build] do
+  Dir.chdir('ext'){
+    sh "#{make} install"
+  }
+end
+
+desc "Clean any build files for win32-open3"
+task :clean do
+  Dir.chdir('ext') do
+    if File.exists?('open3.so') || File.exists?('win32/open3.so')
+      sh "#{make} distclean"
+      rm 'win32/open3.so' if File.exists?('win32/open3.so') 
+    end
+  end
+  rm_rf 'lib'
+end
+
+desc "Build win32-open3 (but don't install it)"
+task :build => [:clean] do
+  Dir.chdir('ext') do
+    ruby 'extconf.rb'
+    sh make
+    mv 'open3.so', 'win32' # For the test suite
+  end
+end
+
+desc "Run the sample program"
+task :example => [:build] do |t|
+  Dir.chdir('examples'){
+    sh 'ruby -I../ext open3_test.rb'
+  }
+end
+
+namespace 'gem' do
+  desc 'Clean any build files and remove the .gem file'
+  task :clean do
+    Dir["*.gem"].each{ |f| File.delete(f) }
+    Dir.chdir('ext') do
+      if File.exists?('open3.so') || File.exists?('win32/open3.so')
+        sh "#{make} distclean"
+        rm 'win32/open3.so' if File.exists?('win32/open3.so') 
+      end
+    end
+  end
+
+  desc 'Build the gem'
+  task :build => [:clean] do
+    spec = eval(IO.read('win32-open3.gemspec'))
+    Gem::Builder.new(spec).build
+  end
+
+  desc 'Install the win32-open3 library as a gem'
+  task :install => [:build] do
+    file = Dir["*.gem"].first
+    sh "gem install #{file}"
+  end
+
+  desc 'Build a binary gem'
+  task :binary => [:clean] do
+    Dir.chdir('ext') do
+      ruby 'extconf.rb'
+      sh make
+    end
+
+    mkdir_p 'lib/win32'
+    mv 'ext/open3.so', 'lib/win32'
+
+    spec = eval(IO.read('win32-open3.gemspec'))
+    spec.extensions = nil
+    spec.platform = Gem::Platform::CURRENT
+
+    spec.files = Dir['**/*'].reject{ |file|
+      file.include?('ext') || file.include?('git')
+    }
+
+    Gem::Builder.new(spec).build
+  end
+end
+
+Rake::TestTask.new('test') do |test|
+  task :test => [:build]
+  test.libs << 'ext'
+  test.warning = true
+  test.verbose = true
+end
+
+task :test do
+  Rake.application[:clean].execute
+end

data/doc/open3.txt

@@ -1,79 +1,79 @@
-= Description
-   An open3 library for MS Windows.
-	
-= Synopsis
-   require 'win32/open3'
-	
-   Open3.popen3('ver'){ |io_in, io_out, io_err|
-      error = io_err.gets
-      if error
-         puts "Error: " + error.chomp
-         exit
-      end
-      puts "Result: " + io_out.readlines.last.chomp
-   }
-
-= Module functions
-Open3.popen3(command, mode='t', show=false)
-
-Open3.popen3(command, mode='t', show=false){ |io_in, io_out, io_err| ... }
-
-   Executes 'command', returning an array of three IO handles representing
-   STDIN, STDOUT and STDERR, respectively.  In block form these IO handles
-   are yielded back to the block and automatically closed at the end of the
-   block.
-	
-   You may optionally pass a mode flag of 't' (text, the default) or 'b'
-   (binary) to this method.
-	
-   If the 'show' variable is set to true, then a console window is shown.
-
-Open4.popen4(command, mode='t', show=false)
-
-Open4.popen4(command, mode='t', show=false){ |io_in, io_out, io_err, pid| ... }
-   
-   Executes 'command', returning an array consisting of three IO handles,
-   representing STDIN, STDOUT and STDERR, respectively, as well as the PID
-   of the newly generated process.  In block form these IO handles and pid
-   are yielded back to the block and automatically closed at the end of the
-   block.
-	
-   You may optionally pass a mode flag of 't' (text, the default) or 'b'
-   (binary) to this method.
-	
-   If the 'show' variable is set to true, then a console window is shown.
-	
-= Notes
-   This is a remake of Park Heesob's win32_popen package.  It has been reworked
-   in order to make the API (nearly) identical to the Open3 package currently
-   included in the Ruby standard library.
-	
-   For now only the popen3 and popen4 methods have been included.  In later
-   releases we will probably add the popen2 and posix_popen methods back in.
-   
-   Ruby 1.9.x users will not generally need this library because of its support
-   for native threads. That means you can use the open3 library that ships as
-   part of the standard library.
-
-= Acknowledgements
-   Thanks go to Samuel Tesla and John-Mason Shackelford for their patches that
-   enabled us to set Process::Status.
-	
-= Known Bugs  
-   None that I know of.  Please log any other bug reports on the RubyForge
-   project page at http://www.rubyforge.net/projects/win32utils.
-      
-= License
-   Artistic 2.0
-        
-= Copyright
-   (C) 2003-2009 Daniel J. Berger, All Rights Reserved .
-       
-= Warranty
-   This package is provided "as is" and without any express or
-   implied warranties, including, without limitation, the implied
-   warranties of merchantability and fitness for a particular purpose.
-		
-= Authors
-   Park Heesob
-   Daniel J. Berger
+= Description
+  An open3 library for MS Windows for the Ruby 1.8.x branch.
+	
+= Synopsis
+  require 'win32/open3'
+	
+  Open3.popen3('ver'){ |io_in, io_out, io_err|
+    error = io_err.gets
+    if error
+      puts "Error: " + error.chomp
+      exit
+    end
+    puts "Result: " + io_out.readlines.last.chomp
+  }
+
+= Module functions
+Open3.popen3(command, mode='t', show=false)
+
+Open3.popen3(command, mode='t', show=false){ |io_in, io_out, io_err| ... }
+
+  Executes 'command', returning an array of three IO handles representing
+  STDIN, STDOUT and STDERR, respectively.  In block form these IO handles
+  are yielded back to the block and automatically closed at the end of the
+  block.
+	
+  You may optionally pass a mode flag of 't' (text, the default) or 'b'
+  (binary) to this method.
+	
+  If the 'show' variable is set to true, then a console window is shown.
+
+Open4.popen4(command, mode='t', show=false)
+
+Open4.popen4(command, mode='t', show=false){ |io_in, io_out, io_err, pid| ... }
+   
+  Executes 'command', returning an array consisting of three IO handles,
+  representing STDIN, STDOUT and STDERR, respectively, as well as the PID
+  of the newly generated process.  In block form these IO handles and pid
+  are yielded back to the block and automatically closed at the end of the
+  block.
+	
+  You may optionally pass a mode flag of 't' (text, the default) or 'b'
+  (binary) to this method.
+	
+  If the 'show' variable is set to true, then a console window is shown.
+	
+= Notes
+  This is a remake of Park Heesob's win32_popen package.  It has been reworked
+  in order to make the API (nearly) identical to the Open3 package currently
+  included in the Ruby standard library.
+	
+  For now only the popen3 and popen4 methods have been included.  In later
+  releases we will probably add the popen2 and posix_popen methods back in.
+   
+  Ruby 1.9.x users will not generally need this library because of its support
+  for native threads. That means you can use the open3 library that ships as
+  part of the standard library.
+
+= Acknowledgements
+  Thanks go to Samuel Tesla and John-Mason Shackelford for their patches that
+  enabled us to set Process::Status.
+	
+= Known Bugs  
+  None that I know of.  Please log any other bug reports on the RubyForge
+  project page at http://www.rubyforge.net/projects/win32utils.
+      
+= License
+  Artistic 2.0
+        
+= Copyright
+  (C) 2003-2010 Daniel J. Berger, All Rights Reserved .
+       
+= Warranty
+  This package is provided "as is" and without any express or
+  implied warranties, including, without limitation, the implied
+  warranties of merchantability and fitness for a particular purpose.
+	
+= Authors
+  Park Heesob
+  Daniel J. Berger