File: debugging.rb

package info (click to toggle)
ruby-guard 2.18.1-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,344 kB
  • sloc: ruby: 9,256; makefile: 6
file content (68 lines) | stat: -rw-r--r-- 1,475 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
# Because it's used by Sheller
require "open3"
require "logger"

require "guard/ui"

require "guard/internals/tracing"

module Guard
  # @private api
  module Internals
    class Debugging
      class << self
        TRACES = [
          [Kernel, :system],
          [Kernel, :spawn],
          [Kernel, :`],
          [Open3, :popen3]
        ]

        # Sets up debugging:
        #
        # * aborts on thread exceptions
        # * Set the logging level to `:debug`
        # * traces execution of Kernel.system and backtick calls
        def start
          return if @started ||= false
          @started = true

          Thread.abort_on_exception = true

          UI.level = Logger::DEBUG

          TRACES.each { |mod, meth| _trace(mod, meth, &method(:_notify)) }
          @traced = true
        end

        def stop
          return unless @started ||= false
          UI.level = Logger::INFO
          _reset
        end

        private

        def _notify(*args)
          UI.debug "Command execution: #{args.join(' ')}"
        end

        # reset singleton - called by tests
        def _reset
          @started = false
          return unless @traced
          TRACES.each { |mod, meth| _untrace(mod, meth) }
          @traced = false
        end

        def _trace(mod, meth, &block)
          Tracing.trace(mod, meth, &block)
        end

        def _untrace(mod, meth)
          Tracing.untrace(mod, meth)
        end
      end
    end
  end
end