colorful-mina 0.3.1

data/Rakefile

@@ -0,0 +1,20 @@
+require 'bundler'
+require 'bundler/gem_tasks'
+
+github = ENV['github'] || 'nadarei/mina'
+
+task :spec do
+  system "rm Gemfile.lock; sh -c 'rake=0.8 bundle exec rspec'"
+  system "rm Gemfile.lock; sh -c 'rake=0.9 bundle exec rspec'"
+end
+
+task :docs do
+  files = ['manual/index.md', 'manual/modules.md', 'HISTORY.md'] + Dir['lib/**/*.rb']
+  system "lidoc #{files.join ' '} -o docs --github #{github}"
+end
+
+task :'docs:deploy' => :docs do
+  system "git-update-ghpages #{github} -i docs -p docs"
+end
+
+task :default => :spec

data/bin/mina

@@ -0,0 +1,65 @@
+#!/usr/bin/env ruby
+$:.unshift File.expand_path('../../lib', __FILE__)
+
+require 'rubygems' unless Object.const_defined?(:Gem)
+require 'mina'
+require 'rake'
+
+# Intercept: if invoked as 'mina --help', don't let it pass through Rake, or else
+# we'll see the Rake help screen. Redirect it to 'mina help'.
+if ARGV.delete('--help') || ARGV.delete('-h')
+  ARGV << 'help'
+end
+
+if ARGV.delete('--version') || ARGV.delete('-V')
+  puts "Mina, version v#{Mina.version}"
+  exit
+end
+
+if ARGV.delete('--simulate') || ARGV.delete('-S')
+  ENV['simulate'] = '1'
+end
+
+scope = self
+
+Rake.application.instance_eval do
+  standard_exception_handling do
+    begin
+      # Initialize Rake and make it think it's Mina.
+      init 'mina'
+
+      # (The only way @rakefiles has only 1 value is if -f is specified.)
+      custom_rakefile = (@rakefiles.size == 1)
+      @rakefiles = ['Minafile', 'config/deploy.rb']  unless custom_rakefile
+
+      # Workaround: Rake 0.9+ doesn't record task descriptions unless it's needed.
+      # Need it for 'mina help'
+      if Rake::TaskManager.respond_to?(:record_task_metadata)
+        Rake::TaskManager.record_task_metadata = true
+      end
+
+      # Load the Mina Rake DSL.
+      require 'mina/rake'
+
+      # Allow running without a Rakefile
+      begin
+        load_rakefile  if have_rakefile || custom_rakefile
+      rescue Exception
+        puts "Error loading Rakefile!"
+        raise "There may be a problem with config/deploy.rb and/or Rakefile"
+      end
+
+      # Run tasks
+      top_level
+
+      scope.mina_cleanup! if top_level_tasks.any?
+
+    rescue Mina::Failed => e
+      puts ""
+      scope.print_error "Command failed."
+      scope.print_stderr "#{e.message}"
+      exit(e.exitstatus > 255 ? e.exitstatus >> 8 : e.exitstatus)
+    end
+  end
+end
+

data/data/deploy.rb

