Integrating the Ruby Debugger into YaST
- 1. Ruby Debugger Integrating Ruby Debugger into YaST Ing. Ladislav Slezák SUSE (The YaST Team) [email protected]
- 2. 2 Ruby Debugger – Introduction ● Debugger is a tool for testing and inspecting running programs ● The Ruby debugger is called “byebug”
- 3. 3 Ruby Debugger – Installation Run Gemfile: Run gem install byebug group :development, :test do gem 'byebug' end bundle install
- 4. 4 Ruby Debugger – Usage Start: Or adapt the script: And start: require 'byebug' byebug byebug script.rb ruby script.rb
- 5. 5 And YaST...? Unfortunately this does NOT work in YaST… ● YaST runs embedded Ruby ● YaST is a GUI/TUI desktop application ● The installer runs in a limited minimal system ● Read-only RAM disk, no storage ● No desktop environment ● Cannot install new libraries/gems easily
- 6. 6 Byebug – Solution Byebug client/server architecture ● Input/output goes through a TCP port instead of STDOUT/STDIN ● Allows remote debugging
- 7. 7 Byebyg – Remote Debugging Start server (in the code): Start client (from another console): # initialize the server require 'byebug/core' Byebug.wait_connection = true # use ‘0.0.0.0’ for real remote debugging Byebug.start_server('localhost', 3344) … # start the debugger byebug byebug -R localhost:3344
- 8. 8 YaST – GUI Open a new terminal window automatically ● Run “xterm -e byebug -R ... ”
- 9. 9 YaST – Text Mode Connect manually in the text mode
- 10. 10 Invoking the Debugger in YaST Simply boot the installer with In installed system run with y2debugger=1 Y2DEBUGGER=1 yast2 <module>
- 11. 11 Demo
- 12. 12 YaST – Exceptions ● Run the debugger also from the global exception handler
- 13. 13 Questions?
- 14. 14 Links ● https://github.com/deivid-rodriguez/byebug ● https://github.com/deivid-rodriguez/byebug/blob/master/GUIDE.md ● https://yastgithubio.readthedocs.io/en/latest/debugging/ ● https://github.com/yast/yast-ruby-bindings/blob/master/src/ruby/yast/debug
- 15. 15 Thank You!