warg 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f3218ac31a91c31f37269dc2e7275ace86b9d8f5
-  data.tar.gz: 91a5418ba04081349f1304a1f1332272c1fdc8a1
+SHA256:
+  metadata.gz: 1dfc90bc5fc1c52e7eac6a1f96968c0fbeed6d18313e35264a025af656dcad8a
+  data.tar.gz: 2cb29f9dc1e49fb87a4b905c052c198de601952d7cf2c9ab39be44a2623d26b8
 SHA512:
-  metadata.gz: 7ff724c5f97e93740491fed3d13eb029d9df461cad2f24f2f88de1eba6a909c9fee17cd6cc4a4b3d5baaeee7c6fbeb283afdde86a61a903d9e25b100042d5933
-  data.tar.gz: 34f45b703c5a7f90e7bd27a879112e88580be9c1d3a5cd07d1fb95a4d82b9e87474481e75d02d2c7303fb8ebd5d0f898fcaf7dc663e03c6722e340c76665444c
+  metadata.gz: 7248cd6836ae24f89e3ccb06d27ad26c273a37a2f6600562ae8d226d2348bc5ec85e67d6899218ea9448a18dde4315d5f966315a046c72cbb9c07e7138a8d206
+  data.tar.gz: 505dc011e56a496e75ad07de1e203592d050792f54992e77c6c908fad8bee9a4c60cc1343b26830992574536b1c84a30513364372896a3cd50601d0aa2aa44be

data/README.md

@@ -1,29 +1 @@
-# Warg
-
-TODO: Write a gem description
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-    gem 'warg'
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install warg
-
-## Usage
-
-TODO: Write usage instructions here
-
-## Contributing
-
-1. Fork it ( http://github.com/<my-github-username>/warg/fork )
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+# warg

data/bin/console-playground

@@ -0,0 +1,124 @@
+#!/usr/bin/env ruby
+
+require "simplecov"
+SimpleCov.start do
+  add_filter %r{^/(?:warg|test)/}
+  # For running on ruby 2.3 on CI. Latest simplecov requires ruby 2.4+ and `enable_coverage`
+  # only exists on the latest versions
+  respond_to?(:enable_coverage) and enable_coverage(:branch)
+
+  # Combine coverage results generated here to what's generated by the test suite
+  command_name "Unit Tests"
+end
+
+$:.unshift(File.expand_path(File.join("..", "..", "lib"), __FILE__))
+
+if ENV["BYEBUG_REMOTE"] == "1"
+  require "byebug"
+  require "byebug/core"
+  Byebug.wait_connection = true
+  Byebug.start_server("localhost", 5000)
+end
+
+require "pry"
+
+# NOTE: Unsure why `"set"` needs to be loaded here
+require "set"
+require "warg"
+
+console = Warg::Console.new
+
+ctpa_town = Warg::Host.from("randy@ctpa-town.com")
+sodo_sopa = Warg::Host.from("loo@sodo-sopa.com")
+nomo_auchi = Warg::Host.from("pc@nomo-auchi.com")
+lomo_robo = Warg::Host.from("luke@lomo-robo.com")
+
+Warg::Console.hostname_width = [ctpa_town, sodo_sopa, nomo_auchi].map { |host| host.address.length }.max
+
+console.redirecting_stdout_and_stderr do
+  # `mirame` is an example of content spanning multiple lines with its last line being longer
+  # than 0.
+  mirame = console.print_content "mirame!\n ahora! "
+
+  # We follow `mirame` with content on the same line; when we reset `mirame` to empty text later,
+  # this ensures content is correctly reflowed
+  console.print Warg::Console::SGR("buscame?").with(text_color: :green, effect: :underline)
+
+  sleep 2
+
+  # Add a `HostStatus` to check that changing host status after multi-line and single-line content
+  # works as expected
+  host_line_1 = Warg::Console::HostStatus.new(ctpa_town, console)
+
+  sleep 2
+
+  # Start a line with single-line content
+  que_tal = console.print_content "que tal "
+
+  sleep 2
+
+  # Add a `HostStatus`
+  host_line_2 = Warg::Console::HostStatus.new(sodo_sopa, console)
+
+  sleep 2
+
+  # Reset `mirame` to an empty string with SGR effects to check SGR sequences don't affect the
+  # `last_line_length` of the content
+  mirame.text = Warg::Console::SGR("").with(text_color: :cyan, effect: :strikethrough)
+
+  sleep 2
+
+  # Update the status of `host_line_1` to check that content after it is re-printed correctly
+  host_line_1.started!
+
+  sleep 2
+
+  # Add content using `Kernel#print` and `IOProxy#print` to test `IOProxy`
+  print "no me cambies! "
+  $stdout.print Warg::Console::SGR("dejame aqui! ").with(text_color: :red, effect: :blink_slow)
+
+  # Add more inline content
+  que_haces = console.print_content "que haces? "
+
+  sleep 2
+
+  # Add two host statuses
+  host_line_3 = Warg::Console::HostStatus.new(nomo_auchi, console)
+
+  sleep 2
+
+  host_line_4 = Warg::Console::HostStatus.new(lomo_robo, console)
+
+  $stdout.puts "me quedo aqui abajo"
+
+  sleep 2
+
+  # Change text so it is longer to check that content after it is reflowed correctly
+  que_tal.text = "que fue mijo?! "
+
+  sleep 2
+
+  host_line_4.started!
+
+  sleep 2
+
+  host_line_2.failed! <<~CONTENT
+  STDOUT: (none)
+  STDERR: unbound variable `$der'
+  CONTENT
+
+  sleep 2
+
+  que_haces.text = Warg::Console::SGR("cuanto quieres? ").with(text_color: :magenta)
+
+  sleep 2
+
+  host_line_3.failed! <<~CONTENT
+  STDOUT: (none)
+  STDERR: whoopsie!
+  CONTENT
+
+  sleep 2
+
+  host_line_4.success!
+end

data/bin/hodor

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.expand_path(File.join("..", "..", "lib"), __FILE__))
+
+require "warg"
+
+Warg::Runner.new(ARGV).run

data/lib/warg.rb

@@ -1,5 +1,2208 @@
-require "warg/version"
+require "uri"
+require "optparse"
+require "pathname"
+require "forwardable"
+require "tempfile"
+require "digest/sha1"
+
+require "net/ssh"
+require "net/scp"
+
+unless Hash.method_defined?(:transform_keys)
+  class Hash
+    def transform_keys
+      if block_given?
+        map { |key, value| [yield(key), value] }.to_h
+      else
+        enum_for(:transform_keys)
+      end
+    end
+  end
+end
+
+unless Exception.method_defined?(:full_message)
+  class Exception
+    def full_message(highlight: true, order: :bottom)
+      trace = backtrace || [caller[0]]
+
+      trace_head = trace[0]
+      trace_tail = trace[1..-1] || []
+
+      output = "#{trace_head}: \e[1m#{message} (\e[1;4m#{self.class}\e[m\e[1m)\e[m"
+
+      case order.to_sym
+      when :top
+        unless trace_tail.empty?
+          output << "\n\t from #{trace_tail.join("\n\t from ")}"
+        end
+      when :bottom
+        trace_tail.each_with_index do |line, index|
+          output.prepend "\t#{index + 1}: from #{line}\n"
+        end
+
+        output.prepend "\e[1mTraceback\e[m (most recent call last):\n"
+      end
+
+      unless highlight
+        output.gsub!(/\e\[(\d+;)+m/, "")
+      end
+
+      output
+    end
+  end
+end
 
 module Warg
-  # Your code goes here...
+  class InvalidHostDataError < StandardError
+    def initialize(host_data)
+      @host_data = host_data
+    end
+
+    def message
+      "could not instantiate a host from `#{@host_data.inspect}'"
+    end
+  end
+
+  class Console
+    class << self
+      attr_accessor :hostname_width
+    end
+
+    def self.SGR(text)
+      SelectGraphicRendition::Renderer.new(text)
+    end
+
+    def initialize
+      @io = $stderr
+      @history = History.new
+      @cursor_position = CursorPosition.new
+      @io_mutex = Mutex.new
+      @history_mutex = Mutex.new
+    end
+
+    def redirecting_stdout_and_stderr
+      $stdout = IOProxy.new($stdout, self)
+      $stderr = IOProxy.new($stderr, self)
+
+      yield
+    ensure
+      $stdout = $stdout.__getobj__
+      $stderr = $stderr.__getobj__
+    end
+
+    def puts(text_or_content = nil)
+      content = print_content text_or_content
+
+      unless text_or_content.to_s.end_with?("\n")
+        print_content "\n"
+      end
+
+      content
+    end
+
+    def print(text_or_content = nil)
+      print_content(text_or_content)
+    end
+
+    def print_content(text_or_content)
+      content = case text_or_content
+                when Content, HostStatus
+                  text_or_content
+                else
+                  Content.new(text_or_content, self)
+                end
+
+      @io_mutex.synchronize do
+        @io.print content.to_s
+
+        append_to_history(content)
+
+        content
+      end
+    end
+
+    def append_to_history(content)
+      @history_mutex.synchronize do
+        @history.append(content, at: @cursor_position)
+        @cursor_position.adjust_to(content)
+      end
+    end
+
+    # For CSI sequences, see:
+    # https://en.wikipedia.org/wiki/ANSI_escape_code#Terminal_output_sequences
+    def reprint_content(content)
+      @io_mutex.lock
+
+      history_entry = @history.find_entry_for(content)
+
+      rows_from_cursor_row_to_content_start = @cursor_position.row - history_entry.row_number
+
+      # starting from the current line, clear the line and move up a line
+      #
+      # this will bring us to the line the content we're reprinting, clearing all lines beneath
+      # it
+      rows_from_cursor_row_to_content_start.times do
+        # clear the current line
+        @io.print "\e[2K"
+
+        # move up a line
+        @io.print "\e[1A"
+      end
+
+      # go to the column of the content
+      @io.print "\e[#{history_entry.column_number}G"
+
+      # clear from the starting column of the content to the end of the line
+      @io.print "\e[0K"
+
+      # re-print the content from its original location
+      @io.print content.to_s
+
+      # initialize how much we'll be adjusting the column number by
+      column_adjustment = history_entry.end_column
+
+      current_entry = history_entry
+
+      until current_entry.next_entry.nil?
+        next_entry = current_entry.next_entry
+
+        # we only update the column of subsequent entries if they were on the same line as the
+        # entry being reprinted.
+        if next_entry.row_number == history_entry.end_row
+          next_entry.column_number = column_adjustment
+          column_adjustment += next_entry.last_line_length
+        end
+
+        # update the next entry's row number by how many rows the updated entry grew or shrank
+        next_entry.row_number += history_entry.newline_count_diff
+
+        # print the content
+        @io.print next_entry.to_s
+
+        # get the next entry to repeat
+        current_entry = next_entry
+      end
+
+      # Update the cursor position by how many row's the new content has changed and the new
+      # end column of the last entry in the history
+      @cursor_position.column = current_entry.end_column
+      @cursor_position.row += history_entry.newline_count_diff
+
+      # reset `newline_count` and `last_line_length` to what they now are in `@content`
+      history_entry.sync!
+
+      @io_mutex.unlock
+    end
+
+    class IOProxy < SimpleDelegator
+      def initialize(io, console)
+        if io.is_a? IOProxy
+          raise ArgumentError, "cannot nest `IOProxy' instances"
+        end
+
+        @io = io
+        @console = console
+        __setobj__ @io
+      end
+
+      def print(*texts)
+        texts.each do |text|
+          @io.print text
+
+          append_to_console_history text
+        end
+
+        nil
+      end
+
+      def puts(*texts)
+        texts.each do |text|
+          @io.puts text
+
+          append_to_console_history text
+
+          unless text.to_s.end_with?("\n")
+            append_to_console_history "\n"
+          end
+        end
+
+        nil
+      end
+
+      def write(*texts)
+        texts.inject(0) do |count, text|
+          @io.print text
+
+          append_to_console_history(text)
+
+          count + text.to_s.length
+        end
+      end
+
+      private
+
+      def append_to_console_history(text)
+        content = Content.new(text, @console)
+        @console.append_to_history(content)
+      end
+    end
+
+    class CursorPosition
+      attr_accessor :column
+      attr_accessor :row
+
+      def initialize
+        @row = 1
+        @column = 1
+      end
+
+      def adjust_to(content)
+        last_line_length = content.last_line_length
+        newline_count = content.newline_count
+
+        if newline_count > 0
+          @column = last_line_length + 1
+        else
+          @column += last_line_length
+        end
+
+        @row += newline_count
+      end
+
+      def inspect
+        %{#<#{self.class.name} row=#{row} column=#{column}>}
+      end
+    end
+
+    class History
+      def initialize
+        @head = FirstEntry.new
+      end
+
+      def append(content, at: cursor_position)
+        entry = Entry.new(content, at)
+
+        entry.previous_entry = @head
+        @head.next_entry     = entry
+
+        @head = entry
+      end
+
+      def find_entry_for(content)
+        current_entry = @head
+
+        until current_entry.previous_entry.nil? || current_entry.content == content
+          current_entry = current_entry.previous_entry
+        end
+
+        current_entry
+      end
+
+      def inspect
+        %{#<#{self.class.name} head=#{@head}>}
+      end
+
+      class FirstEntry
+        attr_reader :content
+        attr_accessor :next_entry
+        attr_reader :previous_entry
+
+        def column_number
+          1
+        end
+
+        def row_number
+          1
+        end
+
+        def newline_count
+          0
+        end
+
+        def last_line_length
+          0
+        end
+
+        def to_s
+          ""
+        end
+
+        def inspect
+          %{#<#{self.class.name}>}
+        end
+      end
+
+      class Entry
+        attr_accessor :column_number
+        attr_reader :content
+        attr_reader :last_line_length
+        attr_accessor :next_entry
+        attr_reader :newline_count
+        attr_accessor :previous_entry
+        attr_accessor :row_number
+
+        def initialize(content, cursor_position)
+          @content = content
+
+          @row_number = cursor_position.row
+          @column_number = cursor_position.column
+
+          @text = @content.to_s
+          @newline_count = @content.newline_count
+          @last_line_length = @content.last_line_length
+        end
+
+        def sync!
+          @text = @content.to_s
+          @last_line_length = @content.last_line_length
+        end
+
+        def newline_count_diff
+          @content.newline_count - @newline_count
+        end
+
+        def end_row
+          @row_number + newline_count
+        end
+
+        def end_column
+          value = 1 + @content.last_line_length
+
+          if newline_count.zero?
+            value += @column_number
+          end
+
+          value
+        end
+
+        def to_s
+          @text.dup
+        end
+
+        def inspect
+          %{#<#{self.class.name} row_number=#{row_number} column_number=#{column_number} content=#{content.inspect}>}
+        end
+      end
+    end
+
+    class Content
+      def initialize(text, console)
+        @text = text.to_s.freeze
+        @console = console
+      end
+
+      def text=(value)
+        @text = value.to_s.freeze
+        @console.reprint_content(self)
+        value
+      end
+
+      def newline_count
+        @text.count("\n")
+      end
+
+      def last_line_length
+        if @text.empty? || @text.end_with?("\n")
+          0
+        else
+          # Remove CSI sequences so they don't count against the length of the line because
+          # they are invisible in the terminal
+          @text.lines.last.gsub(/\e\[\d+;\d+;\d+m/, "").length
+        end
+      end
+
+      def to_s
+        @text
+      end
+
+      def inspect
+        %{#<#{self.class.name} newline_count=#{newline_count} last_line_length=#{last_line_length} text=#{@text.inspect}>}
+      end
+    end
+
+    class HostStatus
+      attr_accessor :row_number
+
+      def initialize(host, console)
+        @host = host
+        @console = console
+
+        @hostname = host.address
+        @state = Console::SGR("STARTING").with(text_color: :cyan)
+        @failure_message = ""
+
+        @console.puts self
+      end
+
+      def newline_count
+        1 + @failure_message.count("\n")
+      end
+
+      def last_line_length
+        0
+      end
+
+      def started!
+        @state = Console::SGR("RUNNING").with(text_color: :magenta)
+
+        @console.reprint_content(self)
+      end
+
+      def failed!(failure_message = "")
+        @state = Console::SGR("FAILED").with(text_color: :red, effect: :bold)
+        @failure_message = failure_message.to_s
+
+        @console.reprint_content(self)
+      end
+
+      def success!
+        @state = Console::SGR("DONE").with(text_color: :green)
+
+        @console.reprint_content(self)
+      end
+
+      def to_s
+        content = "  %-#{Console.hostname_width}s\t[ %s ]\n" % [@hostname, @state]
+
+        unless @failure_message.empty?
+          indented_failure_message = @failure_message.each_line.
+            map { |line| line.prepend("    ") }.
+            join
+
+          content << Console::SGR(indented_failure_message).with(text_color: :yellow)
+        end
+
+        content
+      end
+    end
+
+    class SelectGraphicRendition
+      TEXT_COLORS = {
+        "red"     => "31",
+        "green"   => "32",
+        "yellow"  => "33",
+        "blue"    => "34",
+        "magenta" => "35",
+        "cyan"    => "36",
+        "white"   => "37",
+      }
+
+      BACKGROUND_COLORS = TEXT_COLORS.map { |name, value| [name, (value.to_i + 10).to_s] }.to_h
+
+      EFFECTS = {
+        "bold"          => "1",
+        "faint"         => "2",
+        "italic"        => "3",
+        "underline"     => "4",
+        "blink_slow"    => "5",
+        "blink_fast"    => "6",
+        "invert_colors" => "7",
+        "hide"          => "8",
+        "strikethrough" => "9"
+      }
+
+      def initialize(text_color: "0", background_color: "0", effect: "0")
+        @text_color = TEXT_COLORS.fetch(text_color.to_s, text_color)
+        @background_color = BACKGROUND_COLORS.fetch(background_color.to_s, background_color)
+        @effect = EFFECTS.fetch(effect.to_s, effect)
+      end
+
+      def call(text)
+        "#{self}#{text}#{RESET}"
+      end
+
+      def wrap(text)
+        call(text)
+      end
+
+      def modify(**attrs)
+        combination = to_h.merge(attrs) do |key, old_value, new_value|
+          if old_value == "0"
+            new_value
+          elsif new_value == "0"
+            old_value
+          else
+            new_value
+          end
+        end
+
+        self.class.new(**combination)
+      end
+
+      def |(other)
+        modify(**other.to_h)
+      end
+
+      def to_str
+        "\e[#{@background_color};#{@effect};#{@text_color}m"
+      end
+
+      def to_s
+        to_str
+      end
+
+      def to_h
+        {
+          text_color: @text_color,
+          background_color: @background_color,
+          effect: @effect
+        }
+      end
+
+      RESET = new
+
+      class Renderer
+        def initialize(text)
+          @text = text
+          @select_graphic_rendition = SelectGraphicRendition.new
+        end
+
+        def with(**options)
+          @select_graphic_rendition = @select_graphic_rendition.modify(**options)
+          self
+        end
+
+        def to_s
+          @select_graphic_rendition.(@text)
+        end
+
+        def to_str
+          to_s
+        end
+      end
+    end
+  end
+
+  class Localhost
+    def address
+      "localhost"
+    end
+
+    def run
+      outcome = CommandOutcome.new
+
+      begin
+        outcome.command_started!
+
+        yield
+      rescue => error
+        outcome.error = error
+      end
+
+      outcome.command_finished!
+      outcome
+    end
+
+    def defer(command, banner, &block)
+      run_object = BlockProxy.new(banner, &block)
+      hosts = CollectionProxy.new
+
+      Executor::Deferred.new(command, run_object, hosts, :serial)
+    end
+
+    class BlockProxy
+      def initialize(banner, &block)
+        @banner = banner
+        @block = block
+      end
+
+      def to_s
+        @banner.dup
+      end
+
+      def to_proc
+        @block
+      end
+    end
+
+    class CollectionProxy
+      def run_block(run_object, **)
+        outcome = LOCALHOST.run(&run_object)
+
+        execution_result = Executor::Result.new
+        execution_result.update(outcome)
+        execution_result
+      end
+    end
+
+    class CommandOutcome
+      attr_accessor :error
+
+      def initialize
+        @console_status = Console::HostStatus.new(LOCALHOST, Warg.console)
+        @started_at = nil
+        @finished_at = nil
+      end
+
+      def host
+        LOCALHOST
+      end
+
+      def value
+        self
+      end
+
+      def command_started!
+        @started_at = Time.now
+        @started_at.freeze
+
+        @console_status.started!
+      end
+
+      def command_finished!
+        @finished_at = Time.now
+        @finished_at.freeze
+
+        if successful?
+          @console_status.success!
+        else
+          @console_status.failed!(failure_summary)
+        end
+      end
+
+      def successful?
+        error.nil?
+      end
+
+      def failed?
+        !successful?
+      end
+
+      def started?
+        not @started_at.nil?
+      end
+
+      def finished?
+        not @finished_at.nil?
+      end
+
+      def duration
+        if @started_at && @finished_at
+          @finished_at - @started_at
+        end
+      end
+
+      def failure_summary
+        error && error.full_message
+      end
+    end
+  end
+
+  LOCALHOST = Localhost.new
+
+  class Host
+    module Parser
+      module_function
+
+      REGEXP = URI.regexp("ssh")
+
+      def call(host_string)
+        match_data = REGEXP.match("ssh://#{host_string}")
+
+        query_string = match_data[8] || ""
+        query_fragments = query_string.split("&")
+
+        properties = query_fragments.inject({}) do |all, fragment|
+          name, value = fragment.split("=", 2)
+          all.merge!(name.to_sym => value)
+        end
+
+        {
+          user: match_data[3],
+          address: match_data[4],
+          port: match_data[5],
+          properties: properties
+        }
+      end
+    end
+
+    def self.from(host_data)
+      case host_data
+      when Host
+        host_data
+      when Hash
+        attributes = host_data.transform_keys(&:to_sym)
+
+        new(**attributes)
+      when Array
+        if host_data.length == 1 && Hash === host_data[0]
+          from(host_data[0])
+        elsif String === host_data[0]
+          last_item_index = -1
+          attributes = Parser.(host_data[0])
+
+          if Hash === host_data[-1]
+            last_item_index = -2
+
+            more_properties = host_data[-1].transform_keys(&:to_sym)
+            attributes[:properties].merge!(more_properties)
+          end
+
+          host_data[1..last_item_index].each do |property|
+            name, value = property.to_s.split("=", 2)
+            attributes[:properties][name.to_sym] = value
+          end
+
+          new(**attributes)
+        else
+          raise InvalidHostDataError.new(host_data)
+        end
+      when String
+        new(**Parser.(host_data))
+      else
+        raise InvalidHostDataError.new(host_data)
+      end
+    end
+
+    attr_reader :address
+    attr_reader :id
+    attr_reader :port
+    attr_reader :uri
+    attr_reader :user
+
+    def initialize(user: nil, address:, port: nil, properties: {})
+      @user = user
+      @address = address
+      @port = port
+      @properties = properties.transform_keys(&:to_s)
+
+      build_uri!
+    end
+
+    def matches?(filters)
+      filters.all? do |name, value|
+        if respond_to?(name)
+          send(name) == value
+        else
+          @properties[name.to_s] == value
+        end
+      end
+    end
+
+    def [](name)
+      @properties[name.to_s]
+    end
+
+    def []=(name, value)
+      @properties[name.to_s] = value
+
+      build_uri!
+
+      value
+    end
+
+    def ==(other)
+      self.class == other.class && uri == other.uri
+    end
+
+    alias eql? ==
+
+    def hash
+      inspect.hash
+    end
+
+    def run_command(command, &setup)
+      outcome = CommandOutcome.new(self, command, &setup)
+
+      connection.open_channel do |channel|
+        channel.exec(command) do |_, success|
+          outcome.command_started!
+
+          channel.on_data do |_, data|
+            outcome.collect_stdout(data)
+          end
+
+          channel.on_extended_data do |_, __, data|
+            outcome.collect_stderr(data)
+          end
+
+          channel.on_request("exit-status") do |_, data|
+            outcome.exit_status = data.read_long
+          end
+
+          channel.on_request("exit-signal") do |_, data|
+            outcome.exit_signal = data.read_string
+          end
+
+          channel.on_open_failed do |_, code, reason|
+            outcome.connection_failed(code, reason)
+          end
+
+          channel.on_close do |_|
+            outcome.command_finished!
+          end
+        end
+
+        channel.wait
+      end
+
+      connection.loop
+
+      outcome
+    rescue SocketError, Errno::ECONNREFUSED, Net::SSH::AuthenticationFailed => error
+      outcome.connection_failed(-1, "#{error.class}: #{error.message}")
+      outcome
+    end
+
+    def run_script(script, &setup)
+      create_directory script.install_directory
+
+      create_file_from script.content, path: script.install_path, mode: 0755
+
+      run_command(script.remote_path, &setup)
+    end
+
+    def create_directory(directory)
+      command = "mkdir -p #{directory}"
+
+      connection.open_channel do |channel|
+        channel.exec(command)
+        channel.wait
+      end
+
+      connection.loop
+    end
+
+    def create_file_from(content, path:, mode: 0644)
+      filename = "#{id}-#{File.basename(path)}"
+
+      tempfile = Tempfile.new(filename)
+      tempfile.chmod(mode)
+      tempfile.write(content)
+      tempfile.rewind
+
+      upload tempfile, to: path
+
+      tempfile.unlink
+    end
+
+    def upload(file, to:)
+      connection.scp.upload!(file, to)
+    end
+
+    def download(path, to: nil)
+      content = connection.scp.download!(path)
+
+      if to
+        file = File.new(to, "w+b")
+      else
+        file = Tempfile.new(path)
+      end
+
+      file.write(content)
+      file.rewind
+
+      file
+    end
+
+    def inspect
+      %{#<#{self.class.name} uri=#{@uri.to_s}>}
+    end
+
+    def to_s
+      @uri.to_s
+    end
+
+    private
+
+    def connection
+      if defined?(@connection)
+        @connection
+      else
+        options = { non_interactive: true }
+
+        if port
+          options[:port] = port
+        end
+
+        @connection = Net::SSH.start(address, user || Warg.default_user, options)
+      end
+    end
+
+    def build_uri!
+      @uri = URI.parse("ssh://")
+
+      @uri.user = @user
+      @uri.host = @address
+      @uri.port = @port
+
+      unless @properties.empty?
+        @uri.query = @properties.map { |name, value| "#{name}=#{value}" }.join("&")
+      end
+
+      @id = Digest::SHA1.hexdigest(@uri.to_s)
+    end
+
+    class CommandOutcome
+      attr_reader :command
+      attr_reader :connection_error_code
+      attr_reader :connection_error_reason
+      attr_reader :console_state
+      attr_reader :exit_signal
+      attr_reader :exit_status
+      attr_reader :failure_reason
+      attr_reader :finished_at
+      attr_reader :host
+      attr_reader :started_at
+      attr_reader :stderr
+      attr_reader :stdout
+
+      def initialize(host, command, &setup)
+        @host = host
+        @command = command
+
+        @console_status = Console::HostStatus.new(host, Warg.console)
+
+        @stdout = ""
+        @stdout_callback = proc {}
+
+        @stderr = ""
+        @stderr_callback = proc {}
+
+        @started_at = nil
+        @finished_at = nil
+
+        if setup
+          instance_eval(&setup)
+        end
+      end
+
+      def value
+        self
+      end
+
+      def on_stdout(&block)
+        @stdout_callback = block
+      end
+
+      def collect_stdout(data)
+        @stdout << data
+        @stdout_callback.call(data)
+      end
+
+      def on_stderr(&block)
+        @stderr_callback = block
+      end
+
+      def collect_stderr(data)
+        @stderr << data
+        @stderr_callback.call(data)
+      end
+
+      def successful?
+        exit_status && exit_status.zero?
+      end
+
+      def failed?
+        !successful?
+      end
+
+      def started?
+        not @started_at.nil?
+      end
+
+      def finished?
+        not @finished_at.nil?
+      end
+
+      def exit_status=(value)
+        if finished?
+          $stderr.puts "[WARN] cannot change `#exit_status` after command has finished"
+        else
+          @exit_status = value
+
+          if failed?
+            @failure_reason = :nonzero_exit_status
+          end
+        end
+
+        value
+      end
+
+      def exit_signal=(value)
+        if finished?
+          $stderr.puts "[WARN] cannot change `#exit_signal` after command has finished"
+        else
+          @exit_signal = value
+          @exit_signal.freeze
+
+          @failure_reason = :exit_signal
+        end
+
+        value
+      end
+
+      def duration
+        if @finished_at && @started_at
+          @finished_at - @started_at
+        end
+      end
+
+      def command_started!
+        if @started_at
+          $stderr.puts "[WARN] command already started"
+        else
+          @started_at = Time.now
+          @started_at.freeze
+
+          @console_status.started!
+        end
+      end
+
+      def command_finished!
+        if finished?
+          $stderr.puts "[WARN] command already finished"
+        else
+          @stdout.freeze
+          @stderr.freeze
+
+          @finished_at = Time.now
+          @finished_at.freeze
+
+          if successful?
+            @console_status.success!
+          else
+            @console_status.failed!(failure_summary)
+          end
+        end
+      end
+
+      def connection_failed(code, reason)
+        @connection_error_code = code.freeze
+        @connection_error_reason = reason.freeze
+
+        @failure_reason = :connection_error
+
+        unless started?
+          @console_status.failed!(failure_summary)
+        end
+      end
+
+      def failure_summary
+        case failure_reason
+        when :exit_signal, :nonzero_exit_status
+          adjusted_stdout, adjusted_stderr = [stdout, stderr].map do |output|
+            adjusted = output.each_line.map { |line| line.prepend("  ") }.join.chomp
+
+            if adjusted.empty?
+              adjusted = "(empty)"
+            end
+
+            adjusted
+          end
+
+          <<~OUTPUT
+            STDOUT: #{adjusted_stdout}
+            STDERR: #{adjusted_stderr}
+          OUTPUT
+        when :connection_error
+          <<~OUTPUT
+            Connection failed:
+              Code: #{connection_error_code}
+              Reason: #{connection_error_reason}
+          OUTPUT
+        end
+      end
+    end
+  end
+
+  class HostCollection
+    include Enumerable
+
+    def self.from(value)
+      case value
+      when String, Host
+        new.add(value)
+      when HostCollection
+        value
+      when Array
+        is_array_host_specification = value.any? do |item|
+          # Check key=value items by looking for `=` missing `?`.  If it has `?`, then we
+          # assume it is in the form `host?key=value`
+          String === item and item.index("=") and not item.index("?")
+        end
+
+        if is_array_host_specification
+          new.add(value)
+        else
+          value.inject(new) { |collection, host_data| collection.add(host_data) }
+        end
+      when Hash
+        value.inject(new) do |collection, (property, hosts_data)|
+          name, value = property.to_s.split(":", 2)
+
+          if value.nil?
+            value = name
+            name = "stage"
+          end
+
+          from(hosts_data).each do |host|
+            host[name] = value
+            collection.add(host)
+          end
+
+          collection
+        end
+      when nil
+        new
+      else
+        raise InvalidHostDataError.new(value)
+      end
+    end
+
+    def initialize
+      @hosts = []
+    end
+
+    def one
+      if @hosts.empty?
+        raise "cannot pick a host from `#{inspect}'; collection is empty"
+      end
+
+      HostCollection.from @hosts.sample
+    end
+
+    def add(host_data)
+      @hosts << Host.from(host_data)
+
+      self
+    end
+
+    def with(**filters)
+      HostCollection.from(select { |host| host.matches?(**filters) })
+    end
+
+    def ==(other)
+      self.class == other.class &&
+        length == other.length &&
+        # both are the same length and their intersection is the same length (all the same
+        # elements in common)
+        length == @hosts.&(other.hosts).length
+    end
+
+    alias eql? ==
+
+    def length
+      @hosts.length
+    end
+
+    def create_file_from(content, path:, mode: 0644)
+      each do |host|
+        host.create_file_from(content, path: path, mode: mode)
+      end
+    end
+
+    def upload(file, to:)
+      each do |host|
+        host.upload(file, to: to)
+      end
+    end
+
+    def download(path)
+      map do |host|
+        host.download(path)
+      end
+    end
+
+    def each
+      if block_given?
+        @hosts.each { |host| yield host }
+      else
+        enum_for(:each)
+      end
+
+      self
+    end
+
+    def run_script(script, order: :parallel, &setup)
+      run(order: order) do |host, result|
+        result.update host.run_script(script, &setup)
+      end
+    end
+
+    def run_command(command, order: :parallel, &setup)
+      run(order: order) do |host, result|
+        result.update host.run_command(command, &setup)
+      end
+    end
+
+    def run(order:, &block)
+      strategy = Executor.for(order)
+      executor = strategy.new(self)
+      executor.run(&block)
+    end
+
+    def to_a
+      @hosts.dup
+    end
+
+    protected
+
+    attr_reader :hosts
+  end
+
+  class Config
+    attr_accessor :default_user
+    attr_reader :hosts
+    attr_reader :variables_sets
+
+    def initialize
+      @hosts = HostCollection.new
+      @variables_sets = Set.new
+    end
+
+    def hosts=(value)
+      @hosts = HostCollection.from(value)
+    end
+
+    def variables_set_defined?(name)
+      @variables_sets.include?(name.to_s)
+    end
+
+    def [](name)
+      if variables_set_defined?(name.to_s)
+        instance_variable_get("@#{name}")
+      end
+    end
+
+    def variables(name, &block)
+      variables_name = name.to_s
+      ivar_name = "@#{variables_name}"
+
+      if @variables_sets.include?(variables_name)
+        variables_object = instance_variable_get(ivar_name)
+      else
+        @variables_sets << variables_name
+
+        singleton_class.send(:attr_reader, variables_name)
+        variables_object = instance_variable_set(ivar_name, VariableSet.new(variables_name, self))
+      end
+
+      block.call(variables_object)
+    end
+
+    class VariableSet
+      attr_reader :context
+
+      def initialize(name, context)
+        @_name = name
+        @context = context
+        # FIXME: make this "private" by adding an underscore
+        @properties = Set.new
+      end
+
+      def context=(*)
+        raise NotImplementedError
+      end
+
+      def defined?(property_name)
+        @properties.include?(property_name.to_s)
+      end
+
+      def define!(property_name)
+        @properties << property_name.to_s
+      end
+
+      def copy(other)
+        other.properties.each do |property_name|
+          value = other.instance_variable_get("@#{property_name}")
+
+          extend Property.new(property_name, value)
+        end
+      end
+
+      def to_h
+        @properties.each_with_object({}) do |property_name, variables|
+          variables["#{@_name}_#{property_name}"] = send(property_name)
+        end
+      end
+
+      protected
+
+      attr_reader :properties
+
+      def method_missing(name, *args, &block)
+        writer_name = name.to_s
+        reader_name = writer_name.chomp("=")
+
+        if reader_name !~ Property::REGEXP
+          super
+        elsif reader_name == writer_name && block.nil?
+          $stderr.puts "`#{@_name}.#{reader_name}' was accessed before it was defined"
+          nil
+        elsif writer_name.end_with?("=") or not block.nil?
+          value = block || args
+
+          extend Property.new(reader_name, *value)
+        end
+      end
+
+      private
+
+      class Property < Module
+        REGEXP = /^[A-Za-z_]+$/
+
+        def initialize(name, initial_value = nil)
+          @name = name
+          @initial_value = initial_value
+        end
+
+        def extended(variables_set)
+          variables_set.define! @name
+
+          variables_set.singleton_class.class_eval <<-PROPERTY_METHODS
+            attr_writer :#{@name}
+
+            def #{@name}(&block)
+              if block.nil?
+                value = instance_variable_get(:@#{@name})
+
+                if value.respond_to?(:to_proc)
+                  instance_eval(&value)
+                else
+                  value
+                end
+              else
+                instance_variable_set(:@#{@name}, block)
+              end
+            end
+          PROPERTY_METHODS
+
+          variables_set.instance_variable_set("@#{@name}", @initial_value)
+        end
+      end
+    end
+  end
+
+  class Context < Config
+    attr_reader :argv
+    attr_reader :parser
+
+    def initialize(argv)
+      @argv = argv
+      @parser = OptionParser.new
+      @playlist = Playlist.new
+
+      @parser.on("-t", "--target HOSTS", Array, "hosts to use") do |hosts_data|
+        hosts_data.each { |host_data| hosts.add(host_data) }
+      end
+
+      super()
+    end
+
+    def parse_options!
+      @parser.parse(@argv)
+    end
+
+    def queue!(command)
+      @playlist.queue(command)
+    end
+
+    def run!
+      Console.hostname_width = hosts.map { |host| host.address.length }.max
+
+      @playlist.start
+    end
+
+    def copy(config)
+      config.hosts.each do |host|
+        hosts.add(host)
+      end
+
+      config.variables_sets.each do |variables_name|
+        variables(variables_name) do |variables_object|
+          variables_object.copy config.instance_variable_get("@#{variables_name}")
+        end
+      end
+    end
+
+    class Playlist
+      def initialize
+        @playing_at = 0
+        @insert_at = 0
+        @items = []
+        @started = false
+      end
+
+      def start
+        @started = true
+        @insert_at = 1
+
+        until @playing_at >= @items.length
+          @items[@playing_at].run
+
+          @playing_at += 1
+          @insert_at = @playing_at + 1
+        end
+      end
+
+      def queue(command)
+        @items.insert(@insert_at, command)
+        @insert_at += 1
+      end
+    end
+  end
+
+  class Runner
+    def initialize(argv)
+      @argv = argv.dup
+      @path = nil
+
+      find_warg_directory!
+      load_config!
+
+      @context = Context.new(@argv)
+      @context.copy(Warg.config)
+
+      load_scripts!
+      load_commands!
+
+      @command = Command.find(@argv)
+    end
+
+    def run
+      if @command.nil?
+        $stderr.puts "Could not find command from #{@argv.inspect}"
+        exit 1
+      end
+
+      @command.(@context)
+      @context.parse_options!
+
+      Warg.console.redirecting_stdout_and_stderr do
+        @context.run!
+      end
+    end
+
+    private
+
+    def find_warg_directory!
+      previous_directory = nil
+      current_directory = Pathname.new(Dir.pwd)
+
+      while @path.nil? && current_directory.directory? && current_directory != previous_directory
+        target = current_directory.join("warg")
+
+        if target.directory?
+          @path = target
+
+          Warg.search_paths.unshift(@path)
+          Warg.search_paths.uniq!
+        else
+          previous_directory = current_directory
+          current_directory = current_directory.parent
+        end
+      end
+
+      if @path.nil?
+        $stderr.puts "`warg' directory not found in current directory or ancestors"
+        exit 1
+      end
+    end
+
+    def load_config!
+      config_path = @path.join("config.rb")
+
+      if config_path.exist?
+        load config_path
+      end
+
+      Dir.glob(@path.join("config", "**", "*.rb")).each do |config_file|
+        load config_file
+      end
+    end
+
+    def load_commands!
+      Warg.search_paths.each do |warg_path|
+        Dir.glob(warg_path.join("commands", "**", "*.rb")).each do |command_path|
+          require command_path
+        end
+      end
+    end
+
+    def load_scripts!
+      Warg.search_paths.each do |warg_path|
+        warg_scripts_path = warg_path.join("scripts")
+
+        Dir.glob(warg_scripts_path.join("**", "*")).each do |path|
+          script_path = Pathname.new(path)
+
+          if script_path.directory? || script_path.basename.to_s.index("_defaults") == 0
+            next
+          end
+
+          relative_script_path = script_path.relative_path_from(warg_scripts_path)
+
+          command_name = Command::Name.from_relative_script_path(relative_script_path)
+
+          object_names = command_name.object.split("::")
+          object_names.inject(Object) do |namespace, object_name|
+            if namespace.const_defined?(object_name)
+              object = namespace.const_get(object_name)
+            else
+              if object_name == object_names[-1]
+                object = Class.new do
+                  include Command::BehaviorWithoutRegistration
+
+                  def setup
+                    run_script
+                  end
+                end
+              else
+                object = Module.new
+              end
+
+              namespace.const_set(object_name, object)
+
+              if object < Command::BehaviorWithoutRegistration
+                Warg::Command.register(object)
+              end
+            end
+
+            object
+          end
+        end
+      end
+    end
+  end
+
+  class Executor
+    class << self
+      attr_reader :strategies
+    end
+
+    @strategies = {}
+
+    def self.for(name)
+      @strategies.fetch(name)
+    end
+
+    def self.register(name, &block)
+      strategy = Class.new(self)
+      strategy.send(:define_method, :in_order, &block)
+
+      @strategies[name] = strategy
+    end
+
+    attr_reader :collection
+    attr_reader :result
+
+    def initialize(collection)
+      @collection = collection
+      @result = Result.new
+    end
+
+    # FIXME: error handling?
+    def run(&block)
+      in_order(&block)
+      result
+    end
+
+    def in_order(&block)
+      raise NotImplementedError
+    end
+
+    register :parallel do |&procedure|
+      threads = collection.map do |object|
+        Thread.new do
+          procedure.call(object, result)
+        end
+      end
+
+      threads.each(&:join)
+    end
+
+    register :serial do |&procedure|
+      collection.each do |object|
+        procedure.call(object, result)
+      end
+    end
+
+    class Deferred
+      def initialize(command, run_object, hosts, order, &setup)
+        @command = command
+        @run_object = run_object
+        @hosts = hosts
+        @order = order
+        @setup = setup
+
+        @callbacks_queue = CallbacksQueue.new(order)
+
+        @run_type = case @run_object
+                    when Script
+                      :run_script
+                    when String
+                      :run_command
+                    when Localhost::BlockProxy
+                      :run_block
+                    end
+      end
+
+      def banner
+        @run_object
+      end
+
+      def and_then(&block)
+        @callbacks_queue << block
+        self
+      end
+
+      def run
+        execution_result = @hosts.public_send(@run_type, @run_object, order: @order, &@setup)
+
+        execution_result = @callbacks_queue.drain(execution_result)
+
+        if execution_result.failed?
+          @command.on_failure(execution_result)
+        end
+
+        execution_result
+      end
+
+      class CallbacksQueue
+        def initialize(execution_order)
+          @queue = []
+          @executor_class = Executor.for(execution_order)
+        end
+
+        def <<(callback)
+          @queue << callback
+        end
+
+        def drain(execution_result)
+          drain_queue = @queue.dup
+
+          # NOTE: It would be nice to incorporate the failure callback into the code here
+          until drain_queue.empty? || execution_result.failed?
+            callback = drain_queue.shift
+            executor = @executor_class.new(execution_result)
+
+            execution_result = executor.run do |outcome, result|
+              callback_outcome = Outcome.new(outcome)
+
+              begin
+                # Use `||=` in case `#value` is set in the callback
+                callback_outcome.value ||= callback.(outcome.host, outcome.value, callback_outcome)
+              rescue => error
+                callback_outcome.error = error
+              end
+
+              result.update callback_outcome
+            end
+          end
+
+          execution_result
+        end
+
+        class Outcome
+          attr_reader :error
+          attr_reader :host
+          attr_reader :source_outcome
+          attr_accessor :value
+
+          def initialize(outcome)
+            @source_outcome = outcome
+            @host = @source_outcome.host
+            @successful = true
+          end
+
+          def resolve(value)
+            @value = value
+          end
+
+          def fail!(message)
+            @successful = false
+
+            raise CallbackFailedError.new(message)
+          end
+
+          def error=(error)
+            @successful = false
+            @error = error
+          end
+
+          def successful?
+            @successful
+          end
+
+          def failed?
+            !successful?
+          end
+
+          def failure_summary
+            error && error.full_message
+          end
+        end
+      end
+
+      class CallbackFailedError < StandardError
+      end
+    end
+
+    class Result
+      include Enumerable
+      extend Forwardable
+
+      def_delegator :value, :each
+
+      attr_reader :value
+
+      def initialize
+        @mutex = Mutex.new
+        @successful = true
+        @value = []
+      end
+
+      def update(outcome)
+        @mutex.synchronize do
+          @value << outcome
+          @successful &&= outcome.successful?
+        end
+      end
+
+      def successful?
+        @mutex.synchronize do
+          @successful
+        end
+      end
+
+      def failed?
+        @mutex.synchronize do
+          not @successful
+        end
+      end
+    end
+  end
+
+  class Command
+    class << self
+      attr_reader :registry
+    end
+
+    @registry = {}
+
+    def self.register(klass)
+      if Warg::Command.registry.key?(klass.registry_name)
+        # TODO: include debug information in the warning
+        $stderr.puts "[WARN] command with the name `#{klass.command_name}' already exists " \
+          "and is being replaced"
+      end
+
+      Warg::Command.registry[klass.registry_name] = klass
+    end
+
+    def self.inherited(klass)
+      register(klass)
+    end
+
+    def self.find(argv)
+      klass = nil
+
+      argv.each do |arg|
+        if @registry.key?(arg)
+          klass = @registry.fetch(arg)
+        end
+      end
+
+      klass
+    end
+
+    class Name
+      def self.from_relative_script_path(path)
+        script_name = path.to_s.chomp File.extname(path)
+
+        new(script_name: script_name.tr("_", "-"))
+      end
+
+      attr_reader :cli
+      attr_reader :object
+      attr_reader :script
+
+      def initialize(class_name: nil, script_name: nil)
+        if class_name.nil? && script_name.nil?
+          raise ArgumentError, "`script_name' or `class_name' must be specified"
+        end
+
+        if class_name
+          @object = class_name
+
+          @script = class_name.gsub("::", "/")
+          @script.gsub!(/([A-Z\d]+)([A-Z][a-z])/, '\1-\2')
+          @script.gsub!(/([a-z\d])([A-Z])/, '\1-\2')
+          @script.downcase!
+        elsif script_name
+          @script = script_name
+
+          @object = script_name.gsub(/[a-z\d]*/) { |match| match.capitalize }
+          @object.gsub!(/(?:_|-|(\/))([a-z\d]*)/i) { "#{$1}#{$2.capitalize}" }
+          @object.gsub!("/", "::")
+        end
+
+        @cli = @script.tr("/", ":")
+      end
+
+      def console
+        "[#{cli}]"
+      end
+
+      def registry
+        @cli
+      end
+
+      def to_s
+        @cli.dup
+      end
+    end
+
+    module Naming
+      def self.extended(klass)
+        Warg::Command.register(klass)
+      end
+
+      def command_name
+        if defined?(@command_name)
+          @command_name
+        else
+          @command_name = Name.new(class_name: name)
+        end
+      end
+
+      def registry_name
+        command_name.registry
+      end
+    end
+
+    module CommandMissingHook
+      def const_missing(class_name)
+        loaded = false
+
+        command_name = Name.new(class_name: class_name.to_s)
+        path = "#{command_name.script.tr("-", "_")}.rb"
+
+        Warg.search_paths.each do |warg_path|
+          command_path = warg_path.join("commands", path)
+
+          if command_path.exist?
+            require command_path
+            loaded = true
+            break
+          end
+        end
+
+        if loaded
+          Object.const_get(class_name)
+        else
+          super
+        end
+      end
+    end
+
+    module Chaining
+      def |(other)
+        ChainCommand.new(self, other)
+      end
+    end
+
+    module BehaviorWithoutRegistration
+      def self.included(klass)
+        klass.extend(ClassMethods)
+      end
+
+      module ClassMethods
+        include Naming
+        include Chaining
+        include CommandMissingHook
+
+        def call(context)
+          command = new(context)
+          command.call
+          command
+        end
+      end
+
+      attr_reader :argv
+      attr_reader :context
+      attr_reader :hosts
+      attr_reader :operations
+      attr_reader :parser
+      attr_reader :steps
+
+      def initialize(context)
+        @context = context
+
+        @parser = @context.parser
+        @hosts = @context.hosts
+        @argv = @context.argv.dup
+
+        configure_parser!
+
+        @context.queue!(self)
+        @steps = []
+      end
+
+      def name
+        command_name.cli
+      end
+
+      def call
+        setup
+        self
+      end
+
+      def setup
+      end
+
+      def run
+        Warg.console.puts Console::SGR(command_name.console).with(text_color: :blue, effect: :bold)
+
+        @steps.each do |deferred|
+          Warg.console.puts Console::SGR(" -> #{deferred.banner}").with(text_color: :magenta)
+          deferred.run
+        end
+      end
+
+      def command_name
+        self.class.command_name
+      end
+
+      def |(other)
+        other.(context)
+      end
+
+      def chain(*others)
+        others.inject(self) do |execution, command|
+          execution | command
+        end
+      end
+
+      def on_failure(execution_result)
+        exit 1
+      end
+
+      def SGR(text)
+        Console::SGR(text)
+      end
+
+      private
+
+      def configure_parser!
+      end
+
+      def run_script(script_name = nil, on: hosts, order: :parallel, &setup)
+        script_name ||= command_name.script
+        script = Script.new(script_name, context)
+
+        append Executor::Deferred.new(self, script, on, order, &setup)
+      end
+
+      def run_command(command, on: hosts, order: :parallel, &setup)
+        append Executor::Deferred.new(self, command, on, order, &setup)
+      end
+
+      def on_localhost(banner, &block)
+        append LOCALHOST.defer(self, banner, &block)
+      end
+      alias locally on_localhost
+
+      def append(deferred)
+        @steps << deferred
+        deferred
+      end
+    end
+
+    include BehaviorWithoutRegistration
+
+    module Behavior
+      def self.included(klass)
+        klass.send(:include, BehaviorWithoutRegistration)
+        Command.register(klass)
+      end
+
+      def self.extended(klass)
+        klass.extend(CommandMissingHook)
+        klass.extend(Naming)
+        klass.extend(Chaining)
+      end
+    end
+  end
+
+  class ChainCommand
+    def initialize(left, right)
+      @left = left
+      @right = right
+    end
+
+    def call(context)
+      @left.(context) | @right
+    end
+
+    def |(other)
+      ChainCommand.new(self, other)
+    end
+  end
+
+  class Script
+    class Template
+      INTERPOLATION_REGEXP = /%{([\w:]+)}/
+
+      def self.find(relative_script_path, fail_if_missing: true)
+        extension = File.extname(relative_script_path)
+        relative_paths = [relative_script_path]
+
+        if extension.empty?
+          relative_paths << "#{relative_script_path}.sh"
+        else
+          relative_paths << relative_script_path.chomp(extension)
+        end
+
+        paths_checked = []
+
+        script_path = Warg.search_paths.inject(nil) do |path, directory|
+          relative_paths.each do |relative_path|
+            target_path = directory.join("scripts", relative_path)
+            paths_checked << target_path
+
+            if target_path.exist?
+              path = target_path
+            end
+          end
+
+          if path
+            break path
+          end
+        end
+
+        if script_path
+          new(script_path)
+        elsif fail_if_missing
+          raise <<~ERROR
+            ScriptNotFoundError: Could not find `#{relative_script_path}'
+              Looked in:
+                #{paths_checked.join("\n")}
+          ERROR
+        else
+          MISSING
+        end
+      end
+
+      class Missing
+        def compile(*)
+          "".freeze
+        end
+      end
+
+      MISSING = Missing.new
+
+      attr_reader :content
+
+      def initialize(file_path)
+        @path = file_path
+        @content = @path.read
+      end
+
+      def compile(interpolations)
+        @content.gsub(INTERPOLATION_REGEXP) do |match|
+          if interpolations.key?($1)
+            interpolations[$1]
+          else
+            $stderr.puts "[WARN] `#{$1}' is not defined in interpolations or context variables"
+            $stderr.puts "[WARN]   leaving interpolation `#{match}' as is"
+            match
+          end
+        end
+      end
+    end
+
+    REMOTE_DIRECTORY = Pathname.new("$HOME").join("warg", "scripts")
+
+    class Interpolations
+      CONTEXT_REGEXP = /variables:(\w+)/
+
+      def initialize(context)
+        @context = context
+        @values = {}
+      end
+
+      def key?(key)
+        if key =~ CONTEXT_REGEXP
+          @context.variables_set_defined?($1)
+        else
+          @values.key?(key)
+        end
+      end
+
+      def [](key)
+        if @values.key?(key)
+          @values[key]
+        elsif key =~ CONTEXT_REGEXP && @context.variables_set_defined?($1)
+          variables = @context[$1]
+          content = variables.to_h.sort.map { |key, value| %{#{key}="#{value}"} }.join("\n")
+
+          @values[key] = content
+        end
+      end
+
+      def []=(key, value)
+        @values[key] = value
+      end
+    end
+
+    attr_reader :content
+    attr_reader :name
+    attr_reader :remote_path
+
+    def initialize(script_name, context, defaults_path: nil)
+      command_name = Command::Name.from_relative_script_path(script_name)
+      @name = command_name.script
+      @context = context
+
+      local_path = Pathname.new(@name)
+
+      # FIXME: search parent directories for a defaults script
+      defaults_path ||= File.join(local_path.dirname, "_defaults")
+      @defaults = Template.find(defaults_path, fail_if_missing: false)
+
+      @template = Template.find(local_path.to_s)
+
+      @remote_path = REMOTE_DIRECTORY.join(local_path)
+    end
+
+    def content
+      interpolations = Interpolations.new(@context)
+      interpolations["script_name"] = name
+      interpolations["script_defaults"] = @defaults.compile(interpolations).chomp
+
+      @template.compile(interpolations)
+    end
+
+    def install_directory
+      @remote_path.dirname
+    end
+
+    def install_path
+      @remote_path.relative_path_from Pathname.new("$HOME")
+    end
+
+    def to_s
+      name.dup
+    end
+  end
+
+  class << self
+    attr_reader :config
+    attr_reader :console
+    attr_reader :search_paths
+  end
+
+  @config = Config.new
+  @console = Console.new
+  @search_paths = []
+
+  def self.configure
+    yield config
+  end
+
+  def self.default_user
+    config.default_user
+  end
 end