debundle 0.9.0.alpha

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 97544bb4cd260c59184b14849f692bc44d234ca4
+  data.tar.gz: 7d1beec1f5b2de7840f7e59118a1f82585a88c72
+SHA512:
+  metadata.gz: a18f8799a6486596a6000f4adc11bb233af62a805170e2cbab015669921a34613f579cbe66ad35bba8b5cc7776b46d50bc6c287700f627a50e3919c2a057220c
+  data.tar.gz: 8c4e6532d473e8571b731be85888a0c49ec5e0867cef37bfd236b48416cc87e07e139d02a63b6bdcd283d071275be46b97c469204f43a187e47b67d21864f60e

data/LICENSE.MIT

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Conrad Irwin <conrad.irwin@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,92 @@
+`debundle` allows you to require gems that are not in your `Gemfile`
+when inspecting programs that are run with Bundler.
+
+Usage
+=====
+Use the `pry` command, or `binding.pry` as normal. Watch how you can
+require any gem, even if it's not in your `Gemfile` and celebrate! Avoid
+getting confused by that fact when trying to debug `'require'`
+statements.
+
+
+Installation
+============
+
+Add `pry` and `pry-debundle` to the Gemfile. These are both required, and have few (if
+any) ill effects for developers who don't wish to use them.
+
+```ruby
+group :development do
+  gem 'pry'
+  gem 'pry-debundle'
+  # other development gems everyone needs go here.
+end
+```
+
+If you need to install these gems without buy-in from the rest of your team (sad panda)
+there are instructions under Personal Installation.
+
+
+Long-winded Explanation
+=======================
+
+Bundler is an awesome gem that gives you a good degree of confidence that "if it works in
+development, it works in production". It can do this by being vicious about gem
+dependencies: if it's not in the `Gemfile`, it's not getting required. It also ensures
+that everyone's development environment is identical, no more does "it works on my
+machine" cut it as an excuse.
+
+There are circumstances when this dogmatic dedication to duty can get in the way. In
+particular all good developers have set up their development environment very personally.
+Obviously, it's not important that my local tools work in production, and it's positively
+bad for productivity if everyone is forced to have an identicial development setup.
+
+So how do you reconcile these two points of view: "it should work the same everywhere",
+and "it should be ideal for me"?
+
+The obvious answer is to compromise; mostly "it should work the same everywhere", but when
+I'm actively working on it (i.e. I have my `Pry` open) "it should be ideal for me".
+
+To this end, `pry-debundle` will do nothing (I mean absolutely nothing) until you start
+pry. At that point, the chains locking you into the Bundler jail are hacked asunder, and
+immediately your precious pry plugins load, and all of those random gems you've
+collected will be available to `require` as normal.
+
+Before you rush off to try this, a word of warning: you will waste debugging time because
+of this. Why? Because running a `require 'ampex'` inside Pry works, but running a `require
+'ampex'` outside Pry doesn't. "XOMGWTF? Ohhhh! GAH!!" I hear your future self cry as you
+forget this warning, and then painfully recall it.
+
+As the adage goes: "No gain, without pain".
+
+
+Personal Installation
+=====================
+
+So let's say everyone on your team wants to use pry, but some of them are too scared to
+use `pry-debundle`. This is pretty easy to support. Just add Pry to the Gemfile as
+before, and then copy the implementation of the gem into your ~/.pryrc
+
+```ruby
+group :development do
+  gem 'pry'
+  # other development gems everyone needs go here.
+end
+```
+
+```bash
+curl https://raw.github.com/ConradIrwin/pry-debundle/master/lib/pry-debundle.rb >> ~/.pryrc
+```
+
+If you can't even persuade people to allow you to add Pry to the Gemfile, then you can
+write a little wrapper script to run your app to make sure Pry is loaded before Bundler,
+and install `pry-debundle` into your ~/.pryrc as above.
+
+Meta-fu
+=======
+Licensed under the MIT license (see `LICENSE.MIT`). Bug reports and pull requests are
+welcome.
+
+It's possible that Bundler will solve this issue themselves, in which case I expect to
+deprecate this gem. See https://github.com/carlhuda/bundler/issues/183 for some
+discussion.

data/debundle.gemspec

@@ -0,0 +1,13 @@
+Gem::Specification.new do |s|
+  s.name          = "debundle"
+  s.version       = "0.9.0.alpha"
+  s.authors       = ["Conrad Irwin",           "Jonathan Allard"]
+  s.email         = ["conrad.irwin@gmail.com", "jonathan@allard.io"]
+
+  s.license       = "MIT"
+  s.homepage      = "http://github.com/joallard/debundle"
+  s.summary       = "Allows you to use gems not in your Gemfile"
+  s.description   = "Removes the restrictions on loading gems imposed by Bundler only when you're running in interactive mode."
+  s.files         = `git ls-files`.split("\n")
+  s.require_paths = ["lib"]
+end

data/lib/debundle.rb

