{"id":13392897,"url":"https://github.com/cldwalker/debugger","last_synced_at":"2025-03-13T19:31:12.146Z","repository":{"id":2872287,"uuid":"3878051","full_name":"cldwalker/debugger","owner":"cldwalker","description":"port of ruby-debug that works on 1.9.2 and 1.9.3","archived":true,"fork":true,"pushed_at":"2015-05-26T15:12:46.000Z","size":1640,"stargazers_count":845,"open_issues_count":15,"forks_count":80,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-03-11T06:46:49.080Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"mark-moseley/ruby-debug","license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cldwalker.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-03-30T15:36:37.000Z","updated_at":"2024-09-21T17:58:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/cldwalker/debugger","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cldwalker%2Fdebugger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cldwalker%2Fdebugger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cldwalker%2Fdebugger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cldwalker%2Fdebugger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cldwalker","download_url":"https://codeload.github.com/cldwalker/debugger/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243469132,"owners_count":20295692,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T17:00:38.896Z","updated_at":"2025-03-13T19:31:11.608Z","avatar_url":"https://github.com/cldwalker.png","language":"C","funding_links":[],"categories":["C","Debugging Tools"],"sub_categories":[],"readme":"## Status\n\nStatus: Maintained until 8/1/15. Accepting bug fixes only\n\nAs debugger is only supported for 1.9 and [support for 1.9 has\nended](https://www.ruby-lang.org/en/news/2014/01/10/ruby-1-9-3-will-end-on-2015/), debugger will\nonly be maintained until 8/1/15. After this date, this gem will have no more releases.\nUse of Ruby 2.X is recommended as the Ruby core team has advised.\n\n## Description\nA fork of ruby-debug(19) that works on 1.9.2 and 1.9.3 and installs easily for rvm/rbenv rubies.\nruby \u003e= 2.0 are *not* supported - [see below](#known-issues).\n\n[![Build Status](https://travis-ci.org/cldwalker/debugger.png?branch=master)](https://travis-ci.org/cldwalker/debugger)\n\n## Install\n\n    $ gem install debugger\n\n    # If install fails, try passing headers path\n    $ gem install debugger -- --with-ruby-include=PATH_TO_HEADERS\n\nFor Windows install instructions, see OLD\\_README.\n\n\n## Supported Rubies\nOn install, debugger tries to find your ruby's headers. If it's unable to find them and your ruby is\na patch release, it will use headers included with\n[debugger-ruby_core_source](https://github.com/cldwalker/debugger-ruby_core_source).  For the list\nof 1.9.X rubies supported by debugger [see\nhere](https://github.com/cldwalker/debugger-ruby_core_source/tree/master/lib/debugger/ruby_core_source).\n*If your ruby is not an official patch release i.e. head, dev or an rc, you are responsible for\nhaving headers and setting them with --with-ruby-include.*\n\n## Usage\n\nWherever you need a debugger, simply:\n\n```ruby\nrequire 'debugger'; debugger\n```\n\nTo use with bundler, drop in your Gemfile:\n\n    gem 'debugger'\n\n### Configuration\n\nAt initialization time, debugger loads config files, executing their lines\nas if they were actual commands a user has typed. config files are loaded\nfrom two locations:\n\n* ~/.rdebugrc (~/rdebug.ini for windows)\n* $PWD/.rdebugrc ($PWD/rdebug.ini for windows)\n\nTo see debugger's current settings, use the `set` command.\n\n### Getting Started\n\nAfter installing the debugger gem, you can create a test file to try out the debugger functionality. Save this example to a file and run it with ruby:\n\n```ruby\nrequire 'debugger'\n\nx = 4\ndebugger\ny = 5\n```\n\nRunning the above code as a file in Ruby (e.g., ```ruby test-debug.rb```) will cause debugger to break code execution and give you an interactive console on the line \"debugger\". You can type \"step\" to dive into the line of code or type \"next\" to stay at the same level and process the line you're on. You can also make any IRB style commands you want to inspect or modify the code. Typing \"continue\" will resume code execution until the next \"debugger\" line is encountered, if any.\n\n### Using Commands\n\nFor a list of commands:\n\n    (rdb: 1) help\n\nMost commands are described in rdebug's man page\n\n    $ gem install gem-man\n    $ man rdebug\n\n### Remote Debugging\n\nTo debug a separate process remotely (such as unicorn) try:\n\n```ruby\n  Debugger.wait_connection = true\n  Debugger.start_remote\n  debugger\n```\n\nThen you can do\n\n     $ rdebug -c\n\n### More documentation\n\nSome thorough documentation of debugger is found with [this bashdb\ntutorial](http://bashdb.sourceforge.net/ruby-debug.html). For emacs and debugger\nusage, see [another bashdb\ntutorial](http://bashdb.sourceforge.net/ruby-debug/rdebug-emacs.html)\n\n## Reason for Fork\n\n* ruby-debug19 maintainer isn't maintaining:\n  * Despite patches from ruby core, no gem release in 2+ years! - 9/1/09.\n  * Requests to release a known working 1.9.3 version have been ignored.\n  * Doesn't respond to rubyforge issues and doesn't have github issues open.\n* Current install is painful. Requires either [manually downloading gems from rubyforge](\n  http://blog.wyeworks.com/2011/11/1/ruby-1-9-3-and-ruby-debug) and installing with compiler flags\n  or [recompiling\n  ruby](http://blog.sj26.com/post/12146951658/updated-using-ruby-debug-on-ruby-1-9-3-p0).\n* We need a decent ruby debugger for future rubies!\n\n## What's different from ruby-debug19\n\n* Major\n  * Works on 1.9.2 and 1.9.3\n    * 1.9.2 points to ruby-debug-base19-0.11.25 headers\n    * 1.9.3 points to ruby-debug-base19-0.11.26 headers\n  * Install painlessly for rvm and rbenv rubies i.e. no compiler flags needed\n  * No downloading ruby source during install - was behavior of old ruby_core_source dependency\n  * Add output adapters, Printers, to support output besides plain text e.g. xml\n  * A new and improved test suite\n  * Passing tests are up on travis-ci\n  * Fix several bugs\n    * Fix LocalJumpError caused by using proc in extconf.rb\n    * Fix where command failing at top level\n    * See changelog for more\n* Minor\n  * The gem name matches the module namespace, Debugger, and main required file, debugger.\n  * autolist and autoeval enabled by default\n  * ruby-debug-base19 and ruby-debug19 are released as one gem\n  * Rake tasks have been updated\n  * No more $LOAD_PATH manipulation or runtime code outside of lib\n  * man page available via gem-man\n  * Test helpers for third-party debugger libraries can be accessed from debugger/test. See debugger-xml for an example\n\n## Issues\nPlease report them [on github](http://github.com/cldwalker/debugger/issues).\n\n## Known Issues\n* Only 1.9.2 and 1.9.3 are supported. For 2.X rubies, consider using [byebug](https://github.com/deivid-rodriguez/byebug).\n* If you're interested in porting debugger to ruby2, see [this\n  checklist](https://github.com/cldwalker/debugger/issues/125#issuecomment-43353446). Note an old attempt at porting it lives at\n  [debugger2](https://github.com/ko1/debugger2).\n* If you place a debugger call at the end of a block, debugging will start at the next step and\n  outside of your block. A simple work-around is to place a meaningless step (i.e. puts \"STAY\")\n  at the end of your block and before debugger.\n\n## Contributing\n[See here](http://tagaholic.me/contributing.html) for contribution policies.\nLet's keep this working for the ruby community!\n\n## Related projects\n\n* [debugger-completion](https://github.com/cldwalker/debugger-completion) - autocompletion for\n  debugger commands and more\n* [debugger-xml](https://github.com/astashov/debugger-xml) - XML interface for debugger, compatible\n  with ruby-debug-ide\n* [vim-ruby-debugger](https://github.com/astashov/vim-ruby-debugger) - Vim plugin that uses debugger\n* [debugger-pry](https://github.com/pry/debugger-pry) - using pry within debugger\n* [pry-debugger](https://github.com/nixme/pry-debugger) - using debugger within pry\n* [ruby-debug-passenger](https://github.com/davejamesmiller/ruby-debug-passenger) - rake task to\n  restart Passenger with debugger connected\n* [jruby-debug](https://github.com/jruby/jruby-debug)\n* [rb-trepanning](https://github.com/rocky/rb-trepanning) - rewrite of ruby-debug that requires a\n  patched ruby\n\n## Links\n\n* [Rails guide with debugger](http://guides.rubyonrails.org/debugging_rails_applications.html)\n\n## License\n\nLicensing due to the complicated forking history of this project. Licensing is BSD throughout most\nof the repository except for portions of emacs/, doc/ and old_scripts/ which are GPL.\n\n## Credits\n\n* Thanks to the original authors: Kent Sibilev and Mark Moseley\n* Thanks to astashov for bringing in a new and improved test suite, adding printers support and various bug fixes.\n* Thanks to windwiny for starting the port to 2.0.0\n* Contributors: ericpromislow, jnimety, adammck, hipe, FooBarWidget, aghull, deivid-rodriguez,\n  tessi, os97673, arthurnn\n* Fork started on awesome @relevance fridays!\n\n## TODO\n\n* Port some of bashdb's docs\n* Use ~/.debuggerrc and bin/debugger and gracefully deprecate rdebug*\n* Work with others willing to tackle jruby, rubinius or windows support\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcldwalker%2Fdebugger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcldwalker%2Fdebugger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcldwalker%2Fdebugger/lists"}