ougai 1.5.4 → 1.5.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 97be7511c1c17536603cf512a2f8c107e40ff021
-  data.tar.gz: e2c08a3c8e6833e0ef2622d0fb264b75dba77e94
+  metadata.gz: da3e50121cd1ca747fdf84a266ab60d0fe8d71eb
+  data.tar.gz: 3c93d87d0c32eb0e6a30c0ab0577b537476b3de8
 SHA512:
-  metadata.gz: d457ca8fbff8a3a22003eb9c4878b7b0af931a04d58d89f950733ab80a22de0095f5ee5a16d4c6f8b7695d327434ea12c9629710656df3a32c9543bf1de5c39b
-  data.tar.gz: '0974027ba5cd59d0e8418abb5a2e5b89ee0145cd7cf002d9ea497c871b4c2305952ac3bf56bb06ac5298eb5d8b74f20e2d674aacd8d62e5081861aa4fc853dc8'
+  metadata.gz: 3c7eed367fc984d280ac8f4cfb802c1836ec2918b57dc1c233ab4084585ef115e12d451cafd7c10d0014be7d2d31ea92c877bef8b4e1a2ab02a8947c0b180e42
+  data.tar.gz: 875f603ca33e5349c2edc0a2cec508b39afb4fab9db4545fec82369c1c7a8e383abcd2afb48da8ce597e669eaca357f686a7cc9e633920ac3a5a1d24ae097f10

data/README.md

@@ -197,7 +197,7 @@ But if the field's type is *Array*, both with_field value and logging value are
 
 ### Create a child logger
 
-`logger.child(with_fields)` creates a child logger of self. Its argument `with_fields` add to all logs the child logger outputs. A child logger can also create its child logger.
+`logger.child(with_fields)` creates a child logger of self. Its argument `with_fields` add to all logs the child logger outputs. A child logger can also create its child logger. If you pass a block to this method, the child logger will be yielded to it.
 
 ```ruby
 logger = Ougai::Logger.new(STDOUT)
@@ -212,6 +212,12 @@ gc_logger = child_logger.child({ kind: 'detail' })
 child_logger.info('Created grand child logger')
 
 gc_logger.debug('something detail', age: 34, weight: 72)
+
+gc_logger.child({ mode: 'processed' }) do |gcc_logger|
+  gcc_logger.info('Great-grandchild logger that will be cleaned up on block exit.')
+
+  :some_return_value
+end
 ```
 
 ```json
@@ -219,6 +225,7 @@ gc_logger.debug('something detail', age: 34, weight: 72)
 {"name":"Mike","hostname":"mint2","pid":8342,"level":30,"time":"2017-08-01T22:07:20.400+09:00","v":0,"app":"yourapp","tags":["service","user"],"kind":"logic","msg":"Created a user"}
 {"name":"main","hostname":"mint2","pid":8342,"level":30,"time":"2017-08-01T22:07:20.400+09:00","v":0,"app":"yourapp","tags":["service","user"],"kind":"logic","msg":"Created grand child logger"}
 {"name":"main","hostname":"mint2","pid":8342,"level":20,"time":"2017-08-01T22:07:20.400+09:00","v":0,"app":"yourapp","tags":["service","user"],"kind":"detail","age":34,"weight":72,"msg":"something detail"}
+{"name":"main","hostname":"mint2","pid":8342,"level":20,"time":"2017-08-01T22:07:20.400+09:00","v":0,"app":"yourapp","tags":["service","user"],"kind":"detail","mode":"processed","msg":"Great-grandchild logger that will be cleaned up on block exit."}
 ```
 
 If any field exists in both parent log and child log, the parent value is overridden or merged by child value.

data/lib/ougai/logging.rb

@@ -80,7 +80,13 @@ module Ougai
     # @param fields [Hash] The fields appending to all logs
     # @return [ChildLogger] A created child logger
     def child(fields = {})
-      ChildLogger.new(self, fields)
+      ch = ChildLogger.new(self, fields)
+
+      if !block_given?
+        ch
+      else
+        yield ch
+      end
     end
 
     # @private

data/lib/ougai/version.rb

@@ -1,3 +1,3 @@
 module Ougai
-  VERSION = "1.5.4"
+  VERSION = "1.5.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ougai
 version: !ruby/object:Gem::Version
-  version: 1.5.4
+  version: 1.5.5
 platform: ruby
 authors:
 - Toshimitsu Takahashi