- Add require_context directive

examples/require-context/commands.txt

@@ -0,0 +1,5 @@
+--help
+ping
+server --help
+server
+server deploy

examples/require-context/runfile

@@ -0,0 +1,7 @@
+title 'DevOps Toolbox'
+
+import 'server', image: 'my-rails-app', allow_deploy: true
+
+action 'ping' do
+  say 'PONG'
+end

examples/require-context/server.runfile

@@ -0,0 +1,25 @@
+title   'Server commands'
+summary 'Build and manage all the servers'
+
+# Declare that we need three variables in the `import` directive
+# One mandatory (:image) and two with a default fallback values
+require_context :image
+require_context :allow_deploy, default: false
+require_context :env,          default: 'development'
+
+# $ run server : default command
+action do |args|
+  say 'g`Context`:'
+  p context
+  say 'g`Args`:'
+  p args
+end
+
+help   'Deploy to production'
+action 'deploy' do
+  if context[:allow_deploy]
+    say 'DEPLOYING'
+  else
+    say! "r`Deployment not allowed`"
+  end
+end

lib/runfile/action.rb

@@ -9,12 +9,22 @@ class Action
     attr_accessor :block, :help, :host
 
     def run(args = {})
+      validate_context
+
       instance_eval do
         host.helpers.each { |b| b.call args }
         block.call args
       end
     end
 
+    def validate_context
+      host.required_contexts.each do |varname, default|
+        next if host.context[varname]
+        raise UserError, "Need #{varname}" if default.nil?
+        host.context[varname] = default
+      end
+    end
+
     def inspectable
       { name: name, prefix: prefix, shortcut: shortcut, host: host }
     end

lib/runfile/concerns/dsl.rb

@@ -48,6 +48,14 @@ def param(name, help)
       params[name] = help
     end
 
+    def require_context(varname, default: nil)
+      required_contexts[varname] = default
+    end
+
+    def required_contexts
+      @required_contexts ||= {}
+    end
+
     def shortcut(name)
       current_action.shortcut = name
     end

spec/approvals/initiator/examples

@@ -13,6 +13,7 @@
   multiple-runfiles
   named-only
   naval-fate
+  require-context
   shortcut
 
 Run run example EXAMPLE with any of these examples to copy the files

spec/approvals/integration/require-context/run

@@ -0,0 +1,4 @@
+Usage:
+  run ping
+  run server
+  run [COMMAND] (--help | -h)

spec/approvals/integration/require-context/run --help

@@ -0,0 +1,14 @@
+DevOps Toolbox
+
+Usage:
+  run ping
+  run server
+  run [COMMAND] (--help | -h)
+
+Commands:
+  nb`server`
+    Build and manage all the servers
+
+Options:
+  --help, -h
+    Show this message

spec/approvals/integration/require-context/run ping

@@ -0,0 +1 @@
+PONG

spec/approvals/integration/require-context/run server

@@ -0,0 +1,4 @@
+Context:
+{:image=>"my-rails-app", :allow_deploy=>true, :env=>"development"}
+Args:
+{"server"=>true, "deploy"=>false, "--help"=>false}

spec/approvals/integration/require-context/run server --help

@@ -0,0 +1,16 @@
+Server commands
+
+  Build and manage all the servers
+
+Usage:
+  run server
+  run server deploy
+  run server (--help | -h)
+
+Commands:
+  nb`deploy`
+    Deploy to production
+
+Options:
+  --help, -h
+    Show this message

spec/approvals/integration/require-context/run server deploy

@@ -0,0 +1 @@
+DEPLOYING

spec/spec_helper.rb

@@ -3,7 +3,7 @@
 unless ENV['NOCOV']
   SimpleCov.start do
     enable_coverage :branch
-    # primary_coverage :branch
+    primary_coverage :branch
   end
 end