Ruby C Other
dependabot[bot] and deivid-rodriguez Bump yard from 0.9.15 to 0.9.16 (#479)
Bumps [yard](https://github.com/lsegal/yard) from 0.9.15 to 0.9.16.
- [Release notes](https://github.com/lsegal/yard/releases)
- [Changelog](https://github.com/lsegal/yard/blob/master/CHANGELOG.md)
- [Commits](lsegal/yard@v0.9.15...v0.9.16)

Signed-off-by: dependabot[bot] <support@dependabot.com>
Latest commit 8aecdb3 Aug 13, 2018
Permalink
Failed to load latest commit information.
.circleci Back to running all tasks for all rubies Aug 2, 2018
.github Remove PR template (#354) Sep 15, 2017
bin Back to running all tasks for all rubies Aug 2, 2018
docker Install the proper bundler in docker images Aug 2, 2018
exe Move LOAD_PATH manipulation to gemspec (#422) Jan 7, 2018
ext/byebug Rename functions that conflict with debase's (#447) Mar 30, 2018
lib Bump rubocop from 0.56.0 to 0.57.0 (#463) Jun 6, 2018
tasks Make lint task pass on any supported ruby Jul 26, 2018
test Don't require simplecov when running a bundled env (#476) Jul 25, 2018
.clang-format Move to clang-format for C code formatting Dec 2, 2017
.codeclimate.yml Disable the rest of codeclimate checks Jul 25, 2018
.gitignore Update readme files Dec 7, 2017
.mdlrc Normalize string literals in mdlrc config Jan 6, 2018
.rubocop.yml Add YAML mark to rubocop config May 23, 2018
.simplecov Fix rubocop config to include `.simplecov` Jan 6, 2018
.travis.yml Install the proper bundler on Travis Aug 3, 2018
CHANGELOG.md Get ready for 10.0.2 release (#451) Mar 30, 2018
CONTRIBUTING.md Remove codeclimate traces Jul 25, 2018
GUIDE.md small discrepancies in guide (#467) Jun 12, 2018
Gemfile Bump yard from 0.9.15 to 0.9.16 (#479) Aug 13, 2018
Gemfile.lock Bump yard from 0.9.15 to 0.9.16 (#479) Aug 13, 2018
LICENSE Fix typo in License Dec 9, 2014
README.md Remove codeclimate traces Jul 25, 2018
Rakefile Remove codeclimate traces Jul 25, 2018
Ruby_Grant_2014_Report.md Drop official support for ruby 2.2 Dec 30, 2017
appveyor.yml Fixed rubygems instead of fixed bundler May 22, 2018
byebug.gemspec Move LOAD_PATH manipulation to gemspec (#422) Jan 7, 2018
code_of_conduct.md Add Mdl and fix offenses Jan 31, 2016

README.md

Byebug

Version [![Maintainability][mai]][mai_url] Coverage Gitter

Byebug is a simple to use, feature rich debugger for Ruby. It uses the TracePoint API for execution control and the Debug Inspector API for call stack navigation, so it doesn't depend on internal core sources. It's developed as a C extension, so it's fast. And it has a full test suite so it's reliable.

It allows you to see what is going on inside a Ruby program while it executes and offers many of the traditional debugging features such as:

  • Stepping: Running your program one line at a time.
  • Breaking: Pausing the program at some event or specified instruction, to examine the current state.
  • Evaluating: Basic REPL functionality, although pry does a better job at that.
  • Tracking: Keeping track of the different values of your variables or the different lines executed by your program.

Build Status

Linux Cir macOS Tra Windows Vey

Requirements

  • Required: MRI 2.2.0 or higher.

  • Recommended: MRI 2.3.0 or higher.

Install

gem install byebug

Or if you use bundler,

bundle add byebug --group "development, test"

Usage

From within the Ruby code

Simply drop byebug wherever you want to start debugging and the execution will stop there. If you were debugging Rails, for example, you would add byebug to your code.

def index
  byebug
  @articles = Article.find_recent
end

And then start a Rails server.

bin/rails s

Once the execution gets to your byebug command you will get a debugging prompt.

From the command line

If you want to debug a Ruby script without editing it, you can invoke byebug from the command line.

byebug myscript.rb

Byebug's commands

Command Aliases Subcommands
backtrace bt where
break
catch
condition
continue
debug
delete
disable breakpoints display
display
down
edit
enable breakpoints display
finish
frame
help
history
info args breakpoints catch display file line program
interrupt
irb
kill
list
method instance
next
pry
quit
restart
save
set autoirb autolist autopry autosave basename callstyle fullpath histfile histsize linetrace listsize post_mortem savefile stack_on_error width
show autoirb autolist autopry autosave basename callstyle fullpath histfile histsize linetrace listsize post_mortem savefile stack_on_error width
source
step
thread current list resume stop switch
tracevar
undisplay
untracevar
up
var all constant global instance local

Semantic Versioning

Byebug tries to follow semantic versioning and tries to bump major version only when backwards incompatible changes are released. Backwards compatibility is targeted to pry-byebug and any other plugins relying on byebug.

Getting Started

Read byebug's markdown guide to get started. Proper documentation will be eventually written.

Related projects

  • pry-byebug adds next, step, finish, continue and break commands to pry using byebug.
  • ruby-debug-passenger adds a rake task that restarts Passenger with Byebug connected.
  • minitest-byebug starts a byebug session on minitest failures.
  • sublime_debugger provides a plugin for ruby debugging on Sublime Text.
  • atom-byebug provides integration with the Atom editor [EXPERIMENTAL].

Contribute

See Getting Started with Development.

You can also help byebug by leaving a small (or big) tip through Liberapay.

Support via Liberapay

Credits

Everybody who has ever contributed to this forked and reforked piece of software, especially:

  • @ko1, author of the awesome TracePoint API for Ruby.
  • @cldwalker, debugger's maintainer.
  • @denofevil, author of debase, the starting point of this.
  • @kevjames3 for testing, bug reports and the interest in the project.
  • @FooBarWidget for working and helping with remote debugging.