byebug 11.1.3 → 12.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 756ca67151133e7afeea4be781e49bb948a7b8dc7b2ece045a29e6c549409abc
-  data.tar.gz: a301313d736ee29e15ec53d4e903359be8e4aa0b1bc1f6155d784937c636a0d6
+  metadata.gz: 44cf64e7bdc187e8302b39d4b1dbf6c00fd27f4c19e01f6331414ee4eed05ab1
+  data.tar.gz: 9ddbee412b023e83f7468749cd945ef93d2dddaf7152d477218d1b326db52b20
 SHA512:
-  metadata.gz: 03f857ddb22761e243a99660869b5c1bc4863c6c860e2827e2c6a2569009a7bba7ada3a79804ff6fadd5d556f1974feeee215c49696415733425f542fa78b52e
-  data.tar.gz: 585b54db0201a0ba6e1e23bceed21b7361064c56a1fa08d997e714d088a05e0ba74c1ffd4ed4fbcb763ad7719afb5a39118eacfad7e81c8e14fda850bc4b8265
+  metadata.gz: 0d6540614504a2b8703ae3309cfb01293d442e22166db4d3164452e3e17a2c1202fae273acd5d386c46350c036164e66fe31631652c29aa44db3f02bdff3e709
+  data.tar.gz: ae3fdff0ece10e3de0819cce3321de2dcab9c12ec09f2725caa4ccaf69b26970aec0e0e44854f293e9c6a724ffa8bc25aabd4800e5888eba76f21c3717dc208f

data/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 ## [Unreleased]
 
