mina 0.3.8 → 1.0.0.beta1

data/lib/mina/rake.rb

@@ -1,10 +0,0 @@
-# This file is invoked from Rake.
-extend Mina::Helpers
-extend Mina::DeployHelpers
-extend Mina::SshHelpers
-extend Mina::LocalHelpers
-extend Mina::OutputHelpers
-extend Mina::ExecHelpers
-
-require 'mina/default'
-require 'mina/deploy' if Rake.application.have_rakefile

data/lib/mina/rbenv.rb

@@ -1,47 +0,0 @@
-# # Modules: rbenv
-# Adds settings and tasks for managing [rbenv] installations.
-#
-# [rbenv]: https://github.com/sstephenson/rbenv
-#
-#     require 'mina/rbenv'
-#
-# ## Common usage
-#
-#     task :environment do
-#       invoke :'rbenv:load'
-#     end
-#
-#     task :deploy => :environment do
-#       ...
-#     end
-
-# ## Settings
-# Any and all of these settings can be overriden in your `deploy.rb`.
-
-# ### rbenv_path
-# Sets the path where *rbenv* is installed.
-#
-# You may override this if rbenv is placed elsewhere in your setup.
-
-set_default :rbenv_path, "$HOME/.rbenv"
-
-# ## Tasks
-
-# ### rbenv:load
-# Loads the *rbenv* runtime.
-
-task :'rbenv:load' do
-  queue %{
-    echo "-----> Loading rbenv"
-    #{echo_cmd %{export RBENV_ROOT="#{rbenv_path}"}}
-    #{echo_cmd %{export PATH="#{rbenv_path}/bin:$PATH"}}
-
-    if ! which rbenv >/dev/null; then
-      echo "! rbenv not found"
-      echo "! If rbenv is installed, check your :rbenv_path setting."
-      exit 1
-    fi
-
-    #{echo_cmd %{eval "$(rbenv init -)"}}
-  }
-end

data/lib/mina/rvm.rb

@@ -1,88 +0,0 @@
-# # Modules: RVM
-# Adds settings and tasks for managing [RVM] installations.
-#
-# [rvm]: http://rvm.io
-#
-#     require 'mina/rvm'
-#
-# ## Common usage
-#
-#     task :environment do
-#       invoke :'rvm:use[ruby-1.9.3-p125@gemset_name]'
-#     end
-#
-#     task :deploy => :environment do
-#       ...
-#     end
-
-# ## Settings
-# Any and all of these settings can be overriden in your `deploy.rb`.
-
-# ### rvm_path
-# Sets the path to RVM.
-#
-# You can override this in your projects if RVM is installed in a different
-# path, say, if you have a system-wide RVM install.
-
-set_default :rvm_path, "$HOME/.rvm/scripts/rvm"
-
-# ## Tasks
-
-# ### rvm:use[]
-# Uses a given RVM environment provided as an argument.
-#
-# This is usually placed in the `:environment` task.
-#
-#     task :environment do
-#       invoke :'rvm:use[ruby-1.9.3-p125@gemset_name]'
-#     end
-#
-task :'rvm:use', :env do |t, args|
-  unless args[:env]
-    print_error "Task 'rvm:use' needs an RVM environment name as an argument."
-    print_error "Example: invoke :'rvm:use[ruby-1.9.2@default]'"
-    die
-  end
-
-  queue %{
-    echo "-----> Using RVM environment '#{args[:env]}'"
-    if [[ ! -s "#{rvm_path}" ]]; then
-      echo "! Ruby Version Manager not found"
-      echo "! If RVM is installed, check your :rvm_path setting."
-      exit 1
-    fi
-
-    source #{rvm_path}
-    #{echo_cmd %{rvm use "#{args[:env]}" --create}} || exit 1
-  }
-end
-
-# ### rvm:wrapper[]
-# Creates a rvm wrapper for a given executable.
-#
-# This is usually placed in the `:setup` task.
-#
-#     task ::setup => :environment do
-#       ...
-#       invoke :'rvm:wrapper[ruby-1.9.3-p125@gemset_name,wrapper_name,binary_name]'
-#     end
-#
-task :'rvm:wrapper', :env, :name, :bin do |t,args|
-  unless args[:env] && args[:name] && args[:bin]
-    print_error "Task 'rvm:wrapper' needs an RVM environment name, an wrapper name and the binary name as arguments"
-    print_error "Example: invoke :'rvm:wrapper[ruby-1.9.2@myapp,myapp,unicorn_rails]'"
-    die
-  end
-
-  queue %{
-    echo "-----> creating RVM wrapper '#{args[:name]}_#{args[:bin]}' using '#{args[:env]}'"
-    if [[ ! -s "#{rvm_path}" ]]; then
-      echo "! Ruby Version Manager not found"
-      echo "! If RVM is installed, check your :rvm_path setting."
-      exit 1
-    fi
-
-    source #{rvm_path}
-    #{echo_cmd %{rvm wrapper #{args[:env]} #{args[:name]} #{args[:bin]} }} || exit 1
-  }
-end

data/lib/mina/ry.rb

@@ -1,55 +0,0 @@
-# # Modules: ry
-# Adds settings and tasks for managing [ry] installations.
-#
-# [ry]: https://github.com/jneen/ry
-#
-#     require 'mina/ry'
-#
-# ## Common usage
-#
-#     task :environment do
-#       invoke :'ry[ruby-1.9.3-p392]'
-#       # or without parameter to use default ruby version
-#       invoke :'ry'
-#     end
-#
-#     task :deploy => :environment do
-#       ...
-#     end
-
-# ## Settings
-# Any and all of these settings can be overriden in your `deploy.rb`.
-
-# ### ry_path
-# Path where *ry* init scripts are installed.
-#
-set_default :ry_path, "$HOME/.local"
-
-# ## Tasks
-
-# ### ry[version]
-# Switch to given Ruby version
-
-task :ry, :env do |t, args|
-  unless args[:env]
-    print_status "Task 'ry' without argument will use default Ruby version."
-  end
-
-  queue %{
-    echo "-----> ry to version: '#{args[:env] || '**not specified**'}'"
-
-    echo "-----> Loading ry"
-    if [[ ! -e "#{ry_path}/bin" ]]; then
-      echo "! ry not found"
-      echo "! If ry is installed, check your :ry_path setting."
-      exit 1
-    fi
-    #{echo_cmd %{export PATH="#{ry_path}/bin:$PATH"}}
-    #{echo_cmd %{eval "$(ry setup)"}}
-
-    RY_RUBY="#{args[:env]}"
-    if [ -n "$RY_RUBY" ]; then
-      #{echo_cmd %{ry use $RY_RUBY}} || exit 1
-    fi
-  }
-end

data/lib/mina/settings.rb

@@ -1,32 +0,0 @@
-module Mina
-  class Settings < Hash
-    def method_missing(meth, *args, &blk)
-      name = meth.to_s
-
-      return evaluate(self[meth])  if name.size == 1
-
-      # Ruby 1.8.7 doesn't let you do string[-1]
-      key, suffix = name[0..-2].to_sym, name[-1..-1]
-
-      case suffix
-      when '='
-        self[key] = args.first
-      when '?'
-        include? key
-      when '!'
-        raise Error, "Setting :#{key} is not set" unless include?(key)
-        evaluate self[key]
-      else
-        evaluate self[meth]
-      end
-    end
-
-    def evaluate(value)
-      if value.is_a?(Proc)
-        value.call
-      else
-        value
-      end
-    end
-  end
-end

data/lib/mina/ssh_helpers.rb

@@ -1,125 +0,0 @@
-# # Helpers: SSH helpers
-# You don't need to invoke these helpers, they're already invoked automatically.
-
-module Mina
-  module SshHelpers
-
-    # ### ssh
-    # Executes a command via SSH.
-    #
-    # Returns nothing usually, but if `{ return: true }` is given, returns the
-    # STDOUT output of the SSH session.
-    #
-    # `options` is a hash of options:
-    #
-    #  - `:pretty` - Prettify the output if true.
-    #  - `:return`  - If set to true, returns the output.
-    #
-    # Example
-    #
-    #     ssh("ls", return: true)
-
-    def ssh(cmd, options={})
-      require 'shellwords'
-
-      cmd.unshift("export #{env_vars}") if env_vars?
-      cmd = cmd.join("\n")  if cmd.is_a?(Array)
-      script = Shellwords.escape(cmd)
-
-      if options[:return] == true
-        `#{ssh_command} -- #{script}`
-
-      elsif simulate_mode?
-        Ssh.simulate(cmd, ssh_command)
-
-      else
-        result = Ssh.invoke(script, self)
-        Ssh.ensure_successful result, self
-      end
-    end
-
-    # ### ssh_command
-    # Returns the SSH command to be executed.
-    #
-    #     set :domain, 'foo.com'
-    #     set :user, 'diggity'
-    #
-    #     puts ssh_command
-    #     #=> 'ssh diggity@foo.com'
-
-    def ssh_command
-      args = domain!.dup
-      args = "#{user}@#{args}" if user?
-      args << " -i #{identity_file}" if identity_file?
-      args << " -p #{port}" if port?
-      args << " -A" if forward_agent?
-      args << " #{ssh_options}" if ssh_options?
-      args << " -o StrictHostKeyChecking=no"
-      args << " -t"
-      "ssh #{args}"
-    end
-
-    # ## Private methods
-    # `ssh` delegates to these.
-
-    module Ssh
-
-      extend self
-
-      # ### Ssh.simulate
-      # __Internal:__ Prints SSH command. Called by `ssh`.
-
-      def simulate(cmd, ssh_command)
-        str = "Executing the following via '#{ssh_command}':"
-        puts "#!/usr/bin/env bash"
-        puts "# #{str}"
-        puts "#"
-
-        puts cmd
-
-        0
-      end
-
-      # ### Ssh.invoke
-      # __Internal:__ Initiates an SSH session with script `script` with given
-      # `term_mode`.  Called by `ssh`.
-
-      def invoke(script, this)
-        # Ruby 1.8.7 doesn't let you have empty symbols
-        term_mode = :"#{this.settings.term_mode}" if this.settings.term_mode
-        code = "#{this.ssh_command} -- #{script}"
-
-        # Certain environments can't do :pretty mode.
-        term_mode = :exec  if term_mode == :pretty && !pretty_supported?
-
-        case term_mode
-        when :pretty
-          this.pretty_system(code)
-        when :exec
-          exec code
-        else
-          system code
-          $?.to_i
-        end
-      end
-
-      def pretty_supported?
-        # open4 is not supported under Windows.
-        # https://github.com/nadarei/mina/issues/58
-        require 'rbconfig'
-        ! (RbConfig::CONFIG['host_os'] =~ /mswin|mingw/)
-      end
-
-      # ### Ssh.ensure_successful
-      # __Internal:__ Halts the execution if the given result code is not
-      # successful (non-zero).
-
-      def ensure_successful(result, this)
-        this.die result if result.is_a?(Fixnum) && result > 0
-        result
-      end
-
-    end
-
-  end
-end

data/lib/mina/tools.rb

@@ -1,20 +0,0 @@
-module Mina
-  module Tools
-    if IO.respond_to?(:popen4)
-      def self.popen4(*cmd, &blk)
-        IO.popen4 *cmd, &blk
-        $?
-      end
-    else
-      def self.popen4(*cmd, &blk)
-        require 'open4'
-        Open4.popen4 *cmd, &blk
-      end
-    end
-
-    def self.pfork4(*cmd, &blk)
-      require 'open4'
-      Open4.pfork4 *cmd, &blk
-    end
-  end
-end

data/lib/mina/whenever.rb

@@ -1,51 +0,0 @@
-# # Modules: Whenever
-# Adds settings and tasks for managing projects with [whenever].
-#
-# [whenever]: http://rubygems.org/gems/whenever
-#
-#
-# ## Common usage
-#     require 'mina/whenever'
-#
-#     task :deploy => :environment do
-#       deploy do
-#         ...
-#       to :launch do
-#         invoke :'whenever:update'
-#       end
-#     end
-
-# ## Settings
-# Any and all of these settings can be overriden in your `deploy.rb`.
-
-# ### whenever_name
-# Override the default name used by Whenever when clearing,
-# updating or writing the crontab file.
-
-namespace :whenever do
-  # NOTE: setting this as a lambda to allow the user to override
-  # the domain variable at any time in their schedule.rb file
-  name = lambda { whenever_name || "#{domain}_#{rails_env}" }
-
-  desc "Clear crontab"
-  task :clear => :environment  do
-    queue %{
-      echo "-----> Clear crontab for #{name.call}"
-      #{echo_cmd %[cd #{deploy_to!}/#{current_path!} ; #{bundle_bin} exec whenever --clear-crontab #{name.call} --set 'environment=#{rails_env}&path=#{deploy_to!}/#{current_path!}']}
-    }
-  end
-  desc "Update crontab"
-  task :update => :environment do
-    queue %{
-      echo "-----> Update crontab for #{name.call}"
-      #{echo_cmd %[cd #{deploy_to!}/#{current_path!} ; #{bundle_bin} exec whenever --update-crontab #{name.call} --set 'environment=#{rails_env}&path=#{deploy_to!}/#{current_path!}']}
-    }
-  end
-  desc "Write crontab"
-  task :write => :environment do
-    queue %{
-      echo "-----> Update crontab for #{name.call}"
-      #{echo_cmd %[cd #{deploy_to!}/#{current_path!} ; #{bundle_bin} exec whenever --write-crontab #{name.call} --set 'environment=#{rails_env}&path=#{deploy_to!}/#{current_path!}']}
-    }
-  end
-end

data/manual/index.md

@@ -1,15 +0,0 @@
-# Welcome to Mina
-
-Really fast deployer and server automation tool.
-
-Mina works really fast because it's a deploy Bash script generator. It
-generates an entire procedure as a Bash script and runs it remotely in the
-server.
-
-Compare this to the likes of Vlad or Capistrano, where each command
-is ran separately on their own SSH sessions. Mina only creates *one* SSH
-session per deploy, minimizing the SSH connection overhead.
-
-    $ gem install mina
-    $ mina
-