@@ -0,0 +1,151 @@
+# Copyright (c) Conrad Irwin <conrad.irwin@gmail.com> -- MIT License
+# Source: https://github.com/ConradIrwin/pry-debundle
+#
+# To install and use this:
+#
+# 1. Recommended
+#   Add 'pry' to your Gemfile (in the development group)
+#   Add 'pry-debundle' to your Gemfile (in the development group)
+#
+# 2. OK, if colleagues are wary of pry-debundle:
+#   Add 'pry' to your Gemfile (in the development group)
+#   Copy this file into ~/.pryrc
+#
+# 3. Meh, if colleagues don't like Pry at all:
+#   Copy this file into ~/.pryrc
+#   Create a wrapper script that runs `pry -r<your-application>`
+#
+# 4. Pants, if you don't like Pry:
+#   Run `gem which pry-debundle` outside the Ruby console,
+#   and call `load '/path/to/pry-debundle.rb'; Pry.debundle!`
+#   when you need to.
+
+module Debundle
+
+  # Break out of the Bundler jail.
+  #
+  # This can be used to load files in development that are not in your
+  # Gemfile (for example if you want to test something with a tool
+  # that you have locally).
+  #
+  # @example
+  #   Pry.debundle!
+  #   require 'all_the_things'
+  #
+  # Normally you don't need to cal this directly though, as it is
+  # called for you when Pry starts.
+  #
+  # See https://github.com/carlhuda/bundler/issues/183 for some
+  # background.
+  #
+  def debundle!
+    return unless defined?(Bundler)
+    loaded = false
+
+    if rubygems_18_or_better?
+      if Gem.post_reset_hooks.reject!{ |hook| hook.source_location.first =~ %r{/bundler/} }
+        Bundler.preserve_gem_path
+        Gem.clear_paths
+        Gem::Specification.reset
+        remove_bundler_monkeypatches
+        loaded = true
+      end
+
+    # Rubygems 1.6 — TODO might be quite slow.
+    elsif Gem.source_index && Gem.send(:class_variable_get, :@@source_index)
+      Gem.source_index.refresh!
+      remove_bundler_monkeypatches
+      loaded = true
+
+    else
+      raise "No hacks found :("
+    end
+  rescue => e
+    puts "Debundling failed: #{e.message}"
+    puts "When reporting bugs to https://github.com/ConradIrwin/pry-debundle, please include:"
+    puts "* gem version: #{Gem::VERSION rescue 'undefined'}"
+    puts "* bundler version: #{Bundler::VERSION rescue 'undefined'}"
+    puts "* ruby version: #{RUBY_VERSION rescue 'undefined'}"
+    puts "* ruby engine: #{RUBY_ENGINE rescue 'undefined'}"
+  else
+    return false unless loaded
+
+    require 'pry' unless Debundle.pry_present?
+
+    Debundle.add_hooks
+    Debundle.load_additional_plugins
+
+    true
+  end
+
+  class << self
+    def pry_present?
+      Pry.respond_to?(:config)
+    end
+
+    def add_hooks
+      return false if defined?(@@already_hooked)
+      @@already_hooked = true
+
+      # Run just after a binding.pry, before you get dumped in the
+      # REPL. This handles the case where Bundler is loaded before Pry.
+      # NOTE: This hook happens *before* :before_session
+      Pry.config.hooks.add_hook(:when_started, :debundle){ Pry.debundle! }
+
+      # Run after every line of code typed.  This handles the case
+      # where you load something that loads bundler into your Pry.
+      Pry.config.hooks.add_hook(:after_eval, :debundle){ Pry.debundle! }
+    end
+
+    # After we've escaped from Bundler we want to look around and find
+    # any plugins the user has installed locally but not added to
+    # their Gemfile.
+    #
+    def load_additional_plugins
+      old_plugins = Pry.plugins.values
+      Pry.locate_plugins
+      new_plugins = Pry.plugins.values - old_plugins
+
+      new_plugins.each(&:activate!)
+    end
+  end
+
+  private
+
+  def rubygems_18_or_better?
+    defined?(Gem.post_reset_hooks)
+  end
+
+  def rubygems_20_or_better?
+    Gem::VERSION.to_i >= 2
+  end
+
+  # Ugh, this stuff is quite vile.
+  def remove_bundler_monkeypatches
+    if rubygems_20_or_better?
+      load 'rubygems/core_ext/kernel_require.rb'
+    else
+      load 'rubygems/custom_require.rb'
+    end
+
+    if rubygems_18_or_better?
+      Kernel.module_eval do
+        def gem(gem_name, *requirements) # :doc:
+          skip_list = (ENV['GEM_SKIP'] || "").split(/:/)
+          raise Gem::LoadError, "skipping #{gem_name}" if skip_list.include? gem_name
+          spec = Gem::Dependency.new(gem_name, *requirements).to_spec
+          spec.activate if spec
+        end
+      end
+    else
+      Kernel.module_eval do
+        def gem(gem_name, *requirements) # :doc:
+          skip_list = (ENV['GEM_SKIP'] || "").split(/:/)
+          raise Gem::LoadError, "skipping #{gem_name}" if skip_list.include? gem_name
+          Gem.activate(gem_name, *requirements)
+        end
+      end
+    end
+  end
+end
+

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: debundle
+version: !ruby/object:Gem::Version
+  version: 0.9.0.alpha
+platform: ruby
+authors:
+- Conrad Irwin
+- Jonathan Allard
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-01-06 00:00:00.000000000 Z
+dependencies: []
+description: Removes the restrictions on loading gems imposed by Bundler only when
+  you're running in interactive mode.
+email:
+- conrad.irwin@gmail.com
+- jonathan@allard.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.MIT
+- README.md
+- debundle.gemspec
+- lib/debundle.rb
+homepage: http://github.com/joallard/debundle
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Allows you to use gems not in your Gemfile
+test_files: []