require-profiler 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9031019da202ea4bf4ba530de358c6759bb8417de3f96047a138a9d262c0ff0
-  data.tar.gz: e51c7eb92cc7419bcdd396103a0565db26e9cf2fd97013577ffcc8b5b127a337
+  metadata.gz: 9f7525e2f089705293ecb70a35d28837fb45c144b9c58861c9904d8b58a9e49a
+  data.tar.gz: 8a5e2acb8665b0bb7d665d91d0598d16c61d7488f7d40bed23cc1afe03559e7a
 SHA512:
-  metadata.gz: cc3d71a84a0faac6f801a9836dc0e0b3c3c6c3d694275f709f8a399229c8a1ee5cb8fe3b9ea4f1c311e04f93e0ffb3c28f3462ce6c582888e155da0a64b469d6
-  data.tar.gz: d16347ab1249f15e34f325f11f0505f17985c877bf2808b3e1727bff31c4369d95791032546f5f987034f1061ec95a774f1788646afc5f8c8b010374b26da1cc
+  metadata.gz: ef22d5d6c1a8d98bc7418802be6b95f9a84e82336e4f1de1681cddfba631ca187c504ccf343d2ea25832b46ca1a6c00bd411996bb8c77315a6f0311a4c5895dd
+  data.tar.gz: ae0f1a579693c2242f78eab1f4898e94ed54701ff8d3cc4d080b534791f9043206da1d89ef2da58cf5dcd67fc27404bcf0e2b0aae15d14e67d9f2a3a8c3a0812

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## master
 
+## 0.3.0 (2026-07-23)
+
+- Add Rails initialization tracking: railtie initializers, `to_prepare` callbacks, and lazy load hooks. ([@ardecvz][])
+
+- Prefix HTTP nodes with `http:`. ([@ardecvz][])
+
+## 0.2.3 (2026-06-05)
+
+- Add SKILL.md for rails-hyperdrive. ([@palkan][])
+
 ## 0.2.2 (2026-06-05)
 
 - Fixed YAML tracking when Pathname is used. ([@palkan][])

data/README.md

@@ -7,8 +7,9 @@ Require Profiler is a tool for profiling Ruby's code loading—`Kernel#require`,
 
 It's built on top of [Require Hooks][require-hooks], so it works anywhere Require Hooks does (MRI/JRuby/TruffleRuby).
 
-<a href="https://evilmartians.com/">
-<img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Sponsored by Evil Martians" width="236" height="54"></a>
+<br/>
+
+<img src="https://cdn.evilmartians.com/badges/logo-no-label.svg" alt="Evil Martians logo" width="22" height="16" /> <b>Require Profiler</b> is built by <b><a href="https://evilmartians.com/">Evil Martians</a></b>, an American design and engineering consultancy for <b>developer tools, AI, and cybersecurity startups</b>.
 
 ## Installation
 
@@ -112,6 +113,14 @@ Now you can use Speedscope to dig deeper.
 
 Require Profiler also captures HTTP requests and YAML file loading and add them to the profile, so you can find which Ruby files trigger the corresponding actions on load. NOTE: For HTTP requests tracking, you MUST add [sniffer][] gem to your Gemfile.
 
+Disable with `REQUIRE_PROFILER_YAML=false` or `REQUIRE_PROFILER_HTTP=false`.
+
+### Rails integration
+
+When Rails is loaded, Require Profiler automatically captures its initialization - railtie initializers, `to_prepare` callbacks, and lazy load hooks - and adds them to the profile as `initializer:`, `to_prepare:`, and `load_hook:` nodes, so you can find the slow-running blocks, which are usually invisible when profiling code loading alone.
+
+Disable with `REQUIRE_PROFILER_RAILS=false` (or set a threshold if the extra nodes add too much noise).
+
 ### Configuration
 
 `RequireProfiler.start` accepts the following keyword arguments:

data/lib/require_profiler/patcher.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module RequireProfiler
+  # Use TracePoint to run a callback when a particular class is defined
+  module Patcher
+    class << self
+      def on_load(name, &callback)
+        return callback.call if Object.const_defined?(name)
+
+        callbacks[name] = callback
+
+        tracer.enable
+      end
+
+      private
+
+      def callbacks = @callbacks ||= {}
+
+      def tracer = @tracer ||= TracePoint.new(:end, &method(:on_class))
+
+      def name_method = @name_method ||= Module.instance_method(:name)
+
+      def on_class(event)
+        return if event.self.singleton_class?
+
+        class_name = name_method.bind_call(event.self)
+        return unless callbacks[class_name]
+
+        callback = callbacks.delete(class_name)
+        tracer.disable if callbacks.empty?
+
+        callback.call
+      end
+    end
+  end
+end

