stack-service-base 0.0.4 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 340d3036dfae55df21ac629aea2f177b890257e29e8d51d7c7ec975bff57ee0b
-  data.tar.gz: 76ab84fb603376f3a8f29901c5987cd4bf664625dd6a9bd533f20e928716a775
+  metadata.gz: 7fc2da143ab2622432f7fce2f36bf7e99e4679ffcb110f7b2a0f4b44d762b26b
+  data.tar.gz: 0da55dfcbe8f1ea8cd89ea6625238e99ad607729a914aa0bbe3b45197a5615a3
 SHA512:
-  metadata.gz: d99472369e7dae16f8cfd8526e785a6dee35727e4f7e7b48e81a3509a295c9712883c8060d177f76cb56022d42055868f1ce3ee7cabd27163635a66bb9154bb9
-  data.tar.gz: 3d86d30f6fbcbcb06339d2cdfe03afbf51a58696177d88c4d7fc81e404454093ba0c4e00ef80ac228ebc41140dbf6569f6c405577df0c1ca126ea00cc24360d3
+  metadata.gz: e6a8a2321eef07de698ef008bc3f8cfe834484dda97692e2efa10a8d80fb1ad03c7b7f6906246545d0af9da444723ea49b8d910276393f2efb48b0fc82a9a9a0
+  data.tar.gz: 0c9b6ea5c45abd03e06b9ec132e02abc7746019722b9fbebb30f8f56bb70e24e48944c0597b8a8b1fa42ee937ce02ddad22dd9bc1742f2ae195ed926b7cce113

data/lib/stack-service-base/logging.rb

