require 'childprocess/version' require 'childprocess/errors' require 'childprocess/abstract_process' require 'childprocess/abstract_io' require 'childprocess/process_spawn_process' require "fcntl" require 'logger' module ChildProcess @posix_spawn = false class << self attr_writer :logger def new(*args) case os when :macosx, :linux, :solaris, :bsd, :cygwin, :aix Unix::Process.new(*args) when :windows Windows::Process.new(*args) else raise Error, "unsupported platform #{platform_name.inspect}" end end alias_method :build, :new def logger return @logger if defined?(@logger) and @logger @logger = Logger.new($stderr) @logger.level = $DEBUG ? Logger::DEBUG : Logger::INFO @logger end def platform os end def platform_name @platform_name ||= "#{arch}-#{os}" end def unix? !windows? end def linux? os == :linux end def jruby? RUBY_ENGINE == 'jruby' end def windows? os == :windows end def posix_spawn_chosen_explicitly? @posix_spawn || %w[1 true].include?(ENV['CHILDPROCESS_POSIX_SPAWN']) end def posix_spawn? false end # # Set this to true to enable experimental use of posix_spawn. # def posix_spawn=(bool) @posix_spawn = bool end def os return :windows if ENV['FAKE_WINDOWS'] == 'true' @os ||= ( require "rbconfig" host_os = RbConfig::CONFIG['host_os'].downcase case host_os when /linux/ :linux when /darwin|mac os/ :macosx when /mswin|msys|mingw32/ :windows when /cygwin/ :cygwin when /solaris|sunos/ :solaris when /bsd|dragonfly/ :bsd when /aix/ :aix else raise Error, "unknown os: #{host_os.inspect}" end ) end def arch @arch ||= ( host_cpu = RbConfig::CONFIG['host_cpu'].downcase case host_cpu when /i[3456]86/ if workaround_older_macosx_misreported_cpu? # Workaround case: older 64-bit Darwin Rubies misreported as i686 "x86_64" else "i386" end when /amd64|x86_64/ "x86_64" when /ppc|powerpc/ "powerpc" else host_cpu end ) end # # By default, a child process will inherit open file descriptors from the # parent process. This helper provides a cross-platform way of making sure # that doesn't happen for the given file/io. # def close_on_exec(file) if file.respond_to?(:close_on_exec=) file.close_on_exec = true else raise Error, "not sure how to set close-on-exec for #{file.inspect} on #{platform_name.inspect}" end end private def warn_once(msg) @warnings ||= {} unless @warnings[msg] @warnings[msg] = true logger.warn msg end end # Workaround: detect the situation that an older Darwin Ruby is actually # 64-bit, but is misreporting cpu as i686, which would imply 32-bit. # # @return [Boolean] `true` if: # (a) on Mac OS X # (b) actually running in 64-bit mode def workaround_older_macosx_misreported_cpu? os == :macosx && is_64_bit? end # @return [Boolean] `true` if this Ruby represents `1` in 64 bits (8 bytes). def is_64_bit? 1.size == 8 end end # class << self end # ChildProcess if ChildProcess.windows? require 'childprocess/windows' else require 'childprocess/unix' end