data/lib/require_profiler/plugins/http_plugin.rb

@@ -19,7 +19,7 @@ module RequireProfiler
 
         Sniffer::DataItem::Request.include(Module.new do
           def require_path
-            @url ||= "#{method.to_s.upcase}:#{(port == 443) ? "https" : "http"}://#{host}#{query}"
+            @url ||= "http:#{method.to_s.upcase}:#{(port == 443) ? "https" : "http"}://#{host}#{query}"
           end
         end)
 

data/lib/require_profiler/plugins/rails_plugin.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module RequireProfiler
+  module Plugins
+    # Track Rails initialization: railtie initializers, to_prepare callbacks, and load hooks
+    class RailsPlugin < Base
+      module InitializerPatch
+        def run(...)
+          RailsPlugin.track(:initializer, name, block) { super }
+        end
+      end
+
+      module ToPreparePatch
+        def to_prepare(*args, &block)
+          return super unless block
+
+          super do |*prepare_args|
+            RailsPlugin.track(:to_prepare, nil, block) do
+              instance_exec(*prepare_args, &block)
+            end
+          end
+        end
+      end
+
+      module LoadHookPatch
+        private
+
+        def execute_hook(name, base, options, block)
+          RailsPlugin.track(:load_hook, name, block) { super }
+        end
+      end
+
+      class << self
+        attr_accessor :reporter
+
+        def track(kind, name, block)
+          path = label(kind, name, block)
+          reporter.handle_event(Reporter::Event.new(type: :start, kind: :rails, path:))
+          start = Time.now
+          yield
+        ensure
+          time = Time.now - start
+          reporter.handle_event(Reporter::Event.new(type: :end, path:, time:))
+        end
+
+        def label(kind, name, block)
+          ["rails:#{kind}", name, block&.source_location&.join(":")].compact.join(":")
+        end
+      end
+
+      def activate!
+        RailsPlugin.reporter = reporter
+
+        Patcher.on_load("Rails::Initializable::Initializer") do
+          ::Rails::Initializable::Initializer.prepend(InitializerPatch)
+        end
+        Patcher.on_load("ActiveSupport::Reloader") do
+          ::ActiveSupport::Reloader.singleton_class.prepend(ToPreparePatch)
+        end
+        Patcher.on_load("ActiveSupport::LazyLoadHooks") do
+          ::ActiveSupport.singleton_class.prepend(LoadHookPatch)
+        end
+      end
+    end
+  end
+end

data/lib/require_profiler/plugins.rb

@@ -6,6 +6,7 @@ module RequireProfiler
       def register_reporter(reporter)
         HTTPPlugin.new(reporter).activate! unless ENV["REQUIRE_PROFILER_HTTP"] == "false"
         YAMLPlugin.new(reporter).activate! unless ENV["REQUIRE_PROFILER_YAML"] == "false"
+        RailsPlugin.new(reporter).activate! unless ENV["REQUIRE_PROFILER_RAILS"] == "false"
       end
     end
 
@@ -19,5 +20,6 @@ module RequireProfiler
 
     autoload :HTTPPlugin, "require_profiler/plugins/http_plugin"
     autoload :YAMLPlugin, "require_profiler/plugins/yaml_plugin"
+    autoload :RailsPlugin, "require_profiler/plugins/rails_plugin"
   end
 end

data/lib/require_profiler/printer/call_stack.rb

@@ -4,13 +4,22 @@ module RequireProfiler
   module Printer
     # CallStack formatter prints collapsed stacks (Brendan Gregg's format)
     class CallStack < Base
+      # Rails labels are "rails:#{type}:#{detail}", e.g. "rails:initializer:name:file:line"
+      RAILS_LABEL_PARTS = 3
+      RAILS_TYPE_INDEX = 1
+
       def flush(node, parts: [])
         return unless flush?(node)
 
-        path = node.path.sub(prefix_stripper, "")
-        self_parts = (node.kind == :path) ? path.split("/") : [path]
+        path = strip_prefix(node.path)
+        self_parts =
+          case node.kind
+          when :rails then rails_frames(path)
+          when :path then path_frames(path)
+          else [path]
+          end
 
-        parts += self_parts.size.times.map { self_parts.take(_1 + 1).join("/") }
+        parts += self_parts
         # We only show self-time, so exclude children
         val = ((node.time - node.children.sum(&:time)) * 1000).round(3)
 
