right_agent 0.5.1

data/lib/right_agent/monkey_patches/ruby_patch/object_patch.rb

@@ -0,0 +1,49 @@
+#
+# Copyright (c) 2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+class Object
+  unless defined? instance_exec # 1.9 and 1.8.7
+    module InstanceExecHelper; end
+    include InstanceExecHelper
+
+    # Evaluate the block with the given arguments within the context of
+    # this object, so self is set to the method receiver.
+    #
+    # From Mauricio's http://eigenclass.org/hiki/bounded+space+instance_exec
+    def instance_exec(*args, &block)
+      begin
+        old_critical, Thread.critical = Thread.critical, true
+        n = 0
+        n += 1 while respond_to?(method_name = "__instance_exec#{n}")
+        InstanceExecMethods.module_eval { define_method(method_name, &block) }
+      ensure
+        Thread.critical = old_critical
+      end
+
+      begin
+        send(method_name, *args)
+      ensure
+        InstanceExecMethods.module_eval { remove_method(method_name) } rescue nil
+      end
+    end
+  end
+end

data/lib/right_agent/monkey_patches/ruby_patch/singleton_patch.rb

@@ -0,0 +1,46 @@
+#
+# Copyright (c) 2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'singleton'
+
+module RightScale
+
+  module Singleton
+
+    module ClassMethods
+
+      # Redirect class methods to singleton instance
+      def method_missing(meth, *args, &blk)
+        self.instance.__send__(meth, *args, &blk)
+      end
+
+    end
+
+    # Upon inclusion, also include standard Singleton mixin
+    def self.included(base)
+      base.__send__(:include, ::Singleton)
+      base.__send__(:extend, ClassMethods)
+    end
+
+  end
+
+end

data/lib/right_agent/monkey_patches/ruby_patch/string_patch.rb

@@ -0,0 +1,107 @@
+#
+# Copyright (c) 2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+class String
+  ##
+  # Convert to snake case.
+  #
+  #   "FooBar".snake_case           #=> "foo_bar"
+  #   "HeadlineCNNNews".snake_case  #=> "headline_cnn_news"
+  #   "CNN".snake_case              #=> "cnn"
+  #
+  # @return [String] Receiver converted to snake case.
+  #
+  # @api public
+  def snake_case
+    return downcase if match(/\A[A-Z]+\z/)
+    gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2').
+    gsub(/([a-z])([A-Z])/, '\1_\2').
+    downcase
+  end
+
+  ##
+  # Convert a constant name to a path, assuming a conventional structure.
+  #
+  #   "FooBar::Baz".to_const_path # => "foo_bar/baz"
+  #
+  # @return [String] Path to the file containing the constant named by receiver
+  #   (constantized string), assuming a conventional structure.
+  #
+  # @api public
+  def to_const_path
+    snake_case.gsub(/::/, "/")
+  end
+
+  # Convert constant name to constant
+  #
+  #    "FooBar::Baz".to_const => FooBar::Baz
+  #
+  # @return [Constant] Constant corresponding to given name or nil if no
+  #   constant with that name exists
+  #
+  # @api public
+  def to_const
+    names = split('::')
+    names.shift if names.empty? || names.first.empty?
+
+    constant = Object
+    names.each do |name|
+      # modified to return nil instead of raising an const_missing error
+      constant = constant && constant.const_defined?(name) ? constant.const_get(name) : nil
+    end
+    constant
+  end
+
+  # Reverse operation of snake case:
+  #
+  #    "some_string/some_other_string" => "SomeString::SomeOtherString"
+  #
+  # @return [String] Camelized string
+  #
+  # @api public
+  if !String.public_method_defined?(:camelize)
+    def camelize(first_letter = :upper)
+      case first_letter
+        when :upper then gsub(/\/(.?)/) { "::" + $1.upcase }.gsub(/(^|_)(.)/) { $2.upcase }
+        when :lower then first + camelize(self)[1..-1]
+      end
+    end
+  end
+
+  # Add ability to output colored text to console
+  # e.g.: puts "Hello".red
+  def bold; colorize("\e[1m\e[29m"); end
+  def grey; colorize("\e[30m"); end
+  def red; colorize("\e[1m\e[31m"); end
+  def dark_red; colorize("\e[31m"); end
+  def green; colorize("\e[1m\e[32m"); end
+  def dark_green; colorize("\e[32m"); end
+  def yellow; colorize("\e[1m\e[33m"); end
+  def blue; colorize("\e[1m\e[34m"); end
+  def dark_blue; colorize("\e[34m"); end
+  def pur; colorize("\e[1m\e[35m"); end
+  def colorize(color_code)
+    # Doesn't work with the Windows prompt...
+    (RightScale::Platform.windows? || !$stdout.isatty) ? to_s : "#{color_code}#{to_s}\e[0m"
+  end
+
+end

