Class: Capistrano::TaskDefinition

Inherits:
Object
  • Object
show all
Defined in:
lib/capistrano/task_definition.rb

Overview

Represents the definition of a single task.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, namespace, options = {}, &block) ⇒ TaskDefinition

Returns a new instance of TaskDefinition.



8
9
10
11
12
13
14
15
 
# File 'lib/capistrano/task_definition.rb', line 8

def initialize(name, namespace, options={}, &block)
  @name, @namespace, @options = name, namespace, options
  @desc = @options.delete(:desc)
  @on_error = options.delete(:on_error)
  @max_hosts = options[:max_hosts] && options[:max_hosts].to_i
  @body = block or raise ArgumentError, "a task requires a block"
  @servers = nil
end

Instance Attribute Details

#body ⇒ Object (readonly)

Returns the value of attribute body.



6
7
8
 
# File 'lib/capistrano/task_definition.rb', line 6

def body
  @body
end

#desc ⇒ Object (readonly)

Returns the value of attribute desc.



6
7
8
 
# File 'lib/capistrano/task_definition.rb', line 6

def desc
  @desc
end

#max_hosts ⇒ Object (readonly)

Returns the value of attribute max_hosts.



6
7
8
 
# File 'lib/capistrano/task_definition.rb', line 6

def max_hosts
  @max_hosts
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



6
7
8
 
# File 'lib/capistrano/task_definition.rb', line 6

def name
  @name
end

#namespace ⇒ Object (readonly)

Returns the value of attribute namespace.



6
7
8
 
# File 'lib/capistrano/task_definition.rb', line 6

def namespace
  @namespace
end

#on_error ⇒ Object (readonly)

Returns the value of attribute on_error.



6
7
8
 
# File 'lib/capistrano/task_definition.rb', line 6

def on_error
  @on_error
end

#options ⇒ Object (readonly)

Returns the value of attribute options.



6
7
8
 
# File 'lib/capistrano/task_definition.rb', line 6

def options
  @options
end

Instance Method Details

#brief_description(max_length = nil) ⇒ Object

Returns the first sentence of the full description. If max_length is given, the result will be truncated if it is longer than max_length, and an ellipsis appended.



54
55
56
57
58
59
60
61
62
 
# File 'lib/capistrano/task_definition.rb', line 54

def brief_description(max_length=nil)
  brief = description[/^.*?\.(?=\s|$)/] || description

  if max_length && brief.length > max_length
    brief = brief[0,max_length-3] + "..."
  end

  brief
end

#continue_on_error? ⇒ Boolean

Indicates whether the task wants to continue, even if a server has failed previously

Returns:

  • (Boolean) 


66
67
68
 
# File 'lib/capistrano/task_definition.rb', line 66

def continue_on_error?
  @on_error == :continue
end

#description(rebuild = false) ⇒ Object

Returns the description for this task, with newlines collapsed and whitespace stripped. Returns the empty string if there is no description for this task.



31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/capistrano/task_definition.rb', line 31

def description(rebuild=false)
  @description = nil if rebuild
  @description ||= begin
    description = @desc || ""

    indentation = description[/\A\s+/]
    if indentation
      reformatted_description = ""
      description.strip.each_line do |line|
        line = line.chomp.sub(/^#{indentation}/, "")
        line = line.gsub(/#{indentation}\s*/, " ") if line[/^\S/]
        reformatted_description << line << "\n"
      end
      description = reformatted_description
    end

    description.strip.gsub(/\r\n/, "\n")
  end
end

#fully_qualified_name ⇒ Object

Returns the task’s fully-qualified name, including the namespace



18
19
20
21
22
23
24
25
26
 
# File 'lib/capistrano/task_definition.rb', line 18

def fully_qualified_name
  @fully_qualified_name ||= begin
    if namespace.default_task == self
      namespace.fully_qualified_name
    else
      [namespace.fully_qualified_name, name].compact.join(":")
    end
  end
end