geminfo 0.1.0 → 0.1.1

data/path/gems/lumberjack-1.0.9/lib/lumberjack/formatter/pretty_print_formatter.rb

@@ -1,23 +0,0 @@
-require 'pp'
-require 'stringio'
-
-module Lumberjack
-  class Formatter
-    # Format an object with it's pretty print method.
-    class PrettyPrintFormatter
-      attr_accessor :width
-      
-      # Create a new formatter. The maximum width of the message can be specified with the width
-      # parameter (defaults to 79 characters).
-      def initialize(width = 79)
-        @width = width
-      end
-      
-      def call(obj)
-        s = StringIO.new
-        PP.pp(obj, s)
-        s.string.chomp
-      end
-    end
-  end
-end

data/path/gems/lumberjack-1.0.9/lib/lumberjack/formatter/string_formatter.rb

@@ -1,10 +0,0 @@
-module Lumberjack
-  class Formatter
-    # Format an object by calling +to_s+ on it.
-    class StringFormatter
-      def call(obj)
-        obj.to_s
-      end
-    end
-  end
-end

data/path/gems/lumberjack-1.0.9/lib/lumberjack/log_entry.rb

@@ -1,36 +0,0 @@
-module Lumberjack
-  # An entry in a log is a data structure that captures the log message as well as
-  # information about the system that logged the message.
-  class LogEntry
-    attr_accessor :time, :message, :severity, :progname, :pid, :unit_of_work_id
-    
-    TIME_FORMAT = "%Y-%m-%dT%H:%M:%S".freeze
-    
-    def initialize(time, severity, message, progname, pid, unit_of_work_id)
-      @time = time
-      @severity = (severity.is_a?(Fixnum) ? severity : Severity.label_to_level(severity))
-      @message = message
-      @progname = progname
-      @pid = pid
-      @unit_of_work_id = unit_of_work_id
-    end
-    
-    def severity_label
-      Severity.level_to_label(severity)
-    end
-    
-    def to_s
-      buf = "[#{time.strftime(TIME_FORMAT)}.#{(time.usec / 1000.0).round.to_s.rjust(3, '0')} #{severity_label} #{progname}(#{pid})"
-      if unit_of_work_id
-        buf << " #"
-        buf << unit_of_work_id
-      end
-      buf << "] "
-      buf << message
-    end
-    
-    def inspect
-      to_s
-    end
-  end
-end

data/path/gems/lumberjack-1.0.9/lib/lumberjack/logger.rb