data/lib/right_agent/monkey_patches/ruby_patch/windows_patch.rb

@@ -0,0 +1,32 @@
+#
+# Copyright (c) 2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+# load File monkey-patch first to enable use of File.normalize_path
+require File.expand_path(File.join(File.dirname(__FILE__), 'windows_patch', 'file_patch'))
+
+# hereafter used normalize_path to ensure files are only required once.
+WINDOWS_MONKEY_PATCHES_BASE_DIR = File.normalize_path(File.join(File.dirname(__FILE__), 'windows_patch'))
+
+require File.join(WINDOWS_MONKEY_PATCHES_BASE_DIR, 'process_patch')
+require File.join(WINDOWS_MONKEY_PATCHES_BASE_DIR, 'stdio_patch')
+require File.join(WINDOWS_MONKEY_PATCHES_BASE_DIR, 'time_patch')
+require File.join(WINDOWS_MONKEY_PATCHES_BASE_DIR, 'win32ole_patch')

data/lib/right_agent/monkey_patches/ruby_patch/windows_patch/file_patch.rb

@@ -0,0 +1,90 @@
+#
+# Copyright (c) 2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'rubygems'
+
+begin
+  require 'windows/file'
+
+  class File
+
+    # converts a long path to a short path. in windows terms, this means
+    # taking any file/folder name over 8 characters in length and truncating
+    # it to 6 characters with ~1..~n appended depending on how many similar
+    # names exist in the same directory. file extensions are simply chopped
+    # at three letters. the short name is equivalent for all API calls to
+    # the long path but requires no special quoting, etc. the path must
+    # exist at least partially for the API call to succeed.
+    #
+    # === Parameters
+    # long_path(String):: fully or partially existing long path to be
+    # converted to its short path equivalent.
+    #
+    # === Return
+    # short_path(String):: short path equivalent or same path if non-existent
+    def self.long_path_to_short_path(long_path)
+      if File.exists?(long_path)
+        length = 260
+        while true
+          buffer = 0.chr * length
+          length = ::Windows::File::GetShortPathName.call(long_path, buffer, buffer.length)
+          if length < buffer.length
+            break
+          end
+        end
+        return buffer.unpack('A*').first.gsub("\\", "/")
+      else
+        # must get short path for any existing ancestor since child doesn't
+        # (currently) exist.
+        child_name = File.basename(long_path)
+        long_parent_path = File.dirname(long_path)
+
+        # note that root dirname is root itself (at least in windows)
+        return long_path if long_path == long_parent_path
+
+        # recursion
+        short_parent_path = long_path_to_short_path(File.dirname(long_path))
+        return File.join(short_parent_path, child_name)
+      end
+    end
+
+    # First expand the path then shorten the directory.
+    # Only shorten the directory and not the file name because 'gem' wants
+    # long file names
+    def self.normalize_path(file_name, *dir_string)
+      path = File.expand_path(file_name, *dir_string)
+      dir = self.long_path_to_short_path(File.dirname(path))
+      File.join(dir, File.basename(path))
+    end
+
+  end
+
+rescue LoadError
+  # use the simple definition of normalize_path to avoid breaking code which
+  # depends on having this definition.
+  class File
+    def self.normalize_path(file_name, *dir_string)
+      File.expand_path(file_name, *dir_string)
+    end
+  end
+
+end

