logging-rails 0.1.0

data/History.txt

@@ -0,0 +1,4 @@
+== 0.1.0 / 2011-09-13
+
+Enhancements
+- Birthday!

data/README.md

@@ -0,0 +1,65 @@
+logging-rails
+=============
+
+A Railtie for for integrating the [Logging](https://github.com/TwP/logging) framework into your Rails 3 application.
+
+Features
+--------
+
+Install
+-------
+
+Add the ```logging-rails``` railtie gem to your rails project's Gemfile and run ```bundle install```.
+
+```ruby
+gem 'logging-rails', :require => 'logging/rails'
+````
+
+A generator is included with the railtie that will create a ```config/logging.rb```
+configuration file for use in your rails project.
+
+```
+rails generate logging:install
+```
+
+Usage
+-----
+
+config.log_to
+
+Logging.logger['ModelName'].level = :debug
+
+Author
+------
+
+Original author: [Elliot Winkler](https://github.com/mcmire)
+
+Contributors:
+
+* [Tim Pease](https://github.com/TwP)
+
+License
+-------
+
+The MIT License
+
+Copyright (c) 2011 by Tim Pease
+
+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.

data/Rakefile

@@ -0,0 +1,20 @@
+
+begin
+  require 'bones'
+rescue LoadError
+  abort '### Please install the "bones" gem ###'
+end
+
+task :default => 'gem'
+
+Bones {
+  name     'logging-rails'
+  authors  'Tim Pease'
+  email    'tim.pease@gmail.com'
+  url      'http://rubygems.org/gems/logging-rails'
+
+  use_gmail
+
+  depend_on 'logging', '~> 1.6.1'
+}
+

data/lib/logging-rails.rb

@@ -0,0 +1 @@
+require File.expand_path('../logging/rails.rb', __FILE__)

data/lib/logging/rails.rb

@@ -0,0 +1,68 @@
+
+require 'logging'
+include Logging.globally
+
+module Logging::Rails
+
+  # :stopdoc:
+  LIBPATH = ::File.expand_path('../..', __FILE__) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  # :startdoc:
+
+  class << self
+    # Returns the version string for the library.
+    #
+    def version
+      @version ||= File.read(path('version.txt')).strip
+    end
+
+    # Stores the given Logging configuration block for later evalution by the
+    # Railtie. This method is used in the 'config/logging.rb' configuration
+    # file.
+    #
+    def configure( &block )
+      @configuration = block
+    end
+
+    attr_reader :configuration
+
+    # Returns the path for Mr Bones. If any arguments are given,
+    # they will be joined to the end of the path using <tt>File.join</tt>.
+    #
+    def path( *args )
+      rv = args.empty? ? PATH : ::File.join(PATH, args.flatten)
+      if block_given?
+        begin
+          $LOAD_PATH.unshift PATH
+          rv = yield
+        ensure
+          $LOAD_PATH.shift
+        end
+      end
+      return rv
+    end
+
+    # Returns the lib path for Mr Bones. If any arguments are given,
+    # they will be joined to the end of the path using <tt>File.join</tt>.
+    #
+    def libpath( *args )
+      rv =  args.empty? ? LIBPATH : ::File.join(LIBPATH, args.flatten)
+      if block_given?
+        begin
+          $LOAD_PATH.unshift LIBPATH
+          rv = yield
+        ensure
+          $LOAD_PATH.shift
+        end
+      end
+      return rv
+    end
+  end
+
+  libpath {
+    require 'logging/rails/railtie'
+    require 'logging/rails/mixin'
+  }
+
+end  # Logging::Rails
+

data/lib/logging/rails/generators/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Generates the configuration file used by the Logging framework.
+
+Example:
+    rails generate logging:install
+
+    This will create:
+        config/logging.rb

data/lib/logging/rails/generators/install_generator.rb

@@ -0,0 +1,14 @@
+
+module Logging::Rails
+  module Generators
+    class InstallGenerator < ::Rails::Generators::Base
+      namespace 'logging:install'
+      source_root File.expand_path('../templates', __FILE__)
+
+      def generate_config
+        copy_file 'logging.rb', 'config/logging.rb'
+      end
+    end
+  end
+end
+

data/lib/logging/rails/generators/templates/logging.rb

@@ -0,0 +1,111 @@
+
+Logging::Rails.configure do |config|
+
+  # Objects will be converted to strings using the :format_as method.
+  Logging.format_as :inspect
+
+  # The default layout used by the appenders.
+  layout = Logging.layouts.pattern(:pattern => '[%d] %-5l %c : %m\n')
+
+  # Setup a color scheme called 'bright' than can be used to add color codes
+  # to the pattern layout. Color schemes should only be used with appenders
+  # that write to STDOUT or STDERR; inserting terminal color codes into a file
+  # is generally considered bad form.
+  #
+  Logging.color_scheme( 'bright',
+    :levels => {
+      :info  => :green,
+      :warn  => :yellow,
+      :error => :red,
+      :fatal => [:white, :on_red]
+    },
+    :date => :blue,
+    :logger => :cyan,
+    :message => :magenta
+  )
+
+  # Configure an appender that will write log events to STDOUT. A colorized
+  # pattern layout is used to format the log events into strings before
+  # writing.
+  #
+  Logging.appenders.stdout( 'stdout',
+    :auto_flushing => true,
+    :layout => Logging.layouts.pattern(
+      :pattern => '[%d] %-5l %c : %m\n',
+      :color_scheme => 'bright'
+    )
+  ) if config.log_to.include? 'stdout'
+
+  # Configure an appender that will write log events to a file. The file will
+  # be rolled on a daily basis, and the past 7 rolled files will be kept.
+  # Older files will be deleted. The default pattern layout is used when
+  # formatting log events into strings.
+  #
+  Logging.appenders.rolling_file( 'file',
+    :filename => config.paths['log'].first,
+    :keep => 7,
+    :age => 'daily',
+    :truncate => false,
+    :auto_flushing => true,
+    :layout => layout
+  ) if config.log_to.include? 'file'
+
+  # Configure an appender that will send an email for "error" and "fatal" log
+  # events. All other log events will be ignored. Furthermore, log events will
+  # be buffered for one minute (or 200 events) before an email is sent. This
+  # is done to prevent a flood of messages.
+  #
+  Logging.appenders.email( 'email',
+    :from     => 'server@example.com',
+    :to       => 'developers@example.com',
+    :server   => 'smtp.example.com',
+    :domain   => 'example.com',
+    :acct     => 'server@example.com',
+    :passwd   => 'password',
+    :subject  => "Rails Error [#{%x(uname -n).strip}]",
+    :authtype => :login,
+
+    :auto_flushing => 200,     # send an email after 200 messages have been buffered
+    :flush_period  => 60,      # send an email after one minute
+    :level         => :error,  # only process log events that are "error" or "fatal"
+    :layout        => layout
+  ) if config.log_to.include? 'email'
+
+  # Setup the root logger with the Rails log level and the desired set of
+  # appenders. The list of appenders to use should be set in the environment
+  # specific configuration file.
+  #
+  # For example, in a production application you would not want to log to
+  # STDOUT, but you would want to send an email for "error" and "fatal"
+  # messages:
+  #
+  # => config/environments/production.rb
+  #
+  #     config.log_to = %w[file email]
+  #
+  # In development you would want to log to STDOUT and possibly to a file:
+  #
+  # => config/environments/development.rb
+  #
+  #     config.log_to = %w[stdout file]
+  #
+  Logging.logger.root.level = config.log_level
+  Logging.logger.root.appenders = config.log_to unless config.log_to.empty?
+
+  # Under Phusion Passenger smart spawning, we need to reopen all IO streams
+  # after workers have forked.
+  #
+  # The rolling file appender uses shared file locks to ensure that only one
+  # process will roll the log file. Each process writing to the file must have
+  # its own open file descriptor for flock to function properly. Reopening the
+  # file descriptors afte forking ensure that each worker has a unique file
+  # descriptor.
+  #
+  if defined?(PhusionPassenger)
+    PhusionPassenger.on_event(:starting_worker_process) do |forked|
+      Logging.reopen if forked
+    end
+  end
+
+end
+

data/lib/logging/rails/mixin.rb

@@ -0,0 +1,40 @@
+
+module Logging::Rails
+
+  # Include this module into your ApplicationController to provide
+  # per-controller log level configurability. You can also include this module
+  # into your models or anywhere else you would like to control the log level.
+  #
+  # Alternatively, you can use the `include Logging.globally` trick to add a
+  # `logger` method to every Object in the ruby interpreter. See
+  # https://github.com/TwP/logging/blob/master/lib/logging.rb#L214 for more
+  # details.
+  #
+  module Mixin
+
+    # This method is called when the module is included into a class. It will
+    # extend the including class so it also has a class-level `logger` method.
+    #
+    def self.included( other )
+      other.__send__(:remove_method, :logger) if other.instance_methods.include? :logger
+      other.extend self
+    end
+
+    # This method is called when the modules is extended into another class or
+    # module. It will remove any existing `logger` method and insert its own
+    # version.
+    #
+    def self.extended( other )
+      eigenclass = class << other; self; end
+      eigenclass.__send__(:remove_method, :logger) if eigenclass.instance_methods.include? :logger
+    end
+
+    # Returns the logger instance.
+    #
+    def logger
+      @logger ||= ::Logging::Logger[self]
+    end
+  end  # Mixin
+
+end  # Logging::Rails
+

data/lib/logging/rails/railtie.rb

@@ -0,0 +1,53 @@
+
+module Logging::Rails
+
+  # The Railtie is used to inject the Logging framework into the Rails
+  # application.
+  #
+  class Railtie < ::Rails::Railtie
+
+    generators do
+      require File.expand_path('../generators/install_generator', __FILE__)
+    end
+
+    config.before_configuration do
+      config.log_to = %w[file]
+    end
+
+    initializer 'logging.configure', :before => 'initialize_logger' do |app|
+      file = ::Rails.root.join('config/logging.rb')
+      load file if File.exists? file
+      ::Logging::Rails.configuration.call app.config if ::Logging::Rails.configuration
+    end
+
+    initializer 'logging.initialize', :before => 'initialize_logger' do
+      ::Rails.logger = ::Logging::Logger[::Rails]
+    end
+
+    initializer 'logging.active_record.logger', :before => 'active_record.logger' do
+      ActiveSupport.on_load(:active_record) { self.__send__(:include, ::Logging::Rails::Mixin) }
+    end
+
+    initializer 'logging.action_controller.logger', :before => 'action_controller.logger' do
+      ActiveSupport.on_load(:action_controller) { self.__send__(:include, ::Logging::Rails::Mixin) }
+    end
+
+    initializer 'logging.action_mailer.logger', :before => 'action_mailer.logger' do
+      ActiveSupport.on_load(:action_mailer) { self.__send__(:include, ::Logging::Rails::Mixin) }
+    end
+
+    initializer 'logging.active_support.dependencies.logger' do
+      ActiveSupport::Dependencies.logger = ::Logging::Logger[ActiveSupport::Dependencies]
+    end
+
+    initializer 'logging.initialize_cache', :after => 'initialize_cache' do
+      ::Rails.cache.logger = ::Logging::Logger[::Rails.cache]
+    end
+
+    config.after_initialize do
+      ::Logging.show_configuration if ::Logging::Logger[::Rails].debug?
+    end
+
+  end  # Railtie
+end  # Logging::Rails
+

data/version.txt

@@ -0,0 +1 @@
+0.1.0

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: logging-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Tim Pease
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-16 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: logging
+  requirement: &2166095040 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *2166095040
+- !ruby/object:Gem::Dependency
+  name: bones
+  requirement: &2166094440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.7.1
+  type: :development
+  prerelease: false
+  version_requirements: *2166094440
+description: A Railtie for for integrating the [Logging](https://github.com/TwP/logging)
+  framework into your Rails 3 application.
+email: tim.pease@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- History.txt
+- lib/logging/rails/generators/USAGE
+files:
+- History.txt
+- README.md
+- Rakefile
+- lib/logging-rails.rb
+- lib/logging/rails.rb
+- lib/logging/rails/generators/USAGE
+- lib/logging/rails/generators/install_generator.rb
+- lib/logging/rails/generators/templates/logging.rb
+- lib/logging/rails/mixin.rb
+- lib/logging/rails/railtie.rb
+- version.txt
+homepage: http://rubygems.org/gems/logging-rails
+licenses: []
+post_install_message: 
+rdoc_options:
+- --main
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: logging-rails
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: A Railtie for for integrating the [Logging](https://github.
+test_files: []