pry-remote 0.0.1

data/README.md

@@ -0,0 +1,58 @@
+# What is it?
+
+A way to start Pry remotely and to connect to it using DRb. This allows to
+access the state of the running program from anywhere.
+
+# Installation
+
+    gem install pry-remote
+
+# Usage
+
+Here's a program starting pry-remote:
+
+    require 'pry-remote'
+
+    class Foo
+      def initialize(x, y)
+        binding.remote_pry
+      end
+    end
+
+    Foo.new 10, 20
+
+Running it will prompt you with a message telling you Pry is waiting for a
+program to connect itself to it:
+
+     [pry-remote] Waiting for client on drb://localhost:9876
+
+You can then connect yourself using ``pry-remote``:
+
+    $ pry-remote
+    From: example.rb @ line 7 in Foo#initialize:
+         2:
+         3: require 'pry-remote'
+         4:
+         5: class Foo
+         6:   def initialize(x, y)
+     =>  7:     binding.remote_pry
+         8:   end
+         9: end
+        10:
+        11: Foo.new 10, 20
+    pry(#<Foo:0x00000000d9b5e8>):1> self
+    => #<Foo:0x1efb3b0>
+    pry(#<Foo:0x00000001efb3b0>):2> ls -l
+    Local variables: [
+      [0] :_,
+      [1] :_dir_,
+      [2] :_file_,
+      [3] :_ex_,
+      [4] :_pry_,
+      [5] :_out_,
+      [6] :_in_,
+      [7] :x,
+      [8] :y
+    ]
+    pry(#<Foo:0x00000001efb3b0>):3> ^D
+

data/bin/pry-remote

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'pry-remote'
+PryRemote::CLI.new.run

data/lib/pry-remote.rb

@@ -0,0 +1,109 @@
+require 'pry'
+require 'slop'
+require 'drb'
+require 'readline'
+
+module PryRemote
+  # A class to represent an input object created from DRb. This is used because
+  # Pry checks for arity to know if a prompt should be passed to the object.
+  #
+  # @attr [#readline] input Object to proxy
+  InputProxy = Struct.new :input do
+    # Reads a line from the input
+    def readline(prompt)
+      input.readline(prompt)
+    end
+  end
+
+  # A client is used to retrieve information from the client program.
+  Client = Struct.new :input, :output, :thread do
+    # Waits until both an input and output are set
+    def wait
+      sleep 0.01 until input and output and thread
+    end
+
+    # Tells the client the session is terminated
+    def kill
+      thread.run
+    end
+
+    # @return [InputProxy] Proxy for the input
+    def input_proxy
+      InputProxy.new input
+    end
+  end
+
+  # Parses arguments and allows to start the client.
+  class CLI
+    def initialize(args = ARGV)
+      params = Slop.parse args, :help => true do
+        banner "#$PROGRAM_NAME [-h HOST] [-p PORT]"
+
+        on :h, :host, "Host of the server (localhost)", true,
+           :default => "localhost"
+        on :p, :port, "Port of the server (9876)", true, :as => Integer,
+           :default => 9876
+      end
+
+      @host = params[:host]
+      @port = params[:port]
+    end
+
+    # @return [String] Host of the server
+    attr_reader :host
+
+    # @return [Integer] Port of the server
+    attr_reader :port
+
+    # @return [String] URI for DRb
+    def uri
+      "druby://#{host}:#{port}"
+    end
+
+    # Connects to the server
+    def run
+      DRb.start_service
+      client = DRbObject.new(nil, uri)
+
+      # Passing Readline to DRb won't actually make it use our readline
+      # object. Instead, it will use the server-side readilne. Therefore, we
+      # create a simple proxy here.
+
+      input = Object.new
+      def input.readline(prompt)
+        Readline.readline(prompt, true)
+      end
+
+      client.input  = input
+      client.output = $stdout
+      client.thread = Thread.current
+
+      sleep
+      DRb.stop_service
+    end
+  end
+end
+
+class Object
+  # Starts a remote Pry session
+  #
+  # @param [String]  host Host of the server
+  # @param [Integer] port Port of the server
+  def remote_pry(host = "localhost", port = 9876)
+    uri = "druby://#{host}:#{port}"
+
+    client = PryRemote::Client.new
+    DRb.start_service uri, client
+
+    puts "[pry-remote] Waiting for client on #{uri}"
+    client.wait
+
+    puts "[pry-remote] Client received, starting remote sesion"
+    Pry.start(self, :input => client.input_proxy, :output => client.output)
+
+    puts "[pry-remote] Remote sesion terminated"
+    client.kill
+
+    DRb.stop_service
+  end
+end

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification 
+name: pry-remote
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Mon ouie
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-11 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: slop
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "2.1"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: pry
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.9"
+  type: :runtime
+  version_requirements: *id002
+description: Connect to Pry remotely using DRb
+email: mon.ouie@gmail.com
+executables: 
+- pry-remote
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/pry-remote.rb
+- README.md
+- bin/pry-remote
+homepage: http://github.com/Mon-Ouie/pry-remote
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: Connect to Pry remotely
+test_files: []
+