Project

json_ruby_logger

0.0
The project is in a healthy, maintained state
json_ruby_loggerdo-i-need-a-username/json_ruby_loggerHomepageDocumentationSource CodeBug TrackerWiki
Simple JSON logging for Ruby
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
1,468
Stars
2
Forks
0
Watchers
1
 Releases
Current version
0.1.8
Total releases
4
First release
2023-07-06
Latest release
2023-07-17
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2023-07-10
Reverse Dependencies
0

 Dependencies

Runtime

json
~> 2.6
logger
~> 1.5
time
~> 0.2
 Project Readme

JsonRubyLogger

Gem Version

A simpe ruby logger that logs in json format with the below information.

{
  "date":"2023-07-06T11:59:51+10:00",
  "file_name":"test_logging.rb",
  "calling_class":"LogTest::TestLogging",
  "function_name":"call",
  "lineno":8,
  "severity":"INFO",
  "pid":"27365",
  "message":"Hello World call from LogTest::TestLogging"
}

Table of Contents

  • Installation
  • Usage
  • Examples
  • Example 1 - Single file
  • Example 2 - Multiple files file

Installation

gem install:

gem install json_ruby_logger

bundler install:

gem 'json_ruby_logger'

Usage

Examples

Example 1

Example 1 - Single function in a single file called test_logging.rb:

include JsonRubyLogger
def test
  logger.info("Hello World call from #{self.class.name}")
end

test

Run ruby test_logging.rb

Output from example 1:

{"date":"2023-07-06T15:10:24+10:00","file_name":"test_logger.rb","calling_class":"Object","function_name":"test","lineno":31,"severity":"INFO","pid":44665,"message":"Hello World call from Object"}

Example 2

Example 2 in a single files called test_logging.rb:

require 'json_ruby_logger'

module LogTest
  class TestLogging
    include JsonRubyLogger

    def call
      logger.info("Hello World call from #{self.class.name}")
      call2
    end

    def call2
      logger.info("Hello World call2 from #{self.class.name}")
    end
  end
end


class TestLogging2
  include JsonRubyLogger

  def call
    logger.info("Hello World call from #{self.class.name}")
    call2
  end

  def call2
    logger.info("Hello World call2 from #{self.class.name}")
  end
end

LogTest::TestLogging.new.call
TestLogging2.new.call

Run ruby test_logging.rb

Output from example 2:

{"date":"2023-07-06T11:59:51+10:00","file_name":"test_logging.rb","calling_class":"LogTest::TestLogging","function_name":"call","lineno":8,"severity":"INFO","pid":"#27365","message":"Hello World call from LogTest::TestLogging"}
{"date":"2023-07-06T11:59:51+10:00","file_name":"test_logging.rb","calling_class":"LogTest::TestLogging","function_name":"call2","lineno":13,"severity":"INFO","pid":"#27365","message":"Hello World call2 from LogTest::TestLogging"}
{"date":"2023-07-06T11:59:51+10:00","file_name":"test_logging.rb","calling_class":"TestLogging2","function_name":"call","lineno":23,"severity":"INFO","pid":"#27365","message":"Hello World call from TestLogging2"}
{"date":"2023-07-06T11:59:51+10:00","file_name":"test_logging.rb","calling_class":"TestLogging2","function_name":"call2","lineno":28,"severity":"INFO","pid":"#27365","message":"Hello World call2 from TestLogging2"}

Example 3

Example 3 multi files in sub folders:

File ./lib/another_class.rb

require 'json_ruby_logger'

class AnotherClass
  include JsonRubyLogger

  def another_class_call
    logger.info("AnotherClass Hello World call from #{self.class.name}")
    another_class
  end

  def another_class
    logger.info("Hello World call2 from #{self.class.name}")
  end
end

File ./test_logging.rb

require_relative 'lib/another_class'
require 'json_ruby_logger'

class TestLogging
  include JsonRubyLogger

  def call
    logger.info("Hello World call from #{self.class.name}")
    another_class
  end

  def another_class
    logger.info("Hello World call2 from #{self.class.name}")
    AnotherClass.new.another_class_call
  end
end

TestLogging.new.call

Run ruby test_logging.rb

Output from example 3:

{"date":"2023-07-06T12:08:48+10:00","file_name":"test_logger.rb","calling_class":"TestLogging","function_name":"call","lineno":8,"severity":"INFO","pid":"#29554","message":"Hello World call from TestLogging"}
{"date":"2023-07-06T12:08:48+10:00","file_name":"test_logger.rb","calling_class":"TestLogging","function_name":"another_class","lineno":13,"severity":"INFO","pid":"#29554","message":"Hello World call2 from TestLogging"}
{"date":"2023-07-06T12:08:48+10:00","file_name":"another_class.rb","calling_class":"AnotherClass","function_name":"another_class_call","lineno":7,"severity":"INFO","pid":"#29554","message":"AnotherClass Hello World call from AnotherClass"}
{"date":"2023-07-06T12:08:48+10:00","file_name":"another_class.rb","calling_class":"AnotherClass","function_name":"another_class","lineno":12,"severity":"INFO","pid":"#29554","message":"Hello World call2 from AnotherClass"}

License

The gem is available as open source under the terms of the MIT License.

Creating a Gem

Create a Gem Skeleton

bundle gem json_ruby_logger \
--mit \
--linter=rubocop \
--test=rspec \
--ci=github \
--no-coc

Build the gem

  gem build json_ruby_logger.gemspec

push the gem to rubygems.org

  gem push json_ruby_logger-0.1.0.gem

Revoke/yank a gem

  gem yank json_ruby_logger -v 0.1.0

Bump Gem Version

  gem install gem-release
  gem bump patch --skip-ci --push