simple_structured_logger 0.1.4 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 450b49d293e7743eaa62f2beb6c27cb3e02dea41
-  data.tar.gz: 8d8cc75dabd6c182f445f002e6724cc55d22bf74
+SHA256:
+  metadata.gz: 959e1a8479e4536b7c1a97cca00e409b4d979e611a5da6a214311cb33a877070
+  data.tar.gz: 555fd1aa0f22f2470b65e724bdaf861d1f28ece8fd5d9decf8579bd7bcd4d7b1
 SHA512:
-  metadata.gz: 83c99c8d4e03fbaba09731d2fb9f41d565b3ad89575ca7b79ff216781b079dad94aedc9b84e7f35f30e3d86d5a377107085a040395e5826c1a6371995709f7f6
-  data.tar.gz: 9ef9a6dd5774733c7badfb042a1c800ce52a25428f8b49f0f9e474d94eb92c2d91e6e2d19ec9cd46a471bf453f0806757efc7d78da82b1624153fd05cab15513
+  metadata.gz: 87bc3367c2993374dbb3c2220a6d9378cfecaf0480901e26f305850b75c7584ea7a90cbe8c1c9bc831802e07456bf50a250a03a0cb2634faa926e6f9523e770f
+  data.tar.gz: '0489971ce5a5d82e1a9b3327510a322796ba4b02014300f286502df17923bfe35de572d272119647a32edcd97798409ef68be0ea8fe62d1e93c033758a0633f5'

data/.github/dependabot.yml

@@ -0,0 +1,7 @@
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+version: 2
+updates:
+  - package-ecosystem: "bundler"
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "monthly"

data/.github/workflows/codeql-analysis.yml

@@ -0,0 +1,59 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master ]
+  schedule:
+    - cron: '24 16 * * 1'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'ruby' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v1
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1

data/.github/workflows/ruby.yml

@@ -0,0 +1,33 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+
+name: Ruby
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: ['2.6', '2.7', '3.0', '3.1']
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+        bundler-cache: true
+    - name: Run tests
+      run: bundle exec rake
+

data/.gitignore

@@ -8,3 +8,4 @@
 /spec/reports/
 /tmp/
 /vendor/bundle