@@ -0,0 +1,80 @@
+require 'mina/bundler'
+require 'mina/rails'
+require 'mina/git'
+# require 'mina/rbenv'  # for rbenv support. (http://rbenv.org)
+# require 'mina/rvm'    # for rvm support. (http://rvm.io)
+
+# Basic settings:
+#   domain       - The hostname to SSH to.
+#   deploy_to    - Path to deploy into.
+#   repository   - Git repo to clone from. (needed by mina/git)
+#   branch       - Branch name to deploy. (needed by mina/git)
+
+set :domain, 'foobar.com'
+set :deploy_to, '/var/www/foobar.com'
+set :repository, 'git://...'
+set :branch, 'master'
+
+# For system-wide RVM install.
+#   set :rvm_path, '/usr/local/rvm/bin/rvm'
+
+# Manually create these paths in shared/ (eg: shared/config/database.yml) in your server.
+# They will be linked in the 'deploy:link_shared_paths' step.
+set :shared_paths, ['config/database.yml', 'log']
+
+# Optional settings:
+#   set :user, 'foobar'    # Username in the server to SSH to.
+#   set :port, '30000'     # SSH port number.
+#   set :forward_agent, true     # SSH forward_agent.
+
+# This task is the environment that is loaded for most commands, such as
+# `mina deploy` or `mina rake`.
+task :environment do
+  # If you're using rbenv, use this to load the rbenv environment.
+  # Be sure to commit your .ruby-version or .rbenv-version to your repository.
+  # invoke :'rbenv:load'
+
+  # For those using RVM, use this to load an RVM version@gemset.
+  # invoke :'rvm:use[ruby-1.9.3-p125@default]'
+end
+
+# Put any custom mkdir's in here for when `mina setup` is ran.
+# For Rails apps, we'll make some of the shared paths that are shared between
+# all releases.
+task :setup => :environment do
+  queue! %[mkdir -p "#{deploy_to}/#{shared_path}/log"]
+  queue! %[chmod g+rx,u+rwx "#{deploy_to}/#{shared_path}/log"]
+
+  queue! %[mkdir -p "#{deploy_to}/#{shared_path}/config"]
+  queue! %[chmod g+rx,u+rwx "#{deploy_to}/#{shared_path}/config"]
+
+  queue! %[touch "#{deploy_to}/#{shared_path}/config/database.yml"]
+  queue  %[echo "-----> Be sure to edit '#{deploy_to}/#{shared_path}/config/database.yml'."]
+end
+
+desc "Deploys the current version to the server."
+task :deploy => :environment do
+  deploy do
+    # Put things that will set up an empty directory into a fully set-up
+    # instance of your project.
+    invoke :'git:clone'
+    invoke :'deploy:link_shared_paths'
+    invoke :'bundle:install'
+    invoke :'rails:db_migrate'
+    invoke :'rails:assets_precompile'
+    invoke :'deploy:cleanup'
+
+    to :launch do
+      queue "mkdir -p #{deploy_to}/#{current_path}/tmp/"
+      queue "touch #{deploy_to}/#{current_path}/tmp/restart.txt"
+    end
+  end
+end
+
+# For help in making your deploy script, see the Mina documentation:
+#
+#  - http://nadarei.co/mina
+#  - http://nadarei.co/mina/tasks
+#  - http://nadarei.co/mina/settings
+#  - http://nadarei.co/mina/helpers
+

data/data/deploy.sh.erb

@@ -0,0 +1,106 @@
+<%
+  prepare = commands(:default).map { |s| "(\n\n#{indent 2, s}\n\n)" }.join(" && ")
+  launch  = commands(:launch).map  { |s| "(\n\n#{indent 2, s}\n\n)" }.join(" && ")
+  clean   = commands(:clean).map   { |s| "(\n\n#{indent 2, s}\n\n)" }.join(" && ")
+%>
+#!/usr/bin/env bash
+
+# Go to the deploy path
+cd "<%= deploy_to %>" || (
+  echo "! ERROR: not set up."
+  echo "The path '<%= deploy_to %>' is not accessible on the server."
+  echo "You may need to run 'mina setup' first."
+  false
+) || exit 15
+
+# Check releases path
+if [ ! -d "<%= releases_path %>" ]; then
+  echo "! ERROR: not set up."
+  echo "The directory '<%= releases_path %>' does not exist on the server."
+  echo "You may need to run 'mina setup' first."
+  exit 16
+fi
+
+# Check lockfile
+if [ -e "<%= lock_file %>" ]; then
+  echo "! ERROR: another deployment is ongoing."
+  echo "The file '<%= lock_file %>' was found."
+  echo "If no other deployment is ongoing, delete the file to continue."
+  exit 17
+fi
+
+# Determine $previous_path and other variables
+[ -h "<%= current_path %>" ] && [ -d "<%= current_path %>" ] && previous_path=$(cd "<%= current_path %>" >/dev/null && pwd -LP)
+build_path="./tmp/build-`date +%s`$RANDOM"
+version=$((`cat "<%= deploy_to %>/last_version" 2>/dev/null`+1))
+release_path="<%= releases_path %>/$version"
+
+# Sanity check
+if [ -e "$build_path" ]; then
+  echo "! ERROR: Path already exists."
+  exit 18
+fi
+
+# Bootstrap script (in deployer)
+(
+  <%= print_str '-> Creating a temporary build path' %>
+  <%= echo_cmd %[touch "#{lock_file}"] %> &&
+  <%= echo_cmd %[mkdir -p "$build_path"] %> &&
+  <%= echo_cmd %[cd "$build_path"] %> &&
+  (
+<%= indent 4, (prepare.empty? ? "true" : prepare) %>
+  )
+) &&
+
+#
+# Rename to the real release path, then symlink 'current'
+(
+  <%= print_str '-> Build finished' %>
+  <%= print_str '-> Moving build to $release_path' %>
+  <%= echo_cmd %[mv "$build_path" "$release_path"] %> &&
+
+  <%= print_str "-> Updating the " + current_path + " symlink" %> &&
+  <%= echo_cmd %[ln -nfs "$release_path" "#{current_path}"] %>
+) &&
+
+# ============================
+# === Start up serve => (in deployer)
+(
+  <%= print_str '-> Launching' %>
+  <%= echo_cmd %[cd "$release_path"] %>
+<%= indent 2, (launch.empty? ? "true" : launch) %>
+) &&
+
+# ============================
+# === Complete & unlock
+(
+  rm -f "<%= lock_file %>"
+  echo "$version" > "./last_version"
+  <%= print_str "-> Done. Deployed v$version" %>
+) ||
+
+# ============================
+# === Failed deployment
+(
+  <%= print_str('! ERROR: Deploy failed.') %>
+
+<%= indent 2, clean %>
+
+  echo "-----> Cleaning up build"
+  [ -e "$build_path" ] && (
+    <%= echo_cmd %[rm -rf "$build_path"] %>
+  )
+  [ -e "$release_path" ] && (
+    <%= print_str 'Deleting release' %>
+    <%= echo_cmd %[rm -rf "$release_path"] %>
+  )
+  (
+    echo "Unlinking current"
+    [ -n "$previous_path" ] && <%= echo_cmd %[ln -nfs "$previous_path" "#{current_path}"] %>
+  )
+
+  # Unlock
+  <%= echo_cmd %[rm -f "#{lock_file}"] %>
+  echo "OK"
+  exit 19
+)

