sketches 0.1.0

data/History.txt

@@ -0,0 +1,8 @@
+=== 0.1.0 / 2009-04-29
+
+* Initial release:
+  * Spawn an editor of your choosing from IRB.
+  * Automatically reload your code when it changes.
+  * Use a custom editor command.
+  * Use a custom temp directory to store sketches in.
+

data/Manifest.txt

@@ -0,0 +1,16 @@
+History.txt
+Manifest.txt
+Rakefile
+README.txt
+lib/sketches.rb
+lib/sketches/exceptions.rb
+lib/sketches/exceptions/unknown_sketch.rb
+lib/sketches/exceptions/editor_not_defined.rb
+lib/sketches/config.rb
+lib/sketches/temp_sketch.rb
+lib/sketches/sketch.rb
+lib/sketches/extensions.rb
+lib/sketches/extensions/kernel.rb
+lib/sketches/cache.rb
+lib/sketches/sketches.rb
+lib/sketches/version.rb

data/README.txt

@@ -0,0 +1,86 @@
+= Sketches
+
+* http://sketches.rubyforge.org/
+* http://github.com/postmodern/sketches/
+* Postmodern (postmodern.mod3 at gmail.com)
+
+== DESCRIPTION:
+
+Sketches allows you to create and edit Ruby code from the comfort of your
+editor, while having it safely reloaded in IRB whenever changes to the
+code are saved.
+
+== FEATURES:
+
+* Spawn an editor of your choosing from IRB.
+* Automatically reload your code when it changes.
+* Use a custom editor command.
+* Use a custom temp directory to store sketches in.
+
+== INSTALL:
+
+  $ sudo gem install sketches
+
+Then require sketches in your <tt>.irbrc</tt> file:
+
+  require 'sketches'
+
+Sketches can be configured to use a custom editor command:
+
+  Sketches.config :editor => 'gvim'
+
+  Sketches.config :editor => lambda { |path|
+    "xterm -fg gray -bg black -e vim #{path} &"
+  }
+
+== EXAMPLES:
+
+* Open a new sketch:
+
+    sketch
+
+* Open a new named sketch:
+
+    sketch :foo
+
+* Open a sketch from an existing file:
+
+    sketch_from 'path/to/bar.rb'
+
+* Reopen an existing sketch:
+
+    sketch 2
+
+    sketch :foo
+
+* List all sketches:
+
+    sketches
+
+* Name a sketch:
+
+    name_sketch 2, :foo
+
+* Save a sketch to an alternant location:
+
+    save_sketch :foo, 'path/to/foo.rb'
+
+== LICENSE:
+
+Sketches - A Ruby library for live programming and code reloading.
+
+Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

data/Rakefile

@@ -0,0 +1,12 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/sketches/version.rb'
+
+Hoe.new('sketches', Sketches::VERSION) do |p|
+  p.rubyforge_name = 'sketches'
+  p.developer('Postmodern','postmodern.mod3@gmail.com')
+end
+
+# vim: syntax=Ruby

data/lib/sketches.rb

@@ -0,0 +1,25 @@
+#
+#--
+# Sketches - A Ruby library for live programming and code reloading.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+require 'sketches/extensions'
+require 'sketches/sketches'
+require 'sketches/version'

data/lib/sketches/cache.rb

