rperf 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dd9ddc0ea22d51ff2ebcdae6ddfa2f5e531c4a7814552b16470668d04d1d617
-  data.tar.gz: fce76e35ea6ccbca8e8b429da4b55574349f98b8731a2db3826efd908082dda6
+  metadata.gz: db5be965ca0511ea90e7482309f7dca4dc545a1c83a73f7b3fc08fc4029f9d34
+  data.tar.gz: 4ae2c1fe82a6d754a1ef0b4759ce2b1a2a22370788ce0197b1d269ba0a1e98e4
 SHA512:
-  metadata.gz: dceedb899f6b9249ae342e5701ef3280253c82d317ad73dea0bdd0c0c040a576740bb747c05c79b1f6118c82b05ad4756207ac046d9cc4805982a2f24ad09e1b
-  data.tar.gz: 4353afbe9ca80126c25884e837aacdd902a1e9d20756d543d235415492e17932490711b348ee49eb9e5144f977027a1284876cbd4dea4de31c342a16db16d931
+  metadata.gz: d99ff20c55b9d359b0dfced5f13cdfaa5f8d4fe1debb5375f2a2de2c7d2ed8a219d2bd4b89c05dbb6ee7fe257b5cf51fa74ad8a85b017db608d6f30d9a5eadf1
+  data.tar.gz: fefb4b168fc733da575e758933083fd169ee6513ac38624f7d89ba8e66b202b4166bf2cb6d8f6e513fe85fb5fec9e31c48231d036ba19439a4e24e09b077460d

data/README.md

@@ -82,6 +82,12 @@ rperf report ./profiles/                             # sidebar: per-commit list,
 
 # Flat tables for AI analysis (no Go required)
 rperf diff --format table base.json.gz head.json.gz | claude -p "analyze the regression"
+
+# Drive rperf without wrapping the command (CI/tooling): source the env, then
+# run your command unchanged — `bundle exec …` stays bundler-managed, plain
+# `ruby …` stays plain. (Run `rperf help` for details.)
+eval "$(rperf record --snapshot-dir ./profiles --print-env)"
+export RPERF_ROOT_PROCESS=$$ && exec ruby app.rb
 ```
 
 On `rperf report`, you can see the profile result like this page: [rperf viewer](https://ko1.github.io/rperf/examples/cpu_intensive_profile.html)

data/docs/help.md

@@ -31,8 +31,28 @@ POSIX systems (Linux, macOS). Requires Ruby >= 3.4.0.
     --label KEY=VALUE       Add a label to profile metadata (repeatable)
     --no-inherit            Do not profile forked/spawned child processes
     --no-aggregate          Disable C-level sample aggregation (raw per-sample data)
+    --print-env             Print the env rperf would set (export KEY=VALUE lines)
+                            and exit WITHOUT running a command — see below
     -v, --verbose           Print sampling statistics to stderr
 
+#### --print-env: drive rperf without wrapping the command
+
+Instead of `rperf record [options] -- command`, `--print-env` prints the
+environment a profiled process auto-starts from and exits without running
+anything. A wrapper (e.g. a CI script) sources it, makes the process that runs
+the command the session root, and runs the command unchanged — so a
+`bundle exec …` command stays bundler-managed and a plain `ruby …` stays plain;
+rperf is never inserted into the command line.
+
+    eval "$(rperf record --snapshot-dir ./profiles --print-env)"
+    export RPERF_ROOT_PROCESS=$$    # the pid that will exec the command is the root
+    exec ruby app.rb               # runs verbatim; rperf auto-starts via RUBYOPT
+
+`RPERF_ROOT_PROCESS` is not emitted (the caller sets it to the pid that execs
+the command); `RPERF_META_LABELS` is not emitted (set it yourself if you want
+per-run labels). Everything else (`RUBYOPT=-rrperf`, output path, mode,
+frequency, fork session dir, …) is included.
+
 JSON output embeds `meta` (git commit, host, Ruby/rperf versions, labels)
 and `summary` (time, GC, allocation, top methods) — see "Profile metadata"
 under OUTPUT FORMATS.

data/exe/rperf

@@ -368,6 +368,7 @@ stat_report = (subcommand == "exec")
 inherit = true
 meta_labels = {}
 snapshot_dir = nil
+print_env = false
 
 parser = OptionParser.new do |opts|
   opts.banner = case subcommand
@@ -441,6 +442,13 @@ parser = OptionParser.new do |opts|
     inherit = false
   end
 
+  opts.on("--print-env",
+          "Print the environment rperf would set (one `export KEY=VALUE` per line), then exit " \
+          "WITHOUT running a command. The caller sources it, sets RPERF_ROOT_PROCESS to the pid " \
+          "that will exec the command, and runs the command itself — so rperf never wraps it.") do
+    print_env = true
+  end
+
   opts.on("-v", "--verbose", "Print sampling statistics to stderr") do
     verbose = true
   end
@@ -461,7 +469,7 @@ rescue OptionParser::ParseError => e
   exit 1
 end
 
-if ARGV.empty?
+if ARGV.empty? && !print_env
   $stderr.puts "No command specified."
   $stderr.puts parser
   exit 1
@@ -557,9 +565,27 @@ session_dir = nil
 if inherit
   session_dir = Rperf.send(:_create_session_dir, clean_stale: true)
   if session_dir
-    ENV["RPERF_ROOT_PROCESS"] = Process.pid.to_s
     ENV["RPERF_SESSION_DIR"] = session_dir
+    # In --print-env mode this short-lived process does not run the command, so
+    # it must not claim rootship: the caller sets RPERF_ROOT_PROCESS to the pid
+    # that will exec the command. Otherwise (normal exec) we are the root.
+    ENV["RPERF_ROOT_PROCESS"] = Process.pid.to_s unless print_env
+  end
+end
+
+# --print-env: emit the environment a profiled process inherits to auto-start
+# rperf, then exit without running anything. RPERF_ROOT_PROCESS and
+# RPERF_META_LABELS are deliberately omitted — the caller owns those (it sets
+# the root pid, and labels per measurement run).
+if print_env
+  require "shellwords"
+  %w[RUBYLIB RUBYOPT RPERF_ENABLED RPERF_OUTPUT RPERF_FREQUENCY RPERF_MODE
+     RPERF_FORMAT RPERF_VERBOSE RPERF_SIGNAL RPERF_AGGREGATE RPERF_META_GIT
+     RPERF_SESSION_DIR RPERF_STAT RPERF_STAT_COMMAND RPERF_STAT_REPORT].each do |k|
+    v = ENV[k]
+    puts "export #{k}=#{Shellwords.escape(v)}" unless v.nil?
   end
+  exit 0
 end
 
 begin

data/lib/rperf/version.rb

@@ -1,3 +1,3 @@
 module Rperf
-  VERSION = "0.10.0"
+  VERSION = "0.11.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rperf
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Koichi Sasada
@@ -80,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Safepoint-based sampling performance profiler for Ruby
 test_files: []