guard 0.1.0.beta.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Thibaud Guillaume-Gentil
+
+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.rdoc

@@ -0,0 +1,3 @@
+= Guard
+
+Documentation is coming.

data/bin/guard

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'guard'
+require 'guard/cli'
+
+Guard::CLI.start

data/bin/inotify_watch

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'rb-inotify'
+
+folders = Array.new
+notifier = INotify::Notifier.new
+
+notifier.watch(ARGV.first || '.', :modify, :recursive) do |event|
+  dir = File.expand_path(File.dirname(event.absolute_name)) + '/'
+  if !folders.include?(dir)
+    folders << dir
+  end
+end
+
+while true do
+  notifier.process
+  
+  if !folders.empty?
+    $stdout.puts folders.join(' ')
+    $stdout.flush
+    folders.clear
+  end
+  
+  sleep(0.1)
+end

data/ext/extconf.rb

@@ -0,0 +1,18 @@
+# Workaround to make Rubygems believe it builds a native gem
+require 'mkmf'
+create_makefile('none')
+
+if `uname -s`.chomp == 'Darwin'
+  gem_root      = File.expand_path(File.join('..'))
+  darwin_verion = `uname -r`.to_i
+  sdk_verion    = { 9 => '10.5', 10 => '10.6', 11 => '10.7' }[darwin_verion]
+  
+  raise "Darwin #{darwin_verion} is not supported" unless sdk_verion
+  
+  # Compile the actual fsevent_watch binary
+  system("CFLAGS='-isysroot /Developer/SDKs/MacOSX#{sdk_verion}.sdk -mmacosx-version-min=#{sdk_verion}' /usr/bin/gcc -framework CoreServices -o '#{gem_root}/bin/fsevent_watch' fsevent/fsevent_watch.c")
+  
+  unless File.executable?("#{gem_root}/bin/fsevent_watch")
+    raise "Compilation of fsevent_watch failed (see README)"
+  end
+end

data/ext/fsevent/fsevent_watch.c

@@ -0,0 +1,44 @@
+#include <CoreServices/CoreServices.h>
+
+void callback(ConstFSEventStreamRef streamRef,
+  void *clientCallBackInfo,
+  size_t numEvents,
+  void *eventPaths,
+  const FSEventStreamEventFlags eventFlags[],
+  const FSEventStreamEventId eventIds[]
+) {
+  // Print modified dirs
+  int i;
+  char **paths = eventPaths;
+  for (i = 0; i < numEvents; i++) {
+    printf("%s", paths[i]);
+    printf(" ");
+  }
+  printf("\n");
+  fflush(stdout);
+}
+
+int main (int argc, const char * argv[]) {
+  // Create event stream
+  CFStringRef pathToWatch = CFStringCreateWithCString(kCFAllocatorDefault, argv[1], kCFStringEncodingUTF8);
+  CFArrayRef pathsToWatch = CFArrayCreate(NULL, (const void **)&pathToWatch, 1, NULL);  
+  void *callbackInfo = NULL;
+  FSEventStreamRef stream;
+  CFAbsoluteTime latency = 0.1;
+  stream = FSEventStreamCreate(
+    kCFAllocatorDefault,
+    callback,
+    callbackInfo,
+    pathsToWatch,
+    kFSEventStreamEventIdSinceNow,
+    latency,
+    kFSEventStreamCreateFlagNone
+  );
+  
+  // Add stream to run loop
+  FSEventStreamScheduleWithRunLoop(stream, CFRunLoopGetCurrent(), kCFRunLoopDefaultMode);
+  FSEventStreamStart(stream);
+  CFRunLoopRun();
+  
+  return 2;
+}

data/lib/guard.rb

@@ -0,0 +1,49 @@
+module Guard
+  
+  autoload :UI,         'guard/ui'
+  autoload :Dsl,        'guard/dsl'
+  autoload :Interactor, 'guard/interactor'
+  autoload :Listener,   'guard/listener'
+  autoload :Watcher,    'guard/watcher'
+  autoload :Notifier,   'guard/notifier'
+  
+  class << self
+    attr_accessor :options, :guards, :listener
+    
+    def start(options = {})
+      @options  = options
+      @listener = Listener.new
+      @guards   = []
+      
+      Dsl.evaluate_guardfile
+      Interactor.init_signal_traps
+      
+      listener.on_change do |files|
+        run do
+          guards.each do |guard|
+            paths = Watcher.match_files(guard, files)
+            guard.run_on_change(paths) unless paths.empty?
+          end
+        end
+      end
+      
+      UI.info "Guard is now watching at '#{Dir.pwd}'"
+      guards.each(&:start)
+      listener.start
+    end
+    
+    def add_guard(name, watchers = [], options = {})
+      require "guard/#{name.downcase}"
+      guard_class = ObjectSpace.each_object(Class).detect { |c| c.to_s.downcase.match "^guard::#{name.downcase}" }
+      @guards << guard_class.new(watchers, options)
+    end
+    
+    def run
+      listener.stop
+      yield
+      listener.start
+    end
+    
+  end
+  
+end

