module Fig; end
class Fig::Command; end

# One of the main activities Fig should do as part of the current run.
#
# This exists because the code used to have complicated logic about whether a
# package.fig should be read, whether the Package object should be loaded,
# should a config be applied, when should some activity happen, etc.  Now, we
# let the Action object say what it wants in terms of setup and then tell it to
# do whatever it needs to.
module Fig::Command::Action
  EXIT_SUCCESS = 0
  EXIT_FAILURE = 1

  attr_writer :execution_context

  def primary_option()
    return options()[0]
  end

  def options()
    raise NotImplementedError
  end

  # Is this a special Action that should just be run on its own without looking
  # at other Actions?  Note that anything that returns true won't get an
  # execution context.
  def execute_immediately_after_command_line_parse?
    return false
  end

  def descriptor_requirement()
    raise NotImplementedError
  end

  def allow_both_descriptor_and_file?()
    return false
  end

  def cares_about_package_content_options?()
    return false
  end

  def load_base_package?()
    raise NotImplementedError
  end

  def base_package_can_come_from_descriptor?()
    return true
  end

  # true, false, or nil if don't care.
  def register_base_package?()
    raise NotImplementedError
  end

  # true, false, or nil if don't care.
  def apply_config?()
    raise NotImplementedError
  end

  # true, false, or nil if don't care.
  def apply_base_config?()
    raise NotImplementedError
  end

  def remote_operation_necessary?()
    return false
  end

  def retrieves_should_happen?()
    return false
  end

  # Answers whether we should reset the environment to nothing, sort of like
  # the standardized environment that cron(1) creates.  At present, we're only
  # setting this when we're listing variables.  One could imagine allowing this
  # to be set by a command-line option in general; if we do this, the
  # RuntimeEnvironment class will need to be changed to support deletion of
  # values from ENV.
  def reset_environment?()
    return false
  end

  # Slurp data out of command-line options.
  def configure(options)
    # Do nothing by default.
    return
  end

  def execute()
    raise NotImplementedError
  end
end