Class: Wip::CommandBuilder

Inherits:
Object
  • Object
show all
Defined in:
lib/wip/command_builder.rb

Overview

Builds the argument arrays for wslc build/exec/run/custom invocations.

Instance Method Summary collapse

Constructor Details

#initialize(wslc:, config:, environment: Environment.new, dotenv: {}) ⇒ CommandBuilder

Returns a new instance of CommandBuilder.



8
9
10
11
12
13
 
# File 'lib/wip/command_builder.rb', line 8

def initialize(wslc:, config:, environment: Environment.new, dotenv: {})
  @wslc = wslc
  @config = config
  @environment = environment
  @dotenv = dotenv
end

Instance Method Details

#build(settings:, extra: []) ⇒ Object

Raises:



116
117
118
119
120
121
122
123
 
# File 'lib/wip/command_builder.rb', line 116

def build(settings:, extra: [])
  values = primary_values.merge(settings)
  context = values['context'] || '.'
  tag = values['tag'] || values['image']
  raise ConfigError, 'Build image/tag must not be empty' if tag.to_s.empty?

  [@wslc, 'build', '-t', tag, *extra, context]
end

#custom(name, arguments) ⇒ Object 



125
126
127
128
129
130
131
132
 
# File 'lib/wip/command_builder.rb', line 125

def custom(name, arguments)
  values = @config.command(name) || raise(ConfigError, "Unknown command: #{name}")
  type = values['type'] || (name.to_s == 'build' ? 'build' : 'exec')
  base = Shellwords.split(values['command'].to_s)
  return build(settings: values, extra: arguments) if type == 'build'

  public_send(type, base + arguments, settings: values, interactive: values.fetch('interactive', false))
end

#dependency_down(name) ⇒ Object 



108
109
110
 
# File 'lib/wip/command_builder.rb', line 108

def dependency_down(name)
  [@wslc, 'stop', name.to_s]
end

#dependency_find(name) ⇒ Object 



104
105
106
 
# File 'lib/wip/command_builder.rb', line 104

def dependency_find(name)
  [@wslc, 'list', '--all', '--filter', "name=#{name}", '--format', 'json']
end

#dependency_remove(name) ⇒ Object 



112
113
114
 
# File 'lib/wip/command_builder.rb', line 112

def dependency_remove(name)
  [@wslc, 'remove', '-f', name.to_s]
end

#dependency_start(name) ⇒ Object 



100
101
102
 
# File 'lib/wip/command_builder.rb', line 100

def dependency_start(name)
  [@wslc, 'start', name.to_s]
end

#dependency_up(name, detach: true) ⇒ Object 



90
91
92
93
94
95
96
97
98
 
# File 'lib/wip/command_builder.rb', line 90

def dependency_up(name, detach: true)
  values = dependency_values(name)
  command = [@wslc, 'run', '--name', name.to_s]
  command.push('--network', @config.network) if @config.network
  command << '-d' if detach
  command.concat(options(values, sync: false)).push(required(values, 'image'))
  command.concat(Shellwords.split(values['command'].to_s)) unless values['command'].to_s.empty?
  command
end

#down ⇒ Object 



74
75
76
 
# File 'lib/wip/command_builder.rb', line 74

def down
  [@wslc, 'stop', @config.container]
end

#exec(arguments, settings: {}, interactive: true) ⇒ Object 



15
16
17
18
19
20
21
22
23
 
# File 'lib/wip/command_builder.rb', line 15

def exec(arguments, settings: {}, interactive: true)
  # dependencies: entries don't carry their own name (it's the hash key), so the
  # exec target defaults to @config.container; a commands: entry can still
  # redirect it by setting its own `container:`.
  values = primary_values.merge('container' => @config.container).merge(settings)
  command = [@wslc, 'exec']
  command << '-it' if tty?(interactive)
  command.concat(options(values, include_container: true, include_publish: false)).concat(arguments)
end

#find ⇒ Object 



50
51
52
 
# File 'lib/wip/command_builder.rb', line 50

def find
  [@wslc, 'list', '--all', '--filter', "name=#{@config.container}", '--format', 'json']
end

#network_create ⇒ Object 



82
83
84
 
# File 'lib/wip/command_builder.rb', line 82

def network_create
  [@wslc, 'network', 'create', required_network]
end

#network_list ⇒ Object 



86
87
88
 
# File 'lib/wip/command_builder.rb', line 86

def network_list
  [@wslc, 'network', 'list', '--format', 'json']
end

#remove ⇒ Object 



78
79
80
 
# File 'lib/wip/command_builder.rb', line 78

def remove
  [@wslc, 'remove', '-f', @config.container]
end

#run(arguments, settings: {}, interactive: true) ⇒ Object 



25
26
27
28
29
30
31
 
# File 'lib/wip/command_builder.rb', line 25

def run(arguments, settings: {}, interactive: true)
  values = primary_values.merge(settings)
  command = [@wslc, 'run']
  command << '--rm' if values['remove']
  command << '-it' if tty?(interactive)
  command.concat(options(values)).push(required(values, 'image')).concat(arguments)
end

#start(detach: false) ⇒ Object 



44
45
46
47
48
 
# File 'lib/wip/command_builder.rb', line 44

def start(detach: false)
  command = [@wslc, 'start', @config.container]
  command.push('-a', '-i') unless detach
  command
end

#sync_exec ⇒ Object

Mirrors from inside the already-running container. Only valid for sync.mode: exec (mode: container's default), since only a container wip itself booted is guaranteed to have both the read-only source mount and the volume attached.



70
71
72
 
# File 'lib/wip/command_builder.rb', line 70

def sync_exec
  [@wslc, 'exec', @config.container, *required_sync.mirror_command]
end

#sync_run ⇒ Object

Mirrors into the volume from a throwaway container. Used for sync.mode: run (compose's default, and mode: container's fallback for when the app container isn't running yet — e.g. just before up boots it). sync.image overrides the mirror container's image; compose mode requires it, since there's no dependencies: entry to fall back to (compose owns those).



59
60
61
62
63
64
 
# File 'lib/wip/command_builder.rb', line 59

def sync_run
  sync = required_sync
  command = [@wslc, 'run', '--rm']
  sync.volume_specs.each { |spec| command.push('-v', spec) }
  command.push(sync.image || required(primary_values, 'image')).concat(sync.mirror_command)
end

#tty?(requested) ⇒ Boolean

Returns:

  • (Boolean) 


134
 
# File 'lib/wip/command_builder.rb', line 134

def tty?(requested) = requested && @environment.interactive?

#up(detach: false) ⇒ Object 



33
34
35
36
37
38
39
40
41
42
 
# File 'lib/wip/command_builder.rb', line 33

def up(detach: false)
  values = primary_values
  command = [@wslc, 'run', '--name', @config.container]
  command.push('--network', @config.network) if @config.network
  command << '-d' if detach
  command << '-it' if !detach && tty?(true)
  command.concat(options(values)).push(required(values, 'image'))
  command.concat(Shellwords.split(values['command'].to_s)) unless values['command'].to_s.empty?
  command
end