data/lib/guard/cli.rb

@@ -0,0 +1,20 @@
+require 'thor'
+require 'guard/version'
+
+module Guard
+  class CLI < Thor
+    default_task :start
+    
+    desc "start", "Starts guard"
+    method_option :clear, :type => :boolean, :default => false, :aliases => '-c', :banner => "Auto clear shell after each change"
+    def start
+      Guard.start(options)
+    end
+    
+    desc "version", "Prints the guard's version information"
+    def version
+      Guard::UI.info "Guard version #{Guard::VERSION}"
+    end
+    map %w(-v --version) => :version
+  end
+end

data/lib/guard/dsl.rb

@@ -0,0 +1,24 @@
+module Guard
+  class Dsl
+    
+    def self.evaluate_guardfile
+      guardfile = "#{Dir.pwd}/Guardfile"
+      dsl = new
+      dsl.instance_eval(File.read(guardfile.to_s), guardfile.to_s, 1)
+    rescue
+      UI.error "Guardfile not found or invalid"
+      exit 1
+    end
+    
+    def guard(name, options = {}, &definition)
+      @watchers = []
+      definition.call
+      Guard.add_guard(name, @watchers, options)
+    end
+    
+    def watch(pattern, &action)
+      @watchers << Guard::Watcher.new(pattern, action)
+    end
+    
+  end
+end

data/lib/guard/guard.rb

@@ -0,0 +1,34 @@
+module Guard
+  class Guard
+    attr_accessor :watchers, :options
+    
+    def initialize(watchers = [], options = {})
+      @watchers, @options = watchers, options
+    end
+    
+    # ================
+    # = Guard method =
+    # ================
+    
+    def start
+      true
+    end
+    
+    def stop
+      true
+    end
+    
+    def reload
+      true
+    end
+    
+    def run_all
+      true
+    end
+    
+    def run_on_change(paths)
+      true
+    end
+    
+  end
+end

data/lib/guard/interactor.rb

@@ -0,0 +1,32 @@
+module Guard
+  module Interactor
+    
+    def self.init_signal_traps
+      # Run all (Ctrl-\)
+      Signal.trap('QUIT') do
+        ::Guard.run do
+          ::Guard.guards.each(&:run_all)
+        end
+      end
+      
+      # Stop (Ctrl-C)
+      Signal.trap('INT') do
+        ::Guard.listener.stop
+        if ::Guard.guards.all?(&:stop)
+          UI.info "Bye bye...", :reset => true, :clear => false
+          abort("\n")
+        else
+          ::Guard.listener.start
+        end
+      end
+      
+      # Reload (Ctrl-Z)
+      Signal.trap('TSTP') do
+        ::Guard.run do
+          ::Guard.guards.each(&:reload)
+        end
+      end
+    end
+    
+  end
+end

data/lib/guard/listener.rb

@@ -0,0 +1,64 @@
+require 'sys/uname'
+
+module Guard
+  class Listener
+    attr_reader :last_event, :callback, :pipe
+    
+    def initialize
+      update_last_event
+    end
+    
+    def on_change(&block)
+      @callback = block
+    end
+    
+    def start
+      @pipe = case Sys::Uname.sysname
+      when 'Darwin'
+        IO.popen("#{bin_path}/fsevent_watch .")
+      when 'Linux'
+        IO.popen("#{bin_path}/inotify_watch .")
+      end
+      watch_change
+    end
+    
+    def stop
+      Process.kill("HUP", pipe.pid) if pipe
+    end
+    
+  private
+    
+    def watch_change
+      while !pipe.eof?
+        if line = pipe.readline
+          modified_dirs = line.split(" ")
+          files = modified_files(modified_dirs)
+          update_last_event
+          callback.call(files)
+        end
+      end
+    end
+    
+    def modified_files(dirs)
+      files = potentially_modified_files(dirs).select { |file| recent_file?(file) }
+      files.map! { |file| file.gsub("#{Dir.pwd}/", '') }
+    end
+    
+    def potentially_modified_files(dirs)
+      Dir.glob(dirs.map { |dir| "#{dir}*" })
+    end
+    
+    def recent_file?(file)
+      File.mtime(file) >= last_event
+    end
+    
+    def update_last_event
+      @last_event = Time.now
+    end
+    
+    def bin_path
+      File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'bin'))
+    end
+    
+  end
+end

data/lib/guard/notifier.rb

