alpha_omega 1.4.3 → 1.5.0

data/VERSION

@@ -1 +1 @@
-1.4.3
+1.5.0

data/bin/ao

@@ -2,4 +2,4 @@
 
 ENV['_AO_HOME'] = File.dirname(ENV['BUNDLE_GEMFILE'])
 shome=File.expand_path('../..', __FILE__)
-system("#{shome}/sbin/aoh", *ARGV)
+system("#{shome}/libexec/aoh", *ARGV)

data/lib/alpha_omega/config/deploy_localhost.rb

@@ -12,15 +12,6 @@ Capistrano::Configuration.instance(:must_exist).load do |config|
         set :dir_perms, "0755"
         set :bundler_options, "--path vendor/bundle"
         set :skip_scm, true
-
-        def run cmd
-          logger.debug "executing locally #{cmd}"
-          run_locally cmd
-          if $?.to_i != 0
-            logger.debug "failed with error code #{$?.to_i >> 8}"
-            exit 1
-          end
-        end
       end
     end
   end

data/lib/alpha_omega/config/deploy_notify.rb

@@ -1,21 +1,19 @@
+require 'tempfile'
+
 Capistrano::Configuration.instance(:must_exist).load do |config|
   namespace :deploy do
     namespace :notify do
       task :default do
         if $deploy["notify"]
-          email if $deploy["notify"].member? "email"
-
           unless skip_notifications
             airbrake if $deploy["notify"].member? "airbrake"
             newrelic if $deploy["notify"].member? "newrelic"
             campfire if $deploy["notify"].member? "campfire"
             flowdock if $deploy["notify"].member? "flowdock"
           end
-        end
-      end
 
-      task :email do
-        run_locally "echo '#{notify_message}' | mail -s '#{notify_message_abbr}' #{$deploy["notify"]["email"]["recipients"].join(" ")}"
+          email if $deploy["notify"].member? "email"
+        end
       end
 
       task :campfire do
@@ -39,16 +37,16 @@ Capistrano::Configuration.instance(:must_exist).load do |config|
         require 'airbrake'
         require 'airbrake_tasks'
 
-        Airbrake.configure do |config|
-          config.api_key = $deploy["notify"]["airbrake"]["api_key"]
+        Airbrake.configure do |abconfig|
+          abconfig.api_key = $deploy["notify"]["airbrake"]["api_key"]
         end
         
         begin
           AirbrakeTasks.deploy({
             :rails_env      => dna['app_env'],
-            :scm_revision   => current_revision,
+            :scm_revision   => "#{real_revision} #{revision}",
             :scm_repository => repository,
-            :local_username => ENV['_AO_USER']
+            :local_username => ENV['_AO_DEPLOYER']
           })
         rescue EOFError
           $stderr.puts "An error occurred during the Airtoad deploy notification."
@@ -76,12 +74,33 @@ Capistrano::Configuration.instance(:must_exist).load do |config|
         require 'new_relic/recipes'
       end
 
+      task :email do
+        tmp_notify = Tempfile.new('email')
+        tmp_notify.write notify_message
+        tmp_notify.close
+        run_locally "cat '#{tmp_notify.path}' | mail -s '#{notify_message_abbr}' #{$deploy["notify"]["email"]["recipients"].join(" ")}"
+        tmp_notify.unlink
+      end
+
+      def map_sha_tag rev
+        tag = %x(git show-ref | grep '^#{rev} refs/tags/' | cut -d/ -f3).chomp
+        tag.empty? ? rev : tag
+      end
+
+      def public_git_url url
+        url.sub("git@github.com:","https://github.com/").sub(/\.git$/,'')
+      end
+
       def notify_message
-        "#{ENV['_AO_USER']} deployed #{application} to #{dna['app_env']}: #{repository}: #{ENV['FLAGS_tag']} => #{current_revision}"
+        summary = "#{public_git_url repository}/compare/#{map_sha_tag cmp_previous_revision}...#{map_sha_tag cmp_current_revision}"
+
+        "#{ENV['_AO_DEPLOYER']} deployed #{application} to #{ENV['_AO_ARGS']} (#{dna['app_env']}): #{ENV['FLAGS_tag']}" +
+        "\n\nSummary:\n\n" + summary + 
+        "\n\nLog:\n\n" + full_log
       end 
 
       def notify_message_abbr
-        "#{ENV['_AO_USER']} deployed #{application} to #{dna['app_env']}: #{ENV['FLAGS_tag']}"
+        "#{ENV['_AO_DEPLOYER']} deployed #{application} to #{ENV['_AO_ARGS']} (#{dna['app_env']}): #{ENV['FLAGS_tag']}"
       end 
     end
   end

data/lib/alpha_omega/deploy.rb

@@ -58,7 +58,10 @@ Capistrano::Configuration.instance(:must_exist).load do |config|
   _cset :last_pod, nil
   _cset :success, false
 
-  _cset (:figlet) { [%x(which figlet).strip].reject {|f| !(File.executable? f)}.first || echo }
+  _cset (:figlet) { 
+    fig = [%x(which figlet).strip].reject {|f| !(File.executable? f)}.first
+    fig ? "#{fig} -w 200" : "echo"
+  }
 
   # =========================================================================
   # services, logs
@@ -131,7 +134,7 @@ Capistrano::Configuration.instance(:must_exist).load do |config|
     unless releases.empty?
       w = current_workarea
       workarea = releases[((releases.index(w)?releases.index(w):-1)+1)%releases.length]
-      system "#{figlet} -w 200 on #{workarea}"
+      system "#{figlet} on #{workarea}"
       workarea
     else
       ""
@@ -161,7 +164,9 @@ Capistrano::Configuration.instance(:must_exist).load do |config|
 
   _cset(:rollback_revision)     { capture("cat #{rollback_release}/REVISION 2>&- || true").strip }
   _cset(:previous_revision)     { capture("cat #{previous_release}/REVISION 2>&- || true").strip }
+  _cset(:cmp_previous_revision) { capture("cat #{previous_path}/REVISION 2>&- || true").strip }
   _cset(:current_revision)      { capture("cat #{current_release}/REVISION 2>&- || true").strip }
+  _cset(:cmp_current_revision)  { capture("cat #{current_path}/REVISION 2>&- || true").strip }
   _cset(:next_revision)         { capture("cat #{next_release}/REVISION 2>&- || true").strip }
   _cset(:active_revision)       { capture("cat #{active_release}/REVISION 2>&- || true").strip }
   _cset(:compare_revision)      { capture("cat #{compare_release}/REVISION 2>&- || true").strip }
@@ -358,7 +363,7 @@ Capistrano::Configuration.instance(:must_exist).load do |config|
           run "mv -T #{previous_path}.new #{previous_path}"
         end
 
-        system "#{figlet} -w 200 #{current_release_name} activated"
+        system "#{figlet} #{current_release_name} activated"
       end
     end
 
@@ -435,12 +440,12 @@ Capistrano::Configuration.instance(:must_exist).load do |config|
       DESC
       task :revision do
         if previous_release
-          system "#{figlet} -w 200 on #{previous_release_name}"
+          system "#{figlet} on #{previous_release_name}"
           run "rm -f #{previous_path} #{next_path}"
           run "ln -nfs #{previous_release} #{current_path}.new"
           run "mv -T #{current_path}.new #{current_path}"
         else
-          system "#{figlet} -w 200 failed to rollback"
+          system "#{figlet} failed to rollback"
           abort "could not rollback the code because there is no prior release"
         end
       end
@@ -584,7 +589,10 @@ Capistrano::Configuration.instance(:must_exist).load do |config|
       end
 
       if want_unlock
-        at_exit { self.unlock; }
+        at_exit { 
+          self.unlock; 
+          self.successful;
+        }
       end
 
       run "echo #{epoch} #{ENV['_AO_DEPLOYER']} > #{lock_path}"
@@ -620,13 +628,16 @@ Capistrano::Configuration.instance(:must_exist).load do |config|
       end
     end
 
-    task :successful, :only => { :primary => true } do
-      set :success, true
-      run_locally"#{figlet} success | perl -pe 's{( +)}{chr(46) x length($1)}e'"
+    task :successful do
+      if success
+        system "#{figlet} success"
+      else
+        system "#{figlet} failed"
+      end
     end
 
     task :finished do
-      successful
+      set :success, true
     end
   end # :deploy
 end # Capistrano::Configuration

data/lib/alpha_omega/deploy/scm/git.rb

@@ -77,6 +77,7 @@ module Capistrano
           execute << "[[ -d #{destination}/.git ]] || #{git} clone #{verbose} #{variable(:repository)} #{destination}"
           execute << "cd #{destination} && #{git} fetch -q && #{git} checkout -q --force #{revision}"
           execute << "cd #{destination} && #{git} reset -q --hard #{revision} && #{git} submodule update -q --init --recursive"
+          execute << "cd #{destination} && #{git} status --porcelain"
 
           execute
         end

data/libexec/_ao

@@ -19,6 +19,7 @@ DEFINE_string "group" "" "app group override" "g"
 DEFINE_string "ssh_login" "" "ssh login override" "l"
 DEFINE_boolean "migrations" "$FLAGS_FALSE" "run development migrations" "M"
 DEFINE_string "reviewer" "" "who has reviewed the production version" "R"
+DEFINE_boolean "debug" "${FLAGS_debug:-$FLAGS_FALSE}" "turn on debugging" "D"
 
 # entry point
 function main {
@@ -105,6 +106,10 @@ function main {
     export GATEWAY="$FLAGS_gateway"
   fi
 
+  if [[ -n "$FLAGS_debug" ]]; then
+    export FLAGS_debug
+  fi
+
   if [[ "$FLAGS_proxy" = "$FLAGS_FALSE" || "$FLAGS_direct" = "$FLAGS_TRUE" || -z "$FLAGS_gateway" ]]; then
     export _AO_DEPLOY=1
 
@@ -141,7 +146,6 @@ function main {
     if [[ -n "$FLAGS_reviewer" ]]; then
       export FLAGS_reviewer
     fi
-
     aomain "$nm_pod" "$@"
   else 
     if [[ "$#" > 0 ]]; then

data/libexec/_jason

@@ -136,7 +136,7 @@ function configure_logging {
 }
 
 function ryaml {
-  ruby -ryaml -e 'def ps x; unless x.nil?; puts x; end; end; ps ARGV[1..-1].inject(YAML.load(File.read(ARGV[0]))) {|acc, key| acc[key] }' "$@" 2>&-
+  ruby -ryaml -e 'def ps x; unless x.nil?; puts (x.class == String || x.class == Fixnum) ? x : x.to_yaml; end; end; ps ARGV[1..-1].inject(YAML.load(File.read(ARGV[0]))) {|acc, key| acc[acc.class == Array ? key.to_i : key] }' "$@" 2>&-
 }
 
 function random_str {

data/libexec/_log4sh

@@ -3721,6 +3721,7 @@ log4sh_cleanup()
 #*/
 _log4sh_cleanup()
 {
+  set +x
   _lc__trap=$1
   ${__LOG4SH_INFO} "_log4sh_cleanup(): the ${_lc__trap} signal was caught"
 

data/libexec/aoh-debug

@@ -16,6 +16,7 @@ require 'ao'
 
 function aomain {
   export LOCAL_ONLY=true
+  export FLAGS_DEBUG=$FLAGS_TRUE
   set -- $(for a in "$@"; do echo $a.echo; done)
   cap "$@"
 }

data/libexec/aoh-init

@@ -39,7 +39,7 @@ EOF
     chmod 755 "libexec/aohelper"
 
     for nm_cmd in activate check compare debug deploy dna hosts lock migrate proxy release restart rollback shell stage unlock; do
-      ln -nfs "../libexec/aohelper" "bin/$nm_cmd"
+      ln -nfs "../libexec/aohelper" bin/$nm_cmd
     done
   else
     if [[ "$#" < 1 ]]; then
@@ -58,7 +58,7 @@ require 'alpha_omega/deploy'
 namespace :${nm_app} do
   namespace :bundle do
     task :ruby do
-      run "PATH=${dollar}PATH:/usr/local/rvm/bin:${dollar}HOME/.rvm/bin; { cd #{deploy_release} && #{ruby_loader} bundle check 2>&1 >/dev/null; } || #{ruby_loader} bundle #{bundler_options} >/dev/null"
+      run "PATH=${dollar}PATH:/usr/local/rvm/bin:${dollar}HOME/.rvm/bin; { cd #{deploy_release} && #{ruby_loader} bundle check 2>&1 >/dev/null; } || #{ruby_loader} bundle --local --path vendor/bundle >/dev/null"
     end
   end
 end

data/libexec/aoh-proxy

@@ -48,9 +48,18 @@ function main {
   local nm_ruby="$(ryaml $_AO_HOME/config/deploy.yml app_ruby)"
 
   local tmp_remote="$(ssh $hst_gateway mktemp -t XXXXXXXXX)"
-  scp -q $shome/sbin/remote-helper $hst_gateway:$tmp_remote
-  ssh -t $hst_gateway "$pth_rvmrun" "$nm_ruby" bash "$tmp_remote" "$USER" "$git_url" "$git_spec" "$@"
-  ssh $hst_gateway rm -f $tmp_remote
+  local bash_runner
+  if [[ "${FLAGS_debug:-}" = 0 ]]; then
+    set -x
+    bash_runner="bash $tmp_remote --debug"
+  else
+    bash_runner="bash $tmp_remote"
+  fi
+  scp -q $shome/libexec/remote-helper $hst_gateway:$tmp_remote
+  ssh -t $hst_gateway $bash_runner "${pth_rvmrun:-x}" "${nm_ruby:-x}" "$USER" "$git_url" "$git_spec" "$@"
+  if [[ "${FLAGS_debug:-}" = 1 ]]; then
+    ssh $hst_gateway rm -f $tmp_remote
+  fi
 }
 
 require sub "$BASH_SOURCE" "$@"

data/libexec/aohelper

@@ -1,3 +1,5 @@
+#!/bin/bash
+
 function ryaml { 
   ruby -ryaml -e 'def ps x; unless x.nil?; puts (x.class == String || x.class == Fixnum) ? x : x.to_yaml; end; end; ps ARGV[1..-1].inject(YAML.load(File.read(ARGV[0]))) {|acc, key| acc[acc.class == Array ? key.to_i : key] }' "$@" 2>&-
 }
@@ -9,6 +11,7 @@ ruby_loader="$(ryaml $shome/config/deploy.yml ruby_loader)"
 PATH="$PATH:/usr/local/rvm/bin:$HOME/.rvm/bin"
 
 if ! $ruby_loader $app_ruby bundle check 2>&- > /dev/null; then
-  $ruby_loader $app_ruby bundle install --local --quiet
+  echo "Bundling gems" 1>&2 # TODO use logger stderr
+  $ruby_loader $app_ruby bundle install --local --quiet --path vendor/bundle
 fi
 $ruby_loader $app_ruby bundle exec ao "${BASH_SOURCE##*/}" "$@"

data/libexec/edit

@@ -0,0 +1,81 @@
+#!/bin/bash
+
+#/ NAME
+#/     edit-gem -- set environment to hint to Gemfile to use a local gemspec
+#/
+#/ SYNOPSIS
+#/     edit gem <name> [location]
+#/     edit gem -r <names>
+#/     edit gem -R
+
+# figure out the project root under which bin, lib live
+shome="$(cd -P -- "$(dirname -- "$BASH_SOURCE")/.." && pwd -P)"
+
+# load a jason bourne library
+source "$shome/libexec/_treadstone"
+
+# define command line options:
+DEFINE_boolean "update" "$FLAGS_FALSE" "finish editing a local gem and updates project" "u"
+DEFINE_boolean "reset" "$FLAGS_FALSE" "reset gem to remote" "r"
+DEFINE_boolean "resetall" "$FLAGS_FALSE" "reset all gems to remote" "R"
+
+# entry point
+function main {
+  if [[ "$FLAGS_resetall" = "$FLAGS_TRUE" ]]; then
+    set +f
+    rm -f $shome/.local/*
+    set -f
+    bundle --local --quiet && bundle check > /dev/null
+    git diff --no-ext-diff Gemfile.lock vendor/cache
+  elif [[ "$FLAGS_reset" = "$FLAGS_TRUE" ]]; then
+    local nm_gem
+    for nm_gem in "$@"; do
+      rm -f "$shome/.local/$nm_gem"
+    done
+
+    bundle --local --quiet && bundle check > /dev/null
+
+    git diff --no-ext-diff Gemfile.lock vendor/cache
+  elif [[ "$FLAGS_update" = "$FLAGS_TRUE" ]]; then
+    local nm_gem
+    for nm_gem in "$@"; do
+      echo -n > "$shome/.local/$nm_gem"
+    done
+
+    bundle update "$@"
+
+    for nm_gem in "$@"; do
+      rm -f "$shome/.local/$nm_gem"
+    done
+    bundle --local --quiet && bundle check > /dev/null
+
+    git add Gemfile.lock vendor/cache
+    git add -u vendor/cache
+    git diff --no-ext-diff --cached Gemfile.lock vendor/cache
+  else
+    local nm_gem="$1"; shift
+
+    local pth_gem
+    if [[ "$#" = 0 ]]; then
+      pth_gem="gems/$nm_gem"
+    else
+      pth_gem="$1"; shift
+    fi
+    
+    if [[ ! -d "$pth_gem" ]]; then
+      logger_fatal "cannot find local gem directoy at $pth_gem"
+      exit 1
+    fi
+
+    pth_gem="$(cd -P -- "$pth_gem" && pwd -P)"
+
+    echo "enabling local gem development on ${nm_gem} at ${pth_gem}"
+    mkdir -p "$shome/.local"
+    echo "$pth_gem" > "$shome/.local/$nm_gem"
+
+    bundle --local --quiet && bundle check > /dev/null
+    git diff --no-ext-diff Gemfile.lock vendor/cache
+  fi
+}
+
+require sub "$BASH_SOURCE" "$@"

data/libexec/remote-helper

@@ -0,0 +1,64 @@
+#!/bin/bash
+
+#/ NAME
+#/     remote-helper -- remotely builds a workarea
+#/
+#/ SYNOPSIS
+#/     
+#/     remote-heper deployer git_url git_spec deploy_comand deploy_args
+#/
+
+set -e
+if [[ "$#" > 0 ]]; then
+  if [[ "$1" = "--debug" ]]; then
+    shift
+    export FLAGS_debug=0
+    set -x
+  fi
+fi
+
+# entry point
+function main {
+  pth_rvmrun=$1; shift
+  nm_ruby=$1; shift
+  nm_deployer=$1; shift
+  git_url=$1; shift
+  git_spec=$1; shift
+  cmd_deploy=$1; shift
+
+  git_branch="${git_spec%%:*}"
+  git_sha="${git_spec##*:}"
+
+  mkdir -p "$HOME/.deploy/$nm_deployer"
+  cd "$HOME/.deploy/$nm_deployer"
+
+  nm_project=$(basename $git_url .git)
+  if [[ ! -d $nm_project ]]; then
+    git clone -q $git_url
+  fi
+
+  cd $nm_project
+  git fetch -q
+
+  if [[ -z $git_branch || $git_branch = $git_sha ]]; then
+    git reset -q --hard $git_sha
+    git checkout -q $git_sha
+  else
+    git checkout -q --force $git_branch
+    git reset -q --hard $git_sha
+  fi
+
+  git submodule -q update --init --recursive
+
+  export _AO_DEPLOYER="$nm_deployer"
+  local ruby_loader=""
+  if [[ "$pth_rvmrun" != "x" ]]; then
+    PATH="$PATH:/usr/local/rvm/bin:$HOME/.rvm/bin"
+    ruby_loader="$pth_rvmrun $nm_ruby"
+  fi
+  $ruby_loader bundle check 2>&1 >/dev/null || { bundle install --quiet --local --path vendor/bundle || bundle check > /dev/null; }
+  $ruby_loader bundle exec ao $cmd_deploy "$@"
+}
+
+# pass arguments to entry point
+main "$@"

data/libexec/stub-prepare

@@ -22,8 +22,9 @@ function main {
   local dollar='$'
   local nm_command="$1"; shift
 
-  ln -nfsv stub "$shome/bin/$nm_command"
-  cp "$0" "$shome/libexec/$nm_command"
+
+  cp "$shome/libexec/stub" "$shome/libexec/$nm_command"
+  ln -nfsv $nm_command "$shome/bin/$nm_command"
   chmod 755 "$shome/libexec/$nm_command"
 
   logger_info "$nm_command is stubbed at bin/$nm_command"

data/sbin/local-helper

@@ -1,10 +1,11 @@
 #!/bin/bash
 
 #/ NAME
-#/     stub -- symlink catchall to implement 37signals/sub interface
+#/     local-helper -- resets environment for another bundle exec
 #/
 #/ SYNOPSIS
-#/     ln -nfs stub bin/stubbed-command
+#/     
+#/     local-helper command args ...
 
 # figure out the project root under which bin, lib live
 shome="$(cd -P -- "$(dirname -- "$BASH_SOURCE")/.." && pwd -P)"
@@ -12,4 +13,12 @@ shome="$(cd -P -- "$(dirname -- "$BASH_SOURCE")/.." && pwd -P)"
 # load a jason bourne library
 source "$shome/libexec/_treadstone"
 
-require 'sub' "$BASH_SOURCE" "$@"
+# entry point
+function main {
+  unset GEM_HOME BUNDLE_GEMFILE RUBYOPT
+
+  bundle check 2>&1 >/dev/null || { bundle install --quiet --local --path vendor/bundle || bundle check > /dev/null; }
+  exec bundle exec "$@"
+}
+
+require sub "$BASH_SOURCE" "$@"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: alpha_omega
 version: !ruby/object:Gem::Version 
-  hash: 1
+  hash: 3
   prerelease: 
   segments: 
   - 1
-  - 4
-  - 3
-  version: 1.4.3
+  - 5
+  - 0
+  version: 1.5.0
 platform: ruby
 authors: 
 - David Nghiem
@@ -132,16 +132,20 @@ files:
 - libexec/aoh-rollback
 - libexec/aoh-shell
 - libexec/aoh-stage
+- libexec/aoh-stub
 - libexec/aoh-task
 - libexec/aoh-unlock
 - libexec/aohelper
 - libexec/build
 - libexec/build-gem
 - libexec/bump
+- libexec/edit
 - libexec/edit-gem
 - libexec/local-helper
 - libexec/publish
 - libexec/publish-gem
+- libexec/remote-helper
+- libexec/stub
 - libexec/stub-prepare
 - lib/alpha_omega/config/deploy.rb
 - lib/alpha_omega/config/deploy_challenge.rb
@@ -166,9 +170,6 @@ files:
 - lib/alpha_omega/version.rb
 - lib/development.rb
 - sbin/activate
-- sbin/aoh
-- sbin/aoh-stub
-- sbin/bump
 - sbin/check
 - sbin/compare
 - sbin/debug
@@ -182,12 +183,10 @@ files:
 - sbin/proxy
 - sbin/release
 - sbin/remote
-- sbin/remote-helper
 - sbin/restart
 - sbin/rollback
 - sbin/shell
 - sbin/stage
-- sbin/stub
 - sbin/task
 - sbin/unlock
 - bin/ao

data/sbin/aoh

@@ -1,15 +0,0 @@
-#!/bin/bash
-
-#/ NAME
-#/     stub -- symlink catchall to implement 37signals/sub interface
-#/
-#/ SYNOPSIS
-#/     ln -nfs stub bin/stubbed-command
-
-# figure out the project root under which bin, lib live
-shome="$(cd -P -- "$(dirname -- "$BASH_SOURCE")/.." && pwd -P)"
-
-# load a jason bourne library
-source "$shome/libexec/_treadstone"
-
-require 'sub' "$BASH_SOURCE" "$@"

data/sbin/bump

@@ -1,15 +0,0 @@
-#!/bin/bash
-
-#/ NAME
-#/     stub -- symlink catchall to implement 37signals/sub interface
-#/
-#/ SYNOPSIS
-#/     ln -nfs stub bin/stubbed-command
-
-# figure out the project root under which bin, lib live
-shome="$(cd -P -- "$(dirname -- "$BASH_SOURCE")/.." && pwd -P)"
-
-# load a jason bourne library
-source "$shome/libexec/_treadstone"
-
-require 'sub' "$BASH_SOURCE" "$@"

data/sbin/remote-helper

@@ -1,81 +0,0 @@
-#!/bin/bash
-
-#/ NAME
-#/     remote-helper -- remotely builds a workarea
-#/
-#/ SYNOPSIS
-#/     
-#/     remote-heper deployer git_url git_spec deploy_comand deploy_args
-#/
-
-set -e
-
-# figure out the project root under which bin, lib live
-shome="$(cd -P -- "$(dirname -- "$BASH_SOURCE")/.." && pwd -P)"
-
-fl_debug=
-
-function crumb {
-  if [[ -n "$fl_debug" ]]; then
-    echo "$(date) $@" 1>&2
-  fi
-}
-
-# entry point
-function main {
-  nm_deployer=$1; shift
-  git_url=$1; shift
-  git_spec=$1; shift
-  cmd_deploy=$1; shift
-
-  if [[ "$cmd_deploy" = "debug" ]]; then
-    fl_debug=1
-  fi
-
-  crumb "start remote-helper with args: $nm_deployer, $git_url, $git_spec, $cmd_deploy"
-  crumb "additional args: $@"
-
-  git_branch="${git_spec%%:*}"
-  git_sha="${git_spec##*:}"
-
-  crumb "derive: git_branch = $git_branch"
-  crumb "derive: git_sha = $git_sha"
-
-  mkdir -p "$HOME/.deploy/$nm_deployer"
-  cd "$HOME/.deploy/$nm_deployer"
-
-  nm_project=$(basename $git_url .git)
-  if [[ ! -d $nm_project ]]; then
-    crumb "git clone $git_url"
-    git clone -q $git_url
-  fi
-  crumb "remote deploy on ${LOGNAME}@$(hostname) in $HOME/.deploy/$nm_deployer/$nm_project/"
-
-  cd $nm_project
-  git fetch -q
-
-  if [[ -z $git_branch || $git_branch = $git_sha ]]; then
-    crumb "git reset, checkout of $git_sha"
-    git reset -q --hard $git_sha
-    git checkout -q $git_sha
-  else
-    crumb "git checkout of $git_branch, reset of $git_sha"
-    git checkout -q --force $git_branch
-    git reset -q --hard $git_sha
-  fi
-
-  crumb "git submodule"
-  git submodule -q update --init --recursive
-
-  crumb "executing ao $cmd_deploy $@"
-  export _AO_DEPLOYER="$nm_deployer"
-  bundle check 2>&1 >/dev/null || { bundle install --quiet --local --path vendor/bundle || bundle check > /dev/null; }
-  bundle exec ao $cmd_deploy "$@"
-  crumb "end remote-helper"
-}
-
-# setup
-unset cd # disable rvm's cd function to prevent prompts
-
-# pass arguments to entry point
-main "$@"