lumberjack 1.2.8 → 1.2.10

data/lib/lumberjack.rb

@@ -1,12 +1,13 @@
-# frozen_string_literals: true
+# frozen_string_literal: true
 
 require "rbconfig"
 require "time"
 require "securerandom"
 require "logger"
+require "fiber"
 
 module Lumberjack
-  LINE_SEPARATOR = (RbConfig::CONFIG["host_os"] =~ /mswin/i ? "\r\n" : "\n")
+  LINE_SEPARATOR = ((RbConfig::CONFIG["host_os"] =~ /mswin/i) ? "\r\n" : "\n")
 
   require_relative "lumberjack/severity"
   require_relative "lumberjack/formatter"
@@ -32,6 +33,9 @@ module Lumberjack
     #
     # For the common use case of treating a single web request as a unit of work, see the
     # Lumberjack::Rack::UnitOfWork class.
+    #
+    # @param [String] id The id for the unit of work.
+    # @return [void]
     def unit_of_work(id = nil)
       id ||= SecureRandom.hex(6)
       context do
@@ -41,6 +45,8 @@ module Lumberjack
     end
 
     # Get the UniqueIdentifier for the current unit of work.
+    #
+    # @return [String, nil] The id for the current unit of work.
     def unit_of_work_id
       context[:unit_of_work_id]
     end
@@ -53,6 +59,8 @@ module Lumberjack
     #
     # Otherwise, it will return the current context. If one doesn't exist, it will return a new one
     # but that context will not be in any scope.
+    #
+    # @return [Lumberjack::Context] The current context if called without a block.
     def context(&block)
       current_context = Thread.current[:lumberjack_context]
       if block
@@ -63,6 +71,9 @@ module Lumberjack
     end
 
     # Set the context to use within a block.
+    #
+    # @param [Lumberjack::Context] context The context to use within the block.
+    # @return [Object] The result of the block.
     def use_context(context, &block)
       current_context = Thread.current[:lumberjack_context]
       begin
@@ -74,17 +85,24 @@ module Lumberjack
     end
 
     # Return true if inside a context block.
+    #
+    # @return [Boolean]
     def context?
       !!Thread.current[:lumberjack_context]
     end
 
     # Return the tags from the current context or nil if there are no tags.
+    #
+    # @return [Hash, nil]
     def context_tags
       context = Thread.current[:lumberjack_context]
       context&.tags
     end
 
     # Set tags on the current context
+    #
+    # @param [Hash] tags The tags to set.
+    # @return [void]
     def tag(tags)
       context = Thread.current[:lumberjack_context]
       context&.tag(tags)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lumberjack
 version: !ruby/object:Gem::Version
-  version: 1.2.8
+  version: 1.2.10
 platform: ruby
 authors:
 - Brian Durand
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-08-31 00:00:00.000000000 Z
+date: 2023-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -24,7 +24,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
+description:
 email:
 - bbdurand@gmail.com
 executables: []
@@ -55,6 +55,7 @@ files:
 - lib/lumberjack/formatter/string_formatter.rb
 - lib/lumberjack/formatter/strip_formatter.rb
 - lib/lumberjack/formatter/structured_formatter.rb
+- lib/lumberjack/formatter/truncate_formatter.rb
 - lib/lumberjack/log_entry.rb
 - lib/lumberjack/logger.rb
 - lib/lumberjack/rack.rb
@@ -72,7 +73,7 @@ homepage: https://github.com/bdurand/lumberjack
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -87,8 +88,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.4.20
+signing_key:
 specification_version: 4
 summary: A simple, powerful, and very fast logging utility that can be a drop in replacement
   for Logger or ActiveSupport::BufferedLogger.