Sha256: 1204b7051dfce86ec86792dd3216e77781bfb0dc8b660a8fa96f31f6426489b9

Contents?: true

Size: 1.89 KB

Versions: 142

Compression:

Stored size: 1.89 KB

Contents

module Net; module SSH

  # A simple module to make logging easier to deal with. It assumes that the
  # logger instance (if not nil) quacks like a Logger object (in Ruby's
  # standard library). Although used primarily internally by Net::SSH, it
  # can easily be used to add Net::SSH-like logging to your own programs.
  #
  #   class MyClass
  #     include Net::SSH::Loggable
  #   end
  #
  #   Net::SSH.start(...) do |ssh|
  #     obj = MyClass.new
  #     obj.logger = ssh.logger
  #     ...
  #   end
  module Loggable
    # The logger instance that will be used to log messages. If nil, nothing
    # will be logged.
    attr_accessor :logger

    # Displays the result of yielding if the log level is Logger::DEBUG or
    # greater.
    def debug
      logger.add(Logger::DEBUG, nil, facility) { yield } if logger
    end

    # Displays the result of yielding if the log level is Logger::INFO or
    # greater.
    def info
      logger.add(Logger::INFO, nil, facility) { yield } if logger
    end

    # Displays the result of yielding if the log level is Logger::WARN or
    # greater. (Called lwarn to avoid shadowing with Kernel#warn.)
    def lwarn
      logger.add(Logger::WARN, nil, facility) { yield } if logger
    end

    # Displays the result of yielding if the log level is Logger:ERROR or
    # greater.
    def error
      logger.add(Logger::ERROR, nil, facility) { yield } if logger
    end

    # Displays the result of yielding if the log level is Logger::FATAL or
    # greater.
    def fatal
      logger.add(Logger::FATAL, nil, facility) { yield } if logger
    end

    private

      # Sets the "facility" value, used for reporting where a log message
      # originates. It defaults to the name of class with the object_id
      # appended.
      def facility
        @facility ||= self.class.name.gsub(/::/, ".").gsub(/([a-z])([A-Z])/, "\\1_\\2").downcase + "[%x]" % object_id
      end
  end
end; end

Version data entries

142 entries across 112 versions & 11 rubygems

Version Path
auser-poolparty-1.3.10 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.11 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.12 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.13 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.14 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.15 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.16 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.17 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.5 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.6 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.7 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
auser-poolparty-1.3.8 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
ddollar-net-ssh-2.0.1 lib/net/ssh/loggable.rb
fairchild-poolparty-1.3.17 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
fairchild-poolparty-1.3.5 vendor/gems/net-ssh/lib/net/ssh/loggable.rb
jayniz-net-ssh-2.0.15 lib/net/ssh/loggable.rb
kjvarga-net-ssh-2.0.12 lib/net/ssh/loggable.rb
net-ssh-net-ssh-2.0.12 lib/net/ssh/loggable.rb
net-ssh-net-ssh-2.0.13 lib/net/ssh/loggable.rb
net-ssh-net-ssh-2.0.14 lib/net/ssh/loggable.rb