debug 1.3.4 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58d7a886dc29b717d9f31ca7859a40a881a251a4c5e64705ac38de1cb94c0f32
-  data.tar.gz: a58994d8d302dac0aedd63775b8d81769d326a6bb0746d9953182fa8b36894fd
+  metadata.gz: a62295065b9bb4f9d498a21b32ea122ab680fd1e1b9794368ac2385858abf844
+  data.tar.gz: 0dc6f9aeb1ff23a47e0c399ee32ac80953821520cc52b0c4e27e30d7600a67bd
 SHA512:
-  metadata.gz: 3988bc3fd10cab3592a9f6b3b816dd2f5cabf5e8e4bceaec646011a1663b037a7f9683008c77d1c91a0a8f984540c16ef5975fa14b93f84b6cca5915e98df440
-  data.tar.gz: 4283c41adf172ae2d1e51bb34adfb65ab2b521862bae6be7bd08ba485bea178e0e2ec511db7b9f0297e2aea4e4d2ac249887bb9271f51d71d6beb76a0aee63d0
+  metadata.gz: 144d16fc2b8e377d7d25df0b09f088492647b76de2ffc1a841e09967caed2678f28fbaf24747fc351fd7e7d7c0d107cd39245ca0c8eff41547bce4f2ab35a8c3
+  data.tar.gz: 4e62e36b0fe72a2c1ce8e1dd44e6bae646e06b0d4d8d07072db595f908d00595252e35525a9ba1fde09a53f9a57781165c73e63d8eaa8a59a5e93219bd4c9ed5

data/.github/pull_request_template.md

@@ -0,0 +1,9 @@
+Thanks for your Pull Request 🎉 
+
+**Please follow these instructions to help us review it more efficiently:**
+
+- Add references of related issues/PRs in the description if available.
+- If you're updating the readme file, make sure you followed [the instruction here](https://github.com/ruby/debug/blob/master/CONTRIBUTING.md#to-update-readme).
+
+## Description
+Describe your changes:

data/CONTRIBUTING.md

@@ -26,11 +26,17 @@ $ ruby test/debug/bp_test.rb -h # to see all the test options
 ```
 
 ## Generate Tests
+
 There is a test generator in `debug.rb` project to make it easier to write tests.
+
 ### Quickstart
-This section shows you how to create test file by test generator. For more advanced informations on creating tests, please take a look at [gentest options](#gentest-options). (You can also check by `$bin/gentest -h`)
+
+This section shows you how to create test file by test generator. For more advanced information on creating tests, please take a look at [gentest options](#gentest-options). (You can also check by `$bin/gentest -h`)
+
 #### 1. Create a target file for debuggee.
+
 Let's say, we created `target.rb` which is located in top level directory of debugger.
+
 ```ruby
 module Foo
   class Bar
@@ -42,11 +48,15 @@ module Foo
   bar = Bar.new
 end
 ```
+
 #### 2. Run `gentest` as shown in the example below.
+
 ```shell
 $ bin/gentest target.rb
 ```
+
 #### 3. Debugger will be executed. You can type any debug commands.
+
 ```shell
 $ bin/gentest target.rb
 DEBUGGER: Session start (pid: 11139)
@@ -119,8 +129,11 @@ created: /Users/naotto/workspace/debug/test/tool/../debug/foo_test.rb
     class: FooTest
     method: test_1629720194
 ```
+
 #### 4. The test file will be created as `test/debug/foo_test.rb`.
+
 If the file already exists, **only method** will be added to it.
+
 ```ruby
 # frozen_string_literal: true
 
@@ -204,17 +217,37 @@ end
 ```
 
 #### gentest options
+
 You can get more information about `gentest` here.
 
-The default method name is `test_#{some integer numbers}`, the class name is `FooTest`, and the file name will be `foo_test.rb`.
+The default method name is `test_#{some integer numbers}`, the class name is `FooTest#{some integer numbers}`, and the file name will be `foo_test.rb`.
 The following table shows examples of the gentest options.
 
 | Command | Description | File | Class | Method |
 | --- | --- | --- | --- | --- |
