art::BasicOptionsHandler Class Reference

#include "BasicOptionsHandler.h"

Inheritance diagram for art::BasicOptionsHandler:

Public Member Functions
	BasicOptionsHandler (bpo::options_description &desc, cet::filepath_maker &maker)
int	checkOptions (bpo::variables_map const &vm)
int	processOptions (bpo::variables_map const &vm, fhicl::intermediate_table &raw_config)

Private Member Functions
int	doCheckOptions (bpo::variables_map const &vm) override
int	doProcessOptions (bpo::variables_map const &vm, fhicl::intermediate_table &raw_config) override

Private Attributes
bpo::options_description const &	help_desc_
cet::filepath_maker &	maker_

Detailed Description

Definition at line 15 of file BasicOptionsHandler.h.

Constructor & Destructor Documentation

art::BasicOptionsHandler::BasicOptionsHandler	(	bpo::options_description &	desc,
		cet::filepath_maker &	maker
	)

Definition at line 31 of file BasicOptionsHandler.cc.

References art::add_opt(), art::getReleaseVersion(), maker_, art::Suffixes::print(), s, and fhicl::detail::atom::value().

  : help_desc_{desc}, maker_{maker}
{
  auto options = desc.add_options();
  add_opt(options, "help,h", "produce help message");
  add_opt(
    options,
    "version",
    ("Print art version (" + pretty_version(art::getReleaseVersion()) + ")")
      .c_str());
  add_opt(
    options, "config,c", bpo::value<std::string>(), "Configuration file.");
  add_opt(
    options, "process-name", bpo::value<std::string>(), "art process name.");
  add_opt(
    options,
    "print-available",
    bpo::value<std::string>(),
    ("List all available plugins with the provided suffix.  Choose from:"s +
     Suffixes::print())
      .c_str());
  add_opt(options,
          "print-available-modules",
          "List all available modules that can be invoked in a FHiCL file.");
  add_opt(options,
          "print-available-services",
          "List all available services that can be invoked in a FHiCL file.");
  add_opt(options,
          "print-description",
          bpo::value<std::vector<std::string>>()->multitoken(),
          "Print description of specified module, service, source, or other "
          "plugin (multiple OK).  Argument can be a regular expression used "
          "to match the plugin specification.  To narrow the search to "
          "plugins with a particular suffix, preface the regular expression"
          "with the suffix (e.g. service:TFileService).");
  add_opt(options,
          "status-bar",
          "Provide status bar that reports the progress of retrieving "
          "plugin information for a 'print-available' command.");
}

Member Function Documentation

int art::OptionsHandler::checkOptions ( bpo::variables_map const &  vm )

inherited

Definition at line 51 of file OptionsHandler.cc.

{
  std::string const thisClass(cet::demangle_symbol(typeid(*this).name()));
  return exceptionCatcher([&vm, this] { return doCheckOptions(vm); },
                          thisClass + "::doCheckOptions()",
                          89);
}

int art::BasicOptionsHandler::doCheckOptions ( bpo::variables_map const &  vm )

overrideprivatevirtual

Implements art::OptionsHandler.

Definition at line 74 of file BasicOptionsHandler.cc.

References art::errors::Configuration, art::Suffixes::get(), art::getReleaseVersion(), help_desc_, art::detail::info_success(), art::module, art::detail::print_available_plugins(), art::detail::print_descriptions(), s, art::service, and ss.

{
  // Technically the "help" and "print*" options are processing steps,
  // but we want to short-circuit.
  if (vm.count("help")) {
    // Could simply do cout << help_desc_, but the boost-provided
    // printout does not add any left-hand padding.  Will add a
    // 2-space tab by hand.
    std::stringstream ss;
    ss << help_desc_; // Note NOT our own desc_.
    for (std::string s; std::getline(ss, s);)
      std::cout << std::string(2, ' ') << s << '\n';
    std::cout << '\n';
    return detail::info_success();
  }
  bool const status_bar = vm.count("status-bar") > 0;
  if (vm.count("print-available")) {
    detail::print_available_plugins(
      Suffixes::get(vm["print-available"].as<std::string>()), status_bar);
    return detail::info_success();
  }
  if (vm.count("print-available-modules")) {
    detail::print_available_plugins(suffix_type::module, status_bar);
    return detail::info_success();
  }
  if (vm.count("print-available-services")) {
    detail::print_available_plugins(suffix_type::service, status_bar);
    return detail::info_success();
  }
  if (status_bar) {
    throw Exception(errors::Configuration)
      << "The '--status-bar' option can be used only with the "
         "'--print-available*' program options.\n";
  }

  if (vm.count("print-description")) {
    detail::print_descriptions(
      vm["print-description"].as<std::vector<std::string>>());
    return detail::info_success();
  }
  if (vm.count("version")) {
    std::cout << "art " << pretty_version(getReleaseVersion()) << '\n';
    return detail::info_success();
  }

  if (!vm.count("config")) {
    throw Exception(errors::Configuration) << "No configuration file given.\n";
  }
  return 0;
}

int art::BasicOptionsHandler::doProcessOptions ( bpo::variables_map const &  vm, fhicl::intermediate_table &  raw_config  )

overrideprivatevirtual

Implements art::OptionsHandler.

Definition at line 126 of file BasicOptionsHandler.cc.

References e, fhicl::intermediate_table::empty(), maker_, fhicl::parse_document(), and fhicl::intermediate_table::put().

{
  try {
    fhicl::parse_document(vm["config"].as<std::string>(), maker_, raw_config);
  }
  catch (cet::exception& e) {
    std::cerr << "Failed to parse the configuration file '"
              << vm["config"].as<std::string>() << "' with exception\n"
              << e.what() << "\n";
    return 90;
  }
  if (raw_config.empty()) {
    std::cerr << "INFO: provided configuration file '"
              << vm["config"].as<std::string>() << "' is empty: \n"
              << "using minimal defaults and command-line options.\n";
  }
  if (vm.count("process-name")) {
    raw_config.put("process_name", vm["process-name"].as<std::string>());
  }
  return 0;
}

int art::OptionsHandler::processOptions ( bpo::variables_map const &  vm, fhicl::intermediate_table &  raw_config  )

inherited

Definition at line 60 of file OptionsHandler.cc.

Referenced by art::run_art_string_config().

{
  std::string const thisClass(cet::demangle_symbol(typeid(*this).name()));
  return exceptionCatcher(
    [&, this] { return doProcessOptions(vm, raw_config); },
    thisClass + "::doProcessOptions()",
    90);
}

Member Data Documentation

bpo::options_description const& art::BasicOptionsHandler::help_desc_

private

Definition at line 28 of file BasicOptionsHandler.h.

Referenced by doCheckOptions().

cet::filepath_maker& art::BasicOptionsHandler::maker_

private

Definition at line 29 of file BasicOptionsHandler.h.

Referenced by BasicOptionsHandler(), and doProcessOptions().

---

The documentation for this class was generated from the following files:

• art/Framework/Art/BasicOptionsHandler.h
• art/Framework/Art/BasicOptionsHandler.cc