@@ -1,315 +0,0 @@
-module Lumberjack
-  # Logger is a thread safe logging object. It has a compatible API with the Ruby
-  # standard library Logger class, the Log4r gem, and ActiveSupport::BufferedLogger.
-  #
-  # === Example
-  #
-  #   logger = Lumberjack::Logger.new
-  #   logger.info("Starting processing")
-  #   logger.debug("Processing options #{options.inspect}")
-  #   logger.fatal("OMG the application is on fire!")
-  #
-  # Log entries are written to a logging Device if their severity meets or exceeds the log level.
-  #
-  # Devices may use buffers internally and the log entries are not guaranteed to be written until you call
-  # the +flush+ method. Sometimes this can result in problems when trying to track down extraordinarily
-  # long running sections of code since it is likely that none of the messages logged before the long
-  # running code will appear in the log until the entire process finishes. You can set the +:flush_seconds+
-  # option on the constructor to force the device to be flushed periodically. This will create a new
-  # monitoring thread, but its use is highly recommended.
-  #
-  # Each log entry records the log message and severity along with the time it was logged, the
-  # program name, process id, and unit of work id. The message will be converted to a string, but
-  # otherwise, it is up to the device how these values are recorded. Messages are converted to strings
-  # using a Formatter associated with the logger.
-  class Logger
-    include Severity
-
-    # The time that the device was last flushed.
-    attr_reader :last_flushed_at
-
-    # The name of the program associated with log messages.
-    attr_writer :progname
-
-    # The device being written to.
-    attr_reader :device
-
-    # Set +silencer+ to false to disable silencing the log.
-    attr_accessor :silencer
-
-    # Create a new logger to log to a Device.
-    #
-    # The +device+ argument can be in any one of several formats.
-    #
-    # If it is a Device object, that object will be used.
-    # If it has a +write+ method, it will be wrapped in a Device::Writer class.
-    # If it is <tt>:null</tt>, it will be a Null device that won't record any output.
-    # Otherwise, it will be assumed to be file path and wrapped in a Device::LogFile class.
-    #
-    # This method can take the following options:
-    #
-    # * <tt>:level</tt> - The logging level below which messages will be ignored.
-    # * <tt>:progname</tt> - The name of the program that will be recorded with each log entry.
-    # * <tt>:flush_seconds</tt> - The maximum number of seconds between flush calls.
-    # * <tt>:roll</tt> - If the log device is a file path, it will be a Device::DateRollingLogFile if this is set.
-    # * <tt>:max_size</tt> - If the log device is a file path, it will be a Device::SizeRollingLogFile if this is set.
-    #
-    # All other options are passed to the device constuctor.
-    def initialize(device = STDOUT, options = {})
-      @thread_settings = {}
-
-      options = options.dup
-      self.level = options.delete(:level) || INFO
-      self.progname = options.delete(:progname)
-      max_flush_seconds = options.delete(:flush_seconds).to_f
-
-      @device = open_device(device, options)
-      @_formatter = Formatter.new
-      @lock = Mutex.new
-      @last_flushed_at = Time.now
-      @silencer = true
-
-      create_flusher_thread(max_flush_seconds) if max_flush_seconds > 0
-    end
-
-    # Get the Formatter object used to convert messages into strings.
-    def formatter
-      @_formatter
-    end
-
-    # Get the level of severity of entries that are logged. Entries with a lower
-    # severity level will be ignored.
-    def level
-      thread_local_value(:lumberjack_logger_level) || @level
-    end
-
-    # Add a message to the log with a given severity. The message can be either
-    # passed in the +message+ argument or supplied with a block. This method
-    # is not normally called. Instead call one of the helper functions
-    # +fatal+, +error+, +warn+, +info+, or +debug+.
-    #
-    # The severity can be passed in either as one of the Severity constants,
-    # or as a Severity label.
-    #
-    # === Example
-    #
-    #   logger.add(Lumberjack::Severity::ERROR, exception)
-    #   logger.add(Lumberjack::Severity::INFO, "Request completed")
-    #   logger.add(:warn, "Request took a long time")
-    #   logger.add(Lumberjack::Severity::DEBUG){"Start processing with options #{options.inspect}"}
-    def add(severity, message = nil, progname = nil)
-      severity = Severity.label_to_level(severity) if severity.is_a?(String) || severity.is_a?(Symbol)
-
-      return unless severity && severity >= level
-
-      time = Time.now
-      if message.nil?
-        if block_given?
-          message = yield
-        else
-          message = progname
-          progname = nil
-        end
-      end
-
-      message = @_formatter.format(message)
-      progname ||= self.progname
-      entry = LogEntry.new(time, severity, message, progname, $$, Lumberjack.unit_of_work_id)
-      begin
-        device.write(entry)
-      rescue => e
-        $stderr.puts("#{e.class.name}: #{e.message}#{' at ' + e.backtrace.first if e.backtrace}")
-        $stderr.puts(entry.to_s)
-      end
-
-      nil
-    end
-
-    alias_method :log, :add
-
-    # Flush the logging device. Messages are not guaranteed to be written until this method is called.
-    def flush
-      device.flush
-      @last_flushed_at = Time.now
-      nil
-    end
-
-    # Close the logging device.
-    def close
-      flush
-      @device.close if @device.respond_to?(:close)
-    end
-
-    # Log a +FATAL+ message. The message can be passed in either the +message+ argument or in a block.
-    def fatal(message = nil, progname = nil, &block)
-      add(FATAL, message, progname, &block)
-    end
-
-    # Return +true+ if +FATAL+ messages are being logged.
-    def fatal?
-      level <= FATAL
-    end
-
-    # Log an +ERROR+ message. The message can be passed in either the +message+ argument or in a block.
-    def error(message = nil, progname = nil, &block)
-      add(ERROR, message, progname, &block)
-    end
-
-    # Return +true+ if +ERROR+ messages are being logged.
-    def error?
-      level <= ERROR
-    end
-
-    # Log a +WARN+ message. The message can be passed in either the +message+ argument or in a block.
-    def warn(message = nil, progname = nil, &block)
-      add(WARN, message, progname, &block)
-    end
-
-    # Return +true+ if +WARN+ messages are being logged.
-    def warn?
-      level <= WARN
-    end
-
-    # Log an +INFO+ message. The message can be passed in either the +message+ argument or in a block.
-    def info(message = nil, progname = nil, &block)
-      add(INFO, message, progname, &block)
-    end
-
-    # Return +true+ if +INFO+ messages are being logged.
-    def info?
-      level <= INFO
-    end
-
-    # Log a +DEBUG+ message. The message can be passed in either the +message+ argument or in a block.
-    def debug(message = nil, progname = nil, &block)
-      add(DEBUG, message, progname, &block)
-    end
-
-    # Return +true+ if +DEBUG+ messages are being logged.
-    def debug?
-      level <= DEBUG
-    end
-
-    # Log a message when the severity is not known. Unknown messages will always appear in the log.
-    # The message can be passed in either the +message+ argument or in a block.
-    def unknown(message = nil, progname = nil, &block)
-      add(UNKNOWN, message, progname, &block)
-    end
-
-    alias_method :<<, :unknown
-
-    # Set the minimum level of severity of messages to log.
-    def level=(severity)
-      if severity.is_a?(Fixnum)
-        @level = severity
-      else
-        @level = Severity.label_to_level(severity)
-      end
-    end
-
-    # Silence the logger by setting a new log level inside a block. By default, only +ERROR+ or +FATAL+
-    # messages will be logged.
-    #
-    # === Example
-    #
-    #   logger.level = Lumberjack::Severity::INFO
-    #   logger.silence do
-    #     do_something   # Log level inside the block is +ERROR+
-    #   end
-    def silence(temporary_level = ERROR, &block)
-      if silencer
-        push_thread_local_value(:lumberjack_logger_level, temporary_level, &block)
-      else
-        yield
-      end
-    end
-
-    # Set the program name that is associated with log messages. If a block
-    # is given, the program name will be valid only within the block.
-    def set_progname(value, &block)
-      if block
-        push_thread_local_value(:lumberjack_logger_progname, value, &block)
-      else
-        self.progname = value
-      end
-    end
-
-    # Get the program name associated with log messages.
-    def progname
-      thread_local_value(:lumberjack_logger_progname) || @progname
-    end
-
-    private
-
-    # Set a local value for a thread tied to this object.
-    def set_thread_local_value(name, value) #:nodoc:
-      values = Thread.current[name]
-      unless values
-        values = {}
-        Thread.current[name] = values
-      end
-      if value.nil?
-        values.delete(self)
-        Thread.current[name] = nil if values.empty?
-      else
-        values[self] = value
-      end
-    end
-
-    # Get a local value for a thread tied to this object.
-    def thread_local_value(name) #:nodoc:
-      values = Thread.current[name]
-      values[self] if values
-    end
-
-    # Set a local value for a thread tied to this object within a block.
-    def push_thread_local_value(name, value) #:nodoc:
-      save_val = thread_local_value(name)
-      set_thread_local_value(name, value)
-      begin
-        yield
-      ensure
-        set_thread_local_value(name, save_val)
-      end
-    end
-
-    # Open a logging device.
-    def open_device(device, options) #:nodoc:
-      if device.is_a?(Device)
-        device
-      elsif device.respond_to?(:write) && device.respond_to?(:flush)
-        Device::Writer.new(device, options)
-      elsif device == :null
-        Device::Null.new
-      else
-        device = device.to_s
-        if options[:roll]
-          Device::DateRollingLogFile.new(device, options)
-        elsif options[:max_size]
-            Device::SizeRollingLogFile.new(device, options)
-        else
-          Device::LogFile.new(device, options)
-        end
-      end
-    end
-
-    # Create a thread that will periodically call flush.
-    def create_flusher_thread(flush_seconds) #:nodoc:
-      if flush_seconds > 0
-        begin
-          logger = self
-          Thread.new do
-            loop do
-              begin
-                sleep(flush_seconds)
-                logger.flush if Time.now - logger.last_flushed_at >= flush_seconds
-              rescue => e
-                STDERR.puts("Error flushing log: #{e.inspect}")
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/path/gems/lumberjack-1.0.9/lib/lumberjack/rack.rb

