simple_test_runner 0.6.0-x86-linux

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.simpletestrunnerrc

data/.rvmrc

@@ -0,0 +1 @@
+rvm gemset use 'simple_test_runner'

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in simpletestrunner.gemspec
+gemspec

data/README.md

@@ -0,0 +1,64 @@
+# simple_test_runner is a very simple replacement for autotest.
+
+## Using simple_test_runner
+
+Running simple_test_runner without any options will print out this message:
+
+    Usage: simple_test_runner [options]
+    -c, --command COMMAND            Command to run
+    -d, --dirs x,y,z                 example 'list' of arguments
+    -f, --fake                       Fake run: don't actually monitor the dirs
+    -h, --help                       Print out this message
+    -s, --show                       Show the current configuration
+
+
+So, to run all specs when files in the app/ or lib/ directories are updated:
+
+    simple_test_runner -d app,lib -c "rspec spec"
+
+
+## But why?
+
+"But why?" I hear you ask.
+
+Autotest is great. But ... it can be overkill. And it polls your files for changes. Every second. Yes, with extra helpers it can run without polling. But then there's the configuration.
+
+And the configuration is ... touchy. Unseen things lurk in the background. Doing things for you. "Helping" you. 
+
+After hours of tracking down scattered documentation for obscure bugs, after walking through autotest's source code to identify just where the hell it was doing things and what it was doing, I snapped.
+
+And I wrote this.
+
+The idea is to keep it simple. You tell testRuner which directories to watch for changes, and what command to run when changes happen. And that's all.
+
+Any time a file in the watched directory changes, the command is run.
+
+To quit, type control-c in the terminal running the program, and wait for the next directory change to wake it up. Kinda klunky, I know. If anyone knows a better way to handle it, I'm all ears.
+
+## Installation
+
+* Get 
+
+    git clone git://github.com/Jeff-R/simple_test_runner.git
+
+* Build 
+
+    cd simple_test_runner
+    rake build
+
+* Install (with rvm)
+
+    rvm use gemset global
+    rake install
+
+* Install (without rvm)
+
+    sudo gem install pkg/simple_test_runner_x.gem
+
+
+
+## System requirements
+
+At the moment, simple_test_runner only runs on Linux, because it uses the Linux kernel's INotify feature. I'd love to have it be extended for different platforms, but I'll need help for that.
+
+

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/bin/simple_test_runner

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+require 'fileutils'
+
+$: << File.expand_path(File.dirname(__FILE__) + "/../lib")
+
+require "simple_test_runner"
+
+runner = SimpleTestRunner::TestRunner.new ARGV
+runner.run
+

data/lib/runner_opts.rb

@@ -0,0 +1,123 @@
+require 'optparse'
+require 'ostruct'
+require 'yaml'
+
+module SimpleTestRunner
+  class RunnerOpts
+    def initialize(args, path="")
+      @parsed = OpenStruct.new
+      parse(args)
+      # if not path == ""
+      #   @parsed.dirs_to_monitor = ""
+      # end
+    end
+
+    def load_yaml yaml_string
+      yaml = YAML::load(yaml_string)
+
+      @parsed.command  = yaml["command"]
+      puts "load_yaml: yaml = #{yaml.inspect}"
+    end
+
+    def to_yaml
+      "command: echo 'hello'"
+    end
+
+    def config_file_name= filename
+      @parsed.config_file_name = filename
+    end
+
+    def parsed= val
+      @parsed = val
+    end
+
+    def parsed
+      @parsed
+    end
+
+    def save_to_file
+      File.open(@parsed.config_file_name, 'w+') do |file|
+        file.puts to_yaml
+      end
+    end
+
+    def load_config_file 
+      yaml = File.new(config_file_name).read
+      load_yaml yaml
+    end
+
+    def config_file_name 
+      ".simpletestrunnerrc"
+    end
+
+    def configfileok
+      File.exists? config_file_name
+    end
+
+    def print_usage
+      puts @optionParser
+    end
+
+    def show_config
+      puts "Configuration:"
+      puts "config file:     \"#{config_file_name}\""
+      puts "dirs to monitor: #{@parsed.dirs_to_monitor.inspect}"
+      puts "command to run:  \"#{@parsed.command_str}\""
+      puts "fake run:        #{@parsed.fake}"
+    end
+
+    def parse args
+      @parsed.verbose          ||= false
+      @parsed.make_config_file ||= false
+      @parsed.show_config      ||= false
+      @parsed.dirs_to_monitor  ||= []
+      @parsed.ok               ||= false
+      @parsed.command_str      ||= "echo 'Dir changed'"
+      @parsed.fake             ||= false
+
+      @optionParser = OptionParser.new do |opts|
+        opts.banner = "Usage: simple_test_runner [options]"
+
+        # Command to run
+        opts.on("-c", "--command COMMAND", String, "Command to run") do |commandstr|
+          @parsed.command_str = commandstr
+          @parsed.ok = true
+        end
+
+        # Create a config file
+        # opts.on("-C", "--configfile", "create a config file") do 
+        #   @parsed.make_config_file = true
+        #   @parsed.ok = true
+        # end
+
+        # List of dirs.
+        opts.on("-d", "--dirs x,y,z", Array, "example 'list' of arguments") do |list|
+          @parsed.dirs_to_monitor = list
+          @parsed.ok = true
+        end
+
+        # fake run
+        opts.on("-f", "--fake", "Fake run: don't actually monitor the dirs") do 
+          @parsed.fake = true
+        end
+
+        # show help
+        opts.on('-h', "--help", "Print out this message") do |url|
+          puts opts
+          @parsed.ok = true
+        end
+
+        # Show configuration
+        opts.on('-s', '--show', 'Show the current configuration') do |password|
+          @parsed.show_config = true
+          @parsed.ok = true
+        end
+
+      end
+
+      @optionParser.parse!(args)
+      @parsed
+    end
+
+  end
+end

