threetee-capistrano-offroad 0.1.2

data/LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2010, Maciej Pasternacki <maciej@pasternacki.net>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the copyright holder nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL MACIEJ PASTERNACKI BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README

@@ -0,0 +1,339 @@
+                          Capistrano-offroad
+                          ==================
+
+Author: Maciej Pasternacki <maciej@pasternacki.net>
+Date: 2010-05-28 Fri
+
+
+Capistrano-offroad is a support package for using Capistrano with
+non-rails projects.  It contains basic reset of Rails-specific tasks,
+a handful of utility functions, and modules with recipes.
+
+Capistrano-offroad is available on terms of BSD license.  See LICENSE
+file for details.
+
+Table of Contents
+=================
+1 Installation 
+    1.1 System-wide installation 
+    1.2 Project-local installation 
+2 Usage 
+3 Features 
+    3.1 Reset 
+    3.2 Utilities 
+        3.2.1 `:run' dependency type 
+        3.2.2 `set_from_env_or_ask' 
+        3.2.3 `offroad_modules' 
+    3.3 Version 
+        3.3.1 `require_version' 
+    3.4 Modules 
+        3.4.1 defaults 
+        3.4.2 django 
+        3.4.3 supervisord 
+        3.4.4 daemontools 
+        3.4.5 monit 
+
+
+1 Installation 
+~~~~~~~~~~~~~~~
+
+1.1 System-wide installation 
+=============================
+
+   Capistrano-offroad is available as a Ruby Gem, so in most cases you
+   should simply call:
+
+   gem install capistrano-offroad
+
+   This requires fairly recent version of Ruby gems (1.3.6 or later),
+   so it's possible you'll need to upgrade rubygems itself:
+
+   gem update --system
+
+   You can also download source code directly from Github page
+   [http://github.com/mpasternacki/capistrano-offroad] and install it by
+   rebuilding the gem manually.
+
+1.2 Project-local installation 
+===============================
+
+   You can download source code from Github and use it as a Git
+   submodule, or just drop it into your code base in whatever way
+   suits you.  Then, you should add to you Capfile the magic line
+   adding capistrano-offroad's `lib/' subdirectory to the require
+   path.
+
+   $:.unshift File.join( File.dirname(__FILE__), 'relative/path/to/capistrano-offroad/lib' )
+
+2 Usage 
+~~~~~~~~
+
+  When you've got capistrano-offroad on your require path, whether
+  globally from a gem, or by extending require path, you simply
+  `require' it.
+
+  require 'capistrano-offroad'
+
+  For some reason, this line should appear *after* the
+  `set :application' declaration.
+
+  After that, you either `require' desired modules yourself, or use
+  `offroad_modules' helper function.
+
+  require 'capistrano-offroad/modules/defaults'
+  require 'capistrano-offroad/modules/django'
+
+  offroad_modules 'defaults', 'django'
+
+3 Features 
+~~~~~~~~~~~
+
+3.1 Reset 
+==========
+   By default, capistrano-offroad empties Rails-specific tasks:
+   `deploy:migrate', `deploy:start', `deploy:stop', `deploy:restart'.
+
+   The `:deploy:finalize_update' task is cut down to only run `chgrp'
+   and `chmod' when `:group_writable' setting is true.  `chgrp'
+   behaviour can be modified by setting `:group_writable' to:
+   - `:no_chgrp' - don't run `chgrp' command
+   - `:sudo_chgrp' - use `sudo' to make sure `chgrp' has proper permissions
+
+   The setting `:shared_children' is set to an empty list.  This gives
+   comfortable enough blank slate for working on non-rails projects,
+   without redefining all the workflow that is already present in
+   Capistrano.
+
+3.2 Utilities 
+==============
+   By default, two extensions to Capistrano are defined.
+
+3.2.1 `:run' dependency type 
+-----------------------------
+    Usage:
+    depend :remote, :run, "full shell command"=
+
+    When running `cap deploy:check', run the supplied shell command.
+    If its exit status is non-zero, the dependency has failed.
+
+3.2.2 `set_from_env_or_ask' 
+----------------------------
+    Usage:
+    set_from_env_or_ask :setting_name, "Query prompt: "
+
+    If there is `SETTING_NAME' (uppercased first argument) in
+    environment (i.e. supplied from command line), set `:setting_name'
+    to value of this environment variable.
+
+    If the environment variable is not defined, ask user interactively
+    for a value, using query prompt supplied as a second argument.
+
+3.2.3 `offroad_modules' 
+------------------------
+    Loads capistrano-offroad modules named as arguments.  Convenience
+    function, so that user doesn't have to type `require' lines by himself.
+
+3.3 Version 
+============
+   Three constants defining version of capistrano-offroad are defined:
+
+   CapistranoOffroad::VERSION::MAJOR
+   CapistranoOffroad::VERSION::MINOR
+   CapistranoOffroad::VERSION::TINY
+
+   Convenience string constant with full version number, separated
+   with dots, is provided:
+
+   CapistranoOffroad::VERSION::STRING
+
+3.3.1 `require_version' 
+------------------------
+    A helper function, which can be used in Capfile to enforce a minimum
+    version of capistrano-offroad:
+
+    CapistranoOffroad::VERSION.require_version(major, minor=0, tiny=0)
+
+3.4 Modules 
+============
+   Modules are packs of recipes and helpers for dealing with specific
+   software.
+
+   To load a module, either use the `require' function:
+
+   require 'capistrano-offroad/modules/module-name'
+
+   or use supplied `offroad_modules' helper function:
+
+   offroad_modules "foo", "bar", "baz", ...
+
+   When using a module, it is advised to at least browse through its
+   source to know what to expect.
+
+   Following modules are defined:
+
+3.4.1 defaults 
+---------------
+
+    Contains my personal defaults for settings.  For me it's part of
+    reset, but I moved it out to a separate module, because other
+    users may have different opinions.  The settings are:
+
+    set :scm, :git
+    set :ssh_options, { :forward_agent => true }
+    set :use_sudo, false
+    set :deploy_to, "/srv/#{application}"
+
+3.4.2 django 
+-------------
+    Settings, utilities and recipes for deploying [Django] projects.
+
+    [Django]: http://djangoproject.org/
+
+* Settings 
+  Following settings are defined.
+  + :python 
+    Python interpreter command.  Defaults to "python".
+    
+    Module also adds a dependency on this command to `deploy:check'.
+  + :django_project_subdirectory 
+    Directory in your repository that contains Django project (one
+    with the the `manage.py' file).  Defaults to "project".
+  + :django_use_south 
+    Assume [South] is used for database migrations.  Defaults to false.
+
+    [South]: http://south.aeracode.org/
+
+  + :django_databases 
+    This setting can be set to a list of database names (for
+    Django-1.2 multi-database support), against which Capistrano
+    will run syncdb/migrations. If unset or false, syncdb/migrations
+    will be run with default database only (as for pre-1.2 Django).
+* Functions and utilities 
+  django_manage cmd, options={}
+  Runs the `manage.py' command `cmd'.  Optional keyword argument
+  `:path' provides path to a Capistrano release where the command
+  should be run.  It defaults to `:latest_release'.
+  
+  `:python_module' dependency type is defined to name Python
+  modules in `deploy:check' dependencies:
+  
+  depend :remote, :python_module, "MySQLdb"
+* Tasks 
+  + django:manage 
+    Run custom Django management command in latest release.
+    
+    Pass the management command and arguments in COMMAND="..."
+    variable.  If COMMAND variable is not provided, Capistrano will
+    ask for a command.
+    
+  + deploy:migrate 
+    Runs `manage.py syncdb' in the latest release.  If
+    `:django_use_south' is true, it `--migrate' switch is used.
+    - TODO make it run in specified release, as vanilla Rails `deploy:migrate' 
+  + TODO separate `python' module 
+    Stuff that is not Django-specific should be moved to a separate
+    `python' module that could be used with Python-related
+    non-Django projects.  The `python' module would be automatically
+    loaded by `django' module.
+    
+
+3.4.3 supervisord 
+------------------
+    Control processes with [the supervisor daemon].
+
+
+    [the supervisor daemon]: http://supervisord.org/
+
+* Settings 
+  set :supervisord_path, ""     # directory where supervisord binaries reside
+  set :supervisord_command, "supervisord"
+  set :supervisorctl_command, "supervisorctl"
+  set :supervisord_conf, "supervisord_conf"
+  set :supervisord_pidfile, "supervisord.pid"
+  set :supervisord_start_group, nil # process group to start on deploy:start - nil means all processes
+  set :supervisord_stop_group, nil  # process group to stop on deploy:stop - nil means all processes
+  
+* Utilities 
+  supervisorctl(cmd, options={})
+  Run a `supervisorctl' command specified as first argument.  If
+  optional keyword argument `:try_start' is true (the default, you
+  may specify as false), start `supervisord' if not already
+  running.
+  
+* Tasks 
+  + Standard tasks 
+    Stock Capistrano tasks `deploy:start', `deploy:stop',
+    `deploy:restart' are defined.  They optionally accept `GROUP' or
+    `PROGRAM' environment variables, which can specify a single,
+    specific process group or a single process name to start, stop
+    or restart.
+  + deploy:status 
+    Runs `supervisorctl status'.
+  + deploy:processes 
+    Runs `pstree' with root in supervisord if supervisord is
+    running.
+  + deploy:reload_supervisord 
+    Reloads supervisor daemon's config.  Starts it if not started.
+  + deploy:run_supervisorctl 
+    Runs supplied supervisorctl command.  Command should be provided
+    in COMMAND variable; if no variable is provided,
+    capistrano-offroad will ask for the command.
+    
+
+3.4.4 daemontools 
+------------------
+    Recipes and settings for controlling processes with Dan
+    Bernstein's [daemontools].  It expects that `run' script lives in
+    top level of your repository.
+
+    *WARNING*: this is legacy code, used only in old projects and not
+    very well supported.
+
+    Also, this is probably not the best way to deal with the problem -
+    it would be easier to manage, start and restart with the `run'
+    script in the `:deploy_to' root, which would `cd' to `current' and
+    `exec ./run'.  If anybody wants to write a patch to support that,
+    it would be great :)
+
+    [daemontools]: http://cr.yp.to/daemontools.html
+
+* Settings 
+  set :svscan_root, "/service"
+  set :supervise_name, "#{application}"
+* Utilities 
+  `svc' function runs `svc' with supplied arguments for the
+  supervised directory.
+* Tasks 
+  - `daemontools:create_symlink' - creates a symlink in `:svscan_root'
+  - `daemontools:remove_symlink' - removes symlink from
+    `:svscan_root' and stops the app
+  - `daemontools:status' - displays `svstat' output for current release
+  - `daemontools:relstatus' - displays `svstat' output for all
+    releases (use it after restart to make sure that previous
+    release has actually stopped)
+  - `deploy:start', `deploy:stop', `deploy:restart' - standard
+    Capistrano tasks
+  - `deploy:symlink' internal target is redefined; `on_rollback'
+    handler is currently broken
+  
+
+3.4.5 monit 
+------------
+    Module to run processes with monit.
+    *This is legacy, unsupported, unused code*. Use it (and monit) on
+    your own risk.  I'm leaving it in only because the code is already
+    written and it would be waste to throw it away only because monit
+    sucks.
+* Settings 
+  set :monit_group, nil         # process group to start/stop/reload
+  set :monit_command, "monit"
+  
+* Tasks 
+  - `deploy:start', `deploy:stop', `deploy:restart' - standard
+    Capistrano tasks.  They accept an extra optional variable
+    PROCESS which, if given, specifies a single process to start,
+    stop or restart.  If PROCESS is not given, all processes (of
+    `:monit_group' group, if configured) are started/stopped/restarted.
+  - `deploy:status' - displays `monit summary' output
+  - `deploy:status:full' - displays `monit status' output
+  - `deploy:reload_monit' - reloads monit configuration

data/lib/capistrano-offroad.rb

@@ -0,0 +1,8 @@
+require 'capistrano-offroad/version'
+require 'capistrano-offroad/reset'
+require 'capistrano-offroad/utils'
+
+# just for consistency
+def offroad_modules(*modules)
+  modules.each { |mod| require "capistrano-offroad/modules/#{mod}" }
+end

data/lib/capistrano-offroad/modules/daemontools.rb

@@ -0,0 +1,75 @@
+# Running via demontools
+require 'capistrano'
+
+Capistrano::Configuration.instance(:must_exist).load do
+  set :svscan_root, "/service"
+  set :supervise_name, "#{application}"
+
+  def svc(cmd)
+    sudo "svc #{cmd} #{svscan_root}/#{supervise_name}"
+  end
+
+  namespace :daemontools do
+    desc "Create symlink in svscan directory"
+    task :create_symlink, :except => { :no_release => true } do
+      sudo "ln -s -v #{current_path} #{svscan_root}/#{supervise_name}"
+    end
+
+    desc "[internal] Remove symlink from svscan directory"
+    task :do_remove_symlink, :except => { :no_release => true } do
+      sudo "rm -v #{svscan_root}/#{supervise_name}"
+    end
+
+    desc "Remove symlink from svscan directory and stop supervise"
+    task :remove_symlink, :except => { :no_release => true } do
+      do_remove_symlink
+      sudo "svc -x -t #{current_path}"
+    end
+
+    desc "Supervise status of current release"
+    task :status, :except => { :no_release => true } do
+      sudo "svstat #{svscan_root}/#{supervise_name}"
+    end
+
+    desc "Supervise status of all releases"
+    task :relstatus, :except => { :no_release => true } do
+      sudo "svstat #{releases_path}/*"
+    end
+  end
+
+  namespace :deploy do
+    desc "Start service (svc -u)"
+    task :start, :except => { :no_release => true } do
+      svc "-u"
+    end
+
+    desc "Stop service (svc -d)"
+    task :stop, :except => { :no_release => true } do
+      svc "-d"
+    end
+
+    desc "Restart service (svc -t)"
+    task :restart, :except => { :no_release => true } do
+      svc "-t"
+    end
+
+    desc <<-DESC
+  [internal] Symlink latest release to current, taking daemontools into accont.
+
+  WARNING: rollback is broken!
+  DESC
+    task :symlink, :except => { :no_release => true } do
+      on_rollback { run "rm -f #{current_path}; ln -s #{previous_release} #{current_path}; true" } # FIXME!
+      run "rm -f #{current_path}"
+      sleep 5
+      sudo "svc -t -x #{previous_release}"
+      run "ln -s #{latest_release} #{current_path}"
+    end
+  end
+
+  before "deploy:cleanup" do
+    # needed, by default I don't use sudo, but we need one to remove
+    # supervise/ directories.
+    set :run_method, :sudo
+  end
+end

data/lib/capistrano-offroad/modules/defaults.rb

@@ -0,0 +1,9 @@
+# My defaults for deployment, may or may nat be useful for anyone else.
+require 'capistrano'
+
+Capistrano::Configuration.instance(:must_exist).load do
+  set :scm, :git
+  set :ssh_options, { :forward_agent => true }
+  set :use_sudo, false
+  set :deploy_to, "/srv/#{application}"
+end

data/lib/capistrano-offroad/modules/django.rb

@@ -0,0 +1,58 @@
+# Django deployment
+
+require 'capistrano'
+
+Capistrano::Configuration.instance(:must_exist).load do
+
+  set :python, "python"
+
+  set :django_project_subdirectory, "project"
+  set :django_use_south, false
+  set :django_databases, nil
+
+  depend :remote, :command, "#{python}"
+
+  def django_manage(cmd, options={})
+    path = options.delete(:path) || "#{latest_release}"
+    run "cd #{path}/#{django_project_subdirectory}; #{python} manage.py #{cmd}", options
+  end
+
+  namespace :django do
+    desc <<EOF
+Run custom Django management command in latest release.
+
+Pass the management command and arguments in COMMAND="..." variable.
+If COMMAND variable is not provided, Capistrano will ask for a command.
+EOF
+    task :manage, :except => { :no_release => true } do
+      set_from_env_or_ask :command, "Enter management command"
+      django_manage "#{command}"
+    end
+  end
+
+  namespace :deploy do
+    desc "Run manage.py syncdb in latest release."
+    task :migrate, :roles => :db, :only => { :primary => true } do
+      # FIXME: path, see default railsy deploy:migrate
+      m = if fetch(:django_use_south, false) then "--migrate" else "" end
+      if fetch(:django_databases, nil)
+        fetch(:django_databases, nil).each { |db|
+          django_manage "syncdb --noinput #{m} --database=#{db}"
+        }
+      else
+        django_manage "syncdb --noinput #{m}"
+      end
+    end
+  end
+
+  # depend :remote, :python_module, "module_name"
+  # runs #{python} and tries to import module_name.
+  class Capistrano::Deploy::RemoteDependency
+    def python_module(module_name, options={})
+      @message ||= "Cannot import `#{module_name}'"
+      python = configuration.fetch(:python, "python")
+      try("#{python} -c 'import #{module_name}'", options)
+      self
+    end
+  end
+end

data/lib/capistrano-offroad/modules/monit.rb

@@ -0,0 +1,51 @@
+require 'capistrano'
+
+Capistrano::Configuration.instance(:must_exist).load do
+  set :monit_group, nil         # process group to start/stop/reload
+  set :monit_command, "monit"
+
+  def _monit_args()
+    if fetch :monit_group, nil then
+      return " -g #{monit_group} "
+    else
+      return ""
+    end
+  end
+
+  namespace :deploy do
+    desc "Start processes"
+    task :start, :except => { :no_release => true } do
+      process = ENV['PROCESS'] || 'all'
+      sudo "#{monit_command} #{_monit_args} start #{process}"
+    end
+
+    desc "Stop processes"
+    task :stop, :except => { :no_release => true } do
+      process = ENV['PROCESS'] || 'all'
+      sudo "#{monit_command} #{_monit_args} stop #{process}"
+    end
+
+    desc "Restart processes"
+    task :restart, :except => { :no_release => true } do
+      process = ENV['PROCESS'] || 'all'
+      sudo "#{monit_command} #{_monit_args} restart #{process}"
+    end
+
+    namespace :status do
+      desc "Status summary"
+      task :default, :except => { :no_release => true } do
+        sudo "#{monit_command} #{_monit_args} summary"
+      end
+
+      desc "Full status"
+      task :full, :except => { :no_release => true } do
+        sudo "#{monit_command} #{_monit_args} status"
+      end
+    end
+
+    desc "Reload monit"
+    task :reload_monit, :except => { :no_release => true } do
+      sudo "#{monit_command} reload"
+    end
+  end
+end

data/lib/capistrano-offroad/modules/supervisord.rb

@@ -0,0 +1,94 @@
+require 'capistrano'
+
+Capistrano::Configuration.instance(:must_exist).load do
+  set :supervisord_path, ""     # directory where supervisord binaries reside
+  set :supervisord_command, "supervisord"
+  set :supervisorctl_command, "supervisorctl"
+  set :supervisord_conf, "supervisord_conf"
+  set :supervisord_pidfile, "supervisord.pid"
+  set :supervisord_start_group, nil # process group to start on deploy:start - nil means all processes
+  set :supervisord_stop_group, nil  # process group to stop on deploy:stop - nil means all processes
+
+  namespace :deploy do
+    def supervisord_pidfile_path ; "#{shared_path}/#{supervisord_pidfile}" end
+    def supervisord_pid ; "`cat #{supervisord_pidfile_path}`" end
+
+    # Run supervisorctl command `cmd'.
+    # If options[:try_start] is true (default) and supervisord is not running, start it.
+    # If just started supervisord, and options[:run_when_started] is false (default), skip running supervisorctl
+    def supervisorctl(cmd, options={})
+      try_start = options.delete(:try_start) {|k| true}
+
+      full_command = "#{supervisord_path}#{supervisorctl_command} -c #{current_path}/#{supervisord_conf} #{cmd}"
+      after_start = (full_command if options.delete(:run_when_started)) || ""
+
+      if not try_start then
+        run full_command, options
+      else
+        run <<-EOF, options
+        if test -f #{shared_path}/#{supervisord_pidfile}
+             && ps #{supervisord_pid} > /dev/null ;
+        then
+          echo "supervisord seems to be up, good" ;
+          #{full_command} ;
+        else
+          echo "starting supervisord" ;
+          #{sudo :as => deploy_user} #{supervisord_path}#{supervisord_command} -c #{current_path}/#{supervisord_conf} ;
+          #{after_start}
+        fi
+    EOF
+      end
+    end
+
+    def _target(var)
+      group_name = ENV['GROUP']
+      group_name ||= fetch var
+      prog_name = ENV['PROGRAM']
+      prog_name ||= 'all'
+
+      if ['', nil].include? group_name then
+        prog_name
+      else
+        "'#{group_name}:*'"
+      end
+    end
+
+    desc "Start processes"
+    task :start, :except => { :no_release => true } do
+      to_start = _target(:supervisord_start_group)
+      supervisorctl "start #{to_start}", :try_start => true
+    end
+
+    desc "Stop processes"
+    task :stop, :except => { :no_release => true } do
+      to_stop = _target(:supervisord_stop_group)
+      supervisorctl "stop #{to_stop}", :try_start => false
+    end
+
+    desc "Restart processes"
+    task :restart, :except => { :no_release => true } do
+      to_restart = _target(:supervisord_start_group)
+      supervisorctl "restart #{to_restart}"
+    end
+
+    desc "Display status of processes"
+    task :status, :except => { :no_release => true } do
+      supervisorctl "status", :try_start => false
+    end
+
+    desc "Display detailed list of processes"
+    task :processes, :except => { :no_release => true } do
+      run "test -f #{supervisord_pidfile_path} && pstree -a #{supervisord_pid}"
+    end
+
+    desc "Reload supervisor daemon"
+    task :reload_supervisord, :except => { :no_release => true } do
+      supervisorctl "reload"
+    end
+
+    task :run_supervisorctl, :except => { :no_release => true } do
+      set_from_env_or_ask :command, "supervisorctl command: "
+      supervisorctl "#{command}", :try_start => false
+    end
+  end
+end

data/lib/capistrano-offroad/reset.rb

@@ -0,0 +1,26 @@
+# Reset Rails-specific stuff.
+
+require 'capistrano'
+
+Capistrano::Configuration.instance(:must_exist).load do
+  set :shared_children, %w()
+
+  namespace :deploy do
+    task :finalize_update, :except => { :no_release => true } do
+      if fetch(:group_writable, true)
+        if :no_chgrp == fetch(:group_writable, true)
+          # skip step
+        elsif :sudo_chgrp == fetch(:group_writable, true)
+          sudo "chgrp -R #{deploy_group} #{latest_release}"
+        else
+          run "chgrp -R #{deploy_group} #{latest_release}"
+        end
+        run "chmod -R g+w #{latest_release}"
+      end
+    end
+    task :migrate do end
+    task :start do end
+    task :stop do end
+    task :restart do end
+  end
+end

data/lib/capistrano-offroad/utils.rb

@@ -0,0 +1,67 @@
+# Small extensions to Capistrano
+
+require 'capistrano'
+
+# depend :remote, :run, "whole command with args"
+# runs command, if return code <> 0, dependency fails.
+class Capistrano::Deploy::RemoteDependency
+  def run(command, options={})
+    @message ||= "Cannot run `#{command}'"
+    try(command, options)
+    self
+  end
+end
+
+class Capistrano::Configuration
+  # set_from_env_or_ask :variable, "Please enter variable name: "
+  # If there is VARIABLE in enviroment, set :variable to it, otherwise
+  # ask user for a value
+  def set_from_env_or_ask(sym, question)
+    if ENV.has_key? sym.to_s.upcase then
+      set sym, ENV[sym.to_s.upcase]
+    else
+      set sym do Capistrano::CLI.ui.ask question end
+    end
+  end
+
+  def delayed_warning(short, long=nil)
+    @_offroad_util_warnings ||= []
+    @_offroad_util_warnings.push short
+    puts <<EOF
+
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+                           BIG FAT WARNING:
+EOF
+    puts short
+    puts long if long
+puts <<EOF
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+EOF
+  end
+
+  def _offroad_emit_warnings()
+    if @_offroad_util_warnings
+      puts <<-"EOF"
+
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+                         #{@_offroad_util_warnings.length} WARNING(S) LOGGED
+        READ VERY CAREFULLY, FOR I SHALL WRITE THIS ONLY ONCE
+                        SCROLL UP FOR DETAILS
+
+EOF
+        @_offroad_util_warnings.each { |w| puts " - #{w}" }
+        puts <<EOF
+
+                         YOU HAVE BEEN WARNED
+EOF
+    end
+  end
+end
+
+Capistrano::Configuration.instance(:must_exist).load do
+  on :exit do
+    _offroad_emit_warnings
+  end
+end

data/lib/capistrano-offroad/version.rb

@@ -0,0 +1,14 @@
+module CapistranoOffroad
+  module VERSION
+    MAJOR = 0
+    MINOR = 1
+    TINY  = 2
+    STRING = [MAJOR, MINOR, TINY].join('.')
+
+    def VERSION.require_version(major, minor=0, tiny=0)
+      unless ([MAJOR, MINOR, TINY] <=> [major, minor, tiny]) >= 0
+        raise Capistrano::Error, "capistrano-offroad version #{MAJOR}.#{MINOR}.#{TINY} is below required #{major}.#{minor}.#{tiny}"
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: threetee-capistrano-offroad
+version: !ruby/object:Gem::Version 
+  hash: 31
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 2
+  version: 0.1.2
+platform: ruby
+authors: 
+- Maciej Pasternacki
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-02 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: capistrano
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 2
+        - 5
+        - 8
+        version: 2.5.8
+  type: :runtime
+  version_requirements: *id001
+description: |
+  Capistrano-offroad is a support package for using Capistrano with
+  non-rails projects.  It contains basic reset of Rails-specific tasks,
+  a handful of utility functions, and modules with recipes.
+
+email: maciej@pasternacki.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/capistrano-offroad/modules/daemontools.rb
+- lib/capistrano-offroad/modules/defaults.rb
+- lib/capistrano-offroad/modules/django.rb
+- lib/capistrano-offroad/modules/monit.rb
+- lib/capistrano-offroad/modules/supervisord.rb
+- lib/capistrano-offroad/reset.rb
+- lib/capistrano-offroad/utils.rb
+- lib/capistrano-offroad/version.rb
+- lib/capistrano-offroad.rb
+- README
+- LICENSE
+has_rdoc: true
+homepage: http://github.com/mpasternacki/capistrano-offroad
+licenses: 
+- BSD
+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: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Capistrano add-ons and recipes for non-rails projects
+test_files: []
+