data/lib/right_agent/monkey_patches/ruby_patch/windows_patch/process_patch.rb

@@ -0,0 +1,63 @@
+#
+# Copyright (c) 2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'rubygems'
+
+begin
+  # win32/process monkey-patches the Process class but drops support for any kill
+  # signals which are not directly portable. some signals are acceptable, if not
+  # strictly portable. the 'TERM' signal used to be supported in Ruby v1.8.6 but
+  # raises an exception in Ruby v1.8.7. we will monkey-patch the monkey-patch to
+  # get the best possible implementation of signals.
+  WIN32_PROCESS_LOAD_ORDER_ERROR = "Must require process_patch before win32/process"
+
+  module Process
+    unless defined?(@@ruby_c_kill)
+      @@ruby_c_kill = method(:kill)
+
+      # check to ensure this is the first time 'win32/process' has been required
+      raise LoadError, WIN32_PROCESS_LOAD_ORDER_ERROR unless require 'win32/process'
+
+      @@win32_kill = method(:kill)
+
+      def self.kill(sig, *pids)
+        sig = 1 if 'TERM' == sig  # Signals 1 and 4-8 kill the process in a nice manner.
+        @@win32_kill.call(sig, *pids)
+      end
+
+      # implements getpgid() for Windws
+      def self.getpgid(pid)
+        # FIX: we currently only use this to check if the process is running.
+        # it is possible to get the parent process id for a process in Windows if
+        # we actually need this info.
+        return Process.kill(0, pid).contains?(pid) ? 0 : -1
+      rescue
+        raise Errno::ESRCH
+      end
+    end
+  end
+
+rescue LoadError => e
+  # ignore load error and skip monkey-patch if gems are not yet installed.
+  # re-raise if the error condition we explicitly check for.
+  raise if WIN32_PROCESS_LOAD_ORDER_ERROR == e.message
+end

data/lib/right_agent/monkey_patches/ruby_patch/windows_patch/stdio_patch.rb

@@ -0,0 +1,27 @@
+#
+# Copyright (c) 2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+# it's useful to auto-flush console output on Windows where it would otherwise
+# be unavailable from a ruby process which was hanging (our code would never
+# hang, of course). this is consistent with Powershell's auto-flush behavior.
+STDOUT.sync = true
+STDERR.sync = true

data/lib/right_agent/monkey_patches/ruby_patch/windows_patch/time_patch.rb

@@ -0,0 +1,55 @@
+#
+# Copyright (c) 2011 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'rubygems'
+
+begin
+  require 'windows/time'
+
+  # monkey patch Time.now because Windows Ruby interpreters used the wrong API
+  # and queried local time instead of UTC time prior to Ruby v1.9.1. This
+  # made the Ruby 1.8.x interpreters vulnerable to external changes to
+  # timezone which cause Time.now to return times which are offset from from the
+  # correct value. This implementation is borrowed from the C source for Ruby
+  # v1.9.1 from www.ruby-lang.org ("win32/win32.c").
+  if RUBY_VERSION < "1.9.1"
+    class Time
+      def self.now
+        # query UTC time as a 64-bit ularge value.
+        filetime = 0.chr * 8
+        ::Windows::Time::GetSystemTimeAsFileTime.call(filetime)
+        low_date_time = filetime[0,4].unpack('V')[0]
+        high_date_time = filetime[4,4].unpack('V')[0]
+        value = high_date_time * 0x100000000 + low_date_time
+
+        # value is now 100-nanosec intervals since 1601/01/01 00:00:00 UTC,
+        # convert it into UNIX time (since 1970/01/01 00:00:00 UTC).
+        value /= 10  # 100-nanoseconds to microseconds
+        microseconds = 1000 * 1000
+        value -= ((1970 - 1601) * 365.2425).to_i * 24 * 60 * 60 * microseconds
+        return Time.at(value / microseconds, value % microseconds)
+      end
+    end
+  end
+rescue LoadError
+  # ignore load error and skip monkey-patch if gems are not yet installed.
+end