@@ -18,6 +27,17 @@ module RequireProfiler
 
         node.children.each { flush(_1, parts:) }
       end
+
+      private
+
+      def rails_frames(path)
+        ["rails:#{path.split(":", RAILS_LABEL_PARTS)[RAILS_TYPE_INDEX]}", path]
+      end
+
+      def path_frames(path)
+        segments = path.split("/")
+        segments.size.times.map { segments.take(_1 + 1).join("/") }
+      end
     end
   end
 end

data/lib/require_profiler/printer/text.rb

@@ -8,7 +8,7 @@ module RequireProfiler
       def flush(node, indent: 0)
         return unless flush?(node)
 
-        path = node.path.sub(prefix_stripper, "")
+        path = strip_prefix(node.path)
         output << "#{PAD * indent}#{path} — #{time_to_duration(node.time)}\n"
         node.children.each { flush(_1, indent: indent + 1) }
 

data/lib/require_profiler/printer.rb

@@ -16,7 +16,7 @@ module RequireProfiler
         prefixes << ::Gem.dir if defined?(::Gem.dir)
         prefixes << ::Bundler.bundle_path if defined?(::Bundler.bundle_path)
 
-        @prefix_stripper = %r{^(#{prefixes.join("|")})/}
+        @prefix_stripper = %r{(^|:)(#{prefixes.join("|")})/}
       end
 
       def flush(node)
@@ -29,6 +29,10 @@ module RequireProfiler
 
       private
 
+      def strip_prefix(path)
+        path.sub(prefix_stripper, '\1')
+      end
+
       def flush?(node)
         return false unless (node.time * 1000) >= threshold
 

data/lib/require_profiler/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RequireProfiler # :nodoc:
-  VERSION = "0.2.2"
+  VERSION = "0.3.0"
 end

data/lib/require_profiler.rb

@@ -4,6 +4,7 @@ module RequireProfiler
   autoload :Reporter, "require_profiler/reporter"
   autoload :Printer, "require_profiler/printer"
   autoload :Plugins, "require_profiler/plugins"
+  autoload :Patcher, "require_profiler/patcher"
 
   # Autoload doesn't work here, because we call it from the hooks for the first time
   require "require_profiler/ruby_profiling"

data/{lib/require_profiler/hyperdrive/skills → skills}/rails-boot-profiling/SKILL.md

@@ -167,21 +167,67 @@ This emits one line per stack in Brendan Gregg's collapsed format with per-frame
 | `REQUIRE_PROFILER_HTTP` | Disable HTTP tracking when set to `false` | `false` |
 | `REQUIRE_PROFILER_PLUGINS` | Disable all plugins when set to `false` | `false` |
 
+## Important: Use the Profiler's Built-in Filtering
+
+**Prefer profiler's built-in filtering and searching capabilities over `grep`, `tail`, `head`, `awk`, or `sed` to filter or search results.**:
+
+- To find slow files → use `REQUIRE_PROFILE_THRESHOLD`, not `grep` for timing patterns
+- To investigate a specific gem or file → use `REQUIRE_PROFILE_FOCUS`, not `grep` for the name
+- To reduce output size → use `REQUIRE_PROFILE_THRESHOLD` + `REQUIRE_PROFILE_FOCUS`, not `tail -N | head -M`
+
+Shell-based filtering breaks the indented tree structure (you lose parent-child relationships), misses context, and requires re-running the full profile each time you change the filter. The built-in env vars preserve the tree, show ancestor chains, and handle edge cases the profiler already knows about.
+
+The only acceptable uses of piping are:
+- `| wc -l` to count total loaded files in step 1
+- Piping into a file when `REQUIRE_PROFILE_PATH` is not available
+
 ## Recommended Agent Workflow
 
 Follow this sequence when a user asks about slow boot time:
 
 1. **Get a baseline.** Run the full profile command and note the total boot time (the top-level entry's duration) and total file count (`| wc -l`).
 
-2. **Find the top offenders.** Re-run with `REQUIRE_PROFILE_THRESHOLD=100` (or adjust based on total time) to surface only slow files. Report the top 5-10 slowest entries to the user.
+   ```sh
+   bundle exec ruby -W0 -r./config/boot -require-prof config/environment.rb
+   ```
+
+2. **Find the top offenders.** Re-run with `REQUIRE_PROFILE_THRESHOLD` to surface only slow files. Start with a threshold that shows roughly 10-20 entries (e.g., if total boot is ~4s, try 100ms; if ~1s, try 30ms). Report the top slowest entries to the user.
+
+   ```sh
+   REQUIRE_PROFILE_THRESHOLD=100 bundle exec ruby -W0 -r./config/boot -require-prof config/environment.rb
+   ```
 
-3. **Investigate specific areas.** If the user suspects a particular gem or area, use `REQUIRE_PROFILE_FOCUS` to zoom in. Otherwise, focus on the slowest entries from step 2.
+3. **Investigate specific areas.** Use `REQUIRE_PROFILE_FOCUS` to zoom into a gem, initializer, or file. The focus pattern is a regexp — use it to match file paths, gem names, or directory patterns. Combine with `REQUIRE_PROFILE_THRESHOLD` for precision.
 
-4. **Check for boot-time side effects.** Look at YAML and HTTP entries in the profile. HTTP calls during boot are almost always worth investigating — they add latency and can fail. YAML loads of large files can also be significant.
+   ```sh
+   # Investigate a specific gem
+   REQUIRE_PROFILE_FOCUS="stripe" bundle exec ruby -W0 -r./config/boot -require-prof config/environment.rb
+
+   # Investigate all initializers that took > 50ms
+   REQUIRE_PROFILE_THRESHOLD=50 REQUIRE_PROFILE_FOCUS="initializers" bundle exec ruby -W0 -r./config/boot -require-prof config/environment.rb
+   ```
+
+4. **Check for boot-time side effects.** YAML and HTTP entries appear in the profile tree by default. HTTP calls during boot are almost always worth investigating — they add latency and can fail. Use `REQUIRE_PROFILE_FOCUS` to find them:
+
+   ```sh
+   # Find YAML loading
+   REQUIRE_PROFILE_FOCUS="\.yml" bundle exec ruby -W0 -r./config/boot -require-prof config/environment.rb
+
+   # Find HTTP calls during boot
+   REQUIRE_PROFILE_FOCUS="(GET|POST|PATCH|DELETE):" bundle exec ruby -W0 -r./config/boot -require-prof config/environment.rb
+   ```
 
 5. **Deep-dive when needed.** For files that are unexpectedly slow (the load time seems too high for what the file does), use `REQUIRE_PROFILE_STACKPROF` to generate a Stackprof profile and identify what's happening inside that file.
 
-6. **Generate a JSON profile for handoff.** If the user wants to explore the data themselves, or if the profile is too large to analyze in text, export to JSON with `REQUIRE_PROFILE_PATH=tmp/require-profile.json` and point them to Speedscope.
+   ```sh
+   REQUIRE_PROFILE_STACKPROF=config/initializers/stripe.rb bundle exec ruby -W0 -r./config/boot -require-prof config/environment.rb
+   ```
+
+6. **Generate a JSON profile for handoff.** If the user wants to explore the data themselves, or if the profile is too large to analyze in text, export to JSON and point them to Speedscope.
+
+   ```sh
+   REQUIRE_PROFILE_PATH=tmp/require-profile.json bundle exec ruby -W0 -r./config/boot -require-prof config/environment.rb
+   ```
 
 7. **Suggest actionable improvements** based on findings:
    - Move heavy gem requires behind lazy loading or autoload

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: require-profiler
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Vladimir Dementyev
@@ -65,6 +65,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -134,9 +148,10 @@ files:
 - lib/equire-prof.rb
 - lib/require-profiler.rb
 - lib/require_profiler.rb
-- lib/require_profiler/hyperdrive/skills/rails-boot-profiling/SKILL.md
+- lib/require_profiler/patcher.rb
 - lib/require_profiler/plugins.rb
 - lib/require_profiler/plugins/http_plugin.rb
+- lib/require_profiler/plugins/rails_plugin.rb
 - lib/require_profiler/plugins/yaml_plugin.rb
 - lib/require_profiler/printer.rb
 - lib/require_profiler/printer/call_stack.rb
@@ -145,6 +160,7 @@ files:
 - lib/require_profiler/reporter.rb
 - lib/require_profiler/ruby_profiling.rb
 - lib/require_profiler/version.rb
+- skills/rails-boot-profiling/SKILL.md
 homepage: https://github.com/palkan/require-profiler
 licenses:
 - MIT
@@ -156,6 +172,7 @@ metadata:
   source_code_uri: https://github.com/palkan/require-profiler
   hyperdrive_targets: railties
   hyperdrive_artifacts: skill
+  hyperdrive_skills_dir: "./skills"
 rdoc_options: []
 require_paths:
 - lib
@@ -170,7 +187,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.16
 specification_version: 4
 summary: 'Profile Ruby #require/#load/etc calls'
 test_files: []