ruby_jard 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5a458f6dbabbed48b8cb322d6ac9a3c52e664309b1a1bfde1e90f91921092b6
-  data.tar.gz: e54b2ddcebc06c72fd78b4cc34dc99aba60eb1ba7d20d6815e0c4d88c39d2076
+  metadata.gz: 00607fcc7c6b4de0a2bb272624357ef7f9c8e3a0aa4a46783f127b094fc0a6f9
+  data.tar.gz: 6bd10f20ba123f290b786a875eb5879cf343e126a1a31d420387691e7ee6d5e5
 SHA512:
-  metadata.gz: '079110d831bc4729fe3c5ac9a33726d396cd4df50b889890f5b7e602d7e8d6717cf6e48b6038c4e653e2de2ae2ae4d44da6a0790d6f63be67e573475d59a0980'
-  data.tar.gz: fe4711967e8d0f3a81962038b1d7d40b319934f323ed6d942bde0f918125971e76bc49a73c603347c4e6be07618bf3950236ef0e868b07c587a2d1583cf7cbe6
+  metadata.gz: 64ca81f056c51fd717cb1b1caae5f8490bb71ea8f5b93b587451ab8115e546fea617eb0eb0d4357a281c255ff862d33a024ccae0301a3148800dff1332242662
+  data.tar.gz: b1063583e9f8c31d9ec3e092e8d5e99b339b3d016b2516d2c4e9b27843071099916f8444c5bc648ba506e00d794bdecc030c06b838895385aff61981d696a6ca

data/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "bundler" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "daily"

data/.github/workflows/rspec.yml

@@ -32,8 +32,17 @@ jobs:
       uses: ruby/setup-ruby@v1
       with:
         ruby-version: ${{ matrix.ruby }}
+    - uses: actions/checkout@v2
+      with:
+        repository: tmux/tmux
+        path: 'tmux'
+        ref: '3.1b'
+    - name: Install dependencies for tmux
+      run: sudo apt install -y libevent-dev
     - name: Install tmux
-      run: sudo apt install -y tmux
+      run: cd tmux && sh autogen.sh && ./configure && make && sudo make install
+    - name: Tmux version
+      run: tmux -V
     - name: Start tmux
       run: tmux start-server
     - name: Start dummy tmux session
@@ -42,6 +51,8 @@ jobs:
       run: ruby spec/wait_for_tmux.rb
     - name: Install dependencies
       run: bundle install
+    - name: Kill tmux
+      run: tmux kill-server || true
     - name: Run tests
       run: bundle exec parallel_rspec spec/
   test-macos:
@@ -69,28 +80,39 @@ jobs:
     - name: Run tests
       run: bundle exec parallel_rspec -n 2 spec/
   test-byebug:
-    runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
         byebug: [9.1.0, 10.0.2]
     env:
       BUNDLE_GEMFILE: "./spec/gemfiles/Gemfile-byebug-${{ matrix.byebug }}"
+    runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v2
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1
       with:
         ruby-version: 2.5
+    - uses: actions/checkout@v2
+      with:
+        repository: tmux/tmux
+        path: 'tmux'
+        ref: '3.1b'
+    - name: Install dependencies for tmux
+      run: sudo apt install -y libevent-dev
     - name: Install tmux
-      run: sudo apt install -y tmux
+      run: cd tmux && sh autogen.sh && ./configure && make && sudo make install
+    - name: Tmux version
+      run: tmux -V
     - name: Start tmux
       run: tmux start-server
-    - name: start dummy tmux session
+    - name: Start dummy tmux session
       run: tmux new-session -t dummy -d
     - name: Wait for tmux
       run: ruby spec/wait_for_tmux.rb
     - name: Install dependencies
       run: bundle install
+    - name: Kill tmux
+      run: tmux kill-server || true
     - name: Run tests
       run: bundle exec parallel_rspec spec/

data/.gitignore

@@ -11,3 +11,6 @@
 .rspec_status
 .ruby-version
 Gemfile.lock