@@ -0,0 +1,164 @@
+#
+#--
+# Sketches - A Ruby library for live programming and code reloading.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+require 'sketches/exceptions/unknown_sketch'
+require 'sketches/config'
+require 'sketches/sketch'
+
+require 'thread'
+
+module Sketches
+  class Cache < Hash
+
+    #
+    # Creates a new Sketches cache.
+    #
+    def initialize
+      @mutex = Mutex.new
+
+      super()
+
+      @thread = Thread.new(self) do |cache|
+        loop do
+          cache.synchronize do
+            cache.each_sketch do |sketch|
+              sketch.synchronize do
+                sketch.reload! if sketch.stale?
+              end
+            end
+          end
+
+          sleep(Config.pause)
+        end
+      end
+    end
+
+    #
+    # Returns +true+ if the cache is still checking if any sketches have
+    # been modified, returns +false+ otherwise.
+    #
+    def running?
+      @thread.alive?
+    end
+
+    #
+    # Provides thread-safe access to the cache.
+    #
+    def synchronize(&block)
+      @mutex.synchronize(&block)
+      return nil
+    end
+
+    #
+    # Creates a new Sketch with the given _id_or_name_.
+    #
+    #   cache.new_sketch 2
+    #
+    #   cache.new_sketch :foobar
+    #
+    def new_sketch(id_or_name=nil)
+      id_or_name ||= next_id
+
+      if id_or_name.kind_of?(Integer)
+        return self[id_or_name] = Sketch.new(id_or_name)
+      else
+        id = next_id
+        name = id_or_name
+
+        return self[id] = Sketch.new(id,:name => name)
+      end
+    end
+
+    #
+    # Creates a new sketch using the existing _path_.
+    #
+    #   reuse_sketch 'path/to/foo.rb'
+    #
+    def reuse_sketch(path)
+      id = next_id
+
+      return self[id] = Sketch.new(id,:path => path)
+    end
+
+    #
+    # Finds the sketch with the specified _id_ and gives it then
+    # specified _name_.
+    #
+    #   cache.name_sketch 1, :foobar
+    #
+    def name_sketch(id,name)
+      id = id.to_i
+
+      unless has_key?(id)
+        raise(UnknownSketch,"cannot find the sketch with id: #{id}",caller)
+      end
+
+      sketch = self[id]
+      sketch.synchronize { sketch.name = name.to_sym }
+
+      return sketch
+    end
+
+    #
+    # Returns the sketch with the specified _name_.
+    #
+    #   cache.find_by_name :foobar
+    #
+    def find_by_name(name)
+      name = name.to_sym
+
+      each_value do |sketch|
+        return sketch if sketch.name == name
+      end
+
+      return nil
+    end
+
+    #
+    # Returns the sketch with the specified _id_or_name_.
+    #
+    def [](id_or_name)
+      if id_or_name.kind_of?(Integer)
+        return super(id_or_name)
+      elsif (id_or_name.kind_of?(String) || id_or_name.kind_of?(Symbol))
+        return find_by_name(id_or_name)
+      end
+    end
+
+    #
+    # Returns the next available sketch id.
+    #
+    def next_id
+      size + 1
+    end
+
+    alias each_sketch each_value
+
+    #
+    # Returns the String representation of the cache.
+    #
+    def to_s(verbose=false)
+      values.inject('') { |str,sketch| str << sketch.to_s(verbose) }
+    end
+
+  end
+end

data/lib/sketches/config.rb

@@ -0,0 +1,104 @@
+#
+#--
+# Sketches - A Ruby library for live programming and code reloading.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+require 'tmpdir'
+
+module Sketches
+  module Config
+    # Directory to store temporary sketches in
+    TMPDIR = Dir.tmpdir
+
+    # Default editor to use
+    EDITOR = ENV['EDITOR']
+
+    # Default pause between checking if sketches were modified
+    PAUSE = 3
+
+    @@sketches_editor = EDITOR
+    @@sketches_tmpdir = TMPDIR
+    @@sketches_pause = PAUSE
+
+    #
+    # Returns the directory to store temporary sketches in.
+    #
+    #   Config.tmpdir
+    #   # => "/tmp"
+    #
+    def Config.tmpdir
+      @@sketches_tmpdir
+    end
+
+    #
+    # Sets the directory to store temporary sketches in to the specified
+    # _directory_.
+    #
+    def Config.tmpdir=(directory)
+      @@sketches_tmpdir = File.expand_path(dir)
+    end
+
+    #
+    # Returns the current editor to use for editing sketches.
+    #
+    #   Config.editor
+    #   # => 'pico'
+    #
+    def Config.editor
+      @@sketches_editor
+    end
+
+    #
+    # Use the specified _new_editor_ to edit sketches. _new_editor_ may
+    # be either a String or a lambda which accepts the +path+ of the sketch
+    # and returns the command to run.
+    #
+    #   Config.editor = 'gvim'
+    #
+    #   Config.editor = lambda { |path|
+    #     "xterm -fg gray -bg black -e vim #{path} &"
+    #   }
+    #
+    def Config.editor=(new_editor)
+      @@sketches_editor = new_editor
+    end
+
+    #
+    # Returns the current number of seconds to pause in between checking
+    # if any sketches were modified.
+    #
+    #   Config.pause
+    #   # => 3
+    #
+    def Config.pause
+      @@sketches_pause
+    end
+
+    #
+    # Use the specified number of _seconds_ to pause in between checking
+    # if any sketches were modified.
+    #
+    #   Config.pause = 2
+    #
+    def Config.pause=(seconds)
+      @@sketches_pause = seconds
+    end
+  end
+end

