rage-rb 1.19.2 → 1.20.0

data/lib/rage/telemetry/tracer.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+class Rage::Telemetry::Tracer
+  DEFAULT_SPAN_RESULT = Rage::Telemetry::SpanResult.new.freeze
+  private_constant :DEFAULT_SPAN_RESULT
+
+  # @param spans_registry [Hash{String => Rage::Telemetry::Spans}]
+  # @param handlers_map [Hash{String => Array<Rage::Telemetry::HandlerRef>}]
+  def initialize(spans_registry, handlers_map)
+    @spans_registry = spans_registry
+    @handlers_map = handlers_map
+
+    @all_handler_refs = handlers_map.values.flatten
+
+    @spans_registry.each do |_, span|
+      setup_noop(span)
+    end
+  end
+
+  def setup
+    @handlers_map.each do |span_id, handler_refs|
+      setup_tracer(@spans_registry[span_id], handler_refs)
+    end
+  end
+
+  private
+
+  # @param span [Rage::Telemetry::Spans]
+  def setup_noop(span)
+    parameters = span.span_parameters.join(", ")
+
+    self.class.class_eval <<~RUBY, __FILE__, __LINE__ + 1
+      def #{tracer_name(span.id)}(#{parameters})
+        yield
+      end
+    RUBY
+  end
+
+  # @param span [Rage::Telemetry::Spans]
+  # @param handler_refs [Array<Rage::Telemetry::HandlerRef>]
+  def setup_tracer(span, handler_refs)
+    yield_call = <<~RUBY
+        yield_called = true
+        yield_result = yield
+        span_result = DEFAULT_SPAN_RESULT
+      rescue Exception => e
+        yield_error = e
+        span_result = Rage::Telemetry::SpanResult.new(e).freeze
+    RUBY
+
+    calls_chain = handler_refs.reverse.inject(yield_call) do |memo, handler_ref|
+      handler_index = @all_handler_refs.index(handler_ref)
+
+      handler_method = handler_ref.instance.method(handler_ref.method_name)
+      handler_arguments = Rage::Internal.build_arguments(
+        handler_method,
+        { **span.handler_arguments, id: "\"#{span.id}\".freeze" }
+      )
+
+      <<~RUBY
+        @all_handler_refs[#{handler_index}].instance.#{handler_ref.method_name}(#{handler_arguments}) do
+          #{memo}
+          span_result
+        end
+      RUBY
+    end
+
+    parameters = span.span_parameters.join(", ")
+
+    self.class.class_eval <<~RUBY, __FILE__, __LINE__ + 1
+      def #{tracer_name(span.id)}(#{parameters})
+        span_result = yield_called = yield_result = yield_error = nil
+
+        begin
+          #{calls_chain}
+        rescue Exception => e
+          Rage.logger.error("Telemetry handler failed with error \#{e}:\\n\#{e.backtrace.join("\\n")}")
+        end
+
+        unless yield_called
+          Rage.logger.warn("Telemetry handler didn't call `yield` when processing span '#{span.id}'\\n\#{caller.join("\\n")}")
+          yield_result = yield
+        end
+
+        if yield_error
+          raise yield_error
+        else
+          yield_result
+        end
+      end
+    RUBY
+  end
+
+  def tracer_name(span_id)
+    "span_#{span_id.gsub(".", "_")}"
+  end
+end

data/lib/rage/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rage
-  VERSION = "1.19.2"
+  VERSION = "1.20.0"
 end

data/rage.gemspec

@@ -6,10 +6,10 @@ Gem::Specification.new do |spec|
   spec.name = "rage-rb"
   spec.version = Rage::VERSION
   spec.authors = ["Roman Samoilov"]
-  spec.email = ["rsamoi@icloud.com"]
+  spec.email = ["developers@rage-rb.dev"]
 
   spec.summary = "Fast web framework compatible with Rails."
-  spec.homepage = "https://github.com/rage-rb/rage"
+  spec.homepage = "https://rage-rb.dev"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 3.2.0"
 
@@ -20,7 +20,7 @@ Gem::Specification.new do |spec|
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(__dir__) do
     `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) || f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor .rubocop])
+      (File.expand_path(f) == __FILE__) || f.start_with?(*%w[bin/ gemfiles/ test/ spec/ features/ .git .circleci appveyor .rubocop])
     end
   end
   spec.bindir = "exe"
@@ -34,4 +34,5 @@ Gem::Specification.new do |spec|
   spec.add_dependency "rack-test", "~> 2.1"
   spec.add_dependency "rake", ">= 12.0"
   spec.add_dependency "logger"
+  spec.add_dependency "irb"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: rage-rb
 version: !ruby/object:Gem::Version
-  version: 1.19.2
+  version: 1.20.0
 platform: ruby
 authors:
 - Roman Samoilov
 bindir: exe
 cert_chain: []
-date: 2026-01-06 00:00:00.000000000 Z
+date: 2026-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -107,8 +107,22 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: irb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 email:
-- rsamoi@icloud.com
+- developers@rage-rb.dev
 executables:
 - rage
 extensions: []
@@ -117,6 +131,7 @@ files:
 - ".rspec"
 - ".yardopts"
 - ARCHITECTURE.md
+- Appraisals
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -146,6 +161,8 @@ files:
 - lib/rage/deferred/backends/nil.rb
 - lib/rage/deferred/context.rb
 - lib/rage/deferred/deferred.rb
+- lib/rage/deferred/metadata.rb
+- lib/rage/deferred/middleware_chain.rb
 - lib/rage/deferred/proxy.rb
 - lib/rage/deferred/queue.rb
 - lib/rage/deferred/task.rb
@@ -163,6 +180,7 @@ files:
 - lib/rage/logger/json_formatter.rb
 - lib/rage/logger/logger.rb
 - lib/rage/logger/text_formatter.rb
+- lib/rage/middleware/body_finalizer.rb
 - lib/rage/middleware/cors.rb
 - lib/rage/middleware/fiber_wrapper.rb
 - lib/rage/middleware/origin_validator.rb
@@ -204,6 +222,21 @@ files:
 - lib/rage/setup.rb
 - lib/rage/sidekiq_session.rb
 - lib/rage/tasks.rb
+- lib/rage/telemetry/handler.rb
+- lib/rage/telemetry/spans/await_fiber.rb
+- lib/rage/telemetry/spans/broadcast_cable_stream.rb
+- lib/rage/telemetry/spans/create_websocket_connection.rb
+- lib/rage/telemetry/spans/dispatch_fiber.rb
+- lib/rage/telemetry/spans/enqueue_deferred_task.rb
+- lib/rage/telemetry/spans/process_cable_action.rb
+- lib/rage/telemetry/spans/process_cable_connection.rb
+- lib/rage/telemetry/spans/process_controller_action.rb
+- lib/rage/telemetry/spans/process_deferred_task.rb
+- lib/rage/telemetry/spans/process_event_subscriber.rb
+- lib/rage/telemetry/spans/publish_event.rb
+- lib/rage/telemetry/spans/spawn_fiber.rb
+- lib/rage/telemetry/telemetry.rb
+- lib/rage/telemetry/tracer.rb
 - lib/rage/templates/Gemfile
 - lib/rage/templates/Rakefile
 - lib/rage/templates/app-controllers-application_controller.rb
@@ -229,11 +262,11 @@ files:
 - lib/rage/uploaded_file.rb
 - lib/rage/version.rb
 - rage.gemspec
-homepage: https://github.com/rage-rb/rage
+homepage: https://rage-rb.dev
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/rage-rb/rage
+  homepage_uri: https://rage-rb.dev
   source_code_uri: https://github.com/rage-rb/rage
 rdoc_options: []
 require_paths: