better_errors-pry 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f9ac61c1a9d15b76b8d020fee4586fb2ea5a7ed9
-  data.tar.gz: 81d46ee9e2aa5151e2ab433b8db6ec37bfb7abee
+SHA256:
+  metadata.gz: '088078b5ea91515b9f04b5cac92bff89a3967f7dfd750279e9830df2b08a30de'
+  data.tar.gz: 16a8b49ba4555c3e466fbf287117caf738742c77e12cbe611bd95ee46a9d72b4
 SHA512:
-  metadata.gz: 6ba0b17ff8b1fb545a0c335fab072d4468ff9a29ae8c43c28f05542a5237c712d3d375cc1399dce76c326e7444ccbde1ab5f9c299786518bd08e158c659c81d5
-  data.tar.gz: a1d6fab46d8eab8c47a724b7cd2d448682e3fde27a983463107d9713ff06e4b4a9fc11ecbdc462e0875f8acfa8797f47ab3c08c5a39229004df425e515704aa6
+  metadata.gz: 2c275160f4490b6ec2415e04b1fcf7866388da5c57e5189d1cb5fb298017f977f55365b6fbfc30210b75b4b2fb2c9ba08c1ea38c03f2d6b8486380442811c3ff
+  data.tar.gz: b30f24bc8b785405070361a9b59227ae56ca03ebea54eb6f3c10bc3a72efeff5c9341c9de08224a9f5ad10b10f4af69ccc156b8b0cc29506b8d0e6485106b5e2

data/README.md

@@ -7,33 +7,51 @@
 [Better Errors](https://github.com/charliesome/better_errors) is a gem that provides a very useful error page for Ruby web/API applications.
 This gem adds [Pry](http://pryrepl.org) support to Better Errors.
 
-(This support was previously added directly to Better Errors.
-This gem exists to extract Pry support from the main project.)
+_This gem is intended to allow us to extract Pry support from the BetterErrors project itself.
+Through at least v2.4.0, Pry support is included in the project directly.
+Including this gem will replace the built-in support, and it is functionally the same at this time._
+
+## Why the separate gem for Pry support?
+
+BetterErrors supports a very large number of possible configurations.
+It supports Rails and non-Rails, with binding_of_caller and without, and all of the major versions of the Ruby interpreter.
+
+All of these combinations should be tested.
+Currently BetterErrors has 14 different test gemfiles, each running on 6 different versions of Ruby.
+And these are not comprehensive.
+
+Because the BetterErrors gem needs to support each of these configurations, it can't specify any of its optional dependencies' required versions.
+This makes BetterErrors difficult to maintain, and difficult for application maintainers to keep it and its dependencies up-to-date.
+
+(For example, for several years, the newer version of `binding_of_caller` did not work correctly, so applications that used BetterErrors were given instructions to lock `binding_of_caller` to a specific version.
+This is because BetterErrors could not specify the `binding_of_caller` version in its own gemspec, since it is optional.
+Once the issue was fixed, application maintainers had no way to know that it was possible to remove the fixed version.)
+
+The solution is to extract optional functionality that depends on additional gems from the BetterErrors project, and place it in a project like this one.
 
 ## Installation
 
-Add this to your application's Gemfile, in the same group as better_errors:
+Add this to your application's `Gemfile`, in the `development` group, just like better_errors:
 
 ```ruby
 group :development do
   gem 'better_errors'
-  gem 'binding_of_caller'
   gem 'better_errors-pry'
 end
 ```
 
-**It's important to keep this in the development group.**
-See [Better Errors](https://github.com/charliesome/better_errors) for more information.
-
-[`binding_of_caller`](https://github.com/banister/binding_of_caller) is required by this gem, since it's necessary to be able to run Pry in the context of the exception that was raised.
+You need to activate pry in the application (for example, in `config/environments/development.rb`):
 
-And then execute:
+```ruby
+BetterErrors.use_pry!
+```
 
-    $ bundle
+**It's important to keep this in the development group.**
+See [Better Errors](https://github.com/charliesome/better_errors#security) for more information.
 
 ## Usage
 
-See [Better Errors](https://github.com/charliesome/better_errors#usage) for more information.
+See [Better Errors](https://github.com/charliesome/better_errors#usage) to get started.
 
 When you see the Better Errors console, you can issue Pry-specific commands, such as `ls` and `cd`.
 
@@ -63,4 +81,3 @@ On CI, the specs are run against each major release of Ruby in addition to each
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-

data/better_errors-pry.gemspec

@@ -27,7 +27,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.0"
 
-  spec.add_dependency "better_errors", '~> 2.3.0', '>= 2.3.0'
+  spec.add_dependency "better_errors", '~> 2.3', '>= 2.3.0'
   spec.add_dependency "pry", ">= 0.9"
   spec.add_dependency "binding_of_caller"
 end

data/lib/better_errors/pry/version.rb

@@ -1,5 +1,5 @@
 module BetterErrors
   module Pry
-    VERSION = "1.0.2"
+    VERSION = "1.0.3"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: better_errors-pry
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors:
 - Charlie Somerville
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-08-05 00:00:00.000000000 Z
+date: 2018-09-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -59,7 +59,7 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: '2.3'
     - - ">="
       - !ruby/object:Gem::Version
         version: 2.3.0
@@ -69,7 +69,7 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: '2.3'
     - - ">="
       - !ruby/object:Gem::Version
         version: 2.3.0
@@ -143,7 +143,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.8
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Add Pry support to Better Errors