@@ -1,5 +0,0 @@
-module Lumberjack
-  module Rack
-    autoload :UnitOfWork, File.expand_path("../rack/unit_of_work.rb", __FILE__)
-  end
-end

data/path/gems/lumberjack-1.0.9/lib/lumberjack/rack/unit_of_work.rb

@@ -1,15 +0,0 @@
-module Lumberjack
-  module Rack
-    class UnitOfWork
-      def initialize(app)
-        @app = app
-      end
-      
-      def call(env)
-        Lumberjack.unit_of_work do
-          @app.call(env)
-        end
-      end
-    end
-  end
-end

data/path/gems/lumberjack-1.0.9/lib/lumberjack/severity.rb

@@ -1,23 +0,0 @@
-module Lumberjack
-  # The standard severity levels for logging messages.
-  module Severity
-    UNKNOWN = 5
-    FATAL = 4
-    ERROR = 3
-    WARN = 2
-    INFO = 1
-    DEBUG = 0
-    
-    SEVERITY_LABELS = %w(DEBUG INFO WARN ERROR FATAL UNKNOWN).freeze
-    
-    class << self
-      def level_to_label(severity)
-        SEVERITY_LABELS[severity] || SEVERITY_LABELS.last
-      end
-    
-      def label_to_level(label)
-        SEVERITY_LABELS.index(label.to_s.upcase) || UNKNOWN
-      end
-    end
-  end
-end

