Module: Gem::Util
Relationships & Source Files | |
Defined in: | lib/rubygems/util.rb |
Overview
This module contains various utility methods as module methods.
Constant Summary
-
NULL_DEVICE =
# File 'lib/rubygems/util.rb', line 70defined?(IO::NULL) ? IO::NULL : Gem.win_platform? ? 'NUL' : '/dev/null'
Class Method Summary
-
.gunzip(data)
Zlib::GzipReader
wrapper that unzipsdata
. -
.gzip(data)
Zlib::GzipWriter
wrapper that zipsdata
. -
.inflate(data)
A
Zlib::Inflate#inflate
wrapper. -
.popen(*command)
This calls
IO.popen
where it accepts an array for acommand
(Ruby 1.9+) and implements an IO.popen-like behavior where it does not accept an array for a command. -
.silent_system(*command)
Invokes system, but silences all output.
-
.traverse_parents(directory)
Enumerates the parents of
directory
.
Class Method Details
.gunzip(data)
Zlib::GzipReader
wrapper that unzips data
.
# File 'lib/rubygems/util.rb', line 12
def self.gunzip(data) require 'zlib' require 'stringio' data = StringIO.new(data, 'r') unzipped = Zlib::GzipReader.new(data).read unzipped.force_encoding Encoding::BINARY if Object.const_defined? :Encoding unzipped end
.gzip(data)
Zlib::GzipWriter
wrapper that zips data
.
# File 'lib/rubygems/util.rb', line 25
def self.gzip(data) require 'zlib' require 'stringio' zipped = StringIO.new(String.new, 'w') zipped.set_encoding Encoding::BINARY if Object.const_defined? :Encoding Zlib::GzipWriter.wrap zipped do |io| io.write data end zipped.string end
.inflate(data)
A Zlib::Inflate#inflate
wrapper
# File 'lib/rubygems/util.rb', line 39
def self.inflate(data) require 'zlib' Zlib::Inflate.inflate data end
.popen(*command)
This calls IO.popen
where it accepts an array for a command
(Ruby 1.9+) and implements an IO.popen-like behavior where it does not accept an array for a command.
# File 'lib/rubygems/util.rb', line 49
def self.popen *command IO.popen command, &:read rescue TypeError # ruby 1.8 only supports string command r, w = IO.pipe pid = fork do STDIN.close STDOUT.reopen w exec(*command) end w.close begin return r.read ensure Process.wait pid end end
.silent_system(*command)
Invokes system, but silences all output.
# File 'lib/rubygems/util.rb', line 75
def self.silent_system *command opt = {:out => NULL_DEVICE, :err => [:child, :out]} if Hash === command.last opt.update(command.last) cmds = command[0...-1] else cmds = command.dup end return system(*(cmds << opt)) rescue TypeError require 'thread' @silent_mutex ||= Mutex.new null_device = NULL_DEVICE @silent_mutex.synchronize do begin stdout = STDOUT.dup stderr = STDERR.dup STDOUT.reopen null_device, 'w' STDERR.reopen null_device, 'w' return system(*command) ensure STDOUT.reopen stdout STDERR.reopen stderr stdout.close stderr.close end end end
.traverse_parents(directory)
Enumerates the parents of directory
.
# File 'lib/rubygems/util.rb', line 112
def self.traverse_parents directory return enum_for __method__, directory unless block_given? here = File. directory start = here Dir.chdir start begin loop do yield here Dir.chdir '..' return if Dir.pwd == here # toplevel here = Dir.pwd end ensure Dir.chdir start end end