relaunch 0.0.1 → 0.15.0

data/bin/rerun

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+libdir = "#{File.expand_path(File.dirname(File.dirname(__FILE__)))}/lib"
+$LOAD_PATH.unshift libdir unless $LOAD_PATH.include?(libdir)
+
+require 'rerun'
+require 'optparse'
+
+options = Rerun::Options.parse config_file: ".rerun"
+
+if options and options[:verbose]
+  puts "\nrerun options:\n\t#{options}"
+end
+
+exit if options.nil? or options[:cmd].nil? or options[:cmd].empty?
+
+begin
+  Rerun::Runner.keep_running(options[:cmd], options)
+rescue Rerun::ExitException
+  exit 0
+end

data/bin/rerun.bat

@@ -0,0 +1,3 @@
+:: %~dp0 means "the directory of the current script file"
+:: see https://stackoverflow.com/questions/17063947/get-current-batchfile-directory
+ruby %~dp0\rerun %*

data/lib/relaunch.rb

@@ -1 +1 @@
-puts "Coming soon."
+require 'rerun'

data/lib/rerun/glob.rb

@@ -0,0 +1,85 @@
+# based on http://cpan.uwinnipeg.ca/htdocs/Text-Glob/Text/Glob.pm.html#glob_to_regex_string-
+
+# todo: release as separate gem
+#
+module Rerun
+  class Glob
+    NO_LEADING_DOT = '(?=[^\.])'   # todo
+    START_OF_FILENAME = '(\A|\/)'  # beginning of string or a slash
+    END_OF_STRING = '\z'
+
+    def initialize glob_string
+      @glob_string = glob_string
+    end
+
+    def to_regexp_string
+      chars = @glob_string.split('')
+
+      chars = smoosh(chars)
+
+      curlies = 0
+      escaping = false
+      string = chars.map do |char|
+        if escaping
+          escaping = false
+          char
+        else
+          case char
+            when '**'
+              "([^/]+/)*"
+            when '*'
+              ".*"
+            when "?"
+              "."
+            when "."
+              "\\."
+
+            when "{"
+              curlies += 1
+              "("
+            when "}"
+              if curlies > 0
+                curlies -= 1
+                ")"
+              else
+                char
+              end
+            when ","
+              if curlies > 0
+                "|"
+              else
+                char
+              end
+            when "\\"
+              escaping = true
+              "\\"
+
+            else
+              char
+
+          end
+        end
+      end.join
+      START_OF_FILENAME + string + END_OF_STRING
+    end
+
+    def to_regexp
+      Regexp.new(to_regexp_string)
+    end
+
+    def smoosh chars
+      out = []
+      until chars.empty?
+        char = chars.shift
+        if char == "*" and chars.first == "*"
+          chars.shift
+          chars.shift if chars.first == "/"
+          out.push("**")
+        else
+          out.push(char)
+        end
+      end
+      out
+    end
+  end
+end

data/lib/rerun/notification.rb

@@ -0,0 +1,83 @@
+# todo: unit tests
+
+module Rerun
+  class Notification
+    include System
+
+    attr_reader :title, :body, :options
+
+    def initialize(title, body, options = Options::DEFAULTS.dup)
+      @title = title
+      @body = body
+      @options = options
+    end
+
+    def command
+      # todo: strategy or subclass
+
+      s = nil
+
+      if options[:notify] == true or options[:notify] == "growl"
+        if (cmd = command_named("growlnotify"))
+          # todo: check version of growlnotify and warn if it's too old
+          icon_str = ("--image \"#{icon}\"" if icon)
+          s = "#{cmd} -n \"#{app_name}\" -m \"#{body}\" \"#{app_name} #{title}\" #{icon_str}"
+        end
+      end
+
+      if s.nil? and options[:notify] == true or options[:notify] == "osx"
+        if (cmd = command_named("terminal-notifier"))
+          icon_str = ("-appIcon \"#{icon}\"" if icon)
+          s = "#{cmd} -title \"#{app_name}\" -message \"#{body}\" \"#{app_name} #{title}\" #{icon_str}"
+        end
+      end
+
+      if s.nil? and options[:notify] == true or options[:notify] == "notify-send"
+        if (cmd = command_named('notify-send'))
+          icon_str = "--icon #{icon}" if icon
+          s = "#{cmd} -t 500 --hint=int:transient:1 #{icon_str} \"#{app_name}: #{title}\" \"#{body}\""
+        end
+      end
+
+      s
+    end
+
+    def command_named(name)
+      which_command = windows? ? 'where.exe %{cmd}' : 'which %{cmd} 2> /dev/null'
+      # TODO: remove 'INFO' error message
+      path = `#{which_command % {cmd: name}}`.chomp
+      path.empty? ? nil : path
+    end
+
+    def send(background = true)
+      return unless command
+      with_clean_env do
+        `#{command}#{" &" if background}`
+      end
+    end
+
+    def app_name
+      options[:name]
+    end
+
+    def icon
+      "#{icon_dir}/rails_red_sml.png" if rails?
+    end
+
+    def icon_dir
+      here = File.expand_path(File.dirname(__FILE__))
+      File.expand_path("#{here}/../../icons")
+    end
+
+    def with_clean_env
+      return yield unless defined?(Bundler)
+
+      if Bundler.respond_to?(:with_unbundled_env)
+        Bundler.with_unbundled_env { yield }
+      else
+        # Deprecated on Bundler 2.1
+        Bundler.with_clean_env { yield }
+      end
+    end
+  end
+end

data/lib/rerun/options.rb