data/path/gems/lumberjack-1.0.9/lib/lumberjack/template.rb

@@ -1,71 +0,0 @@
-module Lumberjack
-  # A template converts entries to strings. Templates can contain the following place holders to
-  # reference log entry values:
-  #
-  # * <tt>:time</tt>
-  # * <tt>:severity</tt>
-  # * <tt>:progname</tt>
-  # * <tt>:unit_of_work_id</tt>
-  # * <tt>:message</tt>
-  class Template
-    TEMPLATE_ARGUMENT_ORDER = %w(:time :severity :progname :pid :unit_of_work_id :message).freeze
-    DEFAULT_TIME_FORMAT = "%Y-%m-%dT%H:%M:%S."
-    MILLISECOND_FORMAT = "%03d"
-    MICROSECOND_FORMAT = "%06d"
-    
-    # Create a new template from the markup. The +first_line+ argument is used to format only the first
-    # line of a message. Additional lines will be added to the message unformatted. If you wish to format
-    # the additional lines, use the <tt>:additional_lines</tt> options to specify a template. Note that you'll need
-    # to provide the line separator character in this template if you want to keep the message on multiple lines.
-    #
-    # The time will be formatted as YYYY-MM-DDTHH:MM:SSS.SSS by default. If you wish to change the format, you
-    # can specify the <tt>:time_format</tt> option which can be either a time format template as documented in
-    # +Time#strftime+ or the values +:milliseconds+ or +:microseconds+ to use the standard format with the
-    # specified precision.
-    #
-    # Messages will have white space stripped from both ends.
-    def initialize(first_line, options = {})
-      @first_line_template = compile(first_line)
-      additional_lines = options[:additional_lines] || "#{Lumberjack::LINE_SEPARATOR}:message"
-      @additional_line_template = compile(additional_lines)
-      # Formatting the time is relatively expensive, so only do it if it will be used
-      @template_include_time = first_line.include?(":time") || additional_lines.include?(":time")
-      @time_format = options[:time_format] || :milliseconds
-    end
-    
-    # Convert an entry into a string using the template.
-    def call(entry)
-      lines = entry.message.strip.split(Lumberjack::LINE_SEPARATOR)
-      formatted_time = format_time(entry.time) if @template_include_time
-      message = @first_line_template % [formatted_time, entry.severity_label, entry.progname, entry.pid, entry.unit_of_work_id, lines.shift]
-      lines.each do |line|
-        message << @additional_line_template % [formatted_time, entry.severity_label, entry.progname, entry.pid, entry.unit_of_work_id, line]
-      end
-      message
-    end
-    
-    private
-
-    def format_time(time) #:nodoc:
-      if @time_format.is_a?(String)
-        time.strftime(@time_format)
-      elsif @time_format == :milliseconds
-        time.strftime(DEFAULT_TIME_FORMAT) << MILLISECOND_FORMAT % (time.usec / 1000.0).round
-      else
-        time.strftime(DEFAULT_TIME_FORMAT) << MICROSECOND_FORMAT % time.usec
-      end
-    end
-    
-    # Compile the template string into a value that can be used with sprintf.
-    def compile(template) #:nodoc:
-      template.gsub(/:[a-z0-9_]+/) do |match|
-        position = TEMPLATE_ARGUMENT_ORDER.index(match)
-        if position
-          "%#{position + 1}$s"
-        else
-          match
-        end
-      end
-    end
-  end
-end