data/lib/mina.rb

@@ -0,0 +1,23 @@
+module Mina
+  PREFIX = File.dirname(__FILE__)
+  ROOT = File.expand_path('../../', __FILE__)
+
+  require 'mina/version'
+
+  autoload :DeployHelpers, 'mina/deploy_helpers'
+  autoload :OutputHelpers, 'mina/output_helpers'
+  autoload :SshHelpers, 'mina/ssh_helpers'
+  autoload :ExecHelpers, 'mina/exec_helpers'
+  autoload :Helpers, 'mina/helpers'
+  autoload :Settings, 'mina/settings'
+  autoload :Tools, 'mina/tools'
+
+  Error = Class.new(Exception)
+  class Failed < Error
+    attr_accessor :exitstatus
+  end
+
+  def self.root_path(*a)
+    File.join ROOT, *a
+  end
+end

data/lib/mina/bundler.rb

@@ -0,0 +1,49 @@
+# # Modules: Bundler
+# Adds settings and tasks for managing Ruby Bundler.
+#
+#     require 'mina/bundler'
+
+# ## Settings
+# Any and all of these settings can be overriden in your `deploy.rb`.
+
+# ### bundle_bin
+# Sets the bundle path.
+
+set_default :bundle_bin, 'bundle'
+
+# ### bundle_path
+# Sets the path to where the gems are expected to be.
+#
+# This path will be symlinked to `./shared/bundle` so that the gems cache will
+# be shared between all releases.
+
+set_default :bundle_path, './vendor/bundle'
+
+# ### bundle_withouts
+# Sets the colon-separated list of groups to be skipped from installation.
+
+set_default :bundle_withouts, 'development:test'
+
+# ### bundle_options
+# Sets the options for installing gems via Bundler.
+
+set_default :bundle_options, lambda { %{--without #{bundle_withouts} --path "#{bundle_path}" --deployment} }
+
+# ## Deploy tasks
+# These tasks are meant to be invoked inside deploy scripts, not invoked on
+# their own.
+
+namespace :bundle do
+  # ### bundle:install
+  # Installs gems.
+  desc "Install gem dependencies using Bundler."
+  task :install do
+    queue %{
+      #{print_str '-> Installing gem dependencies using Bundler'}
+      #{echo_cmd %[mkdir -p "#{deploy_to}/#{shared_path}/bundle"]}
+      #{echo_cmd %[mkdir -p "#{File.dirname bundle_path}"]}
+      #{echo_cmd %[ln -s "#{deploy_to}/#{shared_path}/bundle" "#{bundle_path}"]}
+      #{echo_cmd %[#{bundle_bin} install #{bundle_options}]}
+    }
+  end
+end

data/lib/mina/chruby.rb

@@ -0,0 +1,49 @@
+# # Modules: chruby
+# Adds settings and tasks for managing [chruby] installations.
+#
+# [chruby]: https://github.com/postmodern/chruby
+#
+#     require 'mina/chruby'
+#
+# ## Common usage
+#
+#     task :environment do
+#       invoke :'chruby[ruby-1.9.3-p392]'
+#     end
+#
+#     task :deploy => :environment do
+#       ...
+#     end
+
+# ## Settings
+# Any and all of these settings can be overriden in your `deploy.rb`.
+
+# ### chruby_path
+# Path where *chruby* init scripts are installed.
+#
+set_default :chruby_path, "/etc/profile.d/chruby.sh"
+
+# ## Tasks
+
+# ### chruby[version]
+# Switch to given Ruby version
+
+task :chruby, :env do |t, args|
+  unless args[:env]
+    print_error "Task 'chruby' needs a Ruby version as an argument."
+    print_error "Example: invoke :'chruby[ruby-1.9.3-p392]'"
+    die
+  end
+
+  queue %{
+    echo "-----> chruby to version: '#{args[:env]}'"
+
+    if [[ ! -s "#{chruby_path}" ]]; then
+      echo "! chruby.sh init file not found"
+      exit 1
+    fi
+
+    source #{chruby_path}
+    #{echo_cmd %{chruby "#{args[:env]}"}} || exit 1
+  }
+end

data/lib/mina/default.rb

@@ -0,0 +1,145 @@
+# # Modules: Default
+# This module is loaded when invoking `mina` with or without a project.
+
+# ## Settings
+# Here are some of the common settings. All settings are optional unless
+# otherwise noted.
+#
+# ### deploy_to
+# (Required) Path to deploy to.
+#
+# ### domain
+# (Required) Host name to deploy to.
+#
+# ### port
+# SSH port number.
+#
+# ### forward_agent
+# If set to `true`, enables SSH agent forwarding.
+#
+# ### identity_file
+# The local path to the SSH private key file.
+#
+# ### ssh_options
+# Switches to be passed to the `ssh` command.
+
+# ## Tasks
+# Any and all of these settings can be overriden in your `deploy.rb`.
+
+# ### environment
+# Make the `:environment` task exist by default. This is meant to be overridden
+# by users.
+
+task :environment do
+end
+
+# ### init
+# Initializes a new Mina project.
+#
+#     $ mina init
+
+desc "Creates a sample config file."
+task :init => :environment do
+  name = Rake.application.name
+  config_file = Rake.application.rakefile
+
+  unless config_file.to_s.empty?
+    print_str "! You already have #{config_file}."
+    exit 8
+  end
+
+  outfile = './config/deploy.rb'
+  require 'fileutils'
+  FileUtils.mkdir_p './config'
+  FileUtils.cp Mina.root_path('data/deploy.rb'), outfile
+
+  print_str "-----> Created #{outfile}"
+  print_str "Edit this file, then run `#{name} setup` after."
+end
+
+task :default => :help
+
+module HelpHelpers
+  def get_tasks(&blk)
+    Rake.application.tasks.select &blk
+  end
+
+  def print_tasks(tasks, width=nil)
+    name = Rake.application.name
+
+    width ||= tasks.map { |t| t.name_with_args.length }.max || 10
+    tasks.each do |t|
+      if t.comment
+        puts "  #{name} %-#{width}s   # %s" % [ t.name_with_args, t.comment ]
+      else
+        puts "  #{name} %s" % [ t.name_with_args ]
+      end
+    end
+  end
+
+  SYSTEM_TASKS = %w[help tasks init]
+  def system_tasks() get_tasks { |t| SYSTEM_TASKS.include? t.name }; end
+  def top_tasks()    get_tasks { |t| ! t.name.include?(':') && t.comment && !system_tasks.include?(t) }; end
+  def sub_tasks()    get_tasks { |t| t.name.include?(':') }; end
+
+  def show_task_help(options={})
+    puts "Basic usage:"
+    print_tasks system_tasks
+
+    if top_tasks.any?
+      puts "\nServer tasks:"
+      print_tasks top_tasks
+    end
+
+    if sub_tasks.any? && options[:full]
+      puts "\nMore tasks:"
+      print_tasks sub_tasks
+    end
+  end
+end
+
+extend HelpHelpers
+
+# ### help
+# Shows the help screen.
+
+desc "Show help."
+task :help do
+  name = Rake.application.name
+
+  puts "#{name} - Really fast server deployment and automation tool\n\n"
+  puts "Options:"
+
+  opts = [
+    [ "-h, --help", "Show help" ],
+    [ "-V, --version", "Show program version" ],
+    [ "-v, --verbose", "Show commands as they happen" ],
+    [ "-S, --simulate", "Run in simulation mode" ],
+    [ "-t, --trace", "Show backtraces when errors occur" ],
+    [ "-f FILE", "Use FILE as the deploy configuration" ]
+  ]
+  opts.each { |args| puts "  %-17s %s" % args }
+  puts ""
+
+  show_task_help
+
+  unless Rake.application.have_rakefile
+    puts ""
+    puts "Run this command in a project with a 'config/deploy.rb' file to see more options."
+  end
+
+  puts ""
+  puts "All of Rake's options are also available as '#{name}' options. See 'rake --help'"
+  puts "for more information."
+  exit
+end
+
+# ### tasks
+# Display all tasks in a nice table.
+#
+#     $ mina tasks
+
+desc "Show all tasks."
+task :tasks do
+  show_task_help :full => true
+end