+/*.gem

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.1.1

data/Gemfile

@@ -1,4 +1,2 @@
 source 'https://rubygems.org'
-
-# Specify your gem's dependencies in simple_structured_logger.gemspec
 gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Michael Bianco
+
+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/README.md

@@ -1,22 +1,109 @@
+[![Ruby](https://github.com/iloveitaly/simple_structured_logger/actions/workflows/ruby.yml/badge.svg)](https://github.com/iloveitaly/simple_structured_logger/actions/workflows/ruby.yml)
+[![gem](https://img.shields.io/gem/v/simple_structured_logger.svg)](https://rubygems.org/gems/simple_structured_logger)
+
 # SimpleStructuredLogger
 
-Dead-simple structured logging in ruby with a dead-simple codebase. That's it.
+Dead-simple structured logging in ruby with a dead-simple codebase. No dependencies, everything logs to stdout, and simple hooks to customize. That's it.
 
 ```ruby
 gem 'simple_structured_logger'
 ```
 
+## Usage
+
+You can use this logger anywhere. Class methods, instance methods, use it as a logger for libraries, etc.
+
+Some examples:
+
+```ruby
+# in a console or simple script
+include SimpleStructuredLogger
+log.info 'core message', key: Time.now.to_i
+
+# in class & instance methods
+class LoggingInModule
+  include SimpleStructuredLogger
+
+  def self.log_something
+    log.info 'including the module enables a class and instance method', key: Time.now.to_i
+  end
+
+  def log_something_else
+    log.info 'the class and instance method share the same logging context', key: Time.now.to_i
+  end
+end
+
+# So, how do I set the context? How can I customize how it's set?
+SimpleStructuredLogger.configure do
+  expand_context do |context|
+    # you can pass in a object and use `expand_context` to extract the relevant keys
+    if context[:user]
+      context[:user_id] = context[:user].id
+      context[:user_name] = context[:user].name
+    end
+
+    context
+  end
+end
+
+class ExampleJob
+  def perform(user_id)
+    user = get_user(user_id, job_argument)
+    log.set_context(user: user, job: self.class, job_argument: job_argument)
+    log.info 'the log will contain the user_id, job_argument, and job class'
+
+    # you can also add additional default pairs without resetting context
+    log.default_tags[:something] = 'else'
+  end
+end
+
+# Can you pass object arguments as values and automatically expand them? Well, yes, you can!
+SimpleStructuredLogger.configure do
+  expand_log do |tags, default_tags|
+    if tags[:stripe_resource] && tags[:stripe_resource].respond_to?(:id)
+      stripe_resource = tags.delete(:stripe_resource)
+      tags[:stripe_resource_id] = stripe_resource.id
+      tags[:stripe_resource_type] = stripe_resource.class.to_s
+    end
+
+    # this is a really nice pattern I like to use. The `metric` key can trigger a call out to your observability tooling
+    if tags[:metric]
+      dimensions = default_tags.slice(:stripe_user_id, :other_default_tag)
+      metrics.track_counter(tags[:metric], dimensions: dimensions)
+    end
+
+    tags
+  end
+end
+
+# want simple formatting? You got it!
+SimpleStructuredLogger.logger.formatter = proc do |severity, _datetime, _progname, msg|
+  "#{severity}: #{msg}\n"
+end
+
+# Configure the logger directly if you need to
+SimpleStructuredLogger.logger.level(Logger::INFO)
+```
+
+Want to change the log level quickly? Without modifying source?
+
+```shell
+LOG_LEVEL=DEBUG ruby your_script.rb
+
+# case does not matter
+LOG_LEVEL=info ruby your_script.rb
+```
+
 ## Design Goals
 
 * Extremely simple codebase that's easy to read and override
-* Structured logging that reads nicely
+* Structured logging that reads nicely and is easy to filter using grep or something like Papertrail
 * Ability to easily set context, and expand context with user-configurable hook
 * Ability to easily add structured log pre-processing. I want to be able to pass
-  in an object specific to my application and for the relavent important keys to
+  in an object specific to my application and for the relevant important keys to
   be expanded automatically.
 * `Rails.logger = SimpleStructuredLogger.new(STDOUT)`
-* Not designed around massive systems or scale
-* Don't support multiple log destinations
+* Not designed around massive systems or scale: no JSON logging, multiple log destinations, and other fanciness.
 * Don't build in fancy pre-processing for errors or other common ruby objects
 
 ### Opinionated Devops Setup
@@ -34,6 +121,10 @@ gem 'simple_structured_logger'
 * https://github.com/nishidayuya/structured_logger
 * https://github.com/rocketjob/semantic_logger
 
+## Related
+
+* https://github.com/roidrage/lograge
+
 ## Why is structured logging important?
 
 * https://engineering.linkedin.com/distributed-systems/log-what-every-software-engineer-should-know-about-real-time-datas-unifying
@@ -42,33 +133,14 @@ gem 'simple_structured_logger'
 ## What about Rail's tagged logging?
 
 Tagged logging is not structured logging. I want to be able to search through
-PaperTrail and easily grab an audit trail for a specific context, i.e. `the_job=FailingJob the_user=1`.
-
-## Usage
-
-```ruby
-# config/initializers/logger.rb
-if Rails.env.development? || Rails.env.test?
-  SimpleStructuredLogger::Writer.instance.logger = Rails.logger
-end
-
-# models/order.rb
-class Order
-  include SimpleStructuredLogger
-
-  def initialize
-    log.reset_context!
-    log.default_tags[:global] = 'key'
-  end
-
-  def do_something
-    log.info 'simple structured logging', key: value, shopify_id: 123
-  end
-end
-```
+PaperTrail/Splunk/etc and easily grab an audit trail for a specific context, i.e. `the_job=FailingJob the_user=1`.
 
 ## Testing
 
 ```
 bundle exec rake
 ```
+
+## TODO
+
+- [ ] Support logs as blocks?

data/lib/simple_structured_logger.rb

@@ -2,6 +2,14 @@ require 'logger'
 require 'singleton'
 
 module SimpleStructuredLogger
+  def self.configure(&block)
+    SimpleStructuredLogger::Configuration.instance_eval(&block)
+  end
+
+  def self.logger
+    SimpleStructuredLogger::Writer.instance.logger
+  end
+
   def log
     SimpleStructuredLogger::Writer.instance
   end
@@ -13,25 +21,27 @@ module SimpleStructuredLogger
         SimpleStructuredLogger::Writer.instance
       end
     end
-
   end
 
   module Configuration
     extend self
 
+    @expand_context = nil
+    @expand_log = nil
+
     def expand_context(&block)
       if block.nil?
-        @expand_context = block
-      else
         @expand_context
+      else
+        @expand_context = block
       end
     end
 
     def expand_log(&block)
       if block.nil?
-        @expand_log = block
-      else
         @expand_log
+      else
+        @expand_log = block
       end
     end
   end
@@ -44,6 +54,20 @@ module SimpleStructuredLogger
     def initialize
       @logger = ::Logger.new(STDOUT)
       @default_tags = {}
+
+      set_log_level_from_environment
+    end
+
+    # returns true if log level is set from env
+    def set_log_level_from_environment
+      env_log_level = ENV['LOG_LEVEL']
+
+      if !env_log_level.nil? && Logger::Severity.const_defined?(env_log_level.upcase)
+        @logger.level = Logger::Severity.const_get(env_log_level.upcase)
+        true
+      else
+        false
+      end
     end
 
     def reset_context!
@@ -53,8 +77,8 @@ module SimpleStructuredLogger
     def set_context(context)
       reset_context!
 
-      if self.respond_to?(:expand_context)
-        context = self.expand_context(context)
+      if SimpleStructuredLogger::Configuration.expand_context
+        context = SimpleStructuredLogger::Configuration.expand_context.call(context)
       end
 
       @default_tags.merge!(context)
@@ -73,26 +97,18 @@ module SimpleStructuredLogger
     end
 
     def warn(msg, opts={})
-      # TODO consider returning the generated log string with structured keys
-
       @logger.warn("#{msg}: #{stringify_tags(opts)}")
     end
 
-    private
+    private def stringify_tags(additional_tags)
+      additional_tags = additional_tags.dup
 
-      def generate_log(msg, opts)
-        #code
+      if SimpleStructuredLogger::Configuration.expand_log
+        additional_tags = SimpleStructuredLogger::Configuration.expand_log.call(additional_tags, self.default_tags)
       end
 
-      def stringify_tags(additional_tags)
-        additional_tags = additional_tags.dup
-
-        if self.respond_to?(:expand_log)
-          additional_tags = self.expand_log(additional_tags)
-        end
-
-        @default_tags.merge(additional_tags).map { |k,v| "#{k}=#{v}" }.join(' ')
-      end
+      @default_tags.merge(additional_tags).map {|k, v| "#{k}=#{v}" }.join(' ')
+    end
 
   end
 end

data/simple_structured_logger.gemspec

@@ -4,20 +4,19 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = "simple_structured_logger"
-  spec.version       = '0.1.4'
+  spec.version       = '1.0.1'
   spec.authors       = ["Michael Bianco"]
-  spec.email         = ["mike@cliffsidemedia.com"]
+  spec.email         = ["mike@mikebian.co"]
+  spec.licenses      = ['MIT']
 
-  spec.summary       = "Dead-simple structured logging in ruby with a dead-simple codebase."
-  # spec.description   = %q{TODO: Write a longer description or delete this line.}
+  spec.summary       = "Dead-simple structured logging in ruby with a simple codebase"
   spec.homepage      = "https://github.com/iloveitaly/simple_structured_logger"
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.11"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "bundler", "~> 2.3.10"
+  spec.add_development_dependency "rake", "~> 13.0.6"
+  spec.add_development_dependency "minitest", "~> 5.15"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: simple_structured_logger
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 1.0.1
 platform: ruby
 authors:
 - Michael Bianco
-autorequire: 
-bindir: exe
+autorequire:
+bindir: bin
 cert_chain: []
-date: 2017-04-24 00:00:00.000000000 Z
+date: 2022-03-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,51 +16,58 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: 2.3.10
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: 2.3.10
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 13.0.6
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 13.0.6
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.15'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
-description: 
+        version: '5.15'
+description:
 email:
-- mike@cliffsidemedia.com
-executables: []
+- mike@mikebian.co
+executables:
+- console
+- setup
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
+- ".github/workflows/codeql-analysis.yml"
+- ".github/workflows/ruby.yml"
 - ".gitignore"
+- ".tool-versions"
 - Gemfile
+- LICENSE
 - README.md
 - Rakefile
 - bin/console
@@ -68,9 +75,10 @@ files:
 - lib/simple_structured_logger.rb
 - simple_structured_logger.gemspec
 homepage: https://github.com/iloveitaly/simple_structured_logger
-licenses: []
+licenses:
+- MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -85,9 +93,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
-summary: Dead-simple structured logging in ruby with a dead-simple codebase.
+summary: Dead-simple structured logging in ruby with a simple codebase
 test_files: []