rsanheim-beholder 0.5.5

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008-2009 Chad Humphries
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.textile

@@ -0,0 +1,65 @@
+h1. Beholder
+
+An ancient beholder that watches your treasure, and deals with thiefs.
+
+h2. What does it do?
+
+Think autotest, but powered by fseventd.
+
+h2. Requirements
+
+# OSX 10.5 or higher
+# RubyCocoa
+# fsevents gem
+
+
+
+The default treasure map:
+
+map_for(:default_dungeon) do |wizard|
+  
+  wizard.keep_a_watchful_eye_for 'app', 'config', 'lib', 'examples'
+ 
+  wizard.prepare_spell_for /\/app\/(.*)\.rb/ do |spell_component|
+    ["examples/#{spell_component[1]}.rb"]
+  end
+  
+  wizard.prepare_spell_for /\/lib\/(.*)\.rb/ do |spell_component|
+    ["examples/lib/#{spell_component[1]}_example.rb"]
+  end
+  
+  wizard.prepare_spell_for /\/examples\/(.*)_example\.rb/ do |spell_component|
+    ["examples/#{spell_component[1]}_example.rb"]
+  end
+  
+  wizard.prepare_spell_for /\/examples\/example_helper\.rb/ do |spell_component|
+    Dir["examples/**/*_example.rb"]
+  end
+
+  wizard.prepare_spell_for /\/config/ do
+    Dir["examples/**/*_example.rb"]
+  end
+
+end
+
+
+In your own treasure map (stored as treasure_map.rb, .treasure_map.rb, or config/treasure_map.rb) you could do:
+
+map_for(:beholders_lair) do |wizard|
+  
+  # Clear all watched paths => wizard.paths_to_watch.clear
+  # Add these paths to the paths to watch
+  wizard.keep_a_watchful_eye_for 'coverage'
+  
+  # Forget all other treasure maps loaded
+  # wizard.clear_maps
+ 
+  # Add your own rules
+  # wizard.prepare_spell_for /\/foobar/ do
+  #   Dir["examples/foobar/*_example.rb"]
+  # end
+
+  # You could set the list of all examples to be run after pressing ctrl-c once
+  # it defaults to any files in examples, spec, and test
+  wizard.all_examples = Dir['your/path/**/*_here.rb']
+end

data/Rakefile

@@ -0,0 +1,66 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'rubygems/specification'
+require 'date'
+require 'micronaut/rake_task'
+
+GEM = "beholder"
+GEM_VERSION = "0.5.5"
+AUTHOR = "Chad Humphries"
+EMAIL = "chad@spicycode.com"
+HOMEPAGE = "http://github.com/spicycode/beholder"
+SUMMARY = "An ancient beholder that watches your treasure, and deals with thiefs"
+
+spec = Gem::Specification.new do |s|
+  s.name = GEM
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README.textile", "LICENSE", 'TODO']
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  s.add_dependency "fsevents"
+  s.bindir = 'bin'
+  s.default_executable = 'beholder'
+  s.executables = ["beholder"]
+  s.require_path = 'lib'
+  s.autorequire = GEM
+  s.files = %w(LICENSE README.textile Rakefile TODO) + Dir.glob("{lib,examples}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "install the gem locally"
+task :install => [:package] do
+  sh %{sudo gem install pkg/#{GEM}-#{GEM_VERSION}}
+end
+
+desc "create a gemspec file"
+task :make_gemspec do
+  File.open("#{GEM}.gemspec", "w") do |file|
+    file.puts spec.to_ruby
+  end
+end
+
+desc "Run all micronaut examples"
+Micronaut::RakeTask.new :examples do |t|
+  t.pattern = "examples/**/*_example.rb"
+end
+
+namespace :examples do
+  
+  desc "Run all micronaut examples using rcov"
+  Micronaut::RakeTask.new :coverage do |t|
+    t.pattern = "examples/**/*_example.rb"
+    t.rcov = true
+    t.rcov_opts = "--exclude \"examples/*,gems/*,db/*,/Library/Frameworks/*,/Library/Ruby/*,config/*\" --text-summary  --sort coverage --no-validator-links" 
+  end
+
+end
+
+task :default => 'examples:coverage'

data/TODO

@@ -0,0 +1 @@
+TODO:

data/bin/beholder

@@ -0,0 +1,4 @@
+#! /usr/bin/env ruby
+$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + '/../lib'))
+require 'beholder'
+Beholder.run

data/examples/example_helper.rb