data/lib/sketches/exceptions.rb

@@ -0,0 +1,24 @@
+#
+#--
+# Sketches - A Ruby library for live programming and code reloading.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+require 'sketches/exceptions/unknown_sketch'
+require 'sketches/exceptions/editor_not_defined'

data/lib/sketches/exceptions/editor_not_defined.rb

@@ -0,0 +1,26 @@
+#
+#--
+# Sketches - A Ruby library for live programming and code reloading.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+module Sketches
+  class EditorNotDefined < RuntimeError
+  end
+end

data/lib/sketches/exceptions/unknown_sketch.rb

@@ -0,0 +1,26 @@
+#
+#--
+# Sketches - A Ruby library for live programming.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+module Sketches
+  class UnknownSketch < StandardError
+  end
+end

data/lib/sketches/extensions.rb

@@ -0,0 +1,23 @@
+#
+#--
+# Sketches - A Ruby library for live programming and code reloading.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+require 'sketches/extensions/kernel'

data/lib/sketches/extensions/kernel.rb

@@ -0,0 +1,74 @@
+#
+#--
+# Sketches - A Ruby library for live programming.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+require 'sketches/sketches'
+
+module Kernel
+  #
+  # Edits the sketch with the specified _id_or_name_. If no sketch exists
+  # with the specified _id_or_name_, one will be created.
+  #
+  #   sketch 2
+  #
+  #   sketch :foo
+  #
+  def sketch(id_or_name=nil)
+    Sketches.sketch(id_or_name)
+  end
+
+  #
+  # Creates a new sketch using the specified _path_.
+  #
+  #   sketch_from 'path/to/foo.rb'
+  #
+  def sketch_from(path)
+    Sketches.from(path)
+  end
+
+  #
+  # Names the sketch with the specified _id_ with the specified _name_.
+  #
+  #   name_sketch 2, :foo
+  #
+  def name_sketch(id,name)
+    Sketches.name(id,name)
+  end
+
+  #
+  # Saves the sketch with the specified _id_or_name_ to the specified
+  # _path_.
+  #
+  #   save_sketch 2, 'path/to/example.rb'
+  #
+  #   save_sketch :foo, 'path/to/foo.rb'
+  #
+  def save_sketch(id_or_name,path)
+    Sketches.save(id_or_name,path)
+  end
+
+  #
+  # Print out all of the sketches.
+  #
+  def sketches
+    Sketches.print
+  end
+end

data/lib/sketches/sketch.rb

