locd 0.1.12 → 0.1.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 912bd2acbe925cbd22b04ea99e395de57152da05
-  data.tar.gz: d40f1a8e8d2569400868cf2d6486e63dec5829e0
+  metadata.gz: 4f94096db9ae78d4d6a256a23d22b40b0d345c0e
+  data.tar.gz: e09575a1e5757b99012e7d14a68a97d0aa0a1ef0
 SHA512:
-  metadata.gz: 412920e9c3501cba333a675f8e9ca4b71ce88048ffbe214e33496c952f65642e0ee5b1d26c8a65a6e848cc8dd15276c35f012014b93fcc162410f65f0aee204e
-  data.tar.gz: b4fddfc9a03b4c874cb62256e53a8029d433416e795de3d9929af1a6a1696f62af4e16aee61fabe77bc5c67fddaa246e1ee7ae286aa11f8a962da5b13b2e8a19
+  metadata.gz: cd4def91dc1851b6290cf9cac485ba6b1dbd290a1a860de95c2e50a05191cac35aa4740c73686eedb3827e96a8116711f5f4c3f33c3c7913288f290e62922f86
+  data.tar.gz: 655fd3801f4b54eaa0083255dcb2aab2d2be3a1245b9dee3e9c13d980f135e015e71476e3e255d0660903ff1b38b98c4624065459c33a771a6085ca31d8ce811

data/Gemfile

@@ -2,9 +2,9 @@ source "https://rubygems.org"
 
 git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 
-# gem 'nrser', path: './dev/packages/gems/nrser'
+gem 'nrser', path: './dev/packages/gems/nrser'
 # gem 'cmds', path: './dev/packages/gems/cmds'
-# gem 'atli', path: './dev/packages/gems/atli'
+gem 'atli', path: './dev/packages/gems/atli'
 
 # Specify your gem's dependencies in locd.gemspec
 gemspec

data/NAME

@@ -0,0 +1 @@
+locd

data/VERSION

@@ -1 +1 @@
-0.1.12
+0.1.13

data/config/default.lit.yaml

@@ -0,0 +1,43 @@
+locd:
+  home: ~/.locd
+  tmp:
+    $format: ${#locd/home}/tmp
+  bin: locd
+  
+  cli:
+    log:
+      level: info
+      application: Locd
+      dest: $stderr
+    
+    bash_comp:
+      log:
+        level: warn
+        dest:
+          $format: ${#locd/tmp}/bash_comp.log
+  # /CLI
+  
+  namespace:
+    label: com.nrser.locd
+    env: LOCD
+    
+  proxy:
+    port: 8888
+    bind: 127.0.0.1
+  
+  rotate_logs:
+    newsyslog:
+      tmp_conf_dir:
+        $format: ${#locd/tmp}/newsyslog
+    start_interval:
+      minute: 0
+    
+  agent:
+    config_key: locd_config
+  
+  site:
+    bind: 127.0.0.1
+    ports:
+      start: 55000
+      end: 56000
+  

data/lib/locd.rb

@@ -44,9 +44,6 @@ module Locd
   HOST_RE = /^Host\:\ /i
   
   
-  ROTATE_LOGS_LABEL = 'com.nrser.locd.rotate-logs'
-  
-  
   # Mixins
   # ============================================================================
   

data/lib/locd/agent.rb

@@ -1,21 +1,19 @@
+# encoding: UTF-8
 # frozen_string_literal: true
 
 # Requirements
 # =======================================================================
 
-# Stdlib
-# -----------------------------------------------------------------------
+### Stdlib ###
 
-# Deps
-# -----------------------------------------------------------------------
-require 'plist'
 require 'fileutils'
+
+### Deps ###
+
+require 'plist'
 require 'nrser'
 require 'nrser/props/immutable/hash'
 
-# Project / Package
-# -----------------------------------------------------------------------
-
 
 # Refinements
 # =======================================================================
@@ -24,10 +22,15 @@ require 'nrser/refinements/types'
 using NRSER::Types
 
 
+# Namespace
+# ============================================================================
+
+module  Locd
+
+
 # Definitions
 # =======================================================================
 
-
 # Represents a backend agent that the proxy can route to.
 # 
 # Agents are managed by `launchd`, macOS's system service manager, and
@@ -37,7 +40,7 @@ using NRSER::Types
 # From there they can be managed directly with macOS's `launchctl` utility,
 # with the `lunchy` gem, etc.
 # 
-class Locd::Agent
+class Agent
   
   # Constants
   # ==========================================================================
@@ -373,7 +376,7 @@ class Locd::Agent
   # @param [String] label
   #   The agent's label.
   # 
-  # @return [Locd::Agent]
+  # @return [Agent]
   #   If a Loc'd agent with `label` is installed.
   # 
   # @return [nil]
@@ -388,6 +391,29 @@ class Locd::Agent
   end
   
   
+  # Like {.get} but raises if the agent is not found.
+  # 
+  # @param [String] label
+  #   The agent's label.
+  # 
+  # @return [Agent]
+  #   The agent.
+  # 
+  # @raise [NotFoundError]
+  #   If the agent isn't there.
+  # 
+  def self.get! label
+    get( label ).tap do |agent|
+      if agent.nil?
+        raise NotFoundError, [
+            self, "with label", label,
+            "not found. Expected the property list at", plist_abs_path( label )
+          ].map( &:to_s ).join( ' ' )
+      end
+    end
+  end
+  
+  
   # Find a single {Locd::Agent} matching `pattern` or raise.
   # 
   # Parameters are passed to {Locd::Label.regexp_for_glob} and the resulting
@@ -441,7 +467,7 @@ class Locd::Agent
       if agents.empty?
         raise NRSER::CountError.new(
           "No agents found for pattern from #{ pattern.source.inspect }",
-          subject: agents,
+          value: agents,
           expected: '#count > 0',
         )
       end
@@ -1011,6 +1037,11 @@ class Locd::Agent
   end
   
   
+  def ensure_running **start_kwds
+    start( **start_kwds ) unless running?
+  end
+  
+  
   # Stop the agent.
   # 
   # @param [Boolean] unload:
@@ -1269,7 +1300,13 @@ class Locd::Agent
     
   # end protected
   
-end # class Locd::Launchd
+end # class Agent
+
+
+# /Namespace
+# ============================================================================
+
+end # module  Locd
 
 
 # Post-Processing

data/lib/locd/agent/proxy.rb

@@ -1,18 +1,20 @@
+# encoding: UTF-8
 # frozen_string_literal: true
 
 # Requirements
 # =======================================================================
 
-# Stdlib
-# -----------------------------------------------------------------------
+### Stdlib ###
 
-# Deps
-# -----------------------------------------------------------------------
-require 'plist'
 require 'fileutils'
 
-# Project / Package
-# -----------------------------------------------------------------------
+### Deps ###
+
+require 'plist'
+
+### Project / Package ###
+
+require_relative './system'
 
 
 # Refinements
@@ -22,19 +24,25 @@ require 'nrser/refinements/types'
 using NRSER::Types
 
 
+# Namespace
+# ============================================================================
+
+module  Locd
+class   Agent
+
+
 # Definitions
 # =======================================================================
 
-
 # An server {Locd::Agent} (HTTP only at the moment) that the proxy can
 # route requests to.
 # 
-class Locd::Agent::Proxy < Locd::Agent
+class Proxy < Agent
   
   # Mixins
   # ============================================================================
   
-  include Locd::Agent::System
+  include System
   
   
   # Constants
@@ -44,7 +52,7 @@ class Locd::Agent::Proxy < Locd::Agent
   # 
   # @return [Hamster::SortedSet<Symbol>]
   # 
-  TO_H_NAMES = Locd::Agent::TO_H_NAMES.union [:port, :url]
+  TO_H_NAMES = Agent::TO_H_NAMES.union [:port, :url]
   
   
   # Class Methods
@@ -108,4 +116,11 @@ class Locd::Agent::Proxy < Locd::Agent
   
   # @!endgroup Instance Methods: Attribute Readers
   
-end # class Locd::Agent::Proxy
+end # class Proxy
+
+
+# /Namespace
+# ============================================================================
+
+end # class   Agent
+end # module  Locd

data/lib/locd/agent/rotate_logs.rb

@@ -53,12 +53,12 @@ class Locd::Agent::RotateLogs < Locd::Agent::Job
   # @return [String]
   # 
   def self.default_cmd_template
-    "{bin} rotate-logs run"
+    "{bin} rotate-logs run --backtrace"
   end # .cmd_template
   
   
   def self.default_start_interval
-    NRSER.deep_symbolize_keys Locd.config[:rotate_logs, :start_interval]
+    Locd.config[:rotate_logs, :start_interval].deep_symbolize_keys
   end
   
   

data/lib/locd/agent/site.rb

@@ -92,7 +92,10 @@ class Locd::Agent::Site < Locd::Agent
   #    `true` if we think this `plist` belongs to a site.
   # 
   def self.plist? plist
-    !! plist.dig( Locd.config[:agent, :config_key], 'port' )
+    !!(
+      plist.dig( Locd.config[:agent, :config_key], 'port' ) &&
+      plist.dig( Locd.config[:agent, :config_key], 'is_system' ) != true
+    )
   end # .plist?
   
   

data/lib/locd/agent/system.rb

@@ -40,27 +40,52 @@ module Locd::Agent::System
   end
   
   
-  def self.label? label
-    label.is_a?( String ) \
-    && label.start_with?( Locd.config[:namespace, :label] )
+  # Is an agent label for a system agent of *this* Loc'd instance?
+  # 
+  # @note
+  #   We can't tell if a label is a system agent label for *any* Loc'd instance
+  #   since the prefix can be configured to anything (via the
+  #   `locd:namespace:label` key).
+  # 
+  # @return [Boolean]
+  # 
+  def self.instance_label? label
+    label.is_a?( String ) &&
+    label.start_with?( "#{ Locd.config[:namespace, :label] }." )
   end
   
   
-  # Is a plist for one of this config's system agents?
+  # Is the plist for a system agent of *any* Loc'd instance?
+  # 
+  # In case it's not obvious, this tests true given plists of system agents 
+  # of *other* Loc'd instance configurations besides just this one, which can
+  # be useful to weed things out. Maybe.
   # 
   # @param plist (see Locd::Agent.plist?)
   # 
   # @return [Boolean]
-  #   `true` if the plist is for a system agent for this Loc'd config.
+  #   `true` if the plist is for a system agent.
   # 
   def self.plist? plist
-    !!(
-      plist.dig( Locd.config[:agent, :config_key], 'is_system' ) \
-      && label?( plist['Label'] )
-    )
+    plist.dig( Locd.config[:agent, :config_key], 'is_system' ) == true
   end # .plist?
   
   
+  # Is a plist for a system agent of *this* Loc'd instance?
+  # 
+  # @see plist?
+  # @see instance_label?
+  # 
+  # @param plist (see Locd::Agent.plist?)
+  # 
+  # @return [Boolean]
+  #   `true` if the plist is for a system agent for this Loc'd instance config.
+  # 
+  def self.instance_plist? plist
+    plist?( plist ) && instance_label?( plist[ 'Label' ] )
+  end
+  
+  
   # Find the concrete {Locd::Agent} subclass (that has mixed in
   # {Locd::Agent::System}) for a property list.
   # 
@@ -166,8 +191,18 @@ module Locd::Agent::System
     # @return [nil]
     #   If the agent does not exist.
     # 
-    def get
-      super label
+    def get label = self.label
+      unless label == self.label
+        raise NRSER::AttributeError.new \
+          "System agents have a fixed label, must be", self.label
+      end
+      
+      super( label )
+    end
+    
+    
+    def get! label = self.label
+      super( label )
     end
     
     # @!endgroup
@@ -231,7 +266,7 @@ module Locd::Agent::System
       end
       
       {
-        bin: bin,
+        bin: bin.to_s,
         workdir: workdir,
         **kwds,
         is_system: true,

data/lib/locd/cli/command/agent.rb

@@ -3,15 +3,11 @@
 # Requirements
 # =======================================================================
 
-# Stdlib
-# -----------------------------------------------------------------------
-
-# Deps
-# -----------------------------------------------------------------------
-
 # Project / Package
 # -----------------------------------------------------------------------
 
+require_relative './base'
+
 
 # Refinements
 # =======================================================================
@@ -20,6 +16,14 @@ require 'nrser/refinements/types'
 using NRSER::Types
 
 
+# Namespace
+# =======================================================================
+
+module  Locd
+module  CLI
+module  Command
+
+
 # Definitions
 # =======================================================================
 
@@ -27,7 +31,7 @@ using NRSER::Types
 # 
 # @see http://whatisthor.com/
 # 
-class Locd::CLI::Command::Agent < Locd::CLI::Command::Base
+class Agent < Base
   
   # Helpers
   # ==========================================================================
@@ -66,6 +70,21 @@ class Locd::CLI::Command::Agent < Locd::CLI::Command::Base
       end
     end
     
+
+    # The {#pattern} argument is not required because system agent subclasses
+    # don't need or want one.
+    #
+    # My current solution is to check {#pattern} before using it in
+    # {#find_only!} and {#find_multi!} and override those in system agent
+    # commands.
+    #
+    def check_pattern! pattern
+      if pattern.nil?
+        raise Thor::RequiredArgumentMissingError,
+          "No value provided for required arguments 'pattern'"
+      end
+    end
+
     
     # Find exactly one {Locd::Agent} for a `pattern`, using the any `:pattern`
     # shared options provided, and raising if there are no matches or more
@@ -79,11 +98,13 @@ class Locd::CLI::Command::Agent < Locd::CLI::Command::Base
     # @raise If more or less than one agent is matched.
     # 
     def find_only! pattern
+      check_pattern! pattern
       agent_class.find_only! pattern, **option_kwds( groups: :pattern )
     end
     
     
     def find_multi! pattern
+      check_pattern! pattern
       # Behavior depend on the `:all` option...
       if options[:all]
         # `:all` is set, so we find all the agents for the pattern, raising
@@ -101,147 +122,11 @@ class Locd::CLI::Command::Agent < Locd::CLI::Command::Base
   # end protected
   public
   
-  def_shared        :argument,
-    name:           :pattern,
-    groups:         :pattern,
-    desc:           "Label or workdir pattern to find agent(s)",
-    type:           :string,
-    required:       true,
-    complete:       ->( klass:, **etc ) { klass.agent_class.labels.to_a } 
-
   
   # Shared Options
   # ============================================================================
   
-  shared_option :long,
-    groups: :respond_with_agents,
-    group: "Display",
-    desc: "Display agent details table",
-    aliases: '-l',
-    type: :boolean
-  
-  # `:pattern` Group
-  # ----------------------------------------------------------------------------
-  # 
-  # Options when provided a `PATTERN` argument used to find agents by label.
-  # 
-
-  shared_option :full,
-    groups: :pattern,
-    desc: "Require label PATTERN to match entire string",
-    aliases: '-u',
-    type: :boolean
-    
-  shared_option :ignore_case,
-    groups: :pattern,
-    desc: "Make label PATTERN case-insensitive",
-    aliases: '-i',
-    type: :boolean
-  
-  shared_option :recursive,
-    groups: :pattern,
-    desc: "Make workdir PATTERN match all subdirs too",
-    aliases: '-r',
-    type: :boolean
-  
-  # NOTE  We don't expose the workdir pattern's `:cwd` option...
-  #       If you want to match a directory from the CLI, just provide that
-  #       directory... no reason to specify the `:cwd` in an option then
-  #       provide a relative PATTERN
-  # 
-  
-  # `:multi` Group
-  # ----------------------------------------------------------------------------
-  # 
-  # For commands that can match multiple agents.
-  # 
-  
-  shared_option :all,
-    groups: :multi,
-    group: "Pattern",
-    desc: "Apply to ALL agents that PATTERN matches",
-    aliases: '-a',
-    type: :boolean
-
-
-  # `:write` Group
-  # ----------------------------------------------------------------------------
-  # 
-  # Options when writing an agent `.plist` (`create`, `update`).
-  # 
-
-  shared_option :label,
-    groups: :write,
-    desc: "Agent label, which is also the domain the proxy will serve it at",
-    aliases: ['--name', '-n'],
-    type: :string #,
-    # required: true
-
-  shared_option :workdir,
-    groups: :write,
-    desc: "Working directory for the agent's command",
-    aliases: ['--dir'],
-    type: :string
-
-  shared_option :log_path,
-    groups: :write,
-    desc: "Path to log agent's STDOUT and STDERR (combined)",
-    aliases: ['--log'],
-    type: :string
-  
-  shared_option :keep_alive,
-    groups: :write,
-    desc: "Try to keep the agent running",
-    type: :boolean,
-    default: false
-  
-  shared_option :run_at_load,
-    groups: :write,
-    desc: "Start the agent when loading it",
-    type: :boolean,
-    default: false
-
-  
-  # `:add` Group
-  # ----------------------------------------------------------------------------
-  
-  shared_option :force,
-    groups: :add,
-    desc: "Overwrite any existing agent",
-    type: :boolean,
-    default: false
-  
-  
-  shared_option :load,
-    groups: :add,
-    desc: "Load the agent into `launchd`",
-    type: :boolean,
-    default: true
-  
-  
-  # `:start` Group
-  # --------------------------------------------------------------------------
-  # 
-  # Relevant options when starting agents.
-  # 
-  
-  shared_option     :load,
-                    groups: :start,
-                    desc: "Load the agent before starting",
-                    type: :boolean,
-                    default: true
-  
-  shared_option     :force,
-                    groups: :start,
-                    desc: "Force loading of agent even if it's disabled",
-                    type: :boolean,
-                    default: false
-  
-  shared_option     :enable,
-                    groups: :start,
-                    desc: "Set `launchd` *Disabled* key to `false`",
-                    type: :boolean,
-                    default: false
+  require_relative './agent/shared'
   
   
   # Commands
@@ -250,281 +135,40 @@ class Locd::CLI::Command::Agent < Locd::CLI::Command::Base
   # Querying
   # ----------------------------------------------------------------------------
   
-  desc              "ls",
-                    "List agents"
-  
-  map               list: :ls
-  
-  include_shared    groups: :pattern
-
-  include_options   :long,
-                    groups: :pattern
-  
-  def ls            # pattern = nil
-    results = if pattern.nil?
-      agent_class.all
-    else
-      agent_class.list pattern, **option_kwds( groups: :pattern )
-    end
-    
-    respond results.values.sort
-  end
-  
-  
-  desc              "plist PATTERN [OPTIONS]",
-                    "Print an agent's launchd property list"
-  
-  include_options   groups: :pattern
-  
-  def plist         pattern
-    agent = find_only! pattern
-    
-    if options[:json] || options[:yaml]
-      respond agent.plist
-    else
-      respond agent.path.read
-    end
-  end
-  
-  
-  desc              'status PATTERN',
-                    "Print agent status"
-  
-  include_options   groups: :pattern
-  
-  def status        pattern
-    agent = find_only! pattern
-    respond \
-      label:  agent.label,
-      status: agent.status.to_h( compact: false )
-  end
+  require_relative './agent/ls'
+  require_relative './agent/plist'
+  require_relative './agent/status'
   
   
   # Commands for Manipulating Agent Definitions
   # ----------------------------------------------------------------------------
   
   require_relative './agent/add'
-  
-  
-  desc              "update PATTERN [OPTIONS] [-- CMD_TEMPLATE...]",
-                    "Update an existing agent"
-  
-  include_options   groups: [:pattern, :write, :respond_with_agents]
-  
-  def update        pattern, *cmd_template
-    agent = find_only! pattern
-    
-    new_agent = agent.update \
-      cmd_template: cmd_template,
-      **option_kwds( groups: :write )
-    
-    logger.info "Agent `#{ agent.label }` updated"
-    
-    respond agent
-  end
-  
-  
-  desc              "rm PATTERN [OPTIONS]",
-                    "Remove (uninstall, delete) a agent"
-  
-  map               remove: :rm
-  
-  include_options   groups: [:pattern, :multi]
-  
-  option            :logs,
-                    desc: "Remove logs too",
-                    type: :boolean,
-                    default: false
-  
-  def rm            pattern
-    kwds = option_kwds :logs
-    find_multi!( pattern ).each { |agent| agent.remove **kwds }
-  end
-  
+  require_relative './agent/update'
+  require_relative './agent/rm'
+
   
   # Commands for Manipulating Agent State
   # --------------------------------------------------------------------------
   
-  desc              "start PATTERN [OPTIONS]",
-                    "Start an agent"
-  
-  include_options   groups: [ :pattern, :multi, :start ]
-  
-  def start         pattern
-    kwds = option_kwds :load, :force, :enable
-    find_multi!( pattern ).each { |agent| agent.start **kwds }
-  end
-  
-  
-  desc              "stop PATTERN [OPTIONS]",
-                    "Stop an agent"
-  
-  include_options   groups: [:pattern, :multi, :stop]
-  
-  option            :unload,
-                    desc: "Unload the agent from `launchd` after stopping",
-                    type: :boolean,
-                    default: true
-  
-  option            :disable,
-                    desc: "Set `launchd` *Disabled* key to `true`",
-                    type: :boolean,
-                    default: false
-  
-  def stop          pattern
-    kwds = option_kwds :unload, :disable
-    find_multi!( pattern ).each { |agent| agent.stop **kwds }
-  end
-  
-  
-  desc              "restart PATTERN [OPTIONS]",
-                    "Restart an agent"
-  
-  include_options   groups: [:pattern, :multi, :stop]
-  
-  option            :reload,
-                    desc: "Unload and reload the agent in `launchd`",
-                    type: :boolean,
-                    default: true
-  
-  option            :force,
-                    desc: "Force loading of agent even if it's disabled",
-                    type: :boolean,
-                    default: false
-  
-  option            :enable,
-                    desc: "Set `launchd` *Disabled* key to `false`",
-                    type: :boolean,
-                    default: false
-  
-  def restart       pattern
-    kwds = option_kwds :reload, :force, :enable
-    find_multi!( pattern ).each { |agent| agent.restart **kwds }
-  end
+  require_relative './agent/start'
+  require_relative './agent/stop'
+  require_relative './agent/restart'
   
   
   # Assorted Other Commands
   # ----------------------------------------------------------------------------
   
-  desc              "open [OPTIONS]",
-                    "Open an agent's URL in the browser"
+  require_relative './agent/open'
+  require_relative './agent/truncate_logs'
+  require_relative './agent/tail'
   
-  include_options   groups: [ :pattern, :multi, :start ]
+end # class Agent
 
-  # include_shared  groups: [ :pattern, :multi, :start ]
-  
-  arg               :pattern,
-    desc:           "Label or workdir pattern to find agent(s)",
-    type:           :string,
-    required:       true,
-    complete:       ->( klass:, **etc ) { klass.agent_class.labels.to_a }
 
-  option            :start,
-    desc:           %{ Start any stopped agents before opening },
-    type:           :boolean,
-    default:        true
-  
-  def open          # pattern
-    find_multi!( pattern ).each do |agent|
-      if options[:start] && agent.stopped?
-        agent.start **option_kwds( groups: :start )
-      end
-      
-      Cmds! "open %s", agent.url
-      
-      logger.info "Opened agent `#{ agent.label }` at #{ agent.url }"
-    end
-  end
-  
-  
-  desc              'truncate_logs PATTERN',
-                    "Truncate agent log file(s)."
-  
-  include_options   groups: [:pattern, :multi]
-  
-  option            :restart,
-                    desc: "Restart the agent after truncation",
-                    type: :boolean,
-                    default: true
-  
-  def truncate_logs pattern
-    find_multi!( pattern ).each do |agent|
-      log_paths = [agent.out_path, agent.err_path].compact.uniq
-      
-      unless log_paths.empty?
-        restart = options[:restart] && agent.running?
-        
-        agent.stop if restart
-        
-        log_paths.each do |log_path|
-          begin
-            log_path.open( 'w' ) { |f| f.truncate 0 }
-          rescue Exception => error
-            logger.error "Failed to truncate #{ log_path }", error
-          else
-            logger.info "Truncated",
-              'file' => log_path.to_s,
-              'agent.label' => agent.label
-          end
-        end # each log_path
-        
-        agent.start if restart
-      end # unless log_paths.empty?
-    end # each agent
-  end # #truncate_logs
-  
-  
-  desc              'tail [OPTIONS] PATTERN [-- TAIL_OPTIONS]',
-                    "Tail agent logs"
-  
-  include_options   groups: :pattern
-  
-  option            :stream,
-                    desc: "Stream to tail. May omit if uses single log file.",
-                    aliases: ['-s'],
-                    type: :string,
-                    enum: ['out', 'err']
-  
-  option            :follow,
-                    desc: "Run with `tail -F`",
-                    aliases: [ '-f' ],
-                    type: :boolean
-  
-  def tail          pattern, *tail_options
-    agent = find_only! pattern
-    
-    path = case options[:stream]
-    when nil
-      paths = agent.log_paths
-      
-      unless paths.length == 1
-        raise Thor::RequiredArgumentMissingError.new binding.erb <<~END
-          Agent `<%= agent.label %>` has multiple log files.
-          
-          out: <%= agent.out_path.to_s %>
-          err: <%= agent.err_path.to_s %>
-          
-          Must specify one via the `--stream` option.
-          
-        END
-      end
-      
-      paths[0]
-      
-    when 'out'
-      agent.out_path
-      
-    when 'err'
-      agent.err_path
-      
-    else
-      raise "WTF"
-    end
-    
-    cmd = ['tail']
-    cmd += ['-F'] if options[:follow]
-    
-    exec *cmd, *tail_options, path.to_s
-  end # #tail
-  
-end # class Locd::CLI::Command::Agent
+# /Namespace
+# =======================================================================
+
+end # module  Command
+end # module  CLI
+end # module  Locd