logeasy 0.0.4 → 0.0.6

data/lib/logeasy.rb

@@ -5,33 +5,6 @@
 
 # Easy logger module.
 # This module is not thread safe.
-#
-# Usage:
-#
-# To create a new logger:
-# LogEasy::Logger.get_logger(<logger_name>)
-#   logger_name - this should be a '.' separated or '::' separated hierarchy of loggers.
-#   eg. LogEasy::Logger.get_logger("ModuleName::SubModule::ClassName")
-#
-# To change the level of a logger.
-# LogEasy::Logger.get_logger(<logger_name>).change_min_level(<new_level>) # Recursively changes this logger and all child loggers.
-# LogEasy::Logger.get_logger(<logger_name>).min_level = <new_level> # Only change this logger's level.
-#   logger_name - the logger name.
-#   new_level - the new level to set (instance of LogEasy::Level).
-#   eg. LogEasy::Logger.get_logger("ModuleName::SubModule::ClassName").change_min_level(LogEasy::Level::INFO)
-#
-# To add an appender to a logger.
-# LogEasy::Logger.get_logger(<logger_name>).add_appender(<appender>)
-#   logger_name - the logger name.
-#   appender - the appender to add (instance of LogEasy::Appender).
-#   eg. LogEasy::Logger.get_logger("ModuleName::SubModule::ClassName").add_appender(LogEasy::ConsoleAppender.new)
-#
-# By default all sub-loggers will also use this appender. A logger can be told not to use a parent's appender using the
-#   'use_parent_logger' flag. So by adding an appender to the root logger, logs sent to any logger will, by default,
-#   be logged by the root logger's appender(s) also.
-#
-# Right now the only way to configure the loggers is using code. Look at example/example.rb for how to do that.
-#
 module LogEasy
 
   require "logeasy/logger"

data/lib/logeasy/appender.rb

@@ -92,21 +92,28 @@ module LogEasy
   # File appenders write messages to a file.
   class FileAppender < Appender
 
+    # Closes this appender. This will also remove the appender from its logger.
+    def close
+      file.close
+      logger.remove_appender(self) if not logger.nil?
+    end
+
     private
 
     attr_reader :file
+    attr_reader :file_path
 
     # Creates a new file appender.
     # If the specified file already exists, it is overwritten.
     def initialize(file_path)
       super()
-      @file = File.open(file_path, "w")
+      @file_path = file_path
+      create_file
     end
 
-    # Closes this appender. This will also remove the appender from its logger.
-    def close
-      file.close
-      logger.remove_appender(self) if not logger.nil?
+    # Default create file will overwrite existing files.
+    def create_file
+      @file = File.open(file_path, "w")
     end
 
     # Writes the message to the file.
@@ -117,4 +124,14 @@ module LogEasy
 
   end
 
+  # A file appender that writes to the end of the file if it exists.
+  class ConcatFileAppender < FileAppender
+
+    # Overrides default create file. This will use an existing file.
+    def create_file
+      @file = File.open(file_path, "a")
+    end
+
+  end
+
 end

data/lib/logeasy/logger.rb

@@ -10,6 +10,32 @@ require "logeasy/appender"
 module LogEasy
 
   # The logger class. Use the 'get_logger' method to create and use loggers.
+  #
+  # Usage:
+  #
+  # To create a new logger:
+  # LogEasy::Logger.get_logger(<logger_name>)
+  #   logger_name - this should be a '.' separated or '::' separated hierarchy of loggers.
+  #   eg. LogEasy::Logger.get_logger("ModuleName::SubModule::ClassName")
+  #
+  # To change the level of a logger.
+  # LogEasy::Logger.get_logger(<logger_name>).change_min_level(<new_level>) # Recursively changes this logger and all child loggers.
+  # LogEasy::Logger.get_logger(<logger_name>).min_level = <new_level> # Only change this logger's level.
+  #   logger_name - the logger name.
+  #   new_level - the new level to set (instance of LogEasy::Level).
+  #   eg. LogEasy::Logger.get_logger("ModuleName::SubModule::ClassName").change_min_level(LogEasy::Level::INFO)
+  #
+  # To add an appender to a logger.
+  # LogEasy::Logger.get_logger(<logger_name>).add_appender(<appender>)
+  #   logger_name - the logger name.
+  #   appender - the appender to add (instance of LogEasy::Appender).
+  #   eg. LogEasy::Logger.get_logger("ModuleName::SubModule::ClassName").add_appender(LogEasy::ConsoleAppender.new)
+  #
+  # By default all sub-loggers will also use this appender. A logger can be told not to use a parent's appender using the
+  #   'use_parent_logger' flag. So by adding an appender to the root logger, logs sent to any logger will, by default,
+  #   be logged by the root logger's appender(s) also.
+  #
+  # Right now the only way to configure the loggers is using code. Look at example/example.rb for how to do that.
   class Logger
 
     # Get the logger identified by the specified name. If a logger does not exist, a new one is created and returned.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: logeasy
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.6
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-02-19 00:00:00.000000000 +05:30
+date: 2011-02-22 00:00:00.000000000 +05:30
 default_executable: 
 dependencies: []
 description: Hierarchical logger for Ruby. The loggers are arranged in a tree. Output