@@ -0,0 +1,141 @@
+require 'console'
+require 'fiber'
+
+QUIET = ENV.fetch('CONSOLE_LEVEL', 'false') == 'true'
+PERFORMANCE = ENV.fetch('PERFORMANCE', 'false') == 'true'
+
+ENV['CONSOLE_LEVEL'] ||= 'all' unless QUIET || PERFORMANCE
+
+CONSOLE_LOGGER = Class.new {
+  def <<(...) = Console.logger.info(...)
+  def info(...) = Console.logger.info(...)
+  def debug(...) = Console.logger.debug(...)
+  def debug1(...) = Console.logger.debug(...)
+  def debug2(...) = Console.logger.debug(...)
+  def debug3(...) = Console.logger.debug(...)
+  def warn(...) = Console.logger.warn(...)
+  def error(...) = Console.logger.error(...)
+  def fatal(...) = Console.logger.fatal(...)
+}.new
+
+if QUIET
+  ENV['CONSOLE_LEVEL'] = 'error'
+  LOGGER = CONSOLE_LOGGER
+
+  # LOGGER = Class.new {
+  #   def <<(...) = nil
+  #   def info(...) = nil
+  #   def debug(...) = nil
+  #   def debug1(...) = nil
+  #   def debug2(...) = nil
+  #   def debug3(...) = nil
+  #   def warn(...) = nil
+  #   def error(...) = nil
+  #   def fatal(...) = nil
+  # }.new
+else
+  $stdout.sync = true
+  $stderr.sync = true
+  # class Fiber
+  #   alias_method :old_init, :initialize
+  #   attr_reader :parent
+  #
+  #   def initialize(&)
+  #     @parent = Fiber.current
+  #     old_init(&)
+  #   end
+  #
+  #   def parents
+  #     list = [@parent]
+  #     list << list.last.parent while list.last.respond_to?(:parent) && !list.last.parent.nil?
+  #     list
+  #   end
+  # end
+
+  # https://socketry.github.io/traces/guides/getting-started/index.html
+  # OpenTelemetry / Datadog
+  # https://socketry.github.io/console/guides/getting-started/index.html
+  # ENV['TRACES_BACKEND'] = 'traces/backend/console'
+  # ENV['CONSOLE_LEVEL'] = 'all'
+  # ENV['CONSOLE_OUTPUT'] = 'XTerm' # JSON,Text,XTerm,Default
+  # TRACE_METHODS = true
+  TRACE_METHODS ||= !PERFORMANCE unless defined? TRACE_METHODS
+  if TRACE_METHODS
+    trace = TracePoint.new(:call, :return, :b_call, :b_return) { |tp| # :thread_begin, :thread_end
+      call_stack = Thread.current[:call_stack] ||= {}
+      call_stack_fiber = call_stack[Fiber.current.__id__] ||= []
+      call_stack_fiber << [tp.defined_class, tp.method_id] if [:call, :b_call].include? tp.event
+      call_stack_fiber.pop if [:return, :b_return].include? tp.event
+    }
+    trace.enable
+  end
+  # the_method
+  # trace.disable
+  LOG_DEPTH ||= 10 unless defined? LOG_DEPTH
+  LOGGER = Class.new {
+    def initialize = @context_list ||= {}
+
+    def add_context(name)
+      task = Async::Task.current?
+      @context_list[task.__id__] = name
+    end
+
+    def find_context
+      return '' unless Thread.current[:async_task]
+
+      t_stack = [Async::Task.current]
+      t_stack << t_stack.last.parent while t_stack.last.parent
+      task = t_stack.find { @context_list[_1.__id__] }
+
+      task ? " [#{@context_list[task.__id__]}] " : ''
+    end
+
+    def <<(...) = do_log(:info, ...)
+
+    def info(...) = do_log(:info, ...)
+
+    def debug(...) = do_log(:debug, ...)
+
+    def debug1(...) = do_log(:debug1, ...)
+
+    def debug2(...) = do_log(:debug2, ...)
+
+    def debug3(...) = do_log(:debug3, ...)
+
+    def warn(...) = do_log(:warn, ...)
+
+    def error(...) = do_log(:error, ...)
+
+    def fatal(...) = do_log(:fatal, ...)
+
+    def do_log(name, *args)
+      debug_level = name[/(\d+)/, 1].to_i
+      unless debug_level > LOG_DEPTH
+        if TRACE_METHODS
+          call_stack = Thread.current[:call_stack] ||= {}
+          call_stack_fiber = call_stack[Fiber.current.__id__] ||= []
+          last = call_stack_fiber[-3] ? call_stack_fiber[-3].join('.').gsub('Class:', '').gsub(/[#<>]/, '') : ''
+          last += find_context
+          msg = "\e[33m#{last}:\e[0m \e[38;5;254m" + args.flatten.map(&:inspect).join(', ')
+        else
+          msg = args.flatten.map(&:inspect).join(', ')
+        end
+        _name = name.to_s.gsub(/\d/, '')
+        _name = 'info' if _name == '<<'
+        Console.logger.send _name.to_s.gsub(/\d/, ''), msg
+      end
+    end
+  }.new
+
+end
+
+LOGGER_GRAPE = Class.new {
+  def method_missing(name, d)
+    Console.logger.send  name, "REST_API: #{d[:method]} #{d[:path]} #{d[:params]} - #{d[:status]} host:#{d[:host]} time:#{d[:time]}"
+  end
+}.new
+
+$stdout.puts "QUIET: #{QUIET}"
+$stdout.puts "PERFORMANCE: #{PERFORMANCE}"
+
+ENV.select{ |k,v| k =~ /CONSOLE_/}.each { |k,v| $stdout.puts "#{k}: #{v}"}

data/lib/stack-service-base/open_telemetry.rb

@@ -52,8 +52,8 @@ if defined? LOGGER and OTEL_ENABLED
   OpenTelemetry.logger = LOGGER
 end
 
-def otel_initialize
-  $stderr.puts "otl_configure: OTEL_ENABLED: #{OTEL_ENABLED}"
+def otel_initialize(app)
+  $stdout.puts "otl_configure: OTEL_ENABLED: #{OTEL_ENABLED}"
   return unless OTEL_ENABLED
 
   OpenTelemetry::SDK.configure do |c|
@@ -89,6 +89,7 @@ def otel_initialize
     # span.status = OpenTelemetry::Trace::Status.error("error message here!")
   end
 
+  app.use OTELTraceInfo
 end
 
 if defined? Sequel and OTEL_ENABLED

data/lib/stack-service-base/rack_helpers.rb

@@ -0,0 +1,199 @@
+module RackHelpers
+  def Rack.middleware_klass(&block)
+    Class.new do
+      define_method(:initialize) do |app, *opts, &block2|; @app = app; @opts = opts; @block = block2 || block end
+      def call(env) = @block.call env, @app, @opts
+    end
+  end
+
+  def Rack.define_middleware(name, &block)
+    Object.const_set name, Rack.middleware_klass(&block)
+  end
+
+  Rack.define_middleware :Authentication do |env, app|
+    token = env['HTTP_AUTHORIZATION'][/Bearer (.*)/, 1] rescue nil # Authorization: Bearer token
+    token ||= env['HTTP_AUTH'][/Bearer (.*)/, 1] rescue nil # AUTH: Bearer token
+    token ||= Rack::Request.new(env).cookies['token']
+    token_h = JWT.decode token, '', false, algorithm: 'RS256' rescue nil
+    token_h ||= [{}]
+
+    if defined? OpenTelemetry::Trace
+      OpenTelemetry::Trace.current_span.add_attributes'TOKEN' => token_h[0].to_json,
+                                                      'username' => (token_h[0]['username'] || '')
+    end
+    Async::Task.current.define_singleton_method :token, &-> { token_h[0] }
+
+    app.call env
+  end
+
+  # TODO:
+  #  - Only required for cross-thread context transfer
+  #
+  # Rack.define_middleware :AsyncDBConnectionOT do |env, app|
+  #   context_ = OpenTelemetry::Context.current
+  #   OpenTelemetry::Context.with_current(context_) do
+  #     OpenTelemetry::Trace.with_span(OpenTelemetry::Trace.current_span) do
+  #       app.call env
+  #     end
+  #   end
+  # end
+
+  # Rack.define_middleware :SwaggerUI do |env, app, opts|
+  #   # url = opts[:swagger]
+  #   @static ||= Rack::Static.new app, urls: [''], root: "#{__dir__}/../swagger_ui/", index: 'index.html', cascade: true
+  #   env['REQUEST_METHOD'] == 'GET' ? @static.call(env) : app.call(env)
+  # end
+
+  #
+
+  Rack.define_middleware :OTELTraceInfo do |env, app, opts|
+    status, headers, body = app.call env
+    if status.to_i >= 500
+      otl_current_span{
+        span_context = OpenTelemetry::Trace.current_span.context
+        trace_id = span_context.trace_id.unpack1('H*')
+
+        begin
+          bj = JSON.parse(body.join)
+          bj[:trace_id] = trace_id
+          body = [bj.to_json]
+        rescue =>e
+          body = [body.join + "\ntrace_id: #{trace_id}"]
+        end
+      }
+    end
+
+    [status, headers, body]
+  end
+
+  Rack.define_middleware :NoCache do |env, app, opts|
+    status, headers, body = app.call env
+    headers['Cache-Control'] = 'private,max-age=0,must-revalidate,no-store'
+    [status, headers, body]
+  end
+
+  Rack.define_middleware :RequestsLimiter do |env, app, opts|
+    @sem ||= Async::Semaphore.new(opts[0][:limit] || 5 )
+
+    if @sem.blocking?
+      [429, { 'Content-Type' => 'text/plain', 'Retry-After' => '1' }, ['Too Many Requests']]
+    else
+      @sem.acquire {
+        app.call(env)
+      }
+    end
+  end
+
+  # PATCH: for the Grape
+  class Rack::Lint::Wrapper::InputWrapper
+    def rewind = @input.rewind
+  end if defined? Rack::Lint::Wrapper::InputWrapper
+
+  class Rack::Lint
+    def call(env = nil) = @app.call(env)
+  end if defined? Rack::Lint
+
+  class Rack::CommonLogger
+    def log(env, status, header, began_at) = ()
+  end
+  # require 'rack/request'
+  # # sinatra was resolved to 3.0.2, which depends on
+  # #   rack (~> 2.2, >= 2.2.4)
+  # # /home/user/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0/gems/rack-2.2.4/lib/rack/request.rb
+  # module Rack::Request::Helpers
+  #   alias old_post POST
+  #   def POST = get_header(Rack::RACK_INPUT).empty? ? {} : old_post
+  # end
+
+  Rack.define_middleware :HeadersLogger do |env, app, opts|
+    LOGGER.info env.select { _1 =~ /HTTP/ }.transform_keys { _1.gsub 'HTTP_', '' }
+    status, headers, body =app.call env
+
+    if status.to_i / 100 == 5
+      _body = body.to_s # each(&:to_s).join
+      LOGGER.error [status, headers, _body]
+      if defined? OpenTelemetry::Trace
+        OpenTelemetry::Trace.current_span.tap do |span|
+          event_attributes = { 'exception.type' => "HTTP #{status.to_i}", 'exception.message' => _body, 'exception.stacktrace' => '' }
+          span.add_event('exception', attributes: event_attributes)
+          span.status = OpenTelemetry::Trace::Status.error("Request error: #{status.to_i}")
+        end
+      end
+    end
+
+    LOGGER.info headers
+    [status, headers, body]
+  end
+
+  Rack.define_middleware :RequestProfile do |env, app, opts|
+    start = Time.now
+    LOGGER.debug "start:#{start}"
+    status, headers, body = app.call env
+    LOGGER.debug "#{Time.now - start} sec - end (fiber id: #{Fiber.current.__id__}, async task: #{Async::Task.current})"
+    headers['x-runtime'] = "#{Time.now - start}"
+    # if headers['Content-Type'] =~ /html/
+    #   headers['Set-Cookie'] = "Runtime=#{Time.now - start} sec;expires=Sat, 01-Jan-3000 00:00:00 GMT;path=/;"
+    # end
+    [status, headers, body]
+  end
+
+  class << self
+    def rack_setup(app)
+      # PATCH: for the Grape Swagger
+      # https://github.com/ruby-grape/grape-swagger/pull/905
+      # https://github.com/ruby-grape/grape-swagger/issues/904
+      GrapeSwagger::DocMethods::ParseParams.instance_eval do
+        def parse_enum_or_range_values(values)
+          case values
+          when Proc
+            parse_enum_or_range_values(values.call) if values.parameters.empty?
+          when Range
+            parse_range_values(values) # if values.first.is_a?(Integer) TODO
+          when Array
+            { enum: values }
+          else
+            { enum: [values] } if values
+          end
+        end
+      end if defined? GrapeSwagger::DocMethods::ParseParams
+
+      app.use Rack.middleware_klass do |env, app|
+        # env['REQUEST_PATH'] == '/healthcheck' ? [200, {}, ['Healthy']] : app.call(env)
+        env['PATH_INFO'] == '/healthcheck' ? [200, {'Content-Type' =>'application/json'}, [{ Status: 'Healthy' }.to_json ]] : app.call(env)
+      end
+
+      if defined? OpenTelemetry::Instrumentation::Rack::Middlewares::TracerMiddleware
+        use OpenTelemetry::Instrumentation::Rack::Middlewares::TracerMiddleware
+      end
+      app.use Rack::Deflater
+      app.use OTELTraceInfo
+
+      unless defined?(PERFORMANCE) && PERFORMANCE
+        app.use RequestProfile
+        app.use HeadersLogger
+
+        if defined? Rack::ODataCommonLogger
+          app.use Rack::ODataCommonLogger, LOGGER # or use Rack::CommonLogger, LOGGER
+        end
+      end
+
+      app.use Rack.middleware_klass do |env, app|
+        code, headers, body = env['REQUEST_METHOD'] == 'OPTIONS' ? [200, {}, []] : app.call(env)
+
+        # scheme = env['rack.url_scheme']
+        # referer = URI.parse env['HTTP_REFERER']
+        headers.merge!(
+          # 'Access-Control-Allow-Origin' => "#{referer.scheme}://#{referer.host}",
+          'Access-Control-Allow-Origin' => '*',
+          'Access-Control-Allow-Methods' => 'GET, PUT, POST, DELETE, HEAD, OPTIONS',
+          'Access-Control-Allow-Headers' => '*',
+          'Access-Control-Allow-Credentials' => 'true')
+        [code, headers, body]
+      end
+
+      # unless @run
+      #   run ->(_env) { [200, {'Content-Type' => 'text/plain'}, ['OK!?']] }
+      # end
+    end
+  end
+end

data/lib/stack-service-base.rb

@@ -1,3 +1,5 @@
+require 'stack-service-base/logging'
+require 'stack-service-base/rack_helpers'
 require 'stack-service-base/open_telemetry'
 
 module StackServiceBase
@@ -8,6 +10,7 @@ module StackServiceBase
       return unless app.respond_to? :use
 
       app.instance_eval do
+        RackHelpers.rack_setup app
         if ENV.fetch('PROMETHEUS_METRICS_EXPORT', 'true') == 'true'
           require 'stack-service-base/prometheus'
 
@@ -17,8 +20,7 @@ module StackServiceBase
         end
 
         if OTEL_ENABLED
-          otel_initialize
-
+          otel_initialize app
         end
 
       end

data/lib/version.rb

@@ -1,5 +1,5 @@
 module StackServiceBase
   class Base
-    VERSION = '0.0.4'
+    VERSION = '0.0.6'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stack-service-base
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.6
 platform: ruby
 authors:
 - ''
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-05 00:00:00.000000000 Z
+date: 2025-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: prometheus-client
@@ -157,9 +157,11 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/stack-service-base.rb
+- lib/stack-service-base/logging.rb
 - lib/stack-service-base/open_telemetry.rb
 - lib/stack-service-base/prometheus.rb
 - lib/stack-service-base/prometheus_parser.rb
+- lib/stack-service-base/rack_helpers.rb
 - lib/version.rb
 homepage:
 licenses: []