+## [12.0.0] - 2025-03-25
+
+### Changed
+
+* [#690](https://github.com/deivid-rodriguez/byebug/pull/690): `break` without any arguments now sets a breakpoint on the current line, just like `gdb` ([@sergioro9].
+
+### Fixed
+
+* [#741](https://github.com/deivid-rodriguez/byebug/pull/741): Small consistency issues in help messages.
+* [#743](https://github.com/deivid-rodriguez/byebug/pull/743): `untracevar` command crashing when giving a non existent global variable.
+* [#744](https://github.com/deivid-rodriguez/byebug/pull/744): Another punctuation tweak in `enable breakpoints` help message.
+* [#736](https://github.com/deivid-rodriguez/byebug/pull/736): Skip warning about `$SAFE` global variable on ruby 2.7 when listing global variables.
+
+### Added
+
+* [#847](https://github.com/deivid-rodriguez/byebug/pull/847) and [#850](https://github.com/deivid-rodriguez/byebug/pull/850): Support for MRI 3.1, 3.2, and 3.3 ([@marshall-lee]).
+* [#688](https://github.com/deivid-rodriguez/byebug/pull/688): `where` command now receives an optional numeric argument `<n>` to print the nth first frames ([@sergioro9].
+
+### Removed
+
+* Support for MRI 2.4, 2.5, 2.6, 2.7, and 3.0. Byebug no longer installs on this platform.
+
 ## [11.1.3] - 2020-04-23
 
 ### Fixed
@@ -821,6 +843,7 @@
 * Initial release.
 
 [Unreleased]: https://github.com/deivid-rodriguez/byebug/compare/v11.1.3...HEAD
+[12.0.0]: https://github.com/deivid-rodriguez/byebug/compare/v11.1.3...v12.0.0
 [11.1.3]: https://github.com/deivid-rodriguez/byebug/compare/v11.1.2...v11.1.3
 [11.1.2]: https://github.com/deivid-rodriguez/byebug/compare/v11.1.1...v11.1.2
 [11.1.1]: https://github.com/deivid-rodriguez/byebug/compare/v11.1.0...v11.1.1
@@ -919,10 +942,12 @@
 [@k0kubun]: https://github.com/k0kubun
 [@ko1]: https://github.com/ko1
 [@luislavena]: https://github.com/luislavena
+[@marshall-lee]: https://github.com/marshall-lee
 [@mrkn]: https://github.com/mrkn
 [@nobu]: https://github.com/nobu
 [@Olgagr]: https://github.com/Olgagr
 [@sethk]: https://github.com/sethk
+[@sergioro9]: https://github.com/sergioro9
 [@shuky19]: https://github.com/shuky19
 [@tacnoman]: https://github.com/tacnoman
 [@terceiro]: https://github.com/terceiro

data/GUIDE.md

@@ -26,7 +26,7 @@ puts t
 
 Let's debug it.
 
-```bash
+```console
 $ byebug /path/to/triangle.rb
 
 [1, 10] in /path/to/triangle.rb
@@ -62,7 +62,7 @@ accordingly so that only actual real lines of code are displayed.
 
 Now let us step through the program.
 
-```bash
+```console
 (byebug) step
 
 [5, 14] in /path/to/triangle.rb
@@ -118,7 +118,7 @@ previously. However after issuing another `step` command we see that the value
 is 0 as expected. If every time we stop we want to see the value of `tri` to see
 how things are going, there is a better way by setting a display expression:
 
-```bash
+```console
 (byebug) display tri
 1: tri = 0
 ```
@@ -127,7 +127,7 @@ Now let us run the program until right before we return from the function. We'll
 want to see which lines get run, so we turn on _line tracing_. If we don't want
 whole paths to be displayed when tracing, we can turn on _basename_.
 
-```bash
+```console
 (byebug) set linetrace
 linetrace is on
 (byebug) set basename
@@ -207,7 +207,7 @@ Recall in the first section it was stated that before the `def` is run, the
 method it names is undefined. Let's check that out. First let's see what
 private methods we can call before running `def hanoi`.
 
-```bash
+```console
 $ byebug path/to/hanoi.rb
 
     1: #
@@ -317,7 +317,7 @@ is stopped.
 
 Now let's see what happens after stepping:
 
-```bash
+```console
 (byebug) step
 
 [5, 14] in /path/to/hanoi.rb
@@ -338,7 +338,7 @@ true
 
 Okay, lets go on and talk about program arguments.
 
-```bash
+```console
 (byebug) $ARGV
 []
 ```
@@ -346,7 +346,7 @@ Okay, lets go on and talk about program arguments.
 Oops. We forgot to specify any parameters to this program. Let's try again. We
 can use the `restart` command here.
 
-```bash
+```console
 (byebug) restart 3
 Re exec'ing:
   /path/to/exe/byebug /path/to/hanoi.rb 3
@@ -445,7 +445,7 @@ trace (see [callstyle]()).
 
 Now let's move around the callstack.
 
-```bash
+```console
 (byebug) undisplay
 Clear all expressions? (y/n) y
 (byebug) n_args
@@ -554,7 +554,7 @@ def test_basic
 
 Now we run the program, requiring `byebug`
 
-```bash
+```console
 $ ruby -rbyebug test_triangle.rb
 Run options: --seed 31679
 
@@ -579,7 +579,7 @@ list `solutions`.
 
 Now let's see where we are...
 
-```bash
+```console
 (byebug) set nofullpath
 Displaying frame's full file names is off.
 (byebug) bt
@@ -671,7 +671,7 @@ SievePrime.new.next_prime do |prime|
 end
 ```
 
-```bash
+```console
 $ byebug primes.rb
 [1, 10] in /path/to/primes.rb
     1: #
@@ -874,7 +874,7 @@ We instantiate a new company with an initial task and after running that
 company we expect the result to be printed in the screen, but it is not.  Lets
 debug our sample program:
 
-```bash
+```console
 [1, 10] in /path/to/company.rb
 =>  1: class Company
     2:   def initialize(task)
@@ -926,7 +926,7 @@ can then check that the threads are there using the `thread list` command. Now
 we want to debug both of this threads to check what's happening and look for the
 bug.
 
-```bash
+```console
 (byebug) th switch 3
 
 [5, 14] in /path/to/company.rb
@@ -961,7 +961,7 @@ and don't want the program to finish while we are debugging. Notice that stopped
 threads are marked with the "$" symbol whereas the current thread is marked with
 the "+" symbol.
 
-```bash
+```console
 (byebug) s
 
 [17, 26] in /path/to/company.rb
@@ -1061,7 +1061,7 @@ Everything seems fine in this thread. The first iteration the employee will do
 his job, and after that it will just check for new tasks and sleep. Let's debug
 the manager task now:
 
-```bash
+```console
 (byebug) th resume 2
   2 #<Thread:0x000000019892d8@/path/to/company.rb:12 run> /path/to/company.rb:12
 (byebug) th switch 2
@@ -1088,7 +1088,7 @@ run a sleeping thread.
 
 Now we can investigate the problem in the employer's side:
 
-```bash
+```console
 (byebug) s
 [30, 39] in /path/to/company.rb
    30:
@@ -1173,7 +1173,7 @@ If you don't need to pass dash options to your program, which might be confused
 with byebug options, then you don't need to add the `--`. To get a brief list of
 options and descriptions, use the `--help` option.
 
-```bash
+```console
 $ byebug --help
 
   byebug 3.5.1
@@ -1181,7 +1181,7 @@ $ byebug --help
   Usage: byebug [options] <script.rb> -- <script.rb parameters>
 
     -d, --debug               Set $DEBUG=true
-    -I, --include list        Add to paths to $LOAD_PATH
+    -I, --include list        Add paths to $LOAD_PATH
     -m, --[no-]post-mortem    Use post-mortem mode
     -q, --[no-]quit           Quit when script finishes
     -x, --[no-]rc             Run byebug initialization file
@@ -1241,7 +1241,7 @@ Turns on line tracing. Running `byebug --trace <rubyscript>.rb` is pretty much
 like running `ruby -rtracer <rubyscript>.rb`. If all you want to do however is
 get a line trace, `tracer` is most likely faster than `byebug`.
 
-```bash
+```console
 $ time byebug --trace --no-stop hanoi.rb > /dev/null
 
 real 0m0.743s
@@ -1354,9 +1354,9 @@ program that you want to debug (In Rails, the
 `config/environments/development.rb` could be a good candidate).
 
 ```ruby
-  require "byebug/core"
-  Byebug.wait_connection = true
-  Byebug.start_server("localhost", <port>)
+require "byebug/core"
+Byebug.wait_connection = true
+Byebug.start_server("localhost", <port>)
 ```
 
 Once this piece gets executed, you can connect to the remote debugger from your
@@ -1366,9 +1366,9 @@ Next, at a place of program execution which gets run just before the code you
 want to debug, add a call to `byebug` as was done without remote execution:
 
 ```ruby
-   # work, work, work...
-   byebug
-   some ruby code  # byebug will stop before this line is run
+# work, work, work...
+byebug
+some ruby code  # byebug will stop before this line is run
 ```
 
 ## Byebug Command Reference
@@ -1388,7 +1388,7 @@ with a backslash.
 For example, you might want to enter the following code to compute the 5th
 Fibonacci number.
 
-```bash
+```console
 (byebug) fib1=0; fib2=1; 5.times {|temp| temp=fib1; fib1=fib2; fib2 += temp }
 0
 1
@@ -1438,7 +1438,7 @@ Once inside `byebug` you can always ask it for information on its commands using
 the `help` command. You can use `help` (abbreviated `h`) with no arguments to
 display a short list of named classes of commands
 
-```bash
+```console
 (byebug) help
 
   break      -- Sets breakpoints in the source code
@@ -1483,7 +1483,7 @@ display a short list of named classes of commands
 
 With a command name, `help` displays information on how to use the command.
 
-```bash
+```console
 (byebug) help list
 
   l[ist][[-=]][ nn-mm]
@@ -1511,7 +1511,7 @@ as `help info breakpoints`.
 
 Some examples follow.
 
-```bash
+```console
 (byebug) help info
 info[ subcommand]
 
@@ -1530,14 +1530,14 @@ info line        -- Line number and filename of current position in source file
 info program     -- Execution status of the program
 ```
 
-```bash
+```console
 (byebug) help info breakpoints
 Status of user-settable breakpoints.
 Without argument, list info about all breakpoints.
 With an integer argument, list info on that breakpoint.
 ```
 
-```bash
+```console
 (byebug) help info b
 Status of user-settable breakpoints.
 Without argument, list info about all breakpoints.
@@ -1582,7 +1582,7 @@ printed if line tracing is enabled. Each expression added to the list is given a
 number to identify it; to remove an expression from the list, you specify that
 number. The automatic display looks like this:
 
-```bash
+```console
 (byebug) display n
 1: n = 3
 ```
@@ -1591,7 +1591,7 @@ This display shows item numbers, expressions and their current values. If the
 expression is undefined or illegal the expression will be printed but no value
 will appear.
 
-```bash
+```console
 (byebug) display undefined_variable
 2: undefined_variable =
 (byebug) display 1/0
@@ -1631,7 +1631,7 @@ program. If you issue a `list` without location information, the default
 location used is the current line rather than the current position that may have
 got updated via a prior `list` command.
 
-```
+```console
 $ byebug triangle.rb
 [1, 10] in /path/to/triangle.rb
     1: # Compute the n'th triangle number, the hard way: triangle(n) == (n*(n+1))/2
@@ -1712,7 +1712,7 @@ You can customize `byebug` to use any editor you want by using the `EDITOR`
 environment variable. The only restriction is that your editor (say `ex`) recognizes
 the following command-line syntax:
 
-```
+```bash
 ex +nnn file
 ```
 
@@ -1784,7 +1784,7 @@ One such method is `each`. They are marked differently in the call stack to
 indicate that we cannot switch to those frames. This is because they have no
 source code in Ruby, so we can not debug them using Byebug.
 
-```bash
+```console
 (byebug) where
 --> #0 Object.gcd(a#Fixnum, b#Fixnum) at line gcd.rb:6
     #1 at line gcd.rb:19

data/README.md

@@ -41,9 +41,7 @@ more][Tidelift for enterprise].
 
 ## Requirements
 
-* _Required_: MRI 2.4.0 or higher.
-* _Recommended_: MRI 2.6.4 or higher (MRI 2.6.0 to 2.6.3 contain a regression
-  causing unbalanced call/return events in some cases, breaking the `next` command).
+* _Required_: MRI 3.1.0 or higher.
 
 ## Install
 

data/ext/byebug/breakpoint.c

@@ -128,6 +128,13 @@ brkpt_set_hit_condition(VALUE self, VALUE value)
   ID id_value;
 
   Data_Get_Struct(self, breakpoint_t, breakpoint);
+
+  if (NIL_P(value))
+  {
+    breakpoint->hit_condition = HIT_COND_NONE;
+    return value;
+  }
+
   id_value = rb_to_id(value);
 
   if (rb_intern("greater_or_equal") == id_value || rb_intern("ge") == id_value)
@@ -363,20 +370,17 @@ check_breakpoint_by_hit_condition(VALUE rb_breakpoint)
   {
     case HIT_COND_NONE:
       return 1;
-    case HIT_COND_GE:
-    {
+    case HIT_COND_GE: {
       if (breakpoint->hit_count >= breakpoint->hit_value)
         return 1;
       break;
     }
-    case HIT_COND_EQ:
-    {
+    case HIT_COND_EQ: {
       if (breakpoint->hit_count == breakpoint->hit_value)
         return 1;
       break;
     }
-    case HIT_COND_MOD:
-    {
+    case HIT_COND_MOD: {
       if (breakpoint->hit_count % breakpoint->hit_value == 0)
         return 1;
       break;

data/ext/byebug/byebug.c

@@ -136,26 +136,32 @@ cleanup(debug_context_t *dc)
 
 #define EVENT_TEARDOWN cleanup(dc);
 
-#define EVENT_SETUP                                     \
-  debug_context_t *dc;                                  \
-  VALUE context;                                        \
-  rb_trace_arg_t *trace_arg;                            \
-                                                        \
-  UNUSED(data);                                         \
-                                                        \
-  if (!is_living_thread(rb_thread_current()))           \
-    return;                                             \
-                                                        \
-  thread_context_lookup(rb_thread_current(), &context); \
-  Data_Get_Struct(context, debug_context_t, dc);        \
-                                                        \
-  trace_arg = rb_tracearg_from_tracepoint(trace_point); \
-  if (verbose == Qtrue)                                 \
-    trace_print(trace_arg, dc, 0, 0);                   \
-                                                        \
-  if (CTX_FL_TEST(dc, CTX_FL_IGNORE))                   \
-    return;                                             \
-                                                        \
+#define EVENT_SETUP                                              \
+  debug_context_t *dc;                                           \
+  VALUE context;                                                 \
+  rb_trace_arg_t *trace_arg;                                     \
+                                                                 \
+  UNUSED(data);                                                  \
+                                                                 \
+  if (!is_living_thread(rb_thread_current()))                    \
+    return;                                                      \
+                                                                 \
+  thread_context_lookup(rb_thread_current(), &context);          \
+  Data_Get_Struct(context, debug_context_t, dc);                 \
+                                                                 \
+  trace_arg = rb_tracearg_from_tracepoint(trace_point);          \
+  if (verbose == Qtrue)                                          \
+    trace_print(trace_arg, dc, 0, 0);                            \
+                                                                 \
+  if (CTX_FL_TEST(dc, CTX_FL_IGNORE))                            \
+    return;                                                      \
+                                                                 \
+  VALUE rb_path = rb_tracearg_path(trace_arg);                   \
+  const char *path = NIL_P(rb_path) ? "" : RSTRING_PTR(rb_path); \
+                                                                 \
+  if (!strncmp(path, "<internal:", strlen("<internal:")))        \
+    return;                                                      \
+                                                                 \
   acquire_lock(dc);
 
 
@@ -854,7 +860,7 @@ Add_catchpoint(VALUE self, VALUE value)
 }
 
 /*
- *   Document-class: Byebug
+ *   Document-module: Byebug
  *
  *   == Summary
  *

data/ext/byebug/context.c

@@ -658,6 +658,7 @@ void
 Init_byebug_context(VALUE mByebug)
 {
   cContext = rb_define_class_under(mByebug, "Context", rb_cObject);
+  rb_undef_alloc_func(cContext);
 
   rb_define_method(cContext, "backtrace", Context_backtrace, 0);
   rb_define_method(cContext, "dead?", Context_dead, 0);

data/ext/byebug/threads.c

@@ -180,8 +180,16 @@ release_lock(void)
 static VALUE
 Unlock(VALUE self)
 {
+  debug_context_t *dc;
+  VALUE context;
+
   UNUSED(self);
 
+  thread_context_lookup(rb_thread_current(), &context);
+  Data_Get_Struct(context, debug_context_t, dc);
+
+  CTX_FL_SET(dc, CTX_FL_IGNORE);
+
   release_lock();
 
   return locker;
@@ -209,6 +217,8 @@ Lock(VALUE self)
 
   acquire_lock(dc);
 
+  CTX_FL_UNSET(dc, CTX_FL_IGNORE);
+
   return locker;
 }
 
@@ -224,6 +234,7 @@ void
 Init_threads_table(VALUE mByebug)
 {
   cThreadsTable = rb_define_class_under(mByebug, "ThreadsTable", rb_cObject);
+  rb_undef_alloc_func(cThreadsTable);
 
   rb_define_module_function(mByebug, "unlock", Unlock, 0);
   rb_define_module_function(mByebug, "lock", Lock, 0);

data/lib/byebug/breakpoint.rb

@@ -53,11 +53,7 @@ module Byebug
       name = "#{Time.new.to_i}_#{rand(2**31)}"
       iseq = RubyVM::InstructionSequence.compile(File.read(filename), name)
 
-      if iseq.respond_to?(:each_child)
-        potential_lines_with_trace_points(iseq, {})
-      else
-        potential_lines_without_trace_points(iseq, {})
-      end
+      potential_lines_with_trace_points(iseq, {})
     end
 
     def self.potential_lines_with_trace_points(iseq, lines)
@@ -71,19 +67,6 @@ module Byebug
 
     private_class_method :potential_lines_with_trace_points
 
-    def self.potential_lines_without_trace_points(iseq, lines)
-      iseq.disasm.each_line do |line|
-        res = /^\d+ (?<insn>\w+)\s+.+\(\s*(?<lineno>\d+)\)$/.match(line)
-        next unless res && res[:insn] == "trace"
-
-        lines[res[:lineno].to_i] = true
-      end
-
-      lines.keys
-    end
-
-    private_class_method :potential_lines_without_trace_points
-
     #
     # Returns true if a breakpoint could be set in line number +lineno+ in file
     # name +filename.

data/lib/byebug/commands/break.rb

@@ -23,13 +23,15 @@ module Byebug
 
     def self.description
       <<-DESCRIPTION
-        b[reak] [<file>:]<line> [if <expr>]
+        b[reak] [[<file>:]<line> [if <expr>]]
         b[reak] [<module>::...]<class>(.|#)<method> [if <expr>]
 
+        #{short_description}
+
         They can be specified by line or method and an expression can be added
         for conditionally enabled breakpoints.
-
-        #{short_description}
+        for conditionally enabled breakpoints. Without arguments create a
+        a breakpoint in the current line.
       DESCRIPTION
     end
 
@@ -38,9 +40,9 @@ module Byebug
     end
 
     def execute
-      return puts(help) unless @match[1]
+      b = line_breakpoint(frame.line.to_s) unless @match[1]
 
-      b = line_breakpoint(@match[1]) || method_breakpoint(@match[1])
+      b ||= line_breakpoint(@match[1]) || method_breakpoint(@match[1])
       return errmsg(pr("break.errors.location")) unless b
 
       return puts(pr("break.created", id: b.id, file: b.source, line: b.pos)) if syntax_valid?(@match[2])

data/lib/byebug/commands/enable/breakpoints.rb

@@ -31,7 +31,7 @@ module Byebug
       end
 
       def self.short_description
-        "Enable all or specific breakpoints"
+        "Enable all or specific breakpoints."
       end
 
       def execute

data/lib/byebug/commands/finish.rb

@@ -42,7 +42,7 @@ module Byebug
         n_frames = 1
       end
 
-      force = n_frames.zero? ? true : false
+      force = n_frames.zero? || false
       context.step_out(context.frame.pos + n_frames, force)
       context.frame = 0
       processor.proceed!

data/lib/byebug/commands/help.rb

@@ -42,7 +42,7 @@ module Byebug
     private
 
     def help_for_all
-      puts(processor.command_list.to_s)
+      puts(processor.command_list.to_s) # rubocop:disable Lint/RedundantStringCoercion
     end
 
     def help_for(input, cmd)

data/lib/byebug/commands/info.rb

@@ -31,7 +31,7 @@ module Byebug
     end
 
     def self.short_description
-      "Shows several informations about the program being debugged"
+      "Shows short description and information about the program being debugged"
     end
   end
 end

data/lib/byebug/commands/set.rb

@@ -58,7 +58,7 @@ module Byebug
 
       setting.value = value
 
-      puts setting.to_s
+      puts setting
     end
 
     private

data/lib/byebug/commands/step.rb

@@ -7,7 +7,7 @@ module Byebug
   #
   # Implements the step functionality.
   #
-  # Allows the user the continue execution until the next instruction, possibily
+  # Allows the user the continue execution until the next instruction, possibly
   # in a different frame. Use step to step into method calls or blocks.
   #
   class StepCommand < Command

data/lib/byebug/commands/thread/current.rb

@@ -26,7 +26,7 @@ module Byebug
       end
 
       def self.short_description
-        "Shows current thread information"
+        "Shows current thread information."
       end
 
       def execute

data/lib/byebug/commands/thread/list.rb

@@ -26,7 +26,7 @@ module Byebug
       end
 
       def self.short_description
-        "Lists all threads"
+        "Lists all threads."
       end
 
       def execute

data/lib/byebug/commands/thread/resume.rb

@@ -26,7 +26,7 @@ module Byebug
       end
 
       def self.short_description
-        "Resumes execution of the specified thread"
+        "Resumes execution of the specified thread."
       end
 
       def execute

data/lib/byebug/commands/thread/stop.rb

@@ -26,7 +26,7 @@ module Byebug
       end
 
       def self.short_description
-        "Stops the execution of the specified thread"
+        "Stops the execution of the specified thread."
       end
 
       def execute

data/lib/byebug/commands/tracevar.rb

@@ -4,7 +4,7 @@ require_relative "../command"
 
 module Byebug
   #
-  # Show (and possibily stop) at every line that changes a global variable.
+  # Show (and possibly stop) at every line that changes a global variable.
   #
   class TracevarCommand < Command
     def self.regexp

data/lib/byebug/commands/untracevar.rb

@@ -20,7 +20,7 @@ module Byebug
     end
 
     def self.short_description
-      "Stops tracing a global variable"
+      "Stops tracing a global variable."
     end
 
     def execute
@@ -29,7 +29,7 @@ module Byebug
         untrace_var(:"#{var}")
         puts pr("trace.messages.undo", var: var)
       else
-        errmsg pr("trace.errors.not_global", var: var)
+        errmsg pr("trace.errors.var_is_not_global", name: var)
       end
     end
   end

data/lib/byebug/commands/var/args.rb

@@ -28,7 +28,7 @@ module Byebug
       end
 
       def self.short_description
-        "Information about arguments of the current scope"
+        "Information about arguments of the current scope."
       end
 
       def execute

data/lib/byebug/commands/where.rb

@@ -14,12 +14,12 @@ module Byebug
     self.allow_in_post_mortem = true
 
     def self.regexp
-      /^\s* (?:w(?:here)?|bt|backtrace) \s*$/x
+      /^\s* (?:w(?:here)?|bt|backtrace) (?:\s+(\S+))? \s*$/x
     end
 
     def self.description
       <<-DESCRIPTION
-        w[here]|bt|backtrace
+        w[here]|bt|backtrace[ maximum-frame]
 
         #{short_description}
 
@@ -29,6 +29,10 @@ module Byebug
         The position of the current frame is marked with -->. C-frames hang
         from their most immediate Ruby frame to indicate that they are not
         navigable.
+
+        Without an argument, the command prints all the frames. With an argument,
+        the command prints the nth first frames, where n is the largest between
+        the argument or the maximum stack frame.
       DESCRIPTION
     end
 
@@ -43,7 +47,14 @@ module Byebug
     private
 
     def print_backtrace
-      bt = prc("frame.line", (0...context.stack_size)) do |_, index|
+      max_frame =
+        if @match[1] && @match[1].to_i <= context.stack_size
+          @match[1].to_i
+        else
+          context.stack_size
+        end
+
+      bt = prc("frame.line", (0...max_frame)) do |_, index|
         Frame.new(context, index).to_hash
       end
 

data/lib/byebug/helpers/eval.rb

@@ -33,7 +33,7 @@ module Byebug
 
       #
       # Evaluates a string containing Ruby code in a specific binding,
-      # returning nil in an error happens.
+      # returning nil if an error happens.
       #
       def silent_eval(str, binding = frame._binding)
         safe_eval(str, binding) { |_e| nil }
@@ -88,14 +88,12 @@ module Byebug
       # creating new threads won't be properly evaluated because new threads
       # will get blocked by byebug's main thread.
       #
-      def allowing_other_threads
+      def allowing_other_threads(&block)
         Byebug.unlock
 
-        res = yield
-
+        TracePoint.allow_reentry(&block)
+      ensure
         Byebug.lock
-
-        res
       end
 
       #

data/lib/byebug/helpers/file.rb

@@ -56,7 +56,11 @@ module Byebug
       # True for special files like -e, false otherwise
       #
       def virtual_file?(name)
-        ["(irb)", "-e", "(byebug)", "(eval)"].include?(name)
+        if Gem.ruby_version >= Gem::Version.new("3.3.a")
+          ["(irb)", "-e", "(byebug)"].include?(name) || name.start_with?("(eval ")
+        else
+          ["(irb)", "-e", "(byebug)", "(eval)"].include?(name)
+        end
       end
     end
   end

data/lib/byebug/helpers/parse.rb

@@ -35,13 +35,18 @@ module Byebug
       def syntax_valid?(code)
         return true unless code
 
-        without_stderr do
-          begin
+        if defined?(RubyVM::InstructionSequence.compile)
+          without_stderr do
             RubyVM::InstructionSequence.compile(code)
             true
           rescue SyntaxError
             false
           end
+        else
+          require "ripper" unless defined?(Ripper)
+          without_stderr do
+            !Ripper.sexp(code).nil?
+          end
         end
       end
 

data/lib/byebug/helpers/reflection.rb

@@ -3,7 +3,7 @@
 module Byebug
   module Helpers
     #
-    # Reflection utilitie
+    # Reflection utility
     #
     module ReflectionHelper
       #

data/lib/byebug/helpers/var.rb

@@ -12,7 +12,23 @@ module Byebug
 
       def var_list(ary, binding = context.frame._binding)
         vars = ary.sort.map do |name|
-          [name, safe_inspect(silent_eval(name.to_s, binding))]
+          code = name.to_s
+
+          if code == "$SAFE"
+            code = <<~RUBY
+              original_stderr = $stderr
+
+              begin
+                $stderr = StringIO.new
+
+                #{code}
+              ensure
+                $stderr = original_stderr
+              end
+            RUBY
+          end
+
+          [name, safe_inspect(silent_eval(code, binding))]
         end
 
         puts prv(vars, "instance")

data/lib/byebug/history.rb

@@ -17,10 +17,10 @@ module Byebug
   # Handles byebug's history of commands.
   #
   class History
-    attr_accessor :size
+    attr_reader :size
 
     def initialize
-      self.size = 0
+      @size = 0
     end
 
     #
@@ -65,7 +65,7 @@ module Byebug
     def push(cmd)
       return if ignore?(cmd)
 
-      self.size += 1
+      @size += 1
       Readline::HISTORY.push(cmd)
     end
 
@@ -73,7 +73,7 @@ module Byebug
     # Removes a command from Readline's history.
     #
     def pop
-      self.size -= 1
+      @size -= 1
       Readline::HISTORY.pop
     end
 
@@ -103,7 +103,7 @@ module Byebug
     # Never more than Setting[:histsize].
     #
     def default_max_size
-      [Setting[:histsize], self.size].min
+      [Setting[:histsize], size].min
     end
 
     #
@@ -112,7 +112,7 @@ module Byebug
     # The only bound here is not showing more items than available.
     #
     def specific_max_size(number)
-      [self.size, number].min
+      [size, number].min
     end
 
     #

data/lib/byebug/interface.rb

@@ -129,7 +129,7 @@ module Byebug
       return [""] if cmd_line.empty?
 
       cmd_line.split(/;/).each_with_object([]) do |v, m|
-        if m.empty? || m.last[-1] != '\\'
+        if m.empty? || m.last[-1] != "\\"
           m << v.strip
           next
         end

data/lib/byebug/option_setter.rb

@@ -33,7 +33,7 @@ module Byebug
     end
 
     def include_flag
-      @opts.on "-I", "--include list", "Add to paths to $LOAD_PATH" do |list|
+      @opts.on "-I", "--include list", "Add paths to $LOAD_PATH" do |list|
         $LOAD_PATH.push(list.split(":")).flatten!
       end
     end

data/lib/byebug/settings/savefile.rb

@@ -4,7 +4,7 @@ require_relative "../setting"
 
 module Byebug
   #
-  # Setting to customize the file where byebug's history is saved.
+  # Setting to customize the file where byebug's settings are saved.
   #
   class SavefileSetting < Setting
     DEFAULT = File.expand_path("#{ENV['HOME'] || '.'}/.byebug_save")
@@ -14,7 +14,7 @@ module Byebug
     end
 
     def to_s
-      "The command history file is #{value}\n"
+      "The settings file is #{value}\n"
     end
   end
 end

data/lib/byebug/version.rb

@@ -4,5 +4,5 @@
 # Reopen main module to define the library version
 #
 module Byebug
-  VERSION = "11.1.3"
+  VERSION = "12.0.0"
 end

metadata

@@ -1,16 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: byebug
 version: !ruby/object:Gem::Version
-  version: 11.1.3
+  version: 12.0.0
 platform: ruby
 authors:
 - David Rodriguez
 - Kent Sibilev
 - Mark Moseley
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-04-23 00:00:00.000000000 Z
+date: 2025-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -177,7 +177,7 @@ homepage: https://github.com/deivid-rodriguez/byebug
 licenses:
 - BSD-2-Clause
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -185,15 +185,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.0.pre1
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Ruby fast debugger - base + CLI
 test_files: []