Class: Bake::Context

Inherits:
Object
  • Object
show all
Defined in:
lib/bake/context.rb

Overview

Represents a context of task execution, containing all relevant state.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(registry, root = nil) ⇒ Context

Initialize the context with the specified registry.



64
65
66
67
68
69
70
71
72
73
74
75
 
# File 'lib/bake/context.rb', line 64

def initialize(registry, root = nil)
  @registry = registry
  @root = root
  
  @instances = Hash.new do |hash, key|
    hash[key] = instance_for(key)
  end
  
  @recipes = Hash.new do |hash, key|
    hash[key] = recipe_for(key)
  end
end

Instance Attribute Details

#registry ⇒ Object (readonly)

The registry which will be used to resolve recipes in this context.



82
83
84
 
# File 'lib/bake/context.rb', line 82

def registry
  @registry
end

#root ⇒ Object (readonly)

The root path of this context.



86
87
88
 
# File 'lib/bake/context.rb', line 86

def root
  @root
end

Class Method Details

.bakefile_path(path, bakefile: BAKEFILE) ⇒ Object

Search upwards from the specified path for a BAKEFILE. If path points to a file, assume it’s a ‘bake.rb` file. Otherwise, recursively search up the directory tree starting from `path` to find the specified bakefile.



19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
 
# File 'lib/bake/context.rb', line 19

def self.bakefile_path(path, bakefile: BAKEFILE)
  if File.file?(path)
    return path
  end
  
  current = path
  
  while current
    bakefile_path = File.join(current, BAKEFILE)
    
    if File.exist?(bakefile_path)
      return bakefile_path
    end
    
    parent = File.dirname(current)
    
    if current == parent
      break
    else
      current = parent
    end
  end
  
  return nil
end

.load(path = Dir.pwd) ⇒ Object

Load a context from the specified path.



47
48
49
50
51
52
53
54
55
56
57
58
59
60
 
# File 'lib/bake/context.rb', line 47

def self.load(path = Dir.pwd)
  if bakefile_path = self.bakefile_path(path)
    working_directory = File.dirname(bakefile_path)
  else
    working_directory = path
  end
  
  registry = Registry.default(working_directory, bakefile_path)
  context = self.new(registry, working_directory)
  
  context.bakefile
  
  return context
end

Instance Method Details

#bakefile ⇒ Object 



77
78
79
 
# File 'lib/bake/context.rb', line 77

def bakefile
  @instances[[]]
end

#call(*commands) ⇒ Object

Invoke recipes on the context using command line arguments.

e.g. ‘context.call(“gem:release:version:increment”, “0,0,1”)`



93
94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'lib/bake/context.rb', line 93

def call(*commands)
  last_result = nil
  
  while command = commands.shift
    if recipe = @recipes[command]
      arguments, options = recipe.prepare(commands, last_result)
      last_result = recipe.call(*arguments, **options)
    else
      raise ArgumentError, "Could not find recipe for #{command}!"
    end
  end
  
  return last_result
end

#inspect ⇒ Object 



124
125
126
 
# File 'lib/bake/context.rb', line 124

def inspect
  "\#<#{self.class} #{@root}>"
end

#lookup(command) ⇒ Object Also known as: []

Lookup a recipe for the given command name.



110
111
112
 
# File 'lib/bake/context.rb', line 110

def lookup(command)
  @recipes[command]
end

#to_s ⇒ Object 



116
117
118
119
120
121
122
 
# File 'lib/bake/context.rb', line 116

def to_s
  if @root
    "#{self.class} #{File.basename(@root)}"
  else
    self.class.name
  end
end