Class: Build::Task

Inherits:
Graph::Task
  • Object
show all
Defined in:
lib/build/task.rb

Overview

This task class serves as the base class for the environment specific task classes genearted when adding targets.

Defined Under Namespace

Classes: CommandFailure

Instance Method Summary collapse

Constructor Details

#initialize(walker, node, group, logger: nil) ⇒ Task

Returns a new instance of Task.



49
50
51
52
53
54
55
 
# File 'lib/build/task.rb', line 49

def initialize(walker, node, group, logger: nil)
  super(walker, node)
  
  @group = group
  
  @logger = logger || Logger.new($stderr)
end

Instance Method Details

#cp(source_path, destination_path) ⇒ Object 



87
88
89
90
91
92
 
# File 'lib/build/task.rb', line 87

def cp(source_path, destination_path)
  return unless wet?
  
  @logger.info('shell'){ ['cp', source_path, destination_path]}
  FileUtils.copy(source_path, destination_path)
end

#fs ⇒ Object

Legacy FileUtils access, replaced with direct function calls.



119
120
121
 
# File 'lib/build/task.rb', line 119

def fs
  self
end

#install(source_path, destination_path) ⇒ Object 



111
112
113
114
115
116
 
# File 'lib/build/task.rb', line 111

def install(source_path, destination_path)
  return unless wet?
  
  @logger.info('shell'){ ['install', source_path, destination_path]}
  FileUtils.install(source_path, destination_path)
end

#invoke_rule(rule, arguments, &block) ⇒ Object 



127
128
129
130
131
132
133
134
135
136
137
138
 
# File 'lib/build/task.rb', line 127

def invoke_rule(rule, arguments, &block)
  arguments = rule.normalize(arguments, self)
  
  @logger.debug('invoke') {"-> #{rule}(#{arguments.inspect})"}
  
  node = RuleNode.new(rule, arguments, &block)
  task = invoke(node)
  
  @logger.debug('invoke') {"<- #{rule}(...) -> #{rule.result(arguments)}"}
  
  return rule.result(arguments)
end

#mkpath(path) ⇒ Object 



101
102
103
104
105
106
107
108
109
 
# File 'lib/build/task.rb', line 101

def mkpath(path)
  return unless wet?
  
  unless File.exist?(path)
    @logger.info('shell'){ ['mkpath', path] }
    
    FileUtils.mkpath(path)
  end
end

#rm(path) ⇒ Object 



94
95
96
97
98
99
 
# File 'lib/build/task.rb', line 94

def rm(path)
  return unless wet?
  
  @logger.info('shell'){ ['rm -rf', path] }
  FileUtils.rm_rf(path)
end

#run!(*arguments) ⇒ Object 



76
77
78
 
# File 'lib/build/task.rb', line 76

def run!(*arguments)
  self.spawn(shell_environment, *arguments)
end

#shell_environment ⇒ Object 



72
73
74
 
# File 'lib/build/task.rb', line 72

def shell_environment
  @shell_environment ||= environment.flatten.export
end

#spawn(*arguments) ⇒ Object 



61
62
63
64
65
66
67
68
69
70
 
# File 'lib/build/task.rb', line 61

def spawn(*arguments)
  if wet?
    @logger.info('shell') {arguments}
    status = @group.spawn(*arguments)
    
    if status != 0
      raise CommandFailure.new(self, arguments, status)
    end
  end
end

#touch(path) ⇒ Object 



80
81
82
83
84
85
 
# File 'lib/build/task.rb', line 80

def touch(path)
  return unless wet?
  
  @logger.info('shell'){ ['touch', path] }
  FileUtils.touch(path)
end

#update ⇒ Object 



123
124
125
 
# File 'lib/build/task.rb', line 123

def update
  @node.apply!(self)
end

#wet? ⇒ Boolean

Returns:

  • (Boolean) 


57
58
59
 
# File 'lib/build/task.rb', line 57

def wet?
  @node.dirty?
end