@@ -0,0 +1,148 @@
+require 'optparse'
+require 'pathname'
+require 'rerun/watcher'
+require 'rerun/system'
+
+libdir = "#{File.expand_path(File.dirname(File.dirname(__FILE__)))}"
+
+$spec = Gem::Specification.load(File.join(libdir, "..", "relaunch.gemspec"))
+
+module Rerun
+  class Options
+
+    extend Rerun::System
+
+    # If you change the default pattern, please update the README.md file -- the list appears twice therein, which at the time of this comment are lines 17 and 119
+    DEFAULT_PATTERN = "**/*.{rb,js,coffee,css,scss,sass,erb,html,haml,ru,yml,slim,md,feature,c,h}"
+    DEFAULT_DIRS = ["."]
+
+    DEFAULTS = {
+      :background => false,
+      :dir => DEFAULT_DIRS,
+      :force_polling => false,
+      :ignore => [],
+      :ignore_dotfiles => true,
+      :name => Pathname.getwd.basename.to_s.capitalize,
+      :notify => true,
+      :pattern => DEFAULT_PATTERN,
+      :quiet => false,
+      :signal => (windows? ? "TERM,KILL" : "TERM,INT,KILL"),
+      :verbose => false,
+      :wait => 2,
+    }
+
+    def self.parse args: ARGV, config_file: nil
+
+      default_options = DEFAULTS.dup
+      options = {
+        ignore: []
+      }
+
+      if config_file && File.exist?(config_file)
+        require 'shellwords'
+        config_args = File.read(config_file).shellsplit
+        args = config_args + args
+      end
+
+      option_parser = OptionParser.new("", 24, '  ') do |o|
+        o.banner = "Usage: rerun [options] [--] cmd"
+
+        o.separator ""
+        o.separator "Launches an app, and restarts it when the filesystem changes."
+        o.separator "See http://github.com/alexch/rerun for more info."
+        o.separator "Version: #{$spec.version}"
+        o.separator ""
+        o.separator "Options:"
+
+        o.on("-d dir", "--dir dir", "directory to watch, default = \"#{DEFAULT_DIRS}\".  Specify multiple paths with ',' or separate '-d dir' option pairs.") do |dir|
+          elements = dir.split(",")
+          options[:dir] = (options[:dir] || []) + elements
+        end
+
+        # todo: rename to "--watch"
+        o.on("-p pattern", "--pattern pattern", "file glob to watch, default = \"#{DEFAULTS[:pattern]}\"") do |pattern|
+          options[:pattern] = pattern
+        end
+
+        o.on("-i pattern", "--ignore pattern", "file glob(s) to ignore. Can be set many times. To ignore a directory, you must append '/*' e.g. --ignore 'coverage/*' . Globs do not match dotfiles by default.") do |pattern|
+          options[:ignore] += [pattern]
+        end
+
+        o.on("--[no-]ignore-dotfiles", "by default, file globs do not match files that begin with a dot. Setting --no-ignore-dotfiles allows you to monitor a relevant file like .env, but you may also have to explicitly --ignore more dotfiles and dotdirs.") do |value|
+          options[:ignore_dotfiles] = value
+        end
+
+        o.on("-s signal", "--signal signal", "terminate process using this signal. To try several signals in series, use a comma-delimited list. Default: \"#{DEFAULTS[:signal]}\"") do |signal|
+          options[:signal] = signal
+        end
+
+        o.on("-w sec", "--wait sec", "after asking the process to terminate, wait this long (in seconds) before either aborting, or trying the next signal in series. Default: #{DEFAULTS[:wait]} sec") do |value|
+          default_options[:wait] = value
+        end
+
+        o.on("-r", "--restart", "expect process to restart itself, so just send a signal and continue watching. Sends the HUP signal unless overridden using --signal") do |signal|
+          options[:restart] = true
+          default_options[:signal] = "HUP"
+        end
+
+        o.on("-x", "--exit", "expect the program to exit. With this option, rerun checks the return value; without it, rerun checks that the process is running.") do |value|
+          options[:exit] = value
+        end
+
+        o.on("-c", "--clear", "clear screen before each run") do |value|
+          options[:clear] = value
+        end
+
+        o.on("-b", "--background", "disable on-the-fly keypress commands, allowing the process to be backgrounded") do |value|
+          options[:background] = value
+        end
+
+        o.on("-n name", "--name name", "name of app used in logs and notifications, default = \"#{DEFAULTS[:name]}\"") do |name|
+          options[:name] = name
+        end
+
+        o.on("--[no-]force-polling", "use polling instead of a native filesystem scan (useful for Vagrant)") do |value|
+          options[:force_polling] = value
+        end
+
+        o.on("--no-growl", "don't use growl [OBSOLETE]") do
+          options[:growl] = false
+          $stderr.puts "--no-growl is obsolete; use --no-notify instead"
+          return
+        end
+
+        o.on("--[no-]notify [notifier]", "send messages through a desktop notification application. Supports growl (requires growlnotify), osx (requires terminal-notifier gem), and notify-send on GNU/Linux (notify-send must be installed)") do |notifier|
+          notifier = true if notifier.nil?
+          options[:notify] = notifier
+        end
+
+        o.on("-q", "--[no-]quiet", "don't output any logs") do |value|
+          options[:quiet] = value
+        end
+
+        o.on("--[no-]verbose", "log extra stuff like PIDs (unless you also specified `--quiet`") do |value|
+          options[:verbose] = value
+        end
+
+        o.on_tail("-h", "--help", "--usage", "show this message and immediately exit") do
+          puts o
+          return
+        end
+
+        o.on_tail("--version", "show version and immediately exit") do
+          puts $spec.version
+          return
+        end
+
+      end
+
+      puts option_parser if args.empty?
+      option_parser.parse! args
+      options = default_options.merge(options)
+      options[:cmd] = args.join(" ").strip # todo: better arg word handling
+
+      options
+    end
+  end
+
+end