@@ -0,0 +1,17 @@
+lib_path = File.expand_path(File.dirname(__FILE__) + "/../lib")
+$LOAD_PATH.unshift lib_path unless $LOAD_PATH.include?(lib_path)
+
+require 'beholder'
+require 'rubygems'
+require 'micronaut'
+gem :rr, '=0.7.0'
+
+def not_in_editor?
+  ['TM_MODE', 'EMACS', 'VIM'].all? { |k| !ENV.has_key?(k) }
+end
+
+Micronaut.configure do |c|
+  c.formatter = :documentation
+  c.mock_with :rr
+  c.color_enabled = not_in_editor?  
+end

data/examples/lib/beholder_example.rb

@@ -0,0 +1,84 @@
+require File.expand_path(File.dirname(__FILE__) + "/../example_helper")
+
+describe Beholder do
+
+  describe "when run is called" do
+    
+    it "should create a new beholder" do
+      beholder = stub(Beholder.new) { prepare; start }
+      mock(Beholder).new { beholder }
+      
+      Beholder.run
+    end
+    
+    it "should prepare" do
+      beholder = Beholder.new 
+      stub(beholder).start
+      mock(beholder).prepare
+      stub(Beholder).new { beholder }
+      
+      Beholder.run
+    end
+    
+    it "should start" do
+      beholder = Beholder.new 
+      mock(beholder).start
+      stub(beholder).prepare
+      stub(Beholder).new { beholder }
+      
+      Beholder.run
+    end
+    
+  end
+  
+  describe "when it notices file(s) changed" do
+    
+    it "should identify what was changed" do
+      treasures = ['pot_o_gold'] 
+      beholder = Beholder.new
+      mock(beholder).identify_stolen_treasure('pot_o_gold') { nil }
+      beholder.something_changed treasures
+    end
+    
+    it "should run tests for the file that changed" do
+      treasures = ['pot_o_gold'] 
+      beholder = Beholder.new
+      stub(beholder).identify_stolen_treasure('pot_o_gold') { 'x marks the spot' }
+      mock(beholder).run_tests(['x marks the spot'])
+      beholder.something_changed treasures
+    end
+    
+  end
+  
+  describe "when blinking it's eye" do
+    
+    it "should forget about any interlopers" do
+      beholder = Beholder.new
+      beholder.instance_variable_set("@sent_an_int", true) # Not so hot, but I'm tired
+
+      beholder.sent_an_int.should be_true
+      beholder.blink
+      beholder.sent_an_int.should be_false
+    end
+    
+  end
+  
+  describe "when shutting down" do
+    
+    it "should stop watching for changes"  do
+      beholder = Beholder.new
+      stub(beholder).exit
+      stub(beholder).watcher { mock!.shutdown }
+      beholder.shutdown
+    end
+    
+    it "should exit" do
+      beholder = Beholder.new
+      stub(beholder).watcher { stub!.shutdown }
+      mock(beholder).exit
+      beholder.shutdown
+    end
+    
+  end
+  
+end

data/lib/beholder.rb