data/lib/simple_test_runner/version.rb

@@ -0,0 +1,3 @@
+module SimpleTestRunner
+  VERSION = "0.6.0"
+end

data/lib/simple_test_runner.rb

@@ -0,0 +1,94 @@
+#!/home/jeff/.rvm/rubies/ruby-1.9.2-p0/bin/ruby
+require "rubygems"
+require "bundler/setup"
+require_relative 'runner_opts'
+require 'rb-inotify'
+
+require 'io/wait'   # for io.ready?
+
+# Bundler.require        # See http://technotales.wordpress.com/2010/08/22/bundler-without-rails/
+
+# code originally swiped shamelessly from https://github.com/ewollesen/autotest-inotify/blob/master/lib/autotest/inotify.rb
+# Mostly morphed since then ...
+
+module SimpleTestRunner
+
+  class TestRunner
+
+    def initialize args = []
+      @args = args
+    end
+
+    def make_config_file
+      if File.exists? @options.config_file_name
+        puts "Are you sure? (y for yes)"
+        a = gets.strip.downcase
+        return unless a == "y"
+      end
+      File.open(@options.config_file_name, 'w+') do |file| 
+        file.puts @options.to_yaml
+      end
+    end
+
+    def run
+      if not running_linux?
+        puts "Sorry. This program currently only runs in Linux."
+        puts "If you want other platforms to be supported, please help out!"
+        return
+      end
+
+      @options = RunnerOpts.new @args
+      if @options.parsed.make_config_file
+        make_config_file
+        return
+      end
+      # unless @options.configfileok
+      #   puts "Couldn't find the configuration file."
+      #   puts "  The config file is where you place the command that"
+      #   puts "  you want the program to run."
+      #   puts
+      #   puts "  It should be a text file called .simpletestrunnerrc."
+      #   puts "  To generate the file, run 'simpletestrunner -c'"
+      #   puts "  then edit it by hand."
+      #   return
+      # end
+      unless @options.parsed.ok
+        @options.print_usage
+        return
+      end
+
+      if @options.parsed.show_config
+        @options.show_config
+      end
+
+      if not @options.parsed.fake
+        if @options.parsed.dirs_to_monitor.length > 0
+          setup_monitor 
+          while not STDIN.ready?
+            @notifier.process
+          end
+        end
+      end
+    end
+
+    def running_linux?
+      /linux/i === RbConfig::CONFIG["host_os"]
+    end
+
+    def setup_monitor
+      @notifier = INotify::Notifier.new
+      @options.parsed.dirs_to_monitor.each do |dir|
+        foo = @notifier.watch(dir, :modify, :recursive) { run_command }
+      end
+    end
+
+    def event_of_interest?(flags)
+      flags.include?(:modify) || flags.include?(:moved_to)
+    end
+
+    def run_command
+        system "#{@options.parsed.command_str}"
+    end
+
+  end
+end

data/simple_test_runner.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "simple_test_runner/version"
+
+Gem::Specification.new do |s|
+  s.name        = "simple_test_runner"
+  s.version     = SimpleTestRunner::VERSION
+  s.platform    = Gem::Platform::CURRENT
+  s.authors     = ["Jeff Roush"]
+  s.email       = ["jeff@jeffroush.com"]
+  s.homepage    = "https://github.com/Jeff-R/simple_test_runner"
+  s.summary     = %q{Monitors directories; runs a command when it sees a change.}
+  s.description = %q{Very simple command-line program for Linux to monitor directories and run tests.}
+
+  s.rubyforge_project = "simple_test_runner"
+
+  s.add_dependency 'rb-inotify'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = ["simple_test_runner"]
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: simple_test_runner
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 6
+  - 0
+  version: 0.6.0
+platform: x86-linux
+authors: 
+- Jeff Roush
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-15 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rb-inotify
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: Very simple command-line program for Linux to monitor directories and run tests.
+email: 
+- jeff@jeffroush.com
+executables: 
+- simple_test_runner
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rvmrc
+- Gemfile
+- README.md
+- Rakefile
+- bin/simple_test_runner
+- lib/runner_opts.rb
+- lib/simple_test_runner.rb
+- lib/simple_test_runner/version.rb
+- simple_test_runner.gemspec
+has_rdoc: true
+homepage: https://github.com/Jeff-R/simple_test_runner
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: simple_test_runner
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Monitors directories; runs a command when it sees a change.
+test_files: []
+