-| `$ bin/gentest target.rb` | Run without any options | `foo_test.rb` | `FooTest` | `test_#{some integer numbers}` |
-| `$ bin/gentest target.rb -c step` | Specify the class name | `step_test.rb` | `StepTest` | `test_#{some integer numbers}` |
-| `$ bin/gentest target.rb -m test_step` | Specify the method name | `foo_test.rb` | `FooTest` | `test_step` |
-| `$ bin/gentest target.rb -c step -m test_step` | Specify the class name and the method name | `step_test.rb` | `StepTest` | `test_step` |
+| `$ bin/gentest target.rb` | Run without any options | `foo_test.rb` | `FooTest...` | `test_...` |
+| `$ bin/gentest target.rb --open=vscode` | Run the debugger with VScode | `foo_test.rb` | `FooTest...` | `test_...` |
+| `$ bin/gentest target.rb -c step` | Specify the class name | `step_test.rb` | `StepTest...` | `test_...` |
+| `$ bin/gentest target.rb -m test_step` | Specify the method name | `foo_test.rb` | `FooTest...` | `test_step` |
+| `$ bin/gentest target.rb -c step -m test_step` | Specify the class name and the method name | `step_test.rb` | `StepTest...` | `test_step` |
+
+### Assertions
+
+- assert_line_num(expected)
+
+Passes if `expected` is equal to the location where debugger stops.
+
+- assert_line_text(text)
+
+Passes if `text` is included in the last debugger log.
+
+- assert_no_line_text(text)
+
+Passes if `text` is not included in the last debugger log.
+
+- assert_debuggee_line_text(text)
+
+Passes if `text` is included in the debuggee log.
 
 ## To Update README
 

data/README.md

@@ -60,8 +60,14 @@ There are several options for (1) and (2). Please choose your favorite way.
 
 ### Modify source code with [`binding.break`](#bindingbreak-method) (similar to `binding.pry` or `binding.irb`)
 
