when-files-change 0.2

data/README.markdown

@@ -0,0 +1,30 @@
+When Files Change
+=================
+
+Do something when files change, it's that simple.
+
+When files change, run my tests:
+
+    when-files-change -- rake test
+
+When files change, build my css assets:
+
+    when-files-change -- make
+
+When files change, make me a sandwich:
+
+    when-files-change -- sudo make-me-a-sandwhich
+    
+By default `when-files-change` ignores log folders, hidden files in your root, and source control directories.  You can explicitly list any other files you want to ignore:
+
+    when-files-change --ignore 'build' -- make
+
+To quit press CTRL-D or CTRL-C.  To force the command to be run, press Enter.
+
+That's about all there is to it.  Most of the credit for this tool goes to the [guard/listen](https://github.com/guard/listen) library since it does all leg work.  `when-files-change` just wraps it in an easy to use command.
+
+Used with a build tool like Rake, Make, or some other *ake, you can save yourself a lot of time and hassle.  If this doesn't suit your needs, take a look at [Guard](https://github.com/guard/guard) or [Watchr](https://github.com/bevry/watchr), both projects allow special rules for processing various types of events.
+
+-----
+
+Adam Sanderson, http://www.monkeyandcrow.com

data/bin/when-files-change

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require File.dirname(__FILE__) + '/../lib/change_listener'
+
+# Options
+ignored_paths = nil
+
+opts = OptionParser.new do |opts|    
+  opts.banner = "Usage: #{File.basename($0)} [options] -- command [arguments]"
+  opts.separator ""
+  
+  opts.on("-i", "--ignore PATHS", Array, "Ignore changes made at these paths") do |paths|
+    ignore_paths = paths
+  end
+  opts.parse! ARGV
+end
+
+command = ARGV.shift
+unless command
+  puts opts
+  exit 1 
+end
+
+listener = ChangeListener.new(command, *ARGV)
+listener.ignore_paths(ignored_paths) if ignored_paths
+listener.start
+
+# Catch signals so we can exit gracefully
+trap('SIGINT' ){ puts; exit 1 }
+trap('SIGQUIT'){ puts; exit 1 }
+
+# Wait for a ctrl-d to quit
+while char = STDIN.getc
+  listener.execute if char == "\n"
+end

data/lib/change_listener.rb

@@ -0,0 +1,36 @@
+require 'listen'
+require 'file_glob'
+
+class ChangeListener
+  attr_reader :listener
+  attr_reader :command
+  attr_reader :arguments
+  
+  def initialize(command, *arguments)
+    @command   = command
+    @arguments = arguments
+    @listener  = Listen.to('./').ignore(/^\.\w+/)
+    
+    @listener.change{ execute }
+  end
+  
+  def start
+    listener.start(false)
+  end
+  
+  def execute
+    listener.pause
+    Kernel.system(command, *arguments)
+    listener.unpause
+  end
+  
+  def ignore(*regexps)
+    @listener.ignore(*regexps)
+  end
+  
+  def ignore_path(*paths)
+    globs = paths.map{|p| FileGlob.new(p)}
+    
+    @listener.ignore(*globs)
+  end
+end

data/lib/file_glob.rb

@@ -0,0 +1,19 @@
+class FileGlob
+  attr_reader :pattern
+  
+  def initialize(pattern)
+    @pattern = pattern
+  end
+  
+  def =~ path
+    File.fnmatch?(pattern, path)
+  end
+  
+  def to_s
+    pattern
+  end
+  
+  def inspect
+    "<#FileGlob #{pattern}>"
+  end
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: when-files-change
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  version: "0.2"
+platform: ruby
+authors: 
+- Adam Sanderson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-02-26 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: listen
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 7
+        version: "0.7"
+  type: :runtime
+  version_requirements: *id001
+description: Whenever files in your working directory change, execute a command, such as "rake test".
+email: 
+- netghost@gmail.com
+executables: 
+- when-files-change
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/when-files-change
+- lib/change_listener.rb
+- lib/file_glob.rb
+- README.markdown
+has_rdoc: true
+homepage: https://github.com/adamsanderson/when-files-change
+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: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: When files change, do something.
+test_files: []
+