@@ -0,0 +1,165 @@
+require 'rubygems'
+gem :fsevents
+require 'fsevents'
+
+class Beholder
+
+  attr_reader :paths_to_watch, :sent_an_int, :mappings, :working_directory, :verbose
+  attr_reader :watcher, :treasure_maps, :possible_map_locations, :all_examples
+  
+  def initialize
+    @paths_to_watch, @all_examples = [], []
+    @mappings, @treasure_maps = {}, {}
+    @sent_an_int = false
+    @working_directory = Dir.pwd
+    @verbose = ARGV.include?("-v") || ARGV.include?("--verbose")
+    @possible_map_locations = ["#{@working_directory}/.treasure_map.rb", "#{@working_directory}/treasure_map.rb", "#{@working_directory}/config/treasure_map.rb"]
+  end
+
+  def self.run
+    beholder = new
+    beholder.read_all_maps
+    beholder.set_all_examples if beholder.all_examples.empty?
+    beholder.prepare    
+    beholder.start
+  end
+
+  def read_all_maps
+    read_default_map
+
+    possible_map_locations.each do |map_location|
+      if File.exist?(map_location)
+        say "Found a treasure map at #{map_location}"
+        instance_eval(File.readlines(map_location).join("\n"))
+        return
+      end
+    end
+  end
+
+  def prepare
+    trap 'INT' do
+      if @sent_an_int then      
+        puts "   A second INT?  Ok, I get the message.  Shutting down now."
+        shutdown
+      else
+        puts "   Did you just send me an INT? Ugh.  I'll quit for real if you do it again."
+        @sent_an_int = true
+        Kernel.sleep 1.5
+        run_tests all_examples
+      end
+    end
+  end    
+
+  def start
+    say("Watching the following locations:\n  #{paths_to_watch.join(", ")}")
+    @watcher = FSEvents::Stream.watch(paths_to_watch) do |treasure_chest|
+      something_changed(treasure_chest.modified_files)
+      puts "\n\nWaiting to hear from the disk since #{Time.now}"
+    end
+    @watcher.run
+  end    
+  
+  def read_default_map
+    map_for(:default) do |m|
+
+      m.watch 'lib', 'examples'
+
+      m.add_mapping %r%examples/(.*)_example\.rb% do |match|
+        ["examples/#{match[1]}_example.rb"]
+      end
+
+      m.add_mapping %r%examples/example_helper\.rb% do |match|
+        Dir["examples/**/*_example.rb"]
+      end
+
+      m.add_mapping %r%lib/(.*)\.rb% do |file|
+        ["examples/lib/#{match[1]}_example.rb"]
+      end
+
+    end
+  end
+
+  def map_for(map_name)
+    @treasure_maps[map_name] ||= []
+    @current_map = @treasure_maps[map_name]
+    yield self if block_given?
+  ensure
+    @current_map = nil
+  end
+
+  def add_mapping(arcane_enemy, &spell)
+    @current_map << [arcane_enemy, spell]
+  end
+
+  def clear_maps
+    @treasure_maps = {}
+  end
+  
+  def set_all_examples
+    if paths_to_watch.include?('examples')
+      @all_examples += Dir['examples/**/*_example.rb']
+    end
+    
+    if paths_to_watch.include?('test')
+      @all_examples += Dir['test/**/*_test.rb']
+    end
+    
+    if paths_to_watch.include?('spec')
+      @all_examples += Dir['spec/**/*_spec.rb']
+    end
+  end
+
+  def watch(*paths)
+    @paths_to_watch.concat(paths)
+  end
+
+  def blink
+    @sent_an_int = false
+  end
+
+  def shutdown
+    watcher.shutdown
+    exit
+  end
+
+  def identify_stolen_treasure(treasure)
+    treasure_maps.each do |name, treasure_locations|
+      treasure_locations.each do |stolen_by_enemy, spell| 
+        if spell_components = treasure.match(stolen_by_enemy)
+          say "Found the stolen treasure using the #{name} map "
+          return spell.call(spell_components)
+        end
+      end
+    end
+
+    puts "Unknown file: #{treasure}"
+    return []
+  end
+
+  def run_tests(coordinates)
+    coordinates.flatten!
+
+    coordinates.reject! do |coordinate|
+      found_treasure = File.exist?(coordinate)
+      puts "#{coordinate} does not exist." unless found_treasure
+    end
+
+    return if coordinates.empty?
+
+    puts "\nRunning #{coordinates.join(', ').inspect}" 
+    system "ruby #{coordinates.join(' ')}"
+    blink
+  end
+
+  def something_changed(treasure)
+    say "#{treasure} changed" unless treasure.empty?
+    coordinates = treasure.map { |t| identify_stolen_treasure(t) }.uniq.compact
+    run_tests coordinates
+  end
+
+  private
+  def say(msg)
+    puts msg if verbose
+  end
+
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification 
+name: rsanheim-beholder
+version: !ruby/object:Gem::Version 
+  version: 0.5.5
+platform: ruby
+authors: 
+- Chad Humphries
+autorequire: beholder
+bindir: bin
+cert_chain: []
+
+date: 2009-02-27 00:00:00 -08:00
+default_executable: beholder
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: fsevents
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: An ancient beholder that watches your treasure, and deals with thiefs
+email: chad@spicycode.com
+executables: 
+- beholder
+extensions: []
+
+extra_rdoc_files: 
+- README.textile
+- LICENSE
+- TODO
+files: 
+- LICENSE
+- README.textile
+- Rakefile
+- TODO
+- lib/beholder.rb
+- examples/example_helper.rb
+- examples/lib
+- examples/lib/beholder_example.rb
+- bin/beholder
+has_rdoc: true
+homepage: http://github.com/spicycode/beholder
+post_install_message: 
+rdoc_options: []
+
+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: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: An ancient beholder that watches your treasure, and deals with thiefs
+test_files: []
+