+**/.byebug_history
+.byebug_history
+coverage

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.3.1]
+This release fixes bunch of bugs, and performance issues reported by the users after beta launch. No new features are introduced.
+
+- Pry and Byebug backward compatibility: [#39](https://github.com/nguyenquangminh0711/ruby_jard/issues/39), [#45](https://github.com/nguyenquangminh0711/ruby_jard/issues/45)
+- Error with non-UTF8 encoding in the output: [#55](https://github.com/nguyenquangminh0711/ruby_jard/issues/55)
+- Ctrl+D not working: [#34](https://github.com/nguyenquangminh0711/ruby_jard/issues/34)
+- Errors if putting jard with `<%= jard %>` in ERB: [#35](https://github.com/nguyenquangminh0711/ruby_jard/issues/35)
+- Handle standard stream redirections, and prevent Jard from attachment in invalid TTY device: [#38](https://github.com/nguyenquangminh0711/ruby_jard/issues/38), [#46](https://github.com/nguyenquangminh0711/ruby_jard/issues/46), [#53](https://github.com/nguyenquangminh0711/ruby_jard/issues/53)
+- Bring back auto-resize when window size changes: [#40](https://github.com/nguyenquangminh0711/ruby_jard/issues/40)
+- Improve performance after `exit` command: [#49](https://github.com/nguyenquangminh0711/ruby_jard/issues/49)
+- Handle edge cases in Jard color decorator: [#54](https://github.com/nguyenquangminh0711/ruby_jard/issues/54)
+- Escape all special characters and line feeds before printing stuff into the screen: [#57](https://github.com/nguyenquangminh0711/ruby_jard/issues/57)
+
 ## [0.3.0 - Beta 1]
 - Filter feature
 - New variable screen look and feel

data/Gemfile

@@ -17,6 +17,9 @@ gem 'rubocop', '~> 0.89.1'
 gem 'rubocop-rspec', '~> 1.43.1', require: false
 
 group :test do
+  gem 'activerecord'
   gem 'parallel_tests'
   gem 'rspec-retry'
+  gem 'simplecov', require: false
+  gem 'sqlite3'
 end

data/lib/ruby_jard.rb

@@ -14,7 +14,6 @@ require 'ruby_jard/keys'
 require 'ruby_jard/key_binding'
 require 'ruby_jard/key_bindings'
 require 'ruby_jard/repl_proxy'
-require 'ruby_jard/repl_processor'
 require 'ruby_jard/screen_manager'
 require 'ruby_jard/reflection'
 
@@ -98,13 +97,20 @@ module RubyJard
   def self.config
     @config ||= RubyJard::Config.smart_load
   end
+
+  def self.all_files
+    Dir.glob(File.join(File.expand_path(__dir__, './lib'), '**', '*.rb')) +
+      Dir.glob(File.join(File.expand_path(__dir__, './lib'), '*.rb')) +
+      Dir.glob(File.join(File.expand_path(__dir__, './bin'), '**', '*.rb')) +
+      Dir.glob(File.join(File.expand_path(__dir__, './bin'), '*.rb'))
+  end
 end
 
 ##
 # Monkey-patch Kernel module to allow putting jard command anywhere.
 module Kernel
   def jard
-    RubyJard::Session.instance.attach
+    RubyJard::Session.attach
   end
 
   if RubyJard.config.alias_to_debugger

data/lib/ruby_jard/commands/continue_command.rb

@@ -14,7 +14,7 @@ module RubyJard
       Examples:
         continue
 
-      Continue program execution. The program will stop at the next breakpoint, or run until it finishes.
+      Continue the execution of your program to the end, or stop at the first dynamic break point or `jard` attachment command.
       BANNER
 
       def process

data/lib/ruby_jard/commands/exit_command.rb

@@ -14,7 +14,7 @@ module RubyJard
       Examples:
         exit
 
-      Exit program execution. The program will stop at the next breakpoint, or run until it finishes.
+      Exit the execution of the program. Interally, when `jard` receives this command, it removes all debugging hooks, and triggers `::Kernel.exit`. Some long-running processes like `puma` or `sidekiq` may capture this event, treat it as an error, and recover to keep the processes running. In such cases, it's recommended to use `continue` command instead.
       BANNER
 
       def process

data/lib/ruby_jard/commands/jard/output_command.rb

@@ -19,6 +19,7 @@ module RubyJard
       end
 
       def process
+        sleep 0.25 # Cool down
         pry_instance.pager.open(
           force_open: true,
           pager_start_at_the_end: true,

data/lib/ruby_jard/config.rb

@@ -8,6 +8,14 @@ module RubyJard
       def smart_load
         config = RubyJard::Config.new
 
+        unless ENV['JARD_CONFIG_FILE'].nil?
+          unless File.exist?(ENV['JARD_CONFIG_FILE'])
+            raise "Config file '#{ENV['JARD_CONFIG_FILE']}' does not exist"
+          end
+
+          return load_config(config, ENV['JARD_CONFIG_FILE'])
+        end
+
         path = File.expand_path(File.join(Dir.pwd, CONFIG_FILE_NAME))
         load_config(config, path) if File.exist?(path)
 
@@ -15,10 +23,6 @@ module RubyJard
         load_config(config, path) if File.exist?(path)
 
         config
-      rescue StandardError => e
-        # Fallback to default setting
-        STDOUT.puts "Fail to load jard configurations at #{path}. Error: #{e}"
-        RubyJard::Config.new
       end
 
       private
@@ -28,6 +32,9 @@ module RubyJard
         config.instance_eval(config_content)
 
         config
+      rescue SyntaxError, StandardError => e
+        # Fallback to default setting
+        raise "Fail to load jard configurations at #{path}. Error: #{e}"
       end
     end
 

data/lib/ruby_jard/console.rb

@@ -8,22 +8,45 @@ module RubyJard
   # Wrapper for utilities to control screen
   class Console
     class << self
-      def start_alternative_terminal(output)
-        return unless output.tty?
+      def attachable?
+        return false unless output.tty?
 
-        output.print tput('smcup')
-      rescue RubyJard::Error
-        # If tput not found, fallback to hard-coded sequence.
-        output.print "\e[?1049h\e[22;0;0t"
+        width, height = screen_size(output)
+        width != 0 && height != 0
       end
 
-      def stop_alternative_terminal(output)
-        return unless output.tty?
+      def redirected?
+        output != $stdout
+      end
 
-        output.print tput('rmcup')
-      rescue RubyJard::Error
-        # If tput not found, fallback to hard-coded sequence.
-        output.print "\e[?1049l\e[23;0;0t"
+      def output
+        return @output if defined?(@output)
+
+        @output =
+          if STDOUT.tty?
+            STDOUT
+          else
+            begin
+              File.open('/dev/tty', 'w+')
+            rescue StandardError
+              STDOUT # Give up now.
+            end
+          end
+      end
+
+      def input
+        return @input if defined?(@input)
+
+        @input =
+          if STDIN.tty?
+            STDIN
+          else
+            begin
+              File.open('/dev/tty', 'r+')
+            rescue StandardError
+              STDIN # Give up.
+            end
+          end
       end
 
       def move_to(output, x, y)
@@ -35,7 +58,12 @@ module RubyJard
       def screen_size(output)
         return [0, 0] unless output.tty?
 
-        [TTY::Screen.width, TTY::Screen.height]
+        if output.respond_to?(:winsize)
+          height, width = output.winsize
+          [width, height]
+        else
+          [TTY::Screen.width, TTY::Screen.height]
+        end
       end
 
       def clear_screen(output)
@@ -50,7 +78,7 @@ module RubyJard
         output.print "\e[0J"
       end
 
-      def disable_cursor!(output = STDOUT)
+      def disable_cursor!(output)
         return unless output.tty?
 
         output.print tput('civis')
@@ -59,7 +87,7 @@ module RubyJard
         output.print "\e[?25l"
       end
 
-      def enable_cursor!(output = STDOUT)
+      def enable_cursor!(output)
         return unless output.tty?
 
         output.print tput('cnorm')
@@ -81,7 +109,7 @@ module RubyJard
         nil
       end
 
-      def raw!(output = STDOUT)
+      def raw!(output)
         return unless output.tty?
 
         begin
@@ -91,7 +119,7 @@ module RubyJard
         end
       end
 
-      def cooked!(output = STDOUT)
+      def cooked!(output)
         return unless output.tty?
 
         begin
@@ -102,7 +130,7 @@ module RubyJard
         end
       end
 
-      def disable_echo!(output = STDOUT)
+      def disable_echo!(output)
         return unless output.tty?
 
         begin
@@ -113,7 +141,7 @@ module RubyJard
         end
       end
 
-      def enable_echo!(output = STDOUT)
+      def enable_echo!(output)
         return unless output.tty?
 
         begin

data/lib/ruby_jard/control_flow.rb

@@ -21,7 +21,7 @@ module RubyJard
 
     attr_reader :command, :arguments
 
-    def initialize(command, arguments)
+    def initialize(command, arguments = {})
       @command = command
       @arguments = arguments
 

data/lib/ruby_jard/decorators/color_decorator.rb

@@ -37,17 +37,28 @@ module RubyJard
 
       def decorate(style_names, content)
         attributes = nil
+        foreground = nil
+        background = nil
+
         if style_names.is_a?(Symbol)
           styles = @color_scheme.styles_for(style_names)
         else
           attributes = translate_styles(style_names)
           styles = @color_scheme.styles_for(style_names.shift)
         end
-        foreground = translate_color(styles.shift, true)
-        background = translate_color(styles.shift, false)
+
+        if styles.is_a?(Array)
+          foreground = translate_color(styles.shift, true)
+          background = translate_color(styles.shift, false)
+        elsif !styles.nil?
+          raise RubyJard::Error, "Styles for #{style_names.inspect} must be an array"
+        end
+
         "#{foreground}#{background}#{attributes}#{content}#{CSI_RESET}"
       end
 
+      private
+
       def translate_color(color, foreground)
         if (matches = HEX_PATTERN_6.match(color.to_s))
           red = matches[1].to_i(16)
@@ -70,8 +81,6 @@ module RubyJard
         end
       end
 
-      private
-
       def translate_styles(styles = [])
         styles.map { |key| STYLES_CSI_MAP[key] }.compact.join
       end

data/lib/ruby_jard/decorators/rails_decorator.rb

@@ -89,7 +89,9 @@ module RubyJard
           if variable.respond_to?(:loaded?) && variable.loaded?
             spans = []
             label = RubyJard::Span.new(
-              content: RubyJard::Reflection.call_to_s(variable).chomp('>'), styles: :text_primary
+              content: RubyJard::Reflection.call_to_s(variable).chomp('>'),
+              styles: :text_primary,
+              margin_right: variable.length >= 1 ? 1 : 0
             )
             spans << label
             spans += @attributes_decorator.inline_values(
@@ -99,6 +101,10 @@ module RubyJard
             )
             spans << RubyJard::Span.new(content: '>', styles: :text_primary)
 
+            if variable.length <= 0
+              spans << RubyJard::Span.new(content: '(empty)', margin_left: 1, styles: :text_primary)
+            end
+
             spans
           else
             relation_summary(variable, line_limit)
@@ -138,7 +144,7 @@ module RubyJard
           width = overview.length + 1 + 12
           spans = [RubyJard::Span.new(content: overview, styles: :text_primary)]
           if RubyJard::Reflection.call_respond_to?(variable, :to_sql) && width < line_limit
-            detail = variable.to_sql
+            detail = variable.to_sql.inspect
             detail = detail[0..line_limit - width - 2] + '…' if width + detail.length < line_limit
             spans << RubyJard::Span.new(content: detail, styles: :text_dim, margin_left: 1)
           end

data/lib/ruby_jard/keys.rb

@@ -42,7 +42,8 @@ module RubyJard
       F7       => (ACTION_STEP     = :step),
       SHIFT_F7 => (ACTION_STEP_OUT = :step_out),
       F8       => (ACTION_NEXT     = :next),
-      F9       => (ACTION_CONTINUE = :continue)
+      F9       => (ACTION_CONTINUE = :continue),
+      CTRL_D   => ACTION_CONTINUE
     }.freeze
   end
 end

data/lib/ruby_jard/pager.rb

@@ -46,7 +46,13 @@ module RubyJard
         @pager_start_at_the_end = pager_start_at_the_end
         @prompt = prompt
 
-        @window_width, @window_height = RubyJard::Console.screen_size(@pry_instance.output)
+        # There are two cases:
+        # - If the real pager (less) is triggered, it works on a real tty (fetched
+        # from /dev/tty), in which, the same as RubyJard::Console.output
+        # - Otherwise, it writes directly into pry's REPL output.
+        # That's why there should be two output here
+        @tty_output = RubyJard::Console.redirected? ? RubyJard::Console.output : pry_instance.output
+        @window_width, @window_height = RubyJard::Console.screen_size(RubyJard::Console.output)
         @tracker = JardPageTracker.new(@window_height, @window_width)
         @pager = force_open ? open_pager : nil
       end
@@ -93,7 +99,7 @@ module RubyJard
 
         IO.popen(
           less_command.join(' '), 'w',
-          out: @pry_instance.output, err: @pry_instance.output
+          out: @tty_output, err: @tty_output
         )
       end
 

data/lib/ruby_jard/repl_processor.rb

@@ -29,7 +29,8 @@ module RubyJard
       @repl_proxy = RubyJard::ReplProxy.new(
         key_bindings: RubyJard.global_key_bindings
       )
-      @previous_flow = nil
+      @previous_flow = RubyJard::ControlFlow.new(:next)
+      @output = RubyJard::Console.output
     end
 
     def at_line
@@ -123,10 +124,10 @@ module RubyJard
       next_frame = find_frame(options[:frame].to_i)
       if next_frame.nil?
         # There must be an error in outer validators
-        RubyJard::ScreenManager.puts 'Error: Frame not found. There should be an error with Jard.'
+        @output.puts 'Error: Frame not found. There should be an error with Jard.'
         process_commands(false)
       elsif next_frame.c_frame?
-        RubyJard::ScreenManager.puts "Error: Frame #{next_frame} is a c-frame. Not able to inspect c layer!"
+        @output.puts "Error: Frame #{next_frame} is a c-frame. Not able to inspect c layer!"
         process_commands(false)
       else
         RubyJard::Session.frame = next_frame.real_pos
@@ -135,11 +136,12 @@ module RubyJard
     end
 
     def handle_continue_command(_options = {})
-      RubyJard::ScreenManager.puts '▸▸ Program resumed ▸▸'
+      @output.puts '▸▸ Program resumed ▸▸'
       Byebug.stop if Byebug.stoppable?
     end
 
     def handle_exit_command(_options = {})
+      Byebug.stop if Byebug.stoppable?
       Kernel.exit
     end
 

data/lib/ruby_jard/repl_proxy.rb

@@ -123,7 +123,10 @@ module RubyJard
       end
     end
 
-    def initialize(key_bindings: nil)
+    def initialize(key_bindings: nil, input: RubyJard::Console.input, output: RubyJard::Console.output)
+      @input = input
+      @output = output
+
       @state = ReplState.new
 
       @pry_input_pipe_read, @pry_input_pipe_write = IO.pipe
@@ -137,15 +140,23 @@ module RubyJard
 
       @pry_pty_output_thread = Thread.new { pry_pty_output }
       @pry_pty_output_thread.name = '<<Jard: Pty Output Thread>>'
+
+      Signal.trap('SIGWINCH') do
+        @main_thread.raise FlowInterrupt.new('Resize event', RubyJard::ControlFlow.new(:list))
+      end
     end
 
+    # rubocop:disable Metrics/MethodLength
     def repl(current_binding)
       @state.ready!
       @openning_pager = false
 
-      RubyJard::Console.disable_echo!
-      RubyJard::Console.raw!
+      RubyJard::Console.disable_echo!(@output)
+      RubyJard::Console.raw!(@output)
 
+      # Internally, Pry sneakily updates Readline to global output config
+      # when STDOUT is piping regardless of what I pass into Pry instance.
+      Pry.config.output = @pry_output_pty_write
       Readline.input = @pry_input_pipe_read
       Readline.output = @pry_output_pty_write
       @pry.binding_stack.clear
@@ -168,41 +179,47 @@ module RubyJard
       sleep PTY_OUTPUT_TIMEOUT until @state.exited?
       RubyJard::ControlFlow.dispatch(e.flow)
     ensure
-      RubyJard::Console.enable_echo!
-      RubyJard::Console.cooked!
-      Readline.input = STDIN
-      Readline.output = STDOUT
+      RubyJard::Console.enable_echo!(@output)
+      RubyJard::Console.cooked!(@output)
+      Readline.input = @input
+      Readline.output = @output
+      Pry.config.output = @output
       @key_listen_thread&.exit if @key_listen_thread&.alive?
       @pry_input_thread&.exit if @pry_input_thread&.alive?
       @state.exited!
     end
+    # rubocop:enable Metrics/MethodLength
 
     private
 
     def read_key
-      RubyJard::Console.getch(STDIN, KEY_READ_TIMEOUT)
+      RubyJard::Console.getch(@input, KEY_READ_TIMEOUT)
     end
 
     def pry_pty_output
       loop do
         if @state.exiting?
           if @pry_output_pty_read.ready?
-            STDOUT.write @pry_output_pty_read.read_nonblock(2048), from_jard: true
+            write_output(@pry_output_pty_read.read_nonblock(2048))
           else
             @state.exited!
           end
         elsif @state.exited?
           sleep PTY_OUTPUT_TIMEOUT
         else
-          output = @pry_output_pty_read.read_nonblock(2048)
-          unless output.nil?
-            STDOUT.write output, from_jard: true
+          content = @pry_output_pty_read.read_nonblock(2048)
+          unless content.nil?
+            write_output(content)
           end
         end
       rescue IO::WaitReadable, IO::WaitWritable
         # Retry
         sleep PTY_OUTPUT_TIMEOUT
       end
+    rescue StandardError
+      # This thread shoud never die, or the user may be freezed, and cannot type anything
+      sleep 0.5
+      retry
     end
 
     def pry_repl(current_binding)
@@ -312,25 +329,33 @@ module RubyJard
     def pry_hooks
       hooks = Pry::Hooks.default
       hooks.add_hook(:after_read, :jard_proxy_acquire_lock) do |_read_string, _pry|
-        RubyJard::Console.cooked!
+        RubyJard::Console.cooked!(@output)
         @state.processing!
         # Sleep 2 ticks, wait for pry to print out all existing output in the queue
         sleep PTY_OUTPUT_TIMEOUT * 2
       end
       hooks.add_hook(:after_handle_line, :jard_proxy_release_lock) do
-        RubyJard::Console.raw!
+        RubyJard::Console.raw!(@output)
         @state.ready!
       end
       hooks.add_hook(:before_pager, :jard_proxy_before_pager) do
         @openning_pager = true
 
         @state.processing!
-        RubyJard::Console.cooked!
+        RubyJard::Console.cooked!(@output)
       end
       hooks.add_hook(:after_pager, :jard_proxy_after_pager) do
         @openning_pager = false
         @state.ready!
-        RubyJard::Console.raw!
+        RubyJard::Console.raw!(@output)
+      end
+    end
+
+    def write_output(content)
+      if RubyJard::Console.redirected?
+        @output.write content.force_encoding('UTF-8')
+      else
+        @output.write content.force_encoding('UTF-8'), from_jard: true
       end
     end
   end

data/lib/ruby_jard/screen_manager.rb

@@ -38,7 +38,7 @@ module RubyJard
 
     attr_reader :output, :output_storage
 
-    def initialize(output: STDOUT)
+    def initialize(output: RubyJard::Console.output)
       @output = output
       @screens = {}
       @started = false
@@ -68,9 +68,9 @@ module RubyJard
 
       @started = false
 
-      RubyJard::Console.cooked!
-      RubyJard::Console.enable_echo!
-      RubyJard::Console.enable_cursor!
+      RubyJard::Console.cooked!(@output)
+      RubyJard::Console.enable_echo!(@output)
+      RubyJard::Console.enable_cursor!(@output)
     end
 
     def draw_screens
@@ -78,7 +78,7 @@ module RubyJard
       @updating = true
 
       RubyJard::Console.clear_screen(@output)
-      RubyJard::Console.disable_cursor!
+      RubyJard::Console.disable_cursor!(@output)
       width, height = RubyJard::Console.screen_size(@output)
 
       @layouts = calculate_layouts(width, height)
@@ -102,9 +102,9 @@ module RubyJard
       draw_error(e, height)
     ensure
       # You don't want to mess up previous user TTY no matter happens
-      RubyJard::Console.cooked!
-      RubyJard::Console.enable_echo!
-      RubyJard::Console.enable_cursor!
+      RubyJard::Console.cooked!(@output)
+      RubyJard::Console.enable_echo!(@output)
+      RubyJard::Console.enable_cursor!(@output)
       @updating = false
     end
 
@@ -128,10 +128,6 @@ module RubyJard
       RubyJard.error(exception)
     end
 
-    def puts(content)
-      @output.write "#{content}\n", from_jard: true
-    end
-
     private
 
     def calculate_layouts(width, height)

data/lib/ruby_jard/session.rb

@@ -13,7 +13,7 @@ module RubyJard
       extend Forwardable
 
       def_delegators :instance,
-                     :attach, :lock,
+                     :lock,
                      :sync, :should_stop?,
                      :step_over, :step_into, :frame=,
                      :threads, :current_frame, :current_thread, :current_backtrace,
@@ -22,6 +22,21 @@ module RubyJard
       def instance
         @instance ||= new
       end
+
+      def attach
+        unless RubyJard::Console.attachable?
+          $stdout.puts 'Failed to attach. Jard could not detect a valid tty device.'
+          $stdout.puts 'This bug occurs when the process Jard trying to access is a non-interactive environment '\
+            ' such as docker, daemon, sub-processes, etc.'
+          $stdout.puts 'If you are confused, please submit an issue in https://github.com/nguyenquangminh0711/ruby_jard/issues.'
+          return
+        end
+
+        instance.start unless instance.started?
+
+        Byebug.attach
+        Byebug.current_context.step_out(3, true)
+      end
     end
 
     OUTPUT_BUFFER_LENGTH = 10_000 # 10k lines
@@ -52,31 +67,28 @@ module RubyJard
       Byebug::Setting[:autolist] = false
       Byebug::Setting[:autoirb] = false
       Byebug::Setting[:autopry] = false
+
+      require 'ruby_jard/repl_processor'
       Byebug::Context.processor = RubyJard::ReplProcessor
       # Exclude all files in Ruby Jard source code from the stacktrace.
-      Byebug::Context.ignored_files = Byebug::Context.all_files + Dir.glob(
-        File.join(
-          File.expand_path(__dir__, '../lib'),
-          '**',
-          '*.rb'
-        )
-      )
-      # rubocop:disable Lint/NestedMethodDefinition
-      def $stdout.write(*string, from_jard: false)
-        # NOTE: `RubyJard::ScreenManager.instance` is a must. Jard doesn't work well with delegator
-        # TODO: Debug and fix the issues permanently
-        if from_jard
-          super(*string)
-          return
-        end
+      Byebug::Context.ignored_files = Byebug::Context.all_files + RubyJard.all_files
 
-        unless RubyJard::ScreenManager.instance.updating?
-          RubyJard::Session.instance.append_output_buffer(string)
-        end
+      $stdout.send(:instance_eval, <<-CODE)
+        def write(*string, from_jard: false)
+          # NOTE: `RubyJard::ScreenManager.instance` is a must. Jard doesn't work well with delegator
+          # TODO: Debug and fix the issues permanently
+          if from_jard
+            super(*string)
+            return
+          end
 
-        super(*string)
-      end
-      # rubocop:enable Lint/NestedMethodDefinition
+          unless RubyJard::ScreenManager.instance.updating?
+            RubyJard::Session.instance.append_output_buffer(string)
+          end
+
+          super(*string)
+        end
+      CODE
 
       at_exit { stop }
 
@@ -98,13 +110,6 @@ module RubyJard
       @started == true
     end
 
-    def attach
-      start unless started?
-
-      Byebug.attach
-      Byebug.current_context.step_out(3, true)
-    end
-
     def should_stop?
       @path_filter.match?(@current_context.frame_file)
     end

data/lib/ruby_jard/span.rb

@@ -15,7 +15,7 @@ module RubyJard
         content += ' ' * margin_right if margin_right > 0
       end
 
-      @content = content.to_s
+      @content = content.to_s.gsub(/\r\n/, '\n').gsub(/\n/, '\n')
       @content_length = content_length || @content.length
       @styles = styles
     end

data/lib/ruby_jard/version.rb

@@ -2,5 +2,5 @@
 
 # Semantic versionn
 module RubyJard
-  VERSION = '0.3.0'
+  VERSION = '0.3.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_jard
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Minh Nguyen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-12 00:00:00.000000000 Z
+date: 2020-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -70,6 +70,7 @@ files:
 - ".github/FUNDING.yml"
 - ".github/ISSUE_TEMPLATE/bug_report.md"
 - ".github/ISSUE_TEMPLATE/feature_request.md"
+- ".github/dependabot.yml"
 - ".github/workflows/documentation.yml"
 - ".github/workflows/rspec.yml"
 - ".gitignore"