pry-try 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 42dc31f96ce666efa506a7d4eb1818c962517547
-  data.tar.gz: aa56f8839c0a5230092967144e31ef8c930f873b
+  metadata.gz: eb3a1cff65259eb8f5139dbf5f96c2c7d49fea65
+  data.tar.gz: 9920060648bb293ea23dfb7979be94d1d4f7b595
 SHA512:
-  metadata.gz: ab07fa47a0def00a6674df5e061a7434d48f49528d52be5da56258703e81fd606f7f9a6155e5dc70cd5a9214d52b90b94073771d87dbf6bb536e0d8e1b9b3eae
-  data.tar.gz: 83cfcbd300813197a593310db9c4f73bf335d0294d094237c35fcb02c6acc90c0fa4d10d4347d752d0729b7ec821faebbd0c31243352ae8a548eae7ddb8c4e0d
+  metadata.gz: 4a55804801f3d858a7634042a15dabd97ce5f34e23a7da8f3c84919a3b3b8e9b012ad4c554a4ce13938ee9f02664ae2bf316e69f7013279386998383b7f0b610
+  data.tar.gz: 3554b3ccb80b6bfc4de7b79e48d5e22830edc3db3b717ed1d10c516cca07389a484709640e881d6b7fa5681fb748e652ce23e1cd35d9c3579ca012179348c05f

data/README.md

@@ -1,89 +1,121 @@
 # pry-try
 
-Start a pry-session with specific gems or a (remote) script loaded.
+Start a pry-session with specific gems or a (remote) script preloaded.
 
 ## Usage
 
-* start a pry-session with one or more gems loaded:
-
-    ```bash
-    $ pry-try activesupport
-    Fetching gem metadata from https://rubygems.org/.........
-    Fetching version metadata from https://rubygems.org/.
-    Resolving dependencies...
-    Using concurrent-ruby 1.0.5
-    Using i18n 0.8.1
-    Using minitest 5.10.1
-    Using thread_safe 0.3.6
-    Using coderay 1.1.1
-    Using method_source 0.8.2
-    Using slop 3.6.0
-    Using bundler 1.14.5
-    Using tzinfo 1.2.2
-    Using pry 0.10.4
-    Using activesupport 5.0.2
-    [2] pry(main)> 1.second
-    => 1 second
-    ```
+This gem allows you to get a pry-session with either...
+
+1. gems preloaded
+2. a script preloaded
+
+### pry-session with gems pre-loaded
+
+This requires pry-try to be [installed system-wide](#system-wide).
+
+```bash
+$ pry-try activesupport
+Fetching gem metadata from https://rubygems.org/.........
+Fetching version metadata from https://rubygems.org/.
+Resolving dependencies...
+Using concurrent-ruby 1.0.5
+Using i18n 0.8.1
+Using minitest 5.10.1
+Using thread_safe 0.3.6
+Using coderay 1.1.1
+Using method_source 0.8.2
+Using slop 3.6.0
+Using bundler 1.14.5
+Using tzinfo 1.2.2
+Using pry 0.10.4
+Using activesupport 5.0.2
+[2] pry(main)> 1.second
+=> 1 second
+```
     
-    Use a specific version:
-    
-    ```bash
-    $ pry-try activesupport '~>4.2'
-    ...
-    [2] pry(main)>
-    ```
+Use a specific version:
+
+```bash
+# any version notation that is accepted in a Gemfile will work 
+$ pry-try activesupport '~> 4.2'
+...
+[2] pry(main)>
+```
         
-    Multiple gems:
-    
-    ```bash
-    $ pry-try activesupport '~>4.2' redis
-    ...
-    [2] pry(main)>
-    ```
-    
-* start pry-session from within pry:
-
-    ```bash
-    $ pry
-    [1] pry(main)> .pry-try activesupport
-    ...
-    [2] pry(main)> 
-    This session is isolated from the initial session.
-    ^d to return to initial session
-    ```
+Multiple gems:
     
-* pipe-in script and start a pry-session:
+```bash
+$ pry-try activesupport '~> 4.2' redis
+...
+[2] pry(main)>
+```
 
-    ```bash
-    $ echo '@a = 1' | pry-try
-    [1] pry(main)> @a
-    => 1
-    [2] pry(main)> 
-    
-    # handy when sharing code with others:
-    $ curl https://gist.githubusercontent.com/eval/76955c57512c1e4ac01cdd913b76c92d/raw/bf714a15789eca3e968c3544f85b9b786b8eae8f/hello.rb | pry-try
-    
-    # or via the gist command:
-    $ gist -r 76955c57512c1e4ac01cdd913b76c92d | pry-try
-    ```
+### pry-session with script preloaded
+
+Anything piped to pry-try will be evaluated before the pry-session starts:
+
+```bash
+$ echo '@a = 1' | pry-try
+[1] pry(main)> @a
+=> 1
+```
+
+```bash
+# handy when sharing code with others:
+$ curl https://gist.githubusercontent.com/eval/76955c57512c1e4ac01cdd913b76c92d/raw/bf714a15789eca3e968c3544f85b9b786b8eae8f/hello.rb | pry-try
+
+# or via the gist command:
+$ gist -r 76955c57512c1e4ac01cdd913b76c92d | pry-try
+```
     
-    **NOTE:** curl-pipe-runtime is [not without risk](https://www.idontplaydarts.com/2016/04/detecting-curl-pipe-bash-server-side/). A tool like [vipe](https://github.com/madx/moreutils/blob/master/vipe) ([npm variant](https://github.com/juliangruber/vipe#vipe)) allows you to inspect the fetched script before handing it over to pry-try.
+**NOTE:** curl-pipe-runtime is [not without risk](https://www.idontplaydarts.com/2016/04/detecting-curl-pipe-bash-server-side/). A tool like [vipe](https://github.com/madx/moreutils/blob/master/vipe) ([npm variant](https://github.com/juliangruber/vipe#vipe)) allows you to inspect the fetched script before handing it over to pry-try.
 
+#### within a (Rails-)project
+
+When the script needs to be evaluated within a project (i.e. use the gems of your project), make sure pry-try is [part of your project](#within-project).
+
+A script for a Rails project would typically look like this:
+
+```ruby
+# script.rb
+require './config/environment' # load Rails-application
+@user = User.first
+```
+
+Evaluate via:
+```
+cat script.rb | bundle exec pry-try
+...
+[1] pry(main)> @user
+#<User id: 1, username: ...
+```
 
 ## Installation
 
-Install system-wide:
+### System-wide
 
-    $ gem install pry-try
+```bash
+$ gem install pry-try
+```
 
+### Within project
 
-## Development
+Add the following to `Gemfile`:
+    
+```ruby
+# Gemfile
+gem 'pry-try', group: :development
+```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies.
+Then run the tool via:
 
+```
+$ ruby -Ilib exe/pry-try activesupport
+```
 
 ## License
 

data/lib/pry-try/version.rb

@@ -1,3 +1,3 @@
 module PryTry
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

data/pry-try.gemspec

@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "pry", "~>0.10"
-  spec.add_development_dependency "bundler", "~> 1.14"
+  spec.add_dependency "bundler", "~> 1.10"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pry-try
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Gert Goet
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-03-20 00:00:00.000000000 Z
+date: 2017-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.14'
-  type: :development
+        version: '1.10'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.14'
+        version: '1.10'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement