central 0.2.4 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 59a223e19b875e1e3d7dc50f70f60697816d47e3
-  data.tar.gz: 8037442fffcaaccbe55bf1209dae265890432836
+SHA256:
+  metadata.gz: 9ac8e8ea400a706c511823313cf3832bc3fde937077e8388e0b79e03ccb6f2e3
+  data.tar.gz: 8174b7da6cadf72d7c3aa3c5a1ed11fe87ed11413029e7de71712c307746e0ac
 SHA512:
-  metadata.gz: 1ef58f6d6da2bf0f3148677cc86d5cf5779c4d2fa766102c1dfd5cd4ac5aad643d7e55ed78a575b83a6e2d38735bfefdc0bb8a6eebe5935dde1ec4326bf03fa6
-  data.tar.gz: 025ab8f80c6e4cc29038ff1cacb276206527da789865732539d64887b23b590007c9debe723ab7224ed02de28ac705be2a331cdeaf04ae568ed7a1ade5392858
+  metadata.gz: 270220f138029359a37a99d8b79d22a9484d05fd8a0a01efea438031f17b10a3497c98a845a98ba9ef2f36838557f81b2a00f3e318e8ee2eb93cbbf4a5c2223d
+  data.tar.gz: 6d6b11e171213305af47dcc4dd351c8f1abe4ab841f37ca870d549ed6251bff677766dc49ec7263baa33c34282a416061b8c5d7cf85b0166fa839d209f38f916

data/bin/central

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
-# encoding: utf-8
+# frozen_string_literal: true
 
 # -------------------------------------------------------------------------
 # # central - dot files manager licensed under LGPLv3 (see LICENSE file)  |
@@ -7,15 +7,51 @@
 # -------------------------------------------------------------------------
 
 require 'central'
+require 'optparse'
 
-if ARGV.length > 0
-  if ARGV[0] == '-v' || ARGV[0] == '--version' || ARGV[0] == '-version'
-    puts "central v0.2.4"
-    exit 0
+VERSION = 'v0.3.0'
+
+options = {:color => true}
+OptionParser.new do |opts|
+  opts.banner = %{central #{VERSION} - created by Dmitry Geurkov (d.geurkov@gmail.com) and licensed under LGPLv3
+
+Usage: central [options] [directory|configuration.rb, ...]
+
+Description:  if directory is specified it will use configuration.rb file inside that directory
+              if no [directory|configuration.rb] is specified
+              it will use configuration.rb in current working directory
+
+Options:}
+  opts.on("-i", "--irb", "Start interactive IRB REPL") do |_|
+    options[:irb] = true
+  end
+
+  opts.on("-m", "--monitor", "Monitor erb files for changes and reprocess them automatically") do |_|
+    options[:monitor] = true
   end
-  if ARGV[0] == '-h' || ARGV[0] == '--help' || ARGV[0] == '-help'
-    puts "central [path/to/configuration.rb]"
-    exit 0
+
+  opts.on("-n", "--no-color", "Do not colorize output") do |_|
+    options[:color] = false
   end
+
+  opts.on("-v", "--version", "Print version") do |_|
+    puts "central #{VERSION}"
+    exit
+  end
+end.parse!
+
+if options[:irb]
+  require 'irb'
+  $colored = true
+  $colored = options[:color] if options[:color]
+  info "Welcome to central #{VERSION} IRB repl, interactive playground for your dotcentral configuration"
+  info "Please ignore warning below as central has source function, and IRB tries to create alias for irb_source"
+  info "In order to use IRB's source functionality just call it without alias as irb_source"
+  ARGV.clear
+  IRB.start(__FILE__)
+elsif options[:monitor]
+  run_central(ARGV,options[:color])
+  run_monitors
+else
+  run_central(ARGV,options[:color])
 end
-central(ARGV)

data/lib/central.rb

@@ -1,4 +1,5 @@
-# encoding: utf-8
+# frozen_string_literal: true
+
 # -------------------------------------------------------------------------
 # # central - dot files manager licensed under LGPLv3 (see LICENSE file)  |
 # # written in Ruby by Dmitry Geurkov (d.geurkov@gmail.com)               |
@@ -8,6 +9,42 @@ require 'erb'
 require 'socket'
 require 'open3'
 require 'fileutils'
+require 'digest'
+
+# cli colors
+$colored = true
+COLOR_RED = 31
+COLOR_GREEN = 32
+
+# monitors
+$monitors = {}
+
+# putsc, puts with color
+def color(message, color)
+  if $colored
+    "\e[#{color}m#{message}\e[0m"
+  else
+    message
+  end
+end
+
+# info
+def info(message, param = nil)
+  puts color(message, COLOR_GREEN) +
+       (param.nil? ? '' : ': ' + param)
+end
+
+# error
+def error(message, param = nil)
+  puts color(message, COLOR_RED) +
+       (param.nil? ? '' : ': ' + param)
+end
+
+# fail, print message to stderr and exit with 1
+def fail(message, param = nil)
+  error message, param
+  exit 1
+end
 
 # get hostname
 def hostname
@@ -17,114 +54,110 @@ end
 # get operating system
 def os
   if RUBY_PLATFORM.include?('linux')
-    return 'linux'
+    'linux'
   elsif RUBY_PLATFORM.include?('darwin')
-    return 'osx'
+    'osx'
   elsif RUBY_PLATFORM.include?('freebsd')
-    return 'freebsd'
+    'freebsd'
   elsif RUBY_PLATFORM.include?('solaris')
-    return 'solaris'
+    'solaris'
   end
 end
 
 def linux?
-  return os == 'linux'
+  os == 'linux'
 end
 
 def osx?
-  return os == 'osx'
+  os == 'osx'
+end
+
+def macos?
+  os == 'osx'
 end
 
 def freebsd?
-  return os == 'freebsd'
+  os == 'freebsd'
 end
 
 def solaris?
-  return os == 'solaris'
-end
-
-# run shell command and get output, optionaly can print command running if verbose and if not silent will also print to stdout and stderr
-$shell_return_value = nil
-def shell(command,verbose: false, silent: true)
-  puts "Executing: #{command}" if verbose
-  stdout = ''
-  stdout_line = ''
-  stderr = ''
-  stderr_line = ''
-  Open3.popen3(command) do |i,o,e,t|
+  os == 'solaris'
+end
+
+# run shell command and get output, optionaly can print command running
+# if verbose and if not silent will also print to stdout and stderr
+def shell(command, verbose: false, silent: true)
+  info 'Executing', command if verbose
+  exit_code = nil
+  stdout = String.new
+  stdout_line = String.new
+  stderr = String.new
+  stderr_line = String.new
+  Open3.popen3(command) do |_, o, e, t|
     stdout_open = true
     stderr_open = true
-    while stdout_open or stderr_open
+    while stdout_open || stderr_open
       if stdout_open
         begin
           ch = o.read_nonblock(1)
-          stdout.insert(-1,ch)
+          stdout.insert(-1, ch)
           unless silent
-            stdout_line.insert(-1,ch)
+            stdout_line.insert(-1, ch)
             if ch == "\n"
               STDOUT.puts stdout_line
               stdout_line = ''
             end
           end
         rescue IO::WaitReadable
-          IO.select([o],nil,nil,0.1) unless stderr_open
+          IO.select([o], nil, nil, 0.01) unless stderr_open
         rescue EOFError
           stdout_open = false
         end
       end
-      if stderr_open
-        begin
-          ch = e.read_nonblock(1)
-          stderr.insert(-1,ch)
-          unless silent
-            stderr_line.insert(-1,ch)
-            if ch == "\n"
-              STDERR.puts stderr_line
-              stderr_line = ''
-            end
+      next unless stderr_open
+
+      begin
+        ch = e.read_nonblock(1)
+        stderr.insert(-1, ch)
+        unless silent
+          stderr_line.insert(-1, ch)
+          if ch == "\n"
+            STDERR.puts stderr_line
+            stderr_line = ''
           end
-        rescue IO::WaitReadable
-          IO.select([e],nil,nil,0.1) unless stdout_open
-        rescue EOFError
-          stderr_open = false
         end
+      rescue IO::WaitReadable
+        IO.select([e], nil, nil, 0.01) unless stdout_open
+      rescue EOFError
+        stderr_open = false
       end
     end
-    $shell_return_value = t.value
-  end
-  if stderr == ''
-    return stdout
-  else
-    return stdout, stderr
+    exit_code = t.value
   end
+  [exit_code, stdout, stderr]
 end
 
 # run shell command with sudo prefix, acts same as shell
-def sudo(command,verbose:,silent:)
-  return shell('sudo '+command, verbose: verbose, silent: silent)
+def sudo(command, verbose:, silent:)
+  shell('sudo ' + command, verbose: verbose, silent: silent)
 end
 
 # function used to check that system has all required tools installed
-def check_tool(name,check)
-  begin
-    output = shell(check+' 2>&1').downcase
-    if output == '' or output.include?('command not found')
-      STDERR.puts "#{name} not found, please install it to use central"
-      exit 1
-    end
-  rescue Errno::ENOENT
-    STDERR.puts "#{name} not found, please install it to use central"
-    exit 1
+def check_tool(name, check)
+  _, output, = shell(check + ' 2>&1')
+  if output == '' || output.downcase.include?('command not found')
+    fail "#{name} not found, please install it to use central"
   end
+rescue Errno::ENOENT
+  fail "#{name} not found, please install it to use central"
 end
 
-check_tool('file','file --version')
-check_tool('grep','grep --version')
-check_tool('ln','ln --version')
-check_tool('readlink','readlink --version')
-check_tool('git','git --version')
-check_tool('curl','curl --version')
-
+check_tool('file', 'file --version')
+check_tool('grep', 'grep --version')
+check_tool('ln', 'ln --version')
+check_tool('readlink', 'readlink --version')
+check_tool('git', 'git --version')
+check_tool('curl', 'curl --version')
 
 # current working directory
 def pwd
@@ -133,7 +166,7 @@ end
 
 # absolute path
 def abs(path)
-  path = File.absolute_path(File.expand_path(path))
+  File.absolute_path(File.expand_path(path))
 end
 
 # change current working directory
@@ -147,13 +180,45 @@ def file_exists?(path)
   File.file?(path) && File.readable?(path)
 end
 
+# get file size
+def file_size(path)
+  File.new(abs(path)).size
+end
+
+# get file creation time
+def file_ctime(path)
+  File.new(abs(path)).ctime
+end
+
+# get file modification time
+def file_mtime(path)
+  File.new(abs(path)).mtime
+end
+
+# get directory entries
+def dir_entries(path)
+  Dir.entries(abs(path)).select { |f| f != '.' && f != '..' }
+end
+
 # check if directory exists
 def dir_exists?(path)
   path = abs(path)
   Dir.exist?(path)
 end
 
-# get directory name of a file
+# get file name of a path, optionally strip suffix if needed
+def file_name(path, strip_suffix: '')
+  File.basename(abs(path), strip_suffix)
+end
+
+# get file suffix of a path
+def file_suffix(path)
+  path = file_name(path)
+  suffix_index = path =~ /\.[^.]+$/
+  return path[suffix_index, path.size - suffix_index] if suffix_index
+end
+
+# get directory name of a path
 def file_dir(path)
   File.dirname(abs(path))
 end
@@ -165,80 +230,75 @@ end
 
 # get full path of symlink
 def symlink_path(symlink)
-  shell("readlink \"#{abs(symlink)}\" 2>&1").strip
+  _, out, = shell("readlink \"#{abs(symlink)}\" 2>&1")
+  out.strip
+end
+
+# calculate SHA2 digest for a file
+def sha2(file)
+  Digest::SHA256.hexdigest read(file)
 end
 
 # make directory including intermediate directories
 def mkdir(path)
   path = abs(path)
-  unless dir_exists?(path)
-    out = shell("mkdir -p \"#{path}\" 2>&1")
-    unless $shell_return_value.success?
-      STDERR.puts out
-      STDERR.puts "Couldn't create directory: #{path}"
-      exit 1
-    end
-    puts "Created directory: #{path}"
+  return if dir_exists?(path)
+
+  exit_code, out, = shell("mkdir -p \"#{path}\" 2>&1")
+  unless exit_code.success?
+    error out
+    fail "Couldn't create directory", path
   end
+  info 'Created directory', path
 end
 
 # remove file/directory
-def rm(path,recursive: false)
+def rm(path, recursive: false)
   path = abs(path)
-  if recursive
-    recursive = '-R '
-  else
-    recursive = ''
-  end
+  recursive = recursive ? '-R ' : ''
   is_dir = dir_exists?(path)
   is_symlink = symlink?(path)
-  out = shell("rm #{recursive}-f \"#{path}\" 2>&1")
-  unless $shell_return_value.success?
-    STDERR.puts out
-    STDERR.puts "Couldn't remove path: #{path}"
-    exit 1
+  exit_code, out, = shell("rm #{recursive}-f \"#{path}\" 2>&1")
+  unless exit_code.success?
+    error out
+    fail "Couldn't remove path", path
   end
   if is_dir
-    puts "Removed directory: #{path}"
+    info 'Removed directory', path
   elsif is_symlink
-    puts "Removed symlink: #{path}"
+    info 'Removed symlink', path
   else
-    puts "Removed file: #{path}"
+    info 'Removed file', path
   end
 end
 
 # remove directory recursively
 def rmdir(path)
-  rm(path,recursive: true)
+  rm(path, recursive: true)
 end
 
 # touch file
 def touch(path)
   path = abs(path)
-  unless file_exists?(path)
-    out = shell("touch \"#{path}\" 2>&1")
-    unless $shell_return_value.success?
-      STDERR.puts out
-      STDERR.puts "Couldn't touch file: #{path}"
-      exit 1
-    end
-    puts "Touched file: #{path}"
+  return if file_exists?(path)
+
+  exit_code, out, = shell("touch \"#{path}\" 2>&1")
+  unless exit_code.success?
+    error out
+    fail "Couldn't touch file", path
   end
+  info 'Touched file', path
 end
 
 # change file permissions
-def chmod(path,permissions,recursive: false)
+def chmod(path, permissions, recursive: false)
   path = abs(path)
-  if recursive
-    recursive = '-R '
-  else
-    recursive = ''
-  end
+  recursive = recursive ? '-R ' : ''
   shell("chmod #{recursive}#{permissions} \"#{path}\"")
 end
 
 # symlink path
-def symlink(from,to)
+def symlink(from, to)
   from = abs(from)
   to = abs(to)
   if symlink?(from)
@@ -247,187 +307,216 @@ def symlink(from,to)
       symlink from, to
     end
   elsif file_exists?(from)
-    STDERR.puts "File #{from} exists in place of symlink..."
-    exit 1
+    fail "File #{from} exists in place of symlink..."
   elsif dir_exists?(from)
-    STDERR.puts "Directory #{from} exists in place of symlink..."
-    exit 1
+    fail "Directory #{from} exists in place of symlink..."
   else
-    out = shell("ln -s \"#{to}\" \"#{from}\" 2>&1")
-    unless $shell_return_value.success?
-      STDERR.puts out
-      STDERR.puts "Couldn't create symlink: #{from} → #{to}"
-      exit 1
+    exit_code, out, = shell("ln -s \"#{to}\" \"#{from}\" 2>&1")
+    unless exit_code.success?
+      error out
+      fail "Couldn't create symlink", "#{from} → #{to}"
     end
-    puts "Created symlink: #{from} → #{to}"
+    info 'Created symlink', "#{from} → #{to}"
   end
 end
 
 # git clone url into a path
-def git(url,path,branch: nil,silent: false,depth: nil)
+def git(url, path, branch: nil, silent: true, depth: nil)
   path = abs(path)
   if dir_exists?(path) && dir_exists?("#{path}/.git")
-    cwd = pwd()
+    cwd = pwd
     chdir path
     out = nil
     if branch
-      out = shell('git fetch 2>&1',{:silent => silent})
-      if out.size > 0
-        puts out if silent
-      end
-      out = shell("git checkout #{branch} 2>&1",{:silent => silent})
+      _, out, = shell('git fetch 2>&1', silent: silent)
+      puts out if silent && out.size.positive?
+      _, out, = shell("git checkout #{branch} 2>&1", silent: silent)
       unless out.downcase.include? 'is now at'
         puts out if silent
       end
-      out = shell("git pull origin #{branch} 2>&1",{:silent => silent})
+      _, out, = shell("git pull origin #{branch} 2>&1", silent: silent)
     else
-      out = shell('git pull 2>&1',{:silent => silent})
+      _, out, = shell('git pull 2>&1', silent: silent)
     end
-    unless out.downcase.include? "already up-to-date"
+    unless out.downcase.include? 'already up'
       puts out if silent
-      puts "Git repository pulled: #{url} → #{path}"
+      info 'Git repository pulled', "#{url} → #{path}"
     end
     chdir cwd
   else
-    if branch
-      branch = "-b #{branch} "
-    else
-      branch = ''
-    end
-    if depth
-      depth = '--depth '+depth.to_s+' '
-    else
-      depth = ''
-    end
-    out = shell("git clone #{depth}#{branch}#{url} \"#{path}\" 2>&1",{:silent => silent})
+    branch = branch ? "-b #{branch} " : ''
+    depth = depth ? "--depth #{depth} " : ''
+    _, out, = shell("git clone #{depth}#{branch}#{url} \"#{path}\" 2>&1",
+                    silent: silent)
     puts out if silent
-    puts "Git repository cloned: #{url} → #{path}"
+    info 'Git repository cloned', "#{url} → #{path}"
   end
 end
 
 # download url into a path using curl
-def curl(url,path, verbose: false)
+def curl(url, path, content_length_check: false, verbose: false)
   path = abs(path)
-  puts "Downloading #{url} → #{path}"
-  output = shell("curl -s -S \"#{url}\"",verbose: verbose, silent: true)
-  unless $shell_return_value.success?
-    STDERR.puts output
-    STDERR.puts "Couldn't download file from #{url}..."
-    exit 1
+  if content_length_check and file_exists?(path)
+    content_length = curl_headers(url, verbose: verbose)['content-length'].to_i
+    return if file_size(path) == content_length
+  end
+  info 'Downloading', "#{url} → #{path}"
+  exit_code, output, = shell("curl -s -S \"#{url}\"",
+                             verbose: verbose, silent: true)
+  unless exit_code.success?
+    error output
+    fail "Couldn't download file from", url
   end
-  File.write(path,output)
-  puts "Downloaded #{url} → #{path}"
+  File.write(path, output)
+  info 'Downloaded', "#{url} → #{path}"
+end
+
+# get url response headers as Hash using curl
+def curl_headers(url, method: 'HEAD', verbose: false)
+  exit_code, output, = shell("curl -I -X #{method} -s -S \"#{url}\"",
+                             verbose: verbose, silent: true)
+  unless exit_code.success?
+    error output
+    fail "Couldn't get headers from", url
+  end
+  headers = {}
+  output.scan(/^(?!HTTP)([^:]+):(.*)$/).each do |m|
+    headers[m[0].strip.downcase] = m[1].sub("\r","").strip
+  end
+  headers
 end
 
 # read content of a file
 def read(file)
   file = abs(file)
-  if file_exists?(file)
-    return File.read(file)
-  else
-    STDERR.puts "Couldn't read file #{file}..."
-    exit 1
-  end
+  return File.read(file) if file_exists?(file)
+
+  fail "Couldn't read file", file
 end
 
 # write content into a file
-def write(file,content)
+def write(file, content)
   file = abs(file)
-  File.write(file,content)
+  File.write(file, content)
 end
 
 # source file in sh/bash/zsh script
-def source(file,source)
+def source(file, source)
   file = abs(file)
   source = abs(source)
   source_line = "source \"#{source}\""
-  out = shell("grep -Fx '#{source_line}' \"#{file}\"")
-  if out == ""
-    shell("echo '#{source_line}' >> \"#{file}\"")
-    puts "Added source #{source} line to #{file}"
-  end
+  _, out, = shell("grep -Fx '#{source_line}' \"#{file}\"")
+  return unless out == ''
+
+  shell("echo '#{source_line}' >> \"#{file}\"")
+  info 'Added source', "#{source} line to #{file}"
 end
 
 # list directory content
-def ls(path,dotfiles: false, grep: '', dir: true, file: true)
+def ls(path, dotfiles: false, grep: '', dir: true, file: true)
   path = abs(path)
-  if dotfiles
-    dotfiles = '-a '
-  else
-    dotfiles = ''
-  end
+  dotfiles = dotfiles ? '-a ' : ''
   command = "ls -1 #{dotfiles}\"#{path}\" 2>&1"
-  if grep.length > 0
-    command += " | grep #{grep}"
-  end
-  output = shell(command)
+  command += " | grep #{grep}" unless grep.empty?
+
+  _, output, = shell(command)
   if output.downcase.end_with?('no such file or directory')
-    STDERR.puts "Couldn't ls directory #{path}..."
-    exit 1
+    fail "Couldn't ls directory", path
   end
+
   ls = output.split("\n")
-  unless dir
-    ls = ls.keep_if {|f| !File.directory?("#{path}/#{f}") }
-  end
-  unless file
-    ls = ls.keep_if {|f| !File.file?("#{path}/#{f}") }
-  end
-  return ls
+  ls = ls.keep_if { |f| !File.directory?("#{path}/#{f}") } unless dir
+  ls = ls.keep_if { |f| !File.file?("#{path}/#{f}") } unless file
+  ls
+end
+
+# compare_file
+def compare_file(from, to)
+  from = abs(from)
+  to = abs(to)
+  FileUtils.compare_file(from, to)
+end
+
+# copy_file
+def copy_file(from, to)
+  from = abs(from)
+  to = abs(to)
+  fail "Couldn't access file", from unless file_exists?(from)
+
+  return if file_exists?(to) && FileUtils.compare_file(from, to)
+
+  FileUtils.copy_file(from, to)
+  info 'Copied file', "#{from} → #{to}"
 end
 
 # copy
-def copy(from,to)
+def copy(from, to)
   from = abs(from)
   to = abs(to)
   if dir_exists?(from)
-    (Dir.entries(from).select { |f| f != "." and f != ".." }).each do |f|
+    dir_entries(from).each do |f|
       FileUtils.mkdir_p(to)
-      copy("#{from}/#{f}","#{to}/#{f}")
+      copy("#{from}/#{f}", "#{to}/#{f}")
     end
   else
-    unless file_exists?(from)
-      STDERR.puts "Couldn't access file #{from}..."
-      exit 1
+    copy_file(from, to)
+  end
+end
+
+# mirror
+def mirror(from, to)
+  from = abs(from)
+  to = abs(to)
+  if dir_exists?(from)
+    from_entries = dir_entries(from)
+    if dir_exists?(to)
+      dir_entries(to).each do |f|
+        rm("#{to}/#{f}", recursive: true) unless from_entries.include?(f)
+      end
     end
-    if !file_exists?(to) or !FileUtils.compare_file(from,to)
-      FileUtils.copy_file(from,to)
-      puts "Copied file: #{from} → #{to}"
+    from_entries.each do |f|
+      FileUtils.mkdir_p(to)
+      copy("#{from}/#{f}", "#{to}/#{f}")
     end
+  else
+    copy_file(from, to)
   end
 end
 
 # process erb template into an output_file
-def erb(file,output_file = nil)
+def erb(file, output_file = nil, monitor = true)
   file = abs(file)
-  if output_file == nil
-    if file.end_with?('.erb')
-      output_file = file[0...-4]
-    else
-      output_file = file+'.out'
-    end
-  end
-  if file_exists?(file)
-    output = ERB.new(File.read(file)).result
-    if File.exist?(output_file) && File.read(output_file) == output
-      return
-    end
-    File.write(output_file,output)
-    puts "Processed erb #{file} → #{output_file}"
-  else
-    STDERR.puts "Couldn't process erb file #{file}..."
-    exit 1
+  fail 'No erb file found', file unless file_exists?(file)
+
+  if output_file.nil?
+    output_file = file.end_with?('.erb') ? file[0...-4] : file + '.out'
   end
+
+  $monitors[file] = proc { erb(file, output_file, false) } if monitor
+
+  out = ERB.new(File.read(file)).result
+  return if File.exist?(output_file) && File.read(output_file) == out
+
+  File.write(output_file, out)
+  info 'Processed erb', "#{file} → #{output_file}"
+end
+
+# monitor file for changes and execute proc if file changed
+def monitor(file, &block)
+  file = abs(file)
+  fail 'No file found', file unless file_exists?(file)
+
+  $monitors[file] = block
 end
 
 # run configuration.rb file
 def run(file)
-  cwd = pwd()
+  cwd = pwd
   file = abs(file)
-  unless file_exists?(file)
-    STDERR.puts "No configuration file: #{file} found"
-    exit 1
-  end
-  puts "Running configuration: "+file
+  file = File.join(file,'configuration.rb') if not file_exists?(file) and dir_exists?(file)
+  fail 'No configuration file found', file unless file_exists?(file)
+
+  info 'Running configuration', file
   file_cwd = file_dir(file)
   chdir file_cwd
   load file
@@ -436,15 +525,14 @@ end
 
 # run configuration.rb file only if it exists
 def run_if_exists(file)
-  if file_exists?(file)
-    run file
-  end
+  run file if file_exists?(file)
 end
 
 # run central configuration
-def central(configurations)
-  if configurations.instance_of?(Array) && configurations.length > 0
-    configurations.each {|configuration| run configuration }
+def run_central(configurations, colored = true)
+  $colored = colored
+  if configurations.instance_of?(Array) && !configurations.empty?
+    configurations.each { |configuration| run configuration }
   elsif configurations.instance_of?(String)
     run configurations
   else
@@ -452,3 +540,24 @@ def central(configurations)
   end
 end
 
+# run monitors
+def run_monitors
+  info 'Monitoring files for changes (press Ctrl-C to stop)'
+  file_mtimes = {}
+  $monitors.keys.each { |f| file_mtimes[f] = File.mtime(f) }
+  loop do
+    $monitors.keys.each do |f|
+      file_mtime = File.mtime(f)
+      next if file_mtime == file_mtimes[f]
+
+      info 'File modified', f
+      $monitors[f].call
+      file_mtimes[f] = file_mtime
+    end
+    begin
+      sleep(0.5)
+    rescue Interrupt
+      exit 0
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: central
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.3.0
 platform: ruby
 authors:
 - Dmitry Geurkov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-05-19 00:00:00.000000000 Z
+date: 2021-01-14 00:00:00.000000000 Z
 dependencies: []
 description: central dotfile management system
 email: d.geurkov@gmail.com
@@ -31,15 +31,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2.1
+rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
 summary: central dotfile management