sgeorgi-logging 1.4.2

data/History.txt

@@ -0,0 +1,262 @@
+== 1.4.2 / 2010-04-18
+
+Bug Fixes
+- missing require for fileutils
+
+== 1.4.1 / 2010-03-23
+
+Bug Fixes
+- flock(LOCK_UN) was causing errors on windows [issue 4]
+
+== 1.4.0 / 2010-03-16
+
+Minor Enhancements
+- Compatibility with the Rack::CommonLogger
+
+== 1.3.0 / 2009-12-18
+
+Minor Enhancements
+- Using copy/truncate semantics for a faster RollingFile appender
+- Global reopen method for using Logging in forked environments
+- RollingFile appender can use date stamps instead of numbers
+
+== 1.2.3 / 2009-12-01
+
+1 bug fix
+  - Using a reentrant mutex to avoid deadlock in some Rails applications
+
+== 1.2.2 / 2009-08-18
+
+1 minor enhancement
+  - Created a reset method for the logging framework
+
+== 1.2.1 / 2009-08-14
+
+1 bug fix
+  - Using a bug-fix version of little-plugger
+
+== 1.2.0 / 2009-08-14
+
+2 minor enhancements
+  - Added a gem based plugin system
+  - LogEvent is now a struct (slightly faster)
+
+== 1.1.4 / 2009-05-28
+
+1 minor enhancement
+  - Added a Logging.shutdown method to close out all appenders
+
+== 1.1.3 / 2009-05-13
+
+1 bug fix
+  - Fixing an alias bug on the JRuby platform
+
+== 1.1.2 / 2009-05-05
+
+1 minor enhancement
+  - Added two new require methods to Kernel
+
+== 1.1.1 / 2009-04-30
+
+1 minor enhancement
+  - Added a 'filename' method to the file appenders
+
+== 1.1.0 / 2009-04-21
+
+3 minor enhancements
+  - Added a "global" logger method
+  - Loggers can be consolidated on a per-namespace basis
+  - Added a precision to the logger name specifier in the pattern layout
+    [addresses http://github.com/TwP/logging/issues#issue/1]
+
+== 1.0.0 / 2009-04-17
+
+2 major enhancements
+  - Refactored access to the appenders
+  - Created a much cleaner way to initialize the logging framework
+3 minor enhancements
+  - Added a YAML layout option
+  - Added a JSON layout option
+  - Cration of an "examples" directory
+1 bug fix
+  - Logging initialization happens implicitly when a logger, layout, or
+    appender is created
+
+== 0.9.8 / 2009-04-11
+
+2 minor enhancements
+  - Adding a to_s method to the StringIo appender's StringIO object
+  - Added a Spec::LoggingHelper class that will capture log messages
+    when using rspec style testing
+
+== 0.9.7 / 2009-03-17
+
+1 minor enhancement
+  - Added a StringIO appender
+1 bug fix
+  - Handling objects that cannot be dumped via YAML [Tim Galeckas]
+
+== 0.9.6 / 2009-02-02
+
+2 minor enhancements
+  - Ruby 1.9.1 compatability
+  - JRuby 1.1.5 compatability
+
+== 0.9.5 / 2009-01-25
+
+2 minor enhancements
+  - The pattern layout can output the current thread name
+    if set using Thread.current[:name]         [valodzka]
+  - Added buffered logging to all IO based loggers
+    (console, file, rolling file)
+1 bug fix
+  - Uncaught TimeoutError in the e-mail appender
+
+== 0.9.4 / 2008-10-04
+
+2 minor enhancements
+  - Flag to suppress exception backtraces from being logged
+  - Cleaning up color codes on Growl output
+4 bug fixes
+  - Child loggers were not being found in some cases
+  - RollingFileAppender fails to reopen the log file if
+    the log file is deleted.
+  - Fixed a copy/paste error in the YAML configurator
+  - Bug in the configurator where a nil object was being used
+
+== 0.9.3 / 2008-09-12
+
+2 minor enhancement
+  - Added a class for tracking basic statistics
+  - Will use the 'fastthread' gem if availble
+
+== 0.9.2 / 2008-09-03
+
+2 bug fixes
+  - Properly generates logger names for anonymous classes and
+    modules and meta-classes
+  - Fixed the rescue clause when 'turn' cannot be required
+
+== 0.9.1 / 2008-08-14
+
+1 minor enhancement
+  - added a method to show the logging configuration
+2 bug fixes
+  - checking for sync method on the IO streams before calling
+  - fixed the internal logging levels
+
+== 0.9.0 / 2008-07-16
+
+2 minor enhancement
+  - Exceptions from appenders are captured and logged
+  - Internal logger for the Logging framework (disabled by default)
+  - Added a DSL configuration format (more readable than YAML)
+1 bug fix
+  - Modules could not have their own logger instance
+
+== 0.8.0 / 2008-07-02
+
+1 minor enhancement
+  - Setting the log level of a parent will cause this level to
+    be propagated to the children
+1 bug fix
+  - Fixed error with the e-mail appender and missing hostname
+
+== 0.7.1 / 2008-02-25
+
+1 minor enhancement
+  - Removed dependency on the Lockfile gem (brought the ruby
+    file into the logging/stelan directory)
+1 bug fix
+  - Fixed bug with age based rolling: was not multi-process safe
+
+== 0.7.0 / 2008-02-12
+
+1 major enhancement
+  - Rails compatibility
+    * renamed Logger#add method to Logger#add_appenders
+    * renamed Logger#remove method to Logger#remove_appenders
+    * renamed Logger#clear method to Logger#clear_appenders
+    * added a new Logger#add method that conforms to the calling
+      semantics of the Ruby stdlib Logger 
+
+2 minor enhancements
+  - Speed improvements and test coverage
+  - Created a top-level Logging.init method that is used to
+    define the default logging levels
+
+1 bug fix
+  - Tweaked windows detection code
+
+== 0.6.3 / 2008-02-08
+
+2 minor enhancements
+  - YAML configuration now supports multiple keys -- i.e. development
+    or production or whatever
+  - Reorganized a lot of files so that requiring files is cleaner and
+    more deterministic
+
+== 0.6.2 / 2008-02-06
+
+2 bug fixes
+  - An extra e-mail was being pushed out when the e-mail
+    appender was closed
+  - Created an at_exit handler to close all appenders
+
+== 0.6.1 / 2008-01-01
+
+1 bug fix
+  - Fixed include order to avoid double loading when testing
+
+== 0.6.0 / 2007-12-26
+
+* Using the new 'getopt' method for handling option hashes
+* Rolling file appender is safe for multiple processes
+* Added an e-mail appender from Jeremy Hinegardner
+* Updated tests for the appenders
+
+== 0.5.3 / 2007-12-08
+
+* Fixed the quoting for messages sent to the growl appender
+
+== 0.5.2 / 2007-11-28
+
+* Updated the library to work with Ruby 1.9
+* Fixed coalescing with the growl appender
+
+== 0.5.1 / 2007-11-18
+
+* Fixed a bug on Windows when attempting to load the syslog library
+
+== 0.5.0 / 2007-11-18
+
+* Added the ability to log via the syslog daemon
+* Can send messages to the Growl notification system on Mac OS X
+* The Growl appender can coalesce messages of the same title/priority
+
+== 0.4.0 / 2007-03-21
+
+* Added a microsecond flag to the Pattern layout
+* All appenders write immediately upon receipt of a logging event
+* Added a basic logging method that returns a logger object configured in
+  the same manner as the standard Ruby logger
+* Fixed a bug caused by nil log messages
+
+== 0.3.1 / 2007-02-08
+
+* Bugfix Release
+
+== 0.3.0 / 2007-02-01
+
+* Remove the ability to log multiple objects from a single log method call
+
+== 0.2.0 / 2007-01-29
+
+* The "once every four years" release
+* Storage and retrieval of appenders by name
+* YAML configuration support
+* Rolling file appender
+
+== 0.1.0 / 2007-01-12
+
+* Birthday!

data/README.rdoc

@@ -0,0 +1,115 @@
+Logging
+    by Tim Pease
+
+* {Homepage}[http://logging.rubyforge.org/]
+* {Rubyforge Project}[http://rubyforge.org/projects/logging]
+* email tim dot pease at gmail dot com
+
+== DESCRIPTION
+
+Logging is a flexible logging library for use in Ruby programs based on the
+design of Java's log4j library. It features a hierarchical logging system,
+custom level names, multiple output destinations per log event, custom
+formatting, and more.
+
+== INSTALL
+
+  sudo gem install logging
+
+== EXAMPLE
+
+This example configures a logger to output messages in a format similar to the
+core ruby Logger class. Only log messages that are warnings or higher will be
+logged.
+
+  require 'logging'
+
+  logger = Logging.logger(STDOUT)
+  logger.level = :warn
+
+  logger.debug "this debug message will not be output by the logger"
+  logger.warn "this is your last warning"
+
+In this example, a single logger is crated that will append to STDOUT and to a
+file. Only log messages that are informational or higher will be logged.
+
+  require 'logging'
+
+  logger = Logging.logger['example_logger']
+  logger.add_appenders(
+      Logging.appenders.stdout,
+      Logging.appenders.file('example.log')
+  )
+  logger.level = :info
+
+  logger.debug "this debug message will not be output by the logger"
+  logger.info "just some friendly advice"
+
+The Logging library was created to allow each class in a program to have its
+own configurable logger. The logging level for a particular class can be
+changed independently of all other loggers in the system. This example shows
+the recommended way of accomplishing this.
+
+  require 'logging'
+
+  Logging.logger['FirstClass'].level = :warn
+  Logging.logger['SecondClass'].level = :debug
+
+  class FirstClass
+    def initialize
+      @log = Logging.logger[self]
+    end
+
+    def some_method
+      @log.debug "some method was called on #{self.inspect}"
+    end
+  end
+
+  class SecondClass
+    def initialize
+      @log = Logging.logger[self]
+    end
+
+    def another_method
+      @log.debug "another method was called on #{self.inspect}"
+    end
+  end
+
+There are many more examples in the "examples" folder of the logging
+package. The recommended reading order is the following:
+
+  simple.rb
+  loggers.rb
+  classes.rb
+  hierarchies.rb
+  names.rb
+  appenders.rb
+  layouts.rb
+  formatting.rb
+  consolidation.rb
+
+== NOTES
+
+Although Logging is intended to supersede Log4r, it is not a one-to-one
+replacement for the Log4r library. Most notably is the difference in namespaces
+-- Logging vs. Log4r. Other differences include renaming Log4r::Outputter to
+Logging::Appender and renaming Log4r::Formatter to Logging::Layout. These
+changes were meant to bring the Logging class names more in line with the Log4j
+class names.
+
+== REQUIREMENTS
+
+Logging requires the "lockfile" gem to run and the "flexmock" gem to run the
+tests"
+
+== DEVELOPMENT REQUIREMENTS
+
+The Logging source code relies on the Mr Bones project for default rake tasks.
+You will need to install the Mr Bones gem if you want to build or test the
+logging gem.
+
+   gem install bones
+
+== LICENSE
+
+Ruby

data/Rakefile

@@ -0,0 +1,32 @@
+
+begin
+  require 'bones'
+rescue LoadError
+  abort '### please install the "bones" gem ###'
+end
+
+task :default => 'test:run'
+task 'gem:release' => 'test:run'
+
+Bones {
+  name         'logging'
+  summary      'A flexible and extendable logging library for Ruby'
+  authors      'Tim Pease'
+  email        'tim.pease@gmail.com'
+  url          'http://rubygems.org/gems/logging'
+  readme_file  'README.rdoc'
+  ignore_file  '.gitignore'
+
+  rdoc.exclude << '^data'
+  rdoc.include << '^examples/.*\.rb'
+  #rdoc.dir = 'doc/rdoc'
+
+  use_gmail
+
+  depend_on 'little-plugger'
+
+  depend_on 'flexmock',     :development => true
+  depend_on 'bones-git',    :development => true
+  depend_on 'bones-extras', :development => true
+}
+

data/data/bad_logging_1.rb

@@ -0,0 +1,13 @@
+
+Logging.configure {
+
+  logger(:root) {
+    level      :info
+    appenders  'bad'
+  }
+
+  appender('bad') {
+    type 'FooBar'
+  }
+
+}  # logging configuration

data/data/bad_logging_2.rb

@@ -0,0 +1,21 @@
+
+Logging.configure {
+
+  logger(:root) {
+    level      :info
+    appenders  'logfile'
+  }
+
+  appender('logfile') {
+    type      'File'
+    level     'DEB'
+    filename  'tmp/temp.log'
+    truncate  true
+    layout {
+      type         'BadLayout'
+      date_method  'to_s'
+      pattern      '[%d] %l  %c : %m\n'
+    }
+  }
+
+}  # logging configuration