-If you can modify the source code, you can use the debugger by adding `require 'debug'` line at the top of your program and putting [`binding.break`](#bindingbreak-method) method (`binding.b` for short) into lines where you want to stop as breakpoints like `binding.pry` and `binding.irb`.
-After that, you run the program as usual and you will enter the debug console at breakpoints you inserted.
+If you can modify the source code, you can use the debugger by adding `require 'debug'` at the top of your program and putting [`binding.break`](#bindingbreak-method) method into lines where you want to stop as breakpoints like `binding.pry` and `binding.irb`.
+
+You can also use its 2 aliases in the same way:
+
+- `binding.b`
+- `debugger`
+
+After that, run the program as usual and you will enter the debug console at breakpoints you inserted.
 
 The following example shows the demonstration of [`binding.break`](#bindingbreak-method).
 
@@ -346,7 +352,7 @@ You can attach with external debugger frontend with VSCode and Chrome.
 $ rdbg --open=[frontend] target.rb
 ```
 
-will open a debug port and `[frontned]` can attache to the port.
+will open a debug port and `[frontend]` can attach to the port.
 
 Also `open` command allows opening the debug port.
 
@@ -427,7 +433,9 @@ Type `devtools://devtools/bundled/inspector.html?ws=127.0.0.1:43633` in the addr
 
 Also `open chrome` command works like `open vscode`.
 
-For more information about how to use Chrome debugging, you might want to read [here](https://developer.chrome.com/docs/devtools/)
+For more information about how to use Chrome debugging, you might want to read [here](https://developer.chrome.com/docs/devtools/).
+
+Note: If you want to maximize Chrome DevTools, click [Toggle Device Toolbar](https://developer.chrome.com/docs/devtools/device-mode/#viewport).
 
 ## Configuration
 
@@ -479,6 +487,7 @@ config set no_color true
   * `RUBY_DEBUG_SOCK_DIR` (`sock_dir`): UNIX Domain Socket remote debugging: socket directory
   * `RUBY_DEBUG_COOKIE` (`cookie`): Cookie for negotiation
   * `RUBY_DEBUG_OPEN_FRONTEND` (`open_frontend`): frontend used by open command (vscode, chrome, default: rdbg).
+  * `RUBY_DEBUG_CHROME_PATH` (`chrome_path`): Platform dependent path of Chrome (For more information, See [here](https://github.com/ruby/debug/pull/334/files#diff-5fc3d0a901379a95bc111b86cf0090b03f857edfd0b99a0c1537e26735698453R55-R64))
 
 * OBSOLETE
   * `RUBY_DEBUG_PARENT_ON_FORK` (`parent_on_fork`): Keep debugging parent process on fork (default: false)
@@ -525,7 +534,7 @@ The `<...>` notation means the argument.
 * `fin[ish]`
   * Finish this frame. Resume the program until the current frame is finished.
 * `fin[ish] <n>`
-  * Finish frames, same as `step <n>`.
+  * Finish `<n>`th frames.
 * `c[ontinue]`
   * Resume the program.
 * `q[uit]` or `Ctrl-D`
@@ -533,11 +542,11 @@ The `<...>` notation means the argument.
 * `q[uit]!`
   * Same as q[uit] but without the confirmation prompt.
 * `kill`
-  * Stop the debuggee process with `Kernal#exit!`.
+  * Stop the debuggee process with `Kernel#exit!`.
 * `kill!`
   * Same as kill but without the confirmation prompt.
 * `sigint`
-  * Execute SIGINT handler registerred by the debuggee.
+  * Execute SIGINT handler registered by the debuggee.
   * Note that this command should be used just after stop by `SIGINT`.
 
 ### Breakpoint
@@ -558,14 +567,32 @@ The `<...>` notation means the argument.
   * break and run `<command>` before stopping.
 * `b[reak] ... do: <command>`
   * break and run `<command>`, and continue.
+* `b[reak] ... path: <path_regexp>`
+  * break if the triggering event's path matches <path_regexp>.
 * `b[reak] if: <expr>`
   * break if: `<expr>` is true at any lines.
   * Note that this feature is super slow.
 * `catch <Error>`
   * Set breakpoint on raising `<Error>`.
+* `catch ... if: <expr>`
+  * stops only if `<expr>` is true as well.
+* `catch ... pre: <command>`
+  * runs `<command>` before stopping.
+* `catch ... do: <command>`
+  * stops and run `<command>`, and continue.
+* `catch ... path: <path_regexp>`
+  * stops if the exception is raised from a path that matches <path_regexp>.
 * `watch @ivar`
   * Stop the execution when the result of current scope's `@ivar` is changed.
   * Note that this feature is super slow.
+* `watch ... if: <expr>`
+  * stops only if `<expr>` is true as well.
+* `watch ... pre: <command>`
+  * runs `<command>` before stopping.
+* `watch ... do: <command>`
+  * stops and run `<command>`, and continue.
+* `watch ... path: <path_regexp>`
+  * stops if the triggering event's path matches <path_regexp>.
 * `del[ete]`
   * delete all breakpoints.
 * `del[ete] <bpnum>`

data/bin/gentest

@@ -4,19 +4,27 @@ require 'optparse'
 
 require_relative '../test/tool/test_builder'
 
-file_info = {}
+options = {}
 
 OptionParser.new do |opt|
   opt.banner = 'Usage: bin/gentest [file] [option]'
   opt.on('-m METHOD', 'Method name in the test file') do |m|
-    file_info[:method] = m
+    options[:method] = m
   end
   opt.on('-c CLASS', 'Class name in the test file') do |c|
-    file_info[:class] = c
+    options[:class] = c
+  end
+  opt.on('--open=FRONTEND', 'Start remote debugging with opening the network port.',
+                            'Currently, only vscode is supported.') do |f|
+    options[:open] = f.downcase
   end
   opt.parse!(ARGV)
 end
 
 exit if ARGV.empty?
 
-DEBUGGER__::TestBuilder.new(ARGV, file_info[:method], file_info[:class]).start
+if options[:open] == 'vscode'
+  DEBUGGER__::DAPTestBuilder.new(ARGV, options[:method], options[:class]).start
+else
+  DEBUGGER__::LocalTestBuilder.new(ARGV, options[:method], options[:class]).start
+end

data/ext/debug/debug.c

@@ -32,7 +32,10 @@ di_entry(VALUE loc, VALUE self, VALUE binding, VALUE iseq, VALUE klass, VALUE de
                          // :show_line, :local_variables
                          Qnil,
                          // :_local_variables, :_callee # for recorder
-                         Qnil, Qnil);
+                         Qnil, Qnil,
+                         // :dupped_binding
+                         Qnil
+                         );
 }
 
 static int

data/lib/debug/breakpoint.rb

@@ -4,6 +4,8 @@ require_relative 'color'
 
 module DEBUGGER__
   class Breakpoint
+    include SkipPathHelper
+
     attr_reader :key
 
     def initialize do_enable = true
@@ -23,6 +25,10 @@ module DEBUGGER__
       nil
     end
 
+    def oneshot?
+      defined?(@oneshot) && @oneshot
+    end
+
     def setup
       raise "not implemented..."
     end
@@ -75,6 +81,14 @@ module DEBUGGER__
       false
     end
 
+    def skip_path?(path)
+      if @path
+        !path.match?(@path)
+      else
+        super
+      end
+    end
+
     include Color
 
     def generate_label(name)
@@ -87,6 +101,28 @@ module DEBUGGER__
     TracePoint.new(:line){}.enable{}
   end
 
+  class ISeqBreakpoint < Breakpoint
+    def initialize iseq, events, oneshot: false
+      @events = events
+      @iseq = iseq
+      @oneshot = oneshot
+      @key = [:iseq, @iseq.path, @iseq.first_lineno].freeze
+
+      super()
+    end
+
+    def setup
+      @tp = TracePoint.new(*@events) do |tp|
+        delete if @oneshot
+        suspend
+      end
+    end
+
+    def enable
+      @tp.enable(target: @iseq)
+    end
+  end
+
   class LineBreakpoint < Breakpoint
     attr_reader :path, :line, :iseq
 
@@ -235,24 +271,25 @@ module DEBUGGER__
 
   class CatchBreakpoint < Breakpoint
     attr_reader :last_exc
-    include SkipPathHelper
 
-    def initialize pat, cond: nil, command: nil
+    def initialize pat, cond: nil, command: nil, path: nil
       @pat = pat.freeze
       @key = [:catch, @pat].freeze
       @last_exc = nil
 
       @cond = cond
       @command = command
+      @path = path
 
       super()
     end
 
     def setup
       @tp = TracePoint.new(:raise){|tp|
-        next if skip_path?(tp.path)
         exc = tp.raised_exception
         next if SystemExit === exc
+        next if skip_path?(tp.path)
+
         next if !safe_eval(tp.binding, @cond) if @cond
         should_suspend = false
 
@@ -277,9 +314,10 @@ module DEBUGGER__
   end
 
   class CheckBreakpoint < Breakpoint
-    def initialize expr
+    def initialize expr, path
       @expr = expr.freeze
       @key = [:check, @expr].freeze
+      @path = path
 
       super()
     end
@@ -289,6 +327,7 @@ module DEBUGGER__
         next if tp.path.start_with? __dir__
         next if tp.path.start_with? '<internal:'
         next if ThreadClient.current.management?
+        next if skip_path?(tp.path)
 
         if safe_eval tp.binding, @expr
           suspend
@@ -302,22 +341,29 @@ module DEBUGGER__
   end
 
   class WatchIVarBreakpoint < Breakpoint
-    def initialize ivar, object, current
+    def initialize ivar, object, current, cond: nil, command: nil, path: nil
       @ivar = ivar.to_sym
       @object = object
-      @key = [:watch, @ivar].freeze
+      @key = [:watch, object.object_id, @ivar].freeze
 
       @current = current
+
+      @cond = cond
+      @command = command
+      @path = path
       super()
     end
 
-    def watch_eval
+    def watch_eval(tp)
       result = @object.instance_variable_get(@ivar)
       if result != @current
         begin
           @prev = @current
           @current = result
-          suspend
+
+          if (@cond.nil? || @object.instance_eval(@cond)) && !skip_path?(tp.path)
+            suspend
+          end
         ensure
           remove_instance_variable(:@prev)
         end
@@ -331,7 +377,7 @@ module DEBUGGER__
         next if tp.path.start_with? __dir__
         next if tp.path.start_with? '<internal:'
 
-        watch_eval
+        watch_eval(tp)
       }
     end
 
@@ -349,7 +395,7 @@ module DEBUGGER__
   class MethodBreakpoint < Breakpoint
     attr_reader :sig_method_name, :method
 
-    def initialize b, klass_name, op, method_name, cond: nil, command: nil
+    def initialize b, klass_name, op, method_name, cond: nil, command: nil, path: nil
       @sig_klass_name = klass_name
       @sig_op = op
       @sig_method_name = method_name
@@ -361,6 +407,7 @@ module DEBUGGER__
       @cond = cond
       @cond_class = nil
       @command = command
+      @path = path
       @key = "#{klass_name}#{op}#{method_name}".freeze
 
       super(false)
@@ -370,7 +417,10 @@ module DEBUGGER__
       @tp = TracePoint.new(:call){|tp|
         next if !safe_eval(tp.binding, @cond) if @cond
         next if @cond_class && !tp.self.kind_of?(@cond_class)
-        next if @override_method ? (caller_locations(2, 1).first.to_s.start_with?(__dir__)) : tp.path.start_with?(__dir__)
+
+        caller_location = caller_locations(2, 1).first.to_s
+        next if caller_location.start_with?(__dir__)
+        next if skip_path?(caller_location)
 
         suspend
       }

data/lib/debug/client.rb

@@ -21,20 +21,56 @@ module DEBUGGER__
         when 'list-socks'
           cleanup_unix_domain_sockets
           puts list_connections
-        when 'init'
-          if ARGV.shift == '-'
-            puts <<~EOS
-            export RUBYOPT="-r #{__dir__}/prelude $(RUBYOPT)"
-            EOS
-          else
-            puts <<~EOS
-            # add the following lines in your .bash_profile
-
-            eval "$(rdbg init -)"
-            EOS
-          end
+        when 'setup-autoload'
+          setup_autoload
+        else
+          abort "Unknown utility: #{name}"
+        end
+      end
+
+      def working_shell_type
+        shell = `ps -p #{Process.ppid} -o 'args='`
+        case shell
+        when /bash/
+          :bash
+        when /fish/
+          :fish
+        when /csh/
+          :csh
+        when /zsh/
+          :szh
+        when /dash/
+          :dash
         else
-          raise "Unknown utility: #{name}"
+          :unknown
+        end
+      end
+
+      def setup_autoload
+        prelude_path = File.join(__dir__, 'prelude.rb')
+
+        case shell = working_shell_type
+        when :bash, :zsh
+          puts <<~EOS
+          # add the following lines in your ~/.#{shell}_profile
+
+          if test -s #{prelude_path} ; then
+            export RUBYOPT='-r #{prelude_path}'
+          fi
+
+          # Add `Kernel#bb` method which is alias of `Kernel#debugger`
+          # export RUBY_DEBUG_BB=1
+          EOS
+
+        when :fish
+          puts <<~EOS
+          # add the following lines in your ~/.config/fish/config.fish
+          set -x RUBYOPT "-r #{__dir__}/prelude" $RUBYOPT
+          EOS
+
+        else
+          puts "# Sorry that your shell is not supported yet.",
+               "# Please use the content in #{prelude_path} as a reference and modify your login script accordingly."
         end
       end
 
@@ -134,9 +170,14 @@ module DEBUGGER__
       trap(:SIGINT){
         send "pause"
       }
-      trap(:SIGWINCH){
-        @width = IO.console_size[1]
-      }
+
+      begin
+        trap(:SIGWINCH){
+          @width = IO.console_size[1]
+        }
+      rescue ArgumentError => e
+        @width = 80
+      end
 
       while line = @s.gets
         p recv: line if $VERBOSE

data/lib/debug/color.rb

@@ -48,33 +48,29 @@ module DEBUGGER__
 
     if defined? IRB::ColorPrinter.pp
       def color_pp obj, width
-        if !CONFIG[:no_color]
-          IRB::ColorPrinter.pp(obj, "".dup, width)
-        else
-          obj.pretty_inspect
+        with_inspection_error_guard do
+          if !CONFIG[:no_color]
+            IRB::ColorPrinter.pp(obj, "".dup, width)
+          else
+            obj.pretty_inspect
+          end
         end
       end
     else
       def color_pp obj, width
-        obj.pretty_inspect
+        with_inspection_error_guard do
+          obj.pretty_inspect
+        end
       end
     end
 
     def colored_inspect obj, width: SESSION.width, no_color: false
-      if !no_color
-        color_pp obj, width
-      else
-        obj.pretty_inspect
-      end
-    rescue => ex
-      err_msg = "#{ex.inspect} rescued during inspection"
-      string_result = obj.to_s rescue nil
-
-      # don't colorize the string here because it's not from user's application
-      if string_result
-        %Q{"#{string_result}" from #to_s because #{err_msg}}
-      else
-        err_msg
+      with_inspection_error_guard do
+        if !no_color
+          color_pp obj, width
+        else
+          obj.pretty_inspect
+        end
       end
     end
 
@@ -109,5 +105,19 @@ module DEBUGGER__
     def colorize_dim(str)
       colorize(str, [:DIM])
     end
+
+    def with_inspection_error_guard
+      yield
+    rescue Exception => ex
+      err_msg = "#{ex.inspect} rescued during inspection"
+      string_result = obj.to_s rescue nil
+
+      # don't colorize the string here because it's not from user's application
+      if string_result
+        %Q{"#{string_result}" from #to_s because #{err_msg}}
+      else
+        err_msg
+      end
+    end
   end
 end

data/lib/debug/config.rb

@@ -43,20 +43,23 @@ module DEBUGGER__
     sock_dir:       ['RUBY_DEBUG_SOCK_DIR',     "REMOTE: UNIX Domain Socket remote debugging: socket directory"],
     cookie:         ['RUBY_DEBUG_COOKIE',       "REMOTE: Cookie for negotiation"],
     open_frontend:  ['RUBY_DEBUG_OPEN_FRONTEND',"REMOTE: frontend used by open command (vscode, chrome, default: rdbg)."],
+    chrome_path:    ['RUBY_DEBUG_CHROME_PATH',  "REMOTE: Platform dependent path of Chrome (For more information, See [here](https://github.com/ruby/debug/pull/334/files#diff-5fc3d0a901379a95bc111b86cf0090b03f857edfd0b99a0c1537e26735698453R55-R64))"],
 
     # obsolete
     parent_on_fork: ['RUBY_DEBUG_PARENT_ON_FORK', "OBSOLETE: Keep debugging parent process on fork (default: false)",     :bool],
   }.freeze
 
-  CONFIG_MAP = CONFIG_SET.map{|k, (ev, desc)| [k, ev]}.to_h.freeze
+  CONFIG_MAP = CONFIG_SET.map{|k, (ev, _)| [k, ev]}.to_h.freeze
 
   class Config
+    @config = nil
+
     def self.config
       @config
     end
 
     def initialize argv
-      if self.class.instance_variable_defined? :@config
+      if self.class.config
         raise 'Can not make multiple configurations in one process'
       end
 
@@ -480,7 +483,7 @@ module DEBUGGER__
     self.helps.each{|cat, cmds|
       r << "### #{cat}"
       r << ''
-      cmds.each{|ws, desc|
+      cmds.each{|_, desc|
         r << desc
       }
       r << ''

data/lib/debug/console.rb

@@ -34,6 +34,12 @@ module DEBUGGER__
         load_history_if_not_loaded
         commands = DEBUGGER__.commands
 
+        prev_completion_proc = Reline.completion_proc
+        prev_output_modifier_proc = Reline.output_modifier_proc
+        prev_prompt_proc = Reline.prompt_proc
+
+        Reline.prompt_proc = nil
+
         Reline.completion_proc = -> given do
           buff = Reline.line_buffer
           Reline.completion_append_character= ' '
@@ -72,6 +78,13 @@ module DEBUGGER__
             colorize_code(buff.chomp) + colorize("    # ruby", [:DIM])
           end
         end
+
+        yield
+
+      ensure
+        Reline.completion_proc = prev_completion_proc
+        Reline.output_modifier_proc = prev_output_modifier_proc
+        Reline.prompt_proc = prev_prompt_proc
       end
 
       private def get_command line
@@ -84,8 +97,9 @@ module DEBUGGER__
       end
 
       def readline prompt
-        readline_setup prompt
-        Reline.readmultiline(prompt, true){ true }
+        readline_setup prompt do
+          Reline.readmultiline(prompt, true){ true }
+        end
       end
 
       def history
@@ -145,7 +159,7 @@ module DEBUGGER__
     FH = "# Today's OMIKUJI: "
 
     def read_history_file
-      if history && File.exists?(path = history_file)
+      if history && File.exist?(path = history_file)
         f = (['', 'DAI-', 'CHU-', 'SHO-'].map{|e| e+'KICHI'}+['KYO']).sample
         ["#{FH}#{f}".dup] + File.readlines(path)
       else