Top Level Namespace

Defined Under Namespace

Modules: Capistrano, Kernel Classes: String

Instance Method Summary collapse

Instance Method Details

#_cset(name, *args, &block) ⇒ Object 



8
9
10
11
12
 
# File 'lib/capistrano/recipes/deploy.rb', line 8

def _cset(name, *args, &block)
  unless exists?(name)
    set(name, *args, &block)
  end
end

#depend(location, type, *args) ⇒ Object

Auxiliary helper method for the ‘deploy:check’ task. Lets you set up your own dependencies.



110
111
112
113
114
115
116
 
# File 'lib/capistrano/recipes/deploy.rb', line 110

def depend(location, type, *args)
  deps = fetch(:dependencies, {})
  deps[location] ||= {}
  deps[location][type] ||= []
  deps[location][type] << args
  set :dependencies, deps
end

#run_locally(cmd) ⇒ Object

logs the command then executes it locally. returns the command output as a string



129
130
131
132
133
134
135
136
137
138
139
140
 
# File 'lib/capistrano/recipes/deploy.rb', line 129

def run_locally(cmd)
  logger.trace "executing locally: #{cmd.inspect}" if logger
  output_on_stdout = nil
  elapsed = Benchmark.realtime do
    output_on_stdout = `#{cmd}`
  end
  if $?.to_i > 0 # $? is command exit code (posix style)
    raise Capistrano::LocalArgumentError, "Command #{cmd} returned status code #{$?}"
  end
  logger.trace "command finished in #{(elapsed * 1000).round}ms" if logger
  output_on_stdout
end

#scm_default ⇒ Object

Checks known version control directories to intelligently set the version control in-use. For example, if a .svn directory exists in the project, it will set the :scm variable to :subversion, if a .git directory exists in the project, it will set the :scm variable to :git and so on. If no directory is found, it will default to :git.



86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'lib/capistrano/recipes/deploy.rb', line 86

def scm_default
  if File.exist? '.git'
    :git
  elsif File.exist? '.accurev'
    :accurev
  elsif File.exist? '.bzr'
    :bzr
  elsif File.exist? '.cvs'
    :cvs
  elsif File.exist? '_darcs'
    :darcs
  elsif File.exist? '.hg'
    :mercurial
  elsif File.exist? '.perforce'
    :perforce
  elsif File.exist? '.svn'
    :subversion
  else
    :none
  end
end

#try_runner(*args) ⇒ Object

Same as sudo, but tries sudo with :as set to the value of the :runner variable (which defaults to “app”).



176
177
178
179
180
 
# File 'lib/capistrano/recipes/deploy.rb', line 176

def try_runner(*args)
  options = args.last.is_a?(Hash) ? args.pop : {}
  args << options.merge(:as => fetch(:runner, "app"))
  try_sudo(*args)
end

#try_sudo(*args) ⇒ Object

If a command is given, this will try to execute the given command, as described below. Otherwise, it will return a string for use in embedding in another command, for executing that command as described below.

If :run_method is :sudo (or :use_sudo is true), this executes the given command via sudo. Otherwise is uses run. If :as is given as a key, it will be passed as the user to sudo as, if using sudo. If the :as key is not given, it will default to whatever the value of the :admin_runner variable is, which (by default) is unset.

THUS, if you want to try to run something via sudo, and what to use the root user, you’d just to try_sudo(‘something’). If you wanted to try_sudo as someone else, you’d just do try_sudo(‘something’, :as => “bob”). If you always wanted sudo to run as a particular user, you could do set(:admin_runner, “bob”).

Raises:

  • (ArgumentError) 


158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
 
# File 'lib/capistrano/recipes/deploy.rb', line 158

def try_sudo(*args)
  options = args.last.is_a?(Hash) ? args.pop : {}
  command = args.shift
  raise ArgumentError, "too many arguments" if args.any?

  as = options.fetch(:as, fetch(:admin_runner, nil))
  via = fetch(:run_method, :sudo)
  if command
    invoke_command(command, :via => via, :as => as)
  elsif via == :sudo
    sudo(:as => as)
  else
    ""
  end
end

#with_env(name, value) ⇒ Object

Temporarily sets an environment variable, yields to a block, and restores the value when it is done.



120
121
122
123
124
125
 
# File 'lib/capistrano/recipes/deploy.rb', line 120

def with_env(name, value)
  saved, ENV[name] = ENV[name], value
  yield
ensure
  ENV[name] = saved
end