rehctaw 1.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 52bdd0357b77fbd19825f9cbe698a35ba024ba87
+  data.tar.gz: 1f584f7e65da9fa005c19b4aa3ecf886439ce991
+SHA512:
+  metadata.gz: 3d7a13db6f39cdb4bfe59f47b0191eb538c08165084645f3830ecd2d61b4b9ea672fa835256b673c75d14775f519c21ce444ddd567ea4c6affb4d46375085d7c
+  data.tar.gz: 266fed86851ed1a113c1c53333f60138df14a502b7fcc2bc94c005f42b271a166ab082dbcc35716524bdbf7f53f71b66323eb479364bfcac4c8d6fe76e9fccb5

data/README.md

@@ -0,0 +1,41 @@
+## Name
+
+`rehctaw` - Execute system commands according to file contents.
+
+## Description
+
+`rehctaw` watches contents of a file, and executes system commands
+according to those contents. The commands, intervals, ... are provided
+in a YAML configuration file which is also watched.
+
+## Example
+
+The sample configuration file can be found under `./examples/` directory.
+To use this example, type
+
+    $ cp ./examples/simple.yaml ./examples/mine.yaml
+    $ ./bin/rehctaw ./examples/mine.yaml
+    $ echo foobar > /tmp/watcher
+    $ echo reload > /tmp/watcher
+
+You can update the file `./examples/mine.yaml`. The program will use
+new settings in the next run.
+
+## License
+
+MIT
+
+## Author
+
+Anh K. Huynh
+
+## History
+
+The idea comes from some `Rails` framework. When a `Rails` application
+is running, you can quickly send a `reload` signal to it, by touching
+a file. See [ChiliProject][] for an example.
+
+I don't want to use `inotify`, because that works at file system level
+and it may cause some issues when the file is renamed.
+
+[ChiliProject]: https://www.chiliproject.org/projects/chiliproject/wiki/Restart_ChiliProject

data/bin/rehctaw

@@ -0,0 +1,103 @@
+#!/usr/bin/env ruby
+
+# Purpose: Execute something according to contents of a file
+# Author : Anh K. Huynh
+# License: MIT
+# Date   : 2015 Feb 25
+
+begin
+  require 'yaml'
+  require 'timeout'
+rescue => e
+  STDERR.puts ":: Error: #{e}"
+  exit 127
+end
+
+GLOBAL_WATCHER = {
+  "mtime" => 0
+}
+
+_default_watcher = {
+  "interval" => 5,
+  "stop" => "/bin/true",
+  "start" => "/bin/true",
+  "restart" => "/bin/true",
+  "reset" => "/bin/true",
+  "action" => "",
+  "file" => "/dev/null",
+  "mtime" => 0,
+  "timeout" => 10
+}
+
+def _say(something)
+  STDERR.puts ":: #{something}"
+end
+
+def _configuration_rescan(watcher, config_file)
+  return watcher unless File.file?(config_file) and File.readable?(config_file)
+
+  new_mtime = File.stat(config_file).mtime.to_i
+
+  if new_mtime != GLOBAL_WATCHER["mtime"]
+    GLOBAL_WATCHER["mtime"] = new_mtime
+    begin
+      new_watcher = YAML.load_file(config_file)
+      watcher.merge!(new_watcher["watcher"])
+      watcher["interval"] = [1, watcher["interval"].to_i.abs].max
+      watcher["timeout"]  = [1, watcher["timeout"].to_i.abs].max
+
+      _say "Info: Config reload => #{new_watcher.inspect}"
+    rescue => e
+      _say "Error: #{e}"
+      return watcher
+    end
+  end
+
+  return watcher
+end
+
+if ARGV.size < 1
+  _say "Error: Missing configuration file"
+  exit 127
+end
+
+GLOBAL_WATCHER["file"] = ARGV.first
+watcher = _configuration_rescan(_default_watcher, GLOBAL_WATCHER["file"])
+
+while true
+  executable = false
+
+  if File.file?(watcher["file"]) and File.readable?(watcher["file"])
+    new_mtime = File.stat(watcher["file"]).mtime.to_i
+    if new_mtime != watcher["mtime"]
+      executable = true if watcher["mtime"] > 0
+      watcher["mtime"] = new_mtime
+      # FIXME: reading the whole file may not a good idea. It's slow
+      # FIXME: should find a way to read the first line of a file.
+      new_action = File.readlines(watcher["file"]).first.to_s.strip
+      watcher["action"] = new_action
+    end
+  else
+    _say "Error: Action file '#{watcher["file"]}' unreadable"
+  end
+
+  if executable
+    if watcher[watcher["action"]]
+      command = watcher[watcher["action"]]
+      _say "Info: Executing (#{watcher["action"]}) '#{command}'"
+      begin
+        Timeout::timeout(watcher["timeout"]) do
+          ret = system("#{command}")
+        end
+        _say "Info: Execution complete"
+      rescue Timeout::Error => e
+        _say "Error: Timeout reachable (#{watcher["timeout"]}s)"
+      end
+    else
+      _say "Error: Invalid action: #{watcher["action"]}"
+    end
+  end
+
+  sleep(watcher["interval"])
+  watcher = _configuration_rescan(watcher, GLOBAL_WATCHER["file"])
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: rehctaw
+version: !ruby/object:Gem::Version
+  version: 1.1.1
+platform: ruby
+authors:
+- Anh K. Huynh
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-26 00:00:00.000000000 Z
+dependencies: []
+description: "`rehctaw` watches contents of a file, and executes system commands according
+  to those contents. The commands, intervals, ... are provided in a YAML configuration
+  file which is also watched."
+email: kyanh@theslinux.org
+executables:
+- rehctaw
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/rehctaw
+homepage: https://github.com/icy/rehctaw
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: "`rehctaw` executes system commands according to file contents"
+test_files: []