@@ -0,0 +1,45 @@
+require 'sys/uname'
+require 'pathname'
+
+case Sys::Uname.sysname
+when 'Darwin'
+  require 'growl'
+when 'Linux'
+  require 'libnotify'
+end
+
+module Guard
+  module Notifier
+    
+    def self.notify(message, options = {})
+      unless ENV["GUARD_ENV"] == "test"
+        image = options[:image] || :success
+        title = options[:title] || "Guard"
+        case Sys::Uname.sysname
+        when 'Darwin'
+          Growl.notify message, :title => title, :icon => image_path(image), :name => "Guard"
+        when 'Linux'
+          Libnotify.show :body => message, :summary => title, :icon_path => image_path(image)
+        end
+      end
+    end
+    
+  private
+    
+    def self.image_path(image)
+      images_path = Pathname.new(File.dirname(__FILE__)).join('../../images')
+      case image
+      when :failed
+        images_path.join("failed.png").to_s
+      when :pending
+        images_path.join("pending.png").to_s
+      when :success
+        images_path.join("success.png").to_s
+      else
+        # path given
+        image
+      end
+    end
+    
+  end
+end

data/lib/guard/ui.rb

@@ -0,0 +1,37 @@
+module Guard
+  module UI
+    class << self
+      
+      def info(message, options = {})
+        unless ENV["GUARD_ENV"] == "test"
+          reset_line if options[:reset]
+          clear      if options.key?(:clear) ? options[:clear] : ::Guard.options[:clear]
+          puts reset_color(message) if message != ''
+        end
+      end
+      
+      def error(message)
+        puts "ERROR: #{message}"
+      end
+      
+      def reset_line
+        print "\r\e "
+      end
+      
+    private
+      
+      def clear
+        system("clear;")
+      end
+      
+      def reset_color(text)
+        color(text, "\e[0m")
+      end
+      
+      def color(text, color_code)
+        "#{color_code}#{text}\e[0m"
+      end
+      
+    end
+  end
+end

data/lib/guard/version.rb

@@ -0,0 +1,3 @@
+module Guard
+  VERSION = "0.1.0.beta.1"
+end

data/lib/guard/watcher.rb

@@ -0,0 +1,35 @@
+module Guard
+  class Watcher
+    attr_accessor :pattern, :action
+    
+    def initialize(pattern, action = nil)
+      @pattern, @action = pattern, action
+    end
+    
+    def self.match_files(guard, files)
+      guard.watchers.inject([]) do |paths, watcher|
+        files.each do |file|
+          if matches = file.match(watcher.pattern)
+            if watcher.action
+              begin 
+                case watcher.action.arity
+                when -1
+                  result = watcher.action.call
+                when 1
+                  result = watcher.action.call(matches)
+                end
+              rescue
+                UI.info "Problem with watch action"
+              end
+              paths << result if result.is_a?(String) && result != ''
+            else
+              paths << matches[0]
+            end
+          end
+        end
+        paths
+      end
+    end
+    
+  end
+end

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification 
+name: guard
+version: !ruby/object:Gem::Version 
+  hash: 62196401
+  prerelease: true
+  segments: 
+  - 0
+  - 1
+  - 0
+  - beta
+  - 1
+  version: 0.1.0.beta.1
+platform: ruby
+authors: 
+- Thibaud Guillaume-Gentil
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-03 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 1
+        - 0
+        - 1
+        version: 1.0.1
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 62196431
+        segments: 
+        - 2
+        - 0
+        - 0
+        - beta
+        - 22
+        version: 2.0.0.beta.22
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: thor
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 35
+        segments: 
+        - 0
+        - 14
+        - 2
+        version: 0.14.2
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: sys-uname
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 55
+        segments: 
+        - 0
+        - 8
+        - 4
+        version: 0.8.4
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: growl
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 17
+        segments: 
+        - 1
+        - 0
+        - 3
+        version: 1.0.3
+  type: :runtime
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: rb-inotify
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: libnotify
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 29
+        segments: 
+        - 0
+        - 1
+        - 3
+        version: 0.1.3
+  type: :runtime
+  version_requirements: *id007
+description: Guard is a command line tool to easly manage script launch when your files change
+email: 
+- thibaud@thibaud.me
+executables: 
+- guard
+extensions: 
+- ext/extconf.rb
+extra_rdoc_files: []
+
+files: 
+- bin/guard
+- bin/inotify_watch
+- images/failed.png
+- images/pending.png
+- images/success.png
+- lib/guard/cli.rb
+- lib/guard/dsl.rb
+- lib/guard/guard.rb
+- lib/guard/interactor.rb
+- lib/guard/listener.rb
+- lib/guard/notifier.rb
+- lib/guard/ui.rb
+- lib/guard/version.rb
+- lib/guard/watcher.rb
+- lib/guard.rb
+- ext/extconf.rb
+- ext/fsevent/fsevent_watch.c
+- LICENSE
+- README.rdoc
+has_rdoc: true
+homepage: http://rubygems.org/gems/guard
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      hash: 25
+      segments: 
+      - 1
+      - 3
+      - 1
+      version: 1.3.1
+requirements: []
+
+rubyforge_project: guard
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Guard keep an eye on your files event
+test_files: []
+