yell 0.13.0 → 0.13.1

data/README.md

@@ -74,6 +74,38 @@ logger = Yell.new do |l|
 end
 ```
 
+### But I'm used to Log4r and I don't want to move on
+
+One of the really nice features of Log4r is its repository. The following example is 
+taken from the official Log4r [documentation](http://log4r.rubyforge.org/manual.html#outofbox).
+
+```ruby
+require 'log4r'
+include Log4r
+
+# create a logger named 'mylog' that logs to stdout
+mylog = Logger.new 'mylog'
+mylog.outputters = Outputter.stdout
+
+# later in the code, you can get the logger back
+Logger['mylog']
+```
+
+With Yell you can do the same thing with less:
+
+```ruby
+require 'yell'
+
+# create a logger named 'mylog' that logs to stdout
+Yell.new :stdout, :name => 'mylog'
+
+# later in the code, you can get the logger back
+Yell['mylog']
+```
+
+There is no need to define outputters separately and you don't have to taint 
+you global namespace with Yell's subclasses.
+
 
 ## Further Readings
 

data/lib/yell/level.rb

@@ -32,7 +32,7 @@ module Yell #:nodoc:
       # @example Set the level to :warn
       #   level = :warn
       #
-      # @param [String, Symbol, Integer] val The minimum log level
+      # @param [String, Symbol, Integer] severity The minimum log level
       def level=( severity )
         @level = case severity
           when Yell::Level then severity

data/lib/yell/logger.rb

@@ -9,6 +9,9 @@ module Yell #:nodoc:
   class Logger
     include Yell::Level::Helpers
 
+    # The name of the logger instance
+    attr_reader :name
+
     # Initialize a new Logger
     #
     # @example A standard file logger
@@ -48,14 +51,17 @@ module Yell #:nodoc:
       # set the log level when given
       self.level = @options[:level]
 
+      # set the loggeer's name
+      self.name = @options[:name] if @options[:name]
+
       # extract adapter
-      adapter args.pop if args.any?
+      self.adapter args.pop if args.any?
 
       # eval the given block
       _call( &block ) if block
 
       # default adapter when none defined
-      adapter :file if @adapters.empty?
+      self.adapter :file if @adapters.empty?
     end
 
     # Define an adapter to be used for logging.
@@ -88,6 +94,10 @@ module Yell #:nodoc:
       @adapters << Yell::Adapters.new( type, options, &block )
     end
 
+    def name=( val )
+      Yell::Repository[val] = self
+    end
+
     # Deprecated: Use attr_reader in future
     def level( val = nil )
       if val.nil?

data/lib/yell/version.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 module Yell #:nodoc:
-  VERSION = "0.13.0"
+  VERSION = "0.13.1"
 
 end
 

data/spec/yell/logger_spec.rb

@@ -47,6 +47,16 @@ describe Yell::Logger do
     end
   end
 
+  context "initialize with a :name" do
+    let( :name ) { 'test' }
+
+    it "should be added to the repository" do
+      logger = Yell.new :name => name
+
+      Yell::Repository[name].should == logger
+    end
+  end
+
   context "initialize with a :filename" do
     it "should call adapter with :file" do
       mock.proxy( Yell::Adapters::File ).new( :filename => 'test.log' )

data/spec/yell/repository_spec.rb

@@ -29,5 +29,13 @@ describe Yell::Repository do
     it { should == logger }
   end
 
+  context "[]= with a named logger" do
+    before do
+      Yell[ name ] = Yell.new :stdout, :name => name
+    end
+
+    it { should_not be_nil }
+  end
+
 end
 

data/spec/yell_spec.rb

@@ -1,7 +1,9 @@
 require 'spec_helper'
 
 describe Yell do
-  subject { Yell.new }
+  let( :logger ) { Yell.new }
+
+  subject { logger }
 
   it { should be_kind_of Yell::Logger }
 
@@ -31,5 +33,25 @@ describe Yell do
     it { should be_kind_of Yell::Logger }
   end
 
+  context :[] do
+    let( :name ) { 'test' }
+
+    it "should delegate to the repository" do
+      mock( Yell::Repository )[ name ]
+
+      Yell[ name ]
+    end
+  end
+
+  context :[]= do
+    let( :name ) { 'test' }
+
+    it "should delegate to the repository" do
+      mock.proxy( Yell::Repository )[name] = logger
+
+      Yell[ name ] = logger
+    end
+  end
+
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yell
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.13.1
   prerelease: 
 platform: ruby
 authors: