pal 0.0.1

data/bin/pal

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require File.join File.expand_path(File.dirname __FILE__), *%w{.. lib pal}
+
+Pal::REPL.create.loop

data/lib/pal.rb

@@ -0,0 +1,105 @@
+require "readline"
+
+# Public: Exposes a simple read-eval-print loop interface.
+module Pal
+  # Public: The current version of Pal.
+  Version = "0.0.1"
+
+  # Public: Defines the evaluation context. All instance methods defined in
+  # this class are made available as top-level methods during evaluation.
+  class Context
+    # Internal: Stores the result of the last-evaluated expression.
+    attr_reader :_
+
+    # Internal: Provides a less verbose string representation for `Context`s.
+    def inspect
+      "Context"
+    end
+  end
+
+  # Public: Creates a REPL instance.
+  class REPL
+    # Public: Gets the name of the REPL instance, used to generate the prompt
+    # text and debugging information.
+    attr_reader :name
+
+    # Public: Gets the evaluation context associated with the REPL instance.
+    attr_reader :context
+
+    # Public: Gets the result of the last-evaluated expression.
+    attr_reader :result
+
+    class << self
+      # Internal: Gets the current REPL instance.
+      attr_reader :messenger
+
+      # Public: Creates a new REPL instance. The `messenger` class instance
+      # variable is used by the REPL instance to correctly set and expose
+      # the result of the last-evaluated expression to the evaluation context.
+      def create(name = "pal", context = Context.new)
+        @messenger = new(name, context)
+      end
+    end
+
+    def initialize(name, context)
+      @name = name
+      @context = context
+      @line = 1
+      @statements = []
+    end
+
+    # Public: Starts the REPL. The REPL will persist until an `exit` signal
+    # is received.
+    def loop
+      catch :exit do
+        read while true
+      end
+    end
+
+    # Public: Reads, evaluates, and prints a line of Ruby code. If the line is
+    # `exit` or `quit`, an `exit` signal is sent and the loop terminates. If an
+    # interrupt is sent via Control-C, a blank line is printed before exiting.
+    # Multiple lines of code may be evaluated by terminating each line with an
+    # escape character (`\`).
+    def read(prompt = @name)
+      @error = nil
+      @input = Readline.readline("#{prompt}> ", true)
+      throw :exit if @input.nil? || %w{exit quit}.include?(@input)
+      unless @input.empty?
+        @statements << @input
+        if @statements.last[-1] == "\\"
+          @statements.last.chop!
+          read ?. * @name.size
+        else
+          @input = @statements.join($/)
+          @statements.clear
+          evaluate @input
+          print @result
+        end
+      end
+    rescue Interrupt
+      puts
+    end
+
+    # Public: Evaluates a line of code in the current context. If an error was
+    # raised, the stack trace is printed. To reduce noise, all lines containing
+    # the current file name are removed.
+    def evaluate(value)
+      @result = eval(value, @context.instance_eval { binding }, "(#{@name})", @line)
+      @context.instance_variable_set(:@_, REPL.messenger.result)
+    rescue Exception => exception
+      @error = true
+      stack = exception.backtrace.take_while { |line| not line.include? File.basename(__FILE__) }
+      stack.unshift exception.message
+      warn %Q{#{exception.class}: #{stack.join($/ + " " * 4)}}
+    ensure
+      @line += 1
+    end
+
+    # Public: Prints the last output, prepending the output symbol to a
+    # human-readable representation of the result.
+    def print(result)
+      puts "=> #{result.inspect}" unless @error
+    end
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: pal
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Kit Cambridge
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-24 00:00:00.000000000 Z
+dependencies: []
+description: Pal is a miniature Ruby REPL, similar to IRB. It's useful for creating
+  project-specific shells.
+email: kitcambridge@me.com
+executables:
+- pal
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/pal
+- lib/pal.rb
+homepage: http://github.com/kitcambridge/pal
+licenses:
+- MIT
+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.11
+signing_key: 
+specification_version: 3
+summary: A miniature Ruby shell.
+test_files: []