@@ -0,0 +1,185 @@
+#
+#--
+# Sketches - A Ruby library for live programming and code reloading.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+require 'sketches/exceptions/editor_not_defined'
+require 'sketches/config'
+require 'sketches/temp_sketch'
+
+require 'thread'
+require 'fileutils'
+
+module Sketches
+  class Sketch
+
+    # ID of the sketch
+    attr_reader :id
+
+    # Optional name of the sketch
+    attr_accessor :name
+
+    # Last modification time of the sketch
+    attr_reader :mtime
+
+    #
+    # Creates a new sketch object with the specified _id_ and the given
+    # _options_.
+    #
+    # _options_ may contain the following keys:
+    # <tt>:name</tt>:: The name of the sketch.
+    # <tt>:path</tt>:: The path to an existing sketch.
+    #
+    def initialize(id,options={})
+      @id = id
+      @name = options[:name]
+
+      @mtime = Time.now
+      @checksum = 0
+      @mutex = Mutex.new
+
+      if options[:path]
+        @path = options[:path]
+        @name ||= File.basename(@path)
+      else
+        TempSketch.open { |file| @path = file.path }
+      end
+
+      reload!
+    end
+
+    #
+    # Provides thread-safe access to the sketch.
+    #
+    def synchronize(&block)
+      @mutex.synchronize(&block)
+      return nil
+    end
+
+    #
+    # Spawns the Sketches.editor with the path of the sketch.
+    #
+    def edit
+      if Config.editor.nil?
+        raise(EditorNotDefined,"no editor has defined via ENV['EDITOR'] or Sketches.config",caller)
+      elsif Config.editor.kind_of?(Proc)
+        cmd = Config.editor.call(@path)
+      else
+        cmd = "#{Config.editor} #{@path}"
+      end
+
+      system(cmd)
+    end
+
+    #
+    # Returns +true+ if the sketch has become stale and needs reloading,
+    # returns +false+ otherwise.
+    #
+    def stale?
+      if File.file?(@path)
+        if File.mtime(@path) > @mtime
+          return crc32 != @checksum
+        end
+      end
+
+      return false
+    end
+
+    #
+    # Reloads the sketch.
+    #
+    def reload!
+      if File.file?(@path)
+        @mtime = File.mtime(@path)
+        @checksum = crc32
+
+        begin
+          return load(@path)
+        rescue LoadError => e
+          STDERR.puts "#{e.class}: #{e.message}"
+        end
+      end
+
+      return false
+    end
+
+    #
+    # Saves the sketch to the specified _path_.
+    #
+    def save(path)
+      if (File.file?(@path) && @path != path)
+        FileUtils.cp(@path,path)
+        return true
+      end
+
+      return false
+    end
+
+    #
+    # Returns the String representation of the sketch.
+    #
+    def to_s(verbose=false)
+      str = "##{@id}"
+      str << ": #{@name}" if @name
+      str << "\n\n"
+
+      if File.file?(@path)
+        File.open(@path) do |file|
+          unless verbose
+            4.times do
+              if file.eof?
+                str << "\n" unless str[-1..-1] == "\n"
+                str << "  ..."
+                break
+              end
+
+              str << "  #{file.readline}"
+            end
+          else
+            file.each_line { |line| str << "  #{line}" }
+          end
+
+          str << "\n"
+        end
+      end
+
+      return str
+    end
+
+    protected
+
+    #
+    # Returns the CRC32 checksum of the sketch file.
+    #
+    def crc32
+      r = 0xffffffff
+
+      File.open(@path) do |file|
+        file.each_byte do |b|
+          r ^= b
+          8.times { r = ((r >> 1) ^ (0xEDB88320 * (r & 1))) }
+        end
+      end
+
+      return r ^ 0xffffffff
+    end
+
+  end
+end

data/lib/sketches/sketches.rb

@@ -0,0 +1,135 @@
+#
+#--
+# Sketches - A Ruby library for live programming and code reloading.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+require 'sketches/config'
+require 'sketches/cache'
+
+module Sketches
+  #
+  # Configure Sketches with the given _options_.
+  #
+  # _options_ may contain the following keys:
+  # <tt>:tmpdir</tt>:: Directory to store temporary sketches in.
+  #                    Defaults to Dir.tmpdir if unspecified.
+  # <tt>:editor</tt>:: The editor to use to edit sketches.
+  # <tt>:pause</tt>:: The number of seconds to pause in-between
+  #                   checking if any sketches were modified.
+  #
+  #   Sketches.config :editor => 'gvim', :pause => 2
+  #
+  #   Sketches.config :editor => lambda { |path|
+  #     "xterm -fg gray -bg black -e vim #{path} &"
+  #   }
+  #
+  def Sketches.config(options={})
+    if options[:tmpdir]
+      Config.tmpdir = options[:tmpdir]
+    end
+
+    if options[:editor]
+      Config.editor = options[:editor]
+    end
+
+    if options[:pause]
+      Config.pause = options[:pause]
+    end
+
+    return nil
+  end
+
+  @@sketches_cache = nil
+
+  #
+  # The cache of sketches.
+  #
+  def Sketches.cache
+    unless @@sketches_cache
+      @@sketches_cache = Cache.new
+    end
+
+    return @@sketches_cache
+  end
+
+  #
+  # Edits the sketch with the specified _id_or_name_. If no sketch exists
+  # with the specified _id_or_name_, one will be created.
+  #
+  #   Sketches.sketch 2
+  #
+  #   Sketches.sketch :foo
+  #
+  def Sketches.sketch(id_or_name)
+    Sketches.cache.synchronize do
+      sketch = Sketches.cache[id_or_name]
+      sketch ||= Sketches.cache.new_sketch(id_or_name)
+
+      sketch.synchronize { sketch.edit }
+    end
+  end
+
+  #
+  # Creates a new sketch using the specified _path_.
+  #
+  #   Sketches.from 'path/to/foo.rb'
+  #
+  def Sketches.from(path)
+    Sketches.cache.synchronize do
+      sketch = Sketches.cache.reuse_sketch(path)
+
+      sketch.synchronize { sketch.edit }
+    end
+  end
+
+  #
+  # Names the sketch with the specified _id_ with the specified _name_.
+  #
+  #   Sketches.name 2, :foo
+  #
+  def Sketches.name(id,name)
+    Sketches.cache.synchronize do
+      Sketches.cache.name_sketch(id,name)
+    end
+  end
+
+  #
+  # Saves the sketch with the specified _id_or_name_ to the specified
+  # _path_.
+  #
+  #   Sketches.save 2, 'path/to/example.rb'
+  #
+  #   Sketches.save :foo, 'path/to/foo.rb'
+  #
+  def Sketches.save(id_or_name,path)
+    Sketches.cache.synchronize do
+      if (sketch = Sketches.cache[id_or_name])
+        sketch.save(path)
+      end
+    end
+  end
+
+  #
+  # Print out all of the sketches.
+  #
+  def Sketches.print
+    Sketches.cache.synchronize { puts Sketches.cache }
+  end
+end

data/lib/sketches/temp_sketch.rb

@@ -0,0 +1,52 @@
+#
+#--
+# Sketches - A Ruby library for live programming and code reloading.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+require 'sketches/config'
+
+require 'tempfile'
+
+module Sketches
+  class TempSketch < Tempfile
+
+    # Basename to use for temp sketches
+    BASENAME = 'sketch'
+
+    # Extension to use for temp sketches
+    EXT = '.rb'
+
+    #
+    # Create a new TempSketch object.
+    #
+    def initialize
+      super(BASENAME,Config.tmpdir)
+    end
+
+    private
+
+    def make_tmpname(basename,n)
+      prefix, suffix = basename, EXT
+
+      t = Time.now.strftime("%Y%m%d")
+      return "#{prefix}#{t}-#{$$}-#{rand(0x100000000).to_s(36)}-#{n}#{suffix}"
+    end
+  end
+end

data/lib/sketches/version.rb

@@ -0,0 +1,26 @@
+#
+#--
+# Sketches - A Ruby library for live programming and code reloading.
+#
+# Copyright (c) 2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+#Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+module Sketches
+  # Sketches version
+  VERSION = '0.1.0'
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification 
+name: sketches
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Postmodern
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-27 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.12.2
+    version: 
+description: Sketches allows you to create and edit Ruby code from the comfort of your editor, while having it safely reloaded in IRB whenever changes to the code are saved.
+email: 
+- postmodern.mod3@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- Rakefile
+- README.txt
+- lib/sketches.rb
+- lib/sketches/exceptions.rb
+- lib/sketches/exceptions/unknown_sketch.rb
+- lib/sketches/exceptions/editor_not_defined.rb
+- lib/sketches/config.rb
+- lib/sketches/temp_sketch.rb
+- lib/sketches/sketch.rb
+- lib/sketches/extensions.rb
+- lib/sketches/extensions/kernel.rb
+- lib/sketches/cache.rb
+- lib/sketches/sketches.rb
+- lib/sketches/version.rb
+has_rdoc: true
+homepage: http://sketches.rubyforge.org/
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: sketches
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Sketches allows you to create and edit Ruby code from the comfort of your editor, while having it safely reloaded in IRB whenever changes to the code are saved.
+test_files: []
+