• This repository has been archived on 01/Dec/2020
  • Stars
    star
    16
  • Rank 1,311,288 (Top 26 %)
  • Language
    Ruby
  • License
    MIT License
  • Created over 9 years ago
  • Updated over 5 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

BindingDumper

Build Status Code Climate Coverage Status Inline docs

A gem for dumping a whole binding and restoring it later. After restoring you can use pry to perform delayed debugging.

WARNING this gem is not ready for production yet, please, use it only in development environment.

Installation

Add this line to your application's Gemfile:

gem 'binding_dumper'

And then execute:

$ bundle

Or install it yourself as:

$ gem install binding_dumper

Usage

To dump a binding run

binding.dump
# => "a lot of strange output here, that's fine"

Ideally, you should persist an output somewhere (like in the database). Let's say we have a Rails model called DumpedBinding with data field:

StoredBinding.create(data: binding.dump)

Make your server to execute the code above (just put it to any controller's action), go to the console, and run:

b = Binding.load(StoredBinding.last.data)
b.pry

And enjoy!

Blog post about internal parts of the gem

Requirements

  • Ruby >= 1.9.3 (see travis.yml for supported versions)

Examples

The simplest one is in the file examples/simple.rb.

A bit more complex example with Rails environment is in spec/dummy/app/controllers/users_controller.rb

Development

Clone the repo, run bundle install.

To run all tests using current ruby version, run rspec or rake.

To run all tests with ALL supported ruby versions, run bin/multitest and follow the output.

To run dummy app, run bin/dummy_rails s (bin/dummy_rails c for console).

Contributing

  1. Fork it ( https://github.com/[my-github-username]/binding_dumper/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request