HeSYINUvSBZfxqA-capistrano 2.5.21

Sign up to get free protection for your applications and to get access to all the features.
Files changed (111) hide show
  1. data/.gitignore +10 -0
  2. data/CHANGELOG +866 -0
  3. data/Gemfile +4 -0
  4. data/Gemfile.lock +31 -0
  5. data/HeSYINUvSBZfxqA-capistrano.gemspec +49 -0
  6. data/README.mdown +65 -0
  7. data/Rakefile +11 -0
  8. data/VERSION +1 -0
  9. data/bin/cap +4 -0
  10. data/bin/capify +86 -0
  11. data/lib/capistrano.rb +2 -0
  12. data/lib/capistrano/callback.rb +45 -0
  13. data/lib/capistrano/cli.rb +47 -0
  14. data/lib/capistrano/cli/execute.rb +85 -0
  15. data/lib/capistrano/cli/help.rb +125 -0
  16. data/lib/capistrano/cli/help.txt +78 -0
  17. data/lib/capistrano/cli/options.rb +243 -0
  18. data/lib/capistrano/cli/ui.rb +40 -0
  19. data/lib/capistrano/command.rb +286 -0
  20. data/lib/capistrano/configuration.rb +44 -0
  21. data/lib/capistrano/configuration/actions/file_transfer.rb +47 -0
  22. data/lib/capistrano/configuration/actions/inspect.rb +46 -0
  23. data/lib/capistrano/configuration/actions/invocation.rb +295 -0
  24. data/lib/capistrano/configuration/callbacks.rb +148 -0
  25. data/lib/capistrano/configuration/connections.rb +204 -0
  26. data/lib/capistrano/configuration/execution.rb +143 -0
  27. data/lib/capistrano/configuration/loading.rb +197 -0
  28. data/lib/capistrano/configuration/namespaces.rb +197 -0
  29. data/lib/capistrano/configuration/roles.rb +73 -0
  30. data/lib/capistrano/configuration/servers.rb +98 -0
  31. data/lib/capistrano/configuration/variables.rb +127 -0
  32. data/lib/capistrano/errors.rb +19 -0
  33. data/lib/capistrano/extensions.rb +57 -0
  34. data/lib/capistrano/logger.rb +59 -0
  35. data/lib/capistrano/processable.rb +53 -0
  36. data/lib/capistrano/recipes/compat.rb +32 -0
  37. data/lib/capistrano/recipes/deploy.rb +597 -0
  38. data/lib/capistrano/recipes/deploy/dependencies.rb +44 -0
  39. data/lib/capistrano/recipes/deploy/local_dependency.rb +54 -0
  40. data/lib/capistrano/recipes/deploy/remote_dependency.rb +111 -0
  41. data/lib/capistrano/recipes/deploy/scm.rb +19 -0
  42. data/lib/capistrano/recipes/deploy/scm/accurev.rb +169 -0
  43. data/lib/capistrano/recipes/deploy/scm/base.rb +196 -0
  44. data/lib/capistrano/recipes/deploy/scm/bzr.rb +86 -0
  45. data/lib/capistrano/recipes/deploy/scm/cvs.rb +153 -0
  46. data/lib/capistrano/recipes/deploy/scm/darcs.rb +96 -0
  47. data/lib/capistrano/recipes/deploy/scm/git.rb +274 -0
  48. data/lib/capistrano/recipes/deploy/scm/mercurial.rb +137 -0
  49. data/lib/capistrano/recipes/deploy/scm/none.rb +44 -0
  50. data/lib/capistrano/recipes/deploy/scm/perforce.rb +138 -0
  51. data/lib/capistrano/recipes/deploy/scm/subversion.rb +121 -0
  52. data/lib/capistrano/recipes/deploy/strategy.rb +19 -0
  53. data/lib/capistrano/recipes/deploy/strategy/base.rb +88 -0
  54. data/lib/capistrano/recipes/deploy/strategy/checkout.rb +20 -0
  55. data/lib/capistrano/recipes/deploy/strategy/copy.rb +223 -0
  56. data/lib/capistrano/recipes/deploy/strategy/export.rb +20 -0
  57. data/lib/capistrano/recipes/deploy/strategy/remote.rb +52 -0
  58. data/lib/capistrano/recipes/deploy/strategy/remote_cache.rb +57 -0
  59. data/lib/capistrano/recipes/deploy/templates/maintenance.rhtml +53 -0
  60. data/lib/capistrano/recipes/standard.rb +37 -0
  61. data/lib/capistrano/recipes/templates/maintenance.rhtml +53 -0
  62. data/lib/capistrano/role.rb +102 -0
  63. data/lib/capistrano/server_definition.rb +56 -0
  64. data/lib/capistrano/shell.rb +260 -0
  65. data/lib/capistrano/ssh.rb +101 -0
  66. data/lib/capistrano/task_definition.rb +75 -0
  67. data/lib/capistrano/transfer.rb +216 -0
  68. data/lib/capistrano/version.rb +18 -0
  69. data/rvmrc.sample +1 -0
  70. data/test/cli/execute_test.rb +132 -0
  71. data/test/cli/help_test.rb +165 -0
  72. data/test/cli/options_test.rb +329 -0
  73. data/test/cli/ui_test.rb +28 -0
  74. data/test/cli_test.rb +17 -0
  75. data/test/command_test.rb +286 -0
  76. data/test/configuration/actions/file_transfer_test.rb +61 -0
  77. data/test/configuration/actions/inspect_test.rb +65 -0
  78. data/test/configuration/actions/invocation_test.rb +225 -0
  79. data/test/configuration/callbacks_test.rb +220 -0
  80. data/test/configuration/connections_test.rb +349 -0
  81. data/test/configuration/execution_test.rb +175 -0
  82. data/test/configuration/loading_test.rb +132 -0
  83. data/test/configuration/namespace_dsl_test.rb +311 -0
  84. data/test/configuration/roles_test.rb +144 -0
  85. data/test/configuration/servers_test.rb +158 -0
  86. data/test/configuration/variables_test.rb +190 -0
  87. data/test/configuration_test.rb +88 -0
  88. data/test/deploy/local_dependency_test.rb +76 -0
  89. data/test/deploy/remote_dependency_test.rb +135 -0
  90. data/test/deploy/scm/accurev_test.rb +23 -0
  91. data/test/deploy/scm/base_test.rb +55 -0
  92. data/test/deploy/scm/bzr_test.rb +51 -0
  93. data/test/deploy/scm/darcs_test.rb +37 -0
  94. data/test/deploy/scm/git_test.rb +184 -0
  95. data/test/deploy/scm/mercurial_test.rb +134 -0
  96. data/test/deploy/scm/none_test.rb +35 -0
  97. data/test/deploy/scm/subversion_test.rb +32 -0
  98. data/test/deploy/strategy/copy_test.rb +302 -0
  99. data/test/extensions_test.rb +69 -0
  100. data/test/fixtures/cli_integration.rb +5 -0
  101. data/test/fixtures/config.rb +5 -0
  102. data/test/fixtures/custom.rb +3 -0
  103. data/test/logger_test.rb +123 -0
  104. data/test/role_test.rb +11 -0
  105. data/test/server_definition_test.rb +121 -0
  106. data/test/shell_test.rb +90 -0
  107. data/test/ssh_test.rb +113 -0
  108. data/test/task_definition_test.rb +116 -0
  109. data/test/transfer_test.rb +160 -0
  110. data/test/utils.rb +39 -0
  111. metadata +271 -0
@@ -0,0 +1,98 @@
1
+ module Capistrano
2
+ class Configuration
3
+ module Servers
4
+ # Identifies all servers that the given task should be executed on.
5
+ # The options hash accepts the same arguments as #find_servers, and any
6
+ # preexisting options there will take precedence over the options in
7
+ # the task.
8
+ def find_servers_for_task(task, options={})
9
+ find_servers(task.options.merge(options))
10
+ end
11
+
12
+ # Attempts to find all defined servers that match the given criteria.
13
+ # The options hash may include a :hosts option (which should specify
14
+ # an array of host names or ServerDefinition instances), a :roles
15
+ # option (specifying an array of roles), an :only option (specifying
16
+ # a hash of key/value pairs that any matching server must match),
17
+ # an :exception option (like :only, but the inverse), and a
18
+ # :skip_hostfilter option to ignore the HOSTFILTER environment variable
19
+ # described below.
20
+ #
21
+ # Additionally, if the HOSTS environment variable is set, it will take
22
+ # precedence over any other options. Similarly, the ROLES environment
23
+ # variable will take precedence over other options. If both HOSTS and
24
+ # ROLES are given, HOSTS wins.
25
+ #
26
+ # Yet additionally, if the HOSTFILTER environment variable is set, it
27
+ # will limit the result to hosts found in that (comma-separated) list.
28
+ #
29
+ # Usage:
30
+ #
31
+ # # return all known servers
32
+ # servers = find_servers
33
+ #
34
+ # # find all servers in the app role that are not exempted from
35
+ # # deployment
36
+ # servers = find_servers :roles => :app,
37
+ # :except => { :no_release => true }
38
+ #
39
+ # # returns the given hosts, translated to ServerDefinition objects
40
+ # servers = find_servers :hosts => "jamis@example.host.com"
41
+ def find_servers(options={})
42
+ hosts = server_list_from(ENV['HOSTS'] || options[:hosts])
43
+
44
+ if hosts.any?
45
+ if options[:skip_hostfilter]
46
+ hosts.uniq
47
+ else
48
+ filter_server_list(hosts.uniq)
49
+ end
50
+ else
51
+ roles = role_list_from(ENV['ROLES'] || options[:roles] || self.roles.keys)
52
+ roles = roles & Array(options[:roles]) if preserve_roles && !options[:roles].nil?
53
+
54
+ only = options[:only] || {}
55
+ except = options[:except] || {}
56
+
57
+ servers = roles.inject([]) { |list, role| list.concat(self.roles[role]) }
58
+ servers = servers.select { |server| only.all? { |key,value| server.options[key] == value } }
59
+ servers = servers.reject { |server| except.any? { |key,value| server.options[key] == value } }
60
+
61
+ if options[:skip_hostfilter]
62
+ servers.uniq
63
+ else
64
+ filter_server_list(servers.uniq)
65
+ end
66
+ end
67
+ end
68
+
69
+ protected
70
+
71
+ def filter_server_list(servers)
72
+ return servers unless ENV['HOSTFILTER']
73
+ filters = ENV['HOSTFILTER'].split(/,/)
74
+ servers.select { |server| filters.include?(server.host) }
75
+ end
76
+
77
+ def server_list_from(hosts)
78
+ hosts = hosts.split(/,/) if String === hosts
79
+ hosts = build_list(hosts)
80
+ hosts.map { |s| String === s ? ServerDefinition.new(s.strip) : s }
81
+ end
82
+
83
+ def role_list_from(roles)
84
+ roles = roles.split(/,/) if String === roles
85
+ roles = build_list(roles)
86
+ roles.map do |role|
87
+ role = String === role ? role.strip.to_sym : role
88
+ raise ArgumentError, "unknown role `#{role}'" unless self.roles.key?(role)
89
+ role
90
+ end
91
+ end
92
+
93
+ def build_list(list)
94
+ Array(list).map { |item| item.respond_to?(:call) ? item.call : item }.flatten
95
+ end
96
+ end
97
+ end
98
+ end
@@ -0,0 +1,127 @@
1
+ require 'thread'
2
+
3
+ module Capistrano
4
+ class Configuration
5
+ module Variables
6
+ def self.included(base) #:nodoc:
7
+ %w(initialize respond_to? method_missing).each do |m|
8
+ base_name = m[/^\w+/]
9
+ punct = m[/\W+$/]
10
+ base.send :alias_method, "#{base_name}_without_variables#{punct}", m
11
+ base.send :alias_method, m, "#{base_name}_with_variables#{punct}"
12
+ end
13
+ end
14
+
15
+ # The hash of variables that have been defined in this configuration
16
+ # instance.
17
+ attr_reader :variables
18
+
19
+ # Set a variable to the given value.
20
+ def set(variable, *args, &block)
21
+ if variable.to_s !~ /^[_a-z]/
22
+ raise ArgumentError, "invalid variable `#{variable}' (variables must begin with an underscore, or a lower-case letter)"
23
+ end
24
+
25
+ if !block_given? && args.empty? || block_given? && !args.empty?
26
+ raise ArgumentError, "you must specify exactly one of either a value or a block"
27
+ end
28
+
29
+ if args.length > 1
30
+ raise ArgumentError, "wrong number of arguments (#{args.length} for 1)"
31
+ end
32
+
33
+ value = args.empty? ? block : args.first
34
+ sym = variable.to_sym
35
+ protect(sym) { @variables[sym] = value }
36
+ end
37
+
38
+ alias :[]= :set
39
+
40
+ # Removes any trace of the given variable.
41
+ def unset(variable)
42
+ sym = variable.to_sym
43
+ protect(sym) do
44
+ @original_procs.delete(sym)
45
+ @variables.delete(sym)
46
+ end
47
+ end
48
+
49
+ # Returns true if the variable has been defined, and false otherwise.
50
+ def exists?(variable)
51
+ @variables.key?(variable.to_sym)
52
+ end
53
+
54
+ # If the variable was originally a proc value, it will be reset to it's
55
+ # original proc value. Otherwise, this method does nothing. It returns
56
+ # true if the variable was actually reset.
57
+ def reset!(variable)
58
+ sym = variable.to_sym
59
+ protect(sym) do
60
+ if @original_procs.key?(sym)
61
+ @variables[sym] = @original_procs.delete(sym)
62
+ true
63
+ else
64
+ false
65
+ end
66
+ end
67
+ end
68
+
69
+ # Access a named variable. If the value of the variable responds_to? :call,
70
+ # #call will be invoked (without parameters) and the return value cached
71
+ # and returned.
72
+ def fetch(variable, *args)
73
+ if !args.empty? && block_given?
74
+ raise ArgumentError, "you must specify either a default value or a block, but not both"
75
+ end
76
+
77
+ sym = variable.to_sym
78
+ protect(sym) do
79
+ if !@variables.key?(sym)
80
+ return args.first unless args.empty?
81
+ return yield(variable) if block_given?
82
+ raise IndexError, "`#{variable}' not found"
83
+ end
84
+
85
+ if @variables[sym].respond_to?(:call)
86
+ @original_procs[sym] = @variables[sym]
87
+ @variables[sym] = @variables[sym].call
88
+ end
89
+ end
90
+
91
+ @variables[sym]
92
+ end
93
+
94
+ def [](variable)
95
+ fetch(variable, nil)
96
+ end
97
+
98
+ def initialize_with_variables(*args) #:nodoc:
99
+ initialize_without_variables(*args)
100
+ @variables = {}
101
+ @original_procs = {}
102
+ @variable_locks = Hash.new { |h,k| h[k] = Mutex.new }
103
+
104
+ set :ssh_options, {}
105
+ set :logger, logger
106
+ end
107
+ private :initialize_with_variables
108
+
109
+ def protect(variable)
110
+ @variable_locks[variable.to_sym].synchronize { yield }
111
+ end
112
+ private :protect
113
+
114
+ def respond_to_with_variables?(sym, include_priv=false) #:nodoc:
115
+ @variables.has_key?(sym.to_sym) || respond_to_without_variables?(sym, include_priv)
116
+ end
117
+
118
+ def method_missing_with_variables(sym, *args, &block) #:nodoc:
119
+ if args.length == 0 && block.nil? && @variables.has_key?(sym)
120
+ self[sym]
121
+ else
122
+ method_missing_without_variables(sym, *args, &block)
123
+ end
124
+ end
125
+ end
126
+ end
127
+ end
@@ -0,0 +1,19 @@
1
+ module Capistrano
2
+
3
+ Error = Class.new(RuntimeError)
4
+
5
+ CaptureError = Class.new(Capistrano::Error)
6
+ NoSuchTaskError = Class.new(Capistrano::Error)
7
+ NoMatchingServersError = Class.new(Capistrano::Error)
8
+
9
+ class RemoteError < Error
10
+ attr_accessor :hosts
11
+ end
12
+
13
+ ConnectionError = Class.new(Capistrano::RemoteError)
14
+ TransferError = Class.new(Capistrano::RemoteError)
15
+ CommandError = Class.new(Capistrano::RemoteError)
16
+
17
+ LocalArgumentError = Class.new(Capistrano::Error)
18
+
19
+ end
@@ -0,0 +1,57 @@
1
+ module Capistrano
2
+ class ExtensionProxy #:nodoc:
3
+ def initialize(config, mod)
4
+ @config = config
5
+ extend(mod)
6
+ end
7
+
8
+ def method_missing(sym, *args, &block)
9
+ @config.send(sym, *args, &block)
10
+ end
11
+ end
12
+
13
+ # Holds the set of registered plugins, keyed by name (where the name is a
14
+ # symbol).
15
+ EXTENSIONS = {}
16
+
17
+ # Register the given module as a plugin with the given name. It will henceforth
18
+ # be available via a proxy object on Configuration instances, accessible by
19
+ # a method with the given name.
20
+ def self.plugin(name, mod)
21
+ name = name.to_sym
22
+ return false if EXTENSIONS.has_key?(name)
23
+
24
+ methods = Capistrano::Configuration.public_instance_methods +
25
+ Capistrano::Configuration.protected_instance_methods +
26
+ Capistrano::Configuration.private_instance_methods
27
+
28
+ if methods.any? { |m| m.to_sym == name }
29
+ raise Capistrano::Error, "registering a plugin named `#{name}' would shadow a method on Capistrano::Configuration with the same name"
30
+ end
31
+
32
+ Capistrano::Configuration.class_eval <<-STR, __FILE__, __LINE__+1
33
+ def #{name}
34
+ @__#{name}_proxy ||= Capistrano::ExtensionProxy.new(self, Capistrano::EXTENSIONS[#{name.inspect}])
35
+ end
36
+ STR
37
+
38
+ EXTENSIONS[name] = mod
39
+ return true
40
+ end
41
+
42
+ # Unregister the plugin with the given name.
43
+ def self.remove_plugin(name)
44
+ name = name.to_sym
45
+ if EXTENSIONS.delete(name)
46
+ Capistrano::Configuration.send(:remove_method, name)
47
+ return true
48
+ end
49
+
50
+ return false
51
+ end
52
+
53
+ def self.configuration(*args) #:nodoc:
54
+ warn "[DEPRECATION] Capistrano.configuration is deprecated. Use Capistrano::Configuration.instance instead"
55
+ Capistrano::Configuration.instance(*args)
56
+ end
57
+ end
@@ -0,0 +1,59 @@
1
+ module Capistrano
2
+ class Logger #:nodoc:
3
+ attr_accessor :level
4
+ attr_reader :device
5
+
6
+ IMPORTANT = 0
7
+ INFO = 1
8
+ DEBUG = 2
9
+ TRACE = 3
10
+
11
+ MAX_LEVEL = 3
12
+
13
+ def initialize(options={})
14
+ output = options[:output] || $stderr
15
+ if output.respond_to?(:puts)
16
+ @device = output
17
+ else
18
+ @device = File.open(output.to_str, "a")
19
+ @needs_close = true
20
+ end
21
+
22
+ @options = options
23
+ @level = 0
24
+ end
25
+
26
+ def close
27
+ device.close if @needs_close
28
+ end
29
+
30
+ def log(level, message, line_prefix=nil)
31
+ if level <= self.level
32
+ indent = "%*s" % [MAX_LEVEL, "*" * (MAX_LEVEL - level)]
33
+ (RUBY_VERSION >= "1.9" ? message.lines : message).each do |line|
34
+ if line_prefix
35
+ device.puts "#{indent} [#{line_prefix}] #{line.strip}\n"
36
+ else
37
+ device.puts "#{indent} #{line.strip}\n"
38
+ end
39
+ end
40
+ end
41
+ end
42
+
43
+ def important(message, line_prefix=nil)
44
+ log(IMPORTANT, message, line_prefix)
45
+ end
46
+
47
+ def info(message, line_prefix=nil)
48
+ log(INFO, message, line_prefix)
49
+ end
50
+
51
+ def debug(message, line_prefix=nil)
52
+ log(DEBUG, message, line_prefix)
53
+ end
54
+
55
+ def trace(message, line_prefix=nil)
56
+ log(TRACE, message, line_prefix)
57
+ end
58
+ end
59
+ end
@@ -0,0 +1,53 @@
1
+ module Capistrano
2
+ module Processable
3
+ module SessionAssociation
4
+ def self.on(exception, session)
5
+ unless exception.respond_to?(:session)
6
+ exception.extend(self)
7
+ exception.session = session
8
+ end
9
+
10
+ return exception
11
+ end
12
+
13
+ attr_accessor :session
14
+ end
15
+
16
+ def process_iteration(wait=nil, &block)
17
+ ensure_each_session { |session| session.preprocess }
18
+
19
+ return false if block && !block.call(self)
20
+
21
+ readers = sessions.map { |session| session.listeners.keys }.flatten.reject { |io| io.closed? }
22
+ writers = readers.select { |io| io.respond_to?(:pending_write?) && io.pending_write? }
23
+
24
+ if readers.any? || writers.any?
25
+ readers, writers, = IO.select(readers, writers, nil, wait)
26
+ end
27
+
28
+ if readers
29
+ ensure_each_session do |session|
30
+ ios = session.listeners.keys
31
+ session.postprocess(ios & readers, ios & writers)
32
+ end
33
+ end
34
+
35
+ true
36
+ end
37
+
38
+ def ensure_each_session
39
+ errors = []
40
+
41
+ sessions.each do |session|
42
+ begin
43
+ yield session
44
+ rescue Exception => error
45
+ errors << SessionAssociation.on(error, session)
46
+ end
47
+ end
48
+
49
+ raise errors.first if errors.any?
50
+ sessions
51
+ end
52
+ end
53
+ end
@@ -0,0 +1,32 @@
1
+ # A collection of compatibility scripts, to ease the transition between
2
+ # Capistrano 1.x and Capistrano 2.x.
3
+
4
+ # Depends on the deployment system
5
+ load 'deploy'
6
+
7
+ map = { "diff_from_last_deploy" => "deploy:pending:diff",
8
+ "update" => "deploy:update",
9
+ "update_code" => "deploy:update_code",
10
+ "symlink" => "deploy:symlink",
11
+ "restart" => "deploy:restart",
12
+ "rollback" => "deploy:rollback",
13
+ "cleanup" => "deploy:cleanup",
14
+ "disable_web" => "deploy:web:disable",
15
+ "enable_web" => "deploy:web:enable",
16
+ "cold_deploy" => "deploy:cold",
17
+ "deploy_with_migrations" => "deploy:migrations" }
18
+
19
+ map.each do |old, new|
20
+ desc "DEPRECATED: See #{new}."
21
+ eval "task(#{old.inspect}) do
22
+ warn \"[DEPRECATED] `#{old}' is deprecated. Use `#{new}' instead.\"
23
+ find_and_execute_task(#{new.inspect})
24
+ end"
25
+ end
26
+
27
+ desc "DEPRECATED: See deploy:start."
28
+ task :spinner do
29
+ warn "[DEPRECATED] `spinner' is deprecated. Use `deploy:start' instead."
30
+ set :runner, fetch(:spinner_user, "app")
31
+ deploy.start
32
+ end