iugu_logger 0.10.0

data/lib/iugu_logger.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require 'iugu_logger/version'
+require 'iugu_logger/severity'
+require 'iugu_logger/pii'
+require 'iugu_logger/schema'
+require 'iugu_logger/trace_context'
+require 'iugu_logger/tenant_context'
+require 'iugu_logger/buffer'
+require 'iugu_logger/configuration'
+require 'iugu_logger/logger'
+require 'iugu_logger/request_logger'
+require 'iugu_logger/job_logger'
+
+# Auto-wire into Rails when present. No-op for non-Rails apps.
+require 'iugu_logger/railtie' if defined?(::Rails::Railtie)
+
+# iugu Logging Standard (ILS) — Ruby SDK
+#
+# Native iugu structured logging SDK. Standalone (no third-party logging
+# gem dependency). Implements the iugu Logging Standard (ILS) canonical schema.
+#
+# Compatibility: Ruby >= 2.4 (covers Rails 4.2 through modern services).
+#
+# @example basic setup
+#   IuguLogger.configure do |c|
+#     c.service_name        = 'platform'
+#     c.service_version     = ENV['GIT_SHA']
+#     c.service_environment = Rails.env
+#   end
+#
+#   IuguLogger.event('pix.out.requested',
+#                    pix:  { end_to_end_id: e2e, amount_brl: 100 },
+#                    iugu: { account_id: account.id_da_conta })
+module IuguLogger
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+  class SchemaViolation < Error; end
+  class UnknownEventAction < Error; end
+
+  class << self
+    # Yields the configuration object for setup.
+    def configure
+      yield(configuration) if block_given?
+      configuration
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    # The shared singleton logger. Lazy-instantiated.
+    def logger
+      @logger ||= Logger.new(configuration)
+    end
+
+    # Convenience proxy to logger.event(...).
+    def event(action, **fields)
+      logger.event(action, **fields)
+    end
+
+    # Resets configuration and logger. For tests / repl only.
+    def reset!
+      @configuration = nil
+      @logger = nil
+    end
+  end
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: iugu_logger
+version: !ruby/object:Gem::Version
+  version: 0.10.0
+platform: ruby
+authors:
+- Eng Plataforma iugu
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+description: Standalone Ruby logging SDK implementing the iugu Logging Standard (ILS).
+  No third-party logging gem dependency. Compatible from Ruby 2.4 (platform Rails
+  4.2) through Ruby 3.x (modern services).
+email:
+- eng-plataforma@iugu.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- README.md
+- lib/generators/iugu_logger/install/install_generator.rb
+- lib/generators/iugu_logger/install/templates/iugu_logger.rb.tt
+- lib/iugu_logger.rb
+- lib/iugu_logger/buffer.rb
+- lib/iugu_logger/configuration.rb
+- lib/iugu_logger/job_logger.rb
+- lib/iugu_logger/logger.rb
+- lib/iugu_logger/pii.rb
+- lib/iugu_logger/railtie.rb
+- lib/iugu_logger/request_logger.rb
+- lib/iugu_logger/schema.rb
+- lib/iugu_logger/severity.rb
+- lib/iugu_logger/smoke_test.rb
+- lib/iugu_logger/tasks/iugu_logger.rake
+- lib/iugu_logger/tenant_context.rb
+- lib/iugu_logger/trace_context.rb
+- lib/iugu_logger/version.rb
+homepage: https://rubygems.org/gems/iugu_logger
+licenses:
+- Apache-2.0
+metadata:
+  allowed_push_host: https://rubygems.org
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Native iugu structured logging SDK — schema canonical, PII-aware, trace-context
+  aware.
+test_files: []