diff options
author | Andres Noetzli <andres.noetzli@gmail.com> | 2021-07-28 14:11:55 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-07-28 14:11:55 -0700 |
commit | 1377cede4b223a5b6a68d7d9194b7e3346a2d51a (patch) | |
tree | face9b6f6b46f663a38115c6ca11fb7415acbd10 /src/options/options_template.cpp | |
parent | 5067dee413caf5f5bda4e666d877841f936d74b0 (diff) | |
parent | e6747735d2074fc2651c5edc11fa8170fc13663e (diff) |
Merge branch 'master' into docsLinkdocsLink
Diffstat (limited to 'src/options/options_template.cpp')
-rw-r--r-- | src/options/options_template.cpp | 534 |
1 files changed, 15 insertions, 519 deletions
diff --git a/src/options/options_template.cpp b/src/options/options_template.cpp index 2c22065c2..db58c3a4a 100644 --- a/src/options/options_template.cpp +++ b/src/options/options_template.cpp @@ -13,43 +13,11 @@ * Contains code for handling command-line options. */ -#if !defined(_BSD_SOURCE) && defined(__MINGW32__) && !defined(__MINGW64__) -// force use of optreset; mingw32 croaks on argv-switching otherwise -#include "base/cvc5config.h" -#define _BSD_SOURCE -#undef HAVE_DECL_OPTRESET -#define HAVE_DECL_OPTRESET 1 -#define CVC5_IS_NOT_REALLY_BSD -#endif /* !_BSD_SOURCE && __MINGW32__ && !__MINGW64__ */ - -#ifdef __MINGW64__ -extern int optreset; -#endif /* __MINGW64__ */ - -#include <getopt.h> - -// clean up -#ifdef CVC5_IS_NOT_REALLY_BSD -# undef _BSD_SOURCE -#endif /* CVC5_IS_NOT_REALLY_BSD */ - -#include <unistd.h> -#include <string.h> -#include <time.h> - -#include <cstdio> -#include <cstdlib> -#include <cstring> -#include <iomanip> -#include <new> -#include <string> -#include <sstream> -#include <limits> +#include "options/options.h" #include "base/check.h" #include "base/exception.h" #include "base/output.h" -#include "options/didyoumean.h" #include "options/language.h" #include "options/options_handler.h" #include "options/options_listener.h" @@ -65,175 +33,22 @@ using namespace cvc5; using namespace cvc5::options; // clang-format on -namespace cvc5 { - -thread_local Options* Options::s_current = NULL; - -/** - * This is a default handler for options of built-in C++ type. This - * template is really just a helper for the handleOption() template, - * below. Variants of this template handle numeric and non-numeric, - * integral and non-integral, signed and unsigned C++ types. - * handleOption() makes sure to instantiate the right one. - * - * This implements default behavior when e.g. an option is - * unsigned but the user specifies a negative argument; etc. - */ -template <class T, bool is_numeric, bool is_integer> -struct OptionHandler { - static T handle(const std::string& option, - const std::string& flag, - const std::string& optionarg); -};/* struct OptionHandler<> */ - -/** Variant for integral C++ types */ -template <class T> -struct OptionHandler<T, true, true> { - static bool stringToInt(T& t, const std::string& str) { - std::istringstream ss(str); - ss >> t; - char tmp; - return !(ss.fail() || ss.get(tmp)); - } - - static bool containsMinus(const std::string& str) { - return str.find('-') != std::string::npos; - } - - static T handle(const std::string& option, - const std::string& flag, - const std::string& optionarg) - { - try { - T i; - bool success = stringToInt(i, optionarg); - - if(!success){ - throw OptionException(flag + ": failed to parse " + optionarg - + " as an integer of the appropriate type."); - } - - // Depending in the platform unsigned numbers with '-' signs may parse. - // Reject these by looking for any minus if it is not signed. - if( (! std::numeric_limits<T>::is_signed) && containsMinus(optionarg) ) { - // unsigned type but user gave negative argument - throw OptionException(flag + " requires a nonnegative argument"); - } else if(i < std::numeric_limits<T>::min()) { - // negative overflow for type - std::stringstream ss; - ss << flag - << " requires an argument >= " << std::numeric_limits<T>::min(); - throw OptionException(ss.str()); - } else if(i > std::numeric_limits<T>::max()) { - // positive overflow for type - std::stringstream ss; - ss << flag - << " requires an argument <= " << std::numeric_limits<T>::max(); - throw OptionException(ss.str()); - } - - return i; - - // if(std::numeric_limits<T>::is_signed) { - // return T(i.getLong()); - // } else { - // return T(i.getUnsignedLong()); - // } - } catch(std::invalid_argument&) { - // user gave something other than an integer - throw OptionException(flag + " requires an integer argument"); - } - } -};/* struct OptionHandler<T, true, true> */ - -/** Variant for numeric but non-integral C++ types */ -template <class T> -struct OptionHandler<T, true, false> { - static T handle(const std::string& option, - const std::string& flag, - const std::string& optionarg) - { - std::stringstream inss(optionarg); - long double r; - inss >> r; - if (!inss.eof()) - { - // we didn't consume the whole string (junk at end) - throw OptionException(flag + " requires a numeric argument"); - } - - if(! std::numeric_limits<T>::is_signed && r < 0.0) { - // unsigned type but user gave negative value - throw OptionException(flag + " requires a nonnegative argument"); - } else if(r < -std::numeric_limits<T>::max()) { - // negative overflow for type - std::stringstream ss; - ss << flag - << " requires an argument >= " << -std::numeric_limits<T>::max(); - throw OptionException(ss.str()); - } else if(r > std::numeric_limits<T>::max()) { - // positive overflow for type - std::stringstream ss; - ss << flag - << " requires an argument <= " << std::numeric_limits<T>::max(); - throw OptionException(ss.str()); - } - - return T(r); - } -};/* struct OptionHandler<T, true, false> */ - -/** Variant for non-numeric C++ types */ -template <class T> -struct OptionHandler<T, false, false> { - static T handle(const std::string& option, - const std::string& flag, - const std::string& optionarg) - { - T::unsupported_handleOption_call___please_write_me; - // The above line causes a compiler error if this version of the template - // is ever instantiated (meaning that a specialization is missing). So - // don't worry about the segfault in the next line, the "return" is only - // there to keep the compiler from giving additional, distracting errors - // and warnings. - return *(T*)0; - } -};/* struct OptionHandler<T, false, false> */ - -/** Handle an option of type T in the default way. */ -template <class T> -T handleOption(const std::string& option, - const std::string& flag, - const std::string& optionarg) -{ - return OptionHandler<T, - std::numeric_limits<T>::is_specialized, - std::numeric_limits<T>::is_integer>::handle(option, - flag, - optionarg); -} - -/** Handle an option of type std::string in the default way. */ -template <> -std::string handleOption<std::string>(const std::string& option, - const std::string& flag, - const std::string& optionarg) +namespace cvc5 { - return optionarg; -} + thread_local Options* Options::s_current = nullptr; -Options::Options(OptionsListener* ol) - : d_handler(new options::OptionsHandler(this)), + Options::Options(OptionsListener * ol) + : + d_olisten(ol), // clang-format off ${holder_mem_inits}$ ${holder_ref_inits}$ // clang-format on - d_olisten(ol) -{} + d_handler(std::make_unique<options::OptionsHandler>(this)) + { + } -Options::~Options() { - delete d_handler; -} + Options::~Options() {} void Options::copyValues(const Options& options){ if(this != &options) { @@ -244,333 +59,14 @@ ${holder_mem_copy}$ } void Options::setListener(OptionsListener* ol) { d_olisten = ol; } - -// clang-format off -${custom_handlers}$ -// clang-format on - -static const std::string mostCommonOptionsDescription = - "\ -Most commonly-used cvc5 options:\n" - // clang-format off -${help_common}$ - // clang-format on - ; - -// clang-format off -static const std::string optionsDescription = - mostCommonOptionsDescription + "\n\nAdditional cvc5 options:\n" -${help_others}$; -// clang-format on - -static const std::string optionsFootnote = "\n\ -[*] Each of these options has a --no-OPTIONNAME variant, which reverses the\n\ - sense of the option.\n\ -"; - -static const std::string languageDescription = - "\ -Languages currently supported as arguments to the -L / --lang option:\n\ - auto attempt to automatically determine language\n\ - cvc | presentation | pl CVC presentation language\n\ - smt | smtlib | smt2 |\n\ - smt2.6 | smtlib2.6 SMT-LIB format 2.6 with support for the strings standard\n\ - tptp TPTP format (cnf, fof and tff)\n\ - sygus | sygus2 SyGuS version 2.0\n\ -\n\ -Languages currently supported as arguments to the --output-lang option:\n\ - auto match output language to input language\n\ - cvc | presentation | pl CVC presentation language\n\ - smt | smtlib | smt2 |\n\ - smt2.6 | smtlib2.6 SMT-LIB format 2.6 with support for the strings standard\n\ - tptp TPTP format\n\ - ast internal format (simple syntax trees)\n\ -"; - -std::string Options::getDescription() const { - return optionsDescription; -} - -void Options::printUsage(const std::string msg, std::ostream& out) { - out << msg << optionsDescription << std::endl - << optionsFootnote << std::endl << std::flush; -} - -void Options::printShortUsage(const std::string msg, std::ostream& out) { - out << msg << mostCommonOptionsDescription << std::endl - << optionsFootnote << std::endl - << "For full usage, please use --help." - << std::endl << std::endl << std::flush; -} - -void Options::printLanguageHelp(std::ostream& out) { - out << languageDescription << std::flush; -} - -/** - * This is a table of long options. By policy, each short option - * should have an equivalent long option (but the reverse isn't the - * case), so this table should thus contain all command-line options. - * - * Each option in this array has four elements: - * - * 1. the long option string - * 2. argument behavior for the option: - * no_argument - no argument permitted - * required_argument - an argument is expected - * optional_argument - an argument is permitted but not required - * 3. this is a pointer to an int which is set to the 4th entry of the - * array if the option is present; or NULL, in which case - * getopt_long() returns the 4th entry - * 4. the return value for getopt_long() when this long option (or the - * value to set the 3rd entry to; see #3) - * - * If you add something here, you should add it in src/main/usage.h - * also, to document it. - * - * If you add something that has a short option equivalent, you should - * add it to the getopt_long() call in parseOptions(). - */ -// clang-format off -static struct option cmdlineOptions[] = { - ${cmdline_options}$ - {nullptr, no_argument, nullptr, '\0'}}; -// clang-format on - -namespace options { - -/** Set a given Options* as "current" just for a particular scope. */ -class OptionsGuard { - Options** d_field; - Options* d_old; -public: - OptionsGuard(Options** field, Options* opts) : - d_field(field), - d_old(*field) { - *field = opts; - } - ~OptionsGuard() { - *d_field = d_old; - } -};/* class OptionsGuard */ - -} // namespace options - -/** - * Parse argc/argv and put the result into a cvc5::Options. - * The return value is what's left of the command line (that is, the - * non-option arguments). - * - * Throws OptionException on failures. - */ -std::vector<std::string> Options::parseOptions(Options* options, - int argc, - char* argv[], - std::string& binaryName) -{ - Assert(options != NULL); - Assert(argv != NULL); - - options::OptionsGuard guard(&s_current, options); - - const char *progName = argv[0]; - - // To debug options parsing, you may prefer to simply uncomment this - // and recompile. Debug flags have not been parsed yet so these have - // not been set. - //DebugChannel.on("options"); - - Debug("options") << "Options::parseOptions == " << options << std::endl; - Debug("options") << "argv == " << argv << std::endl; - - // Find the base name of the program. - const char *x = strrchr(progName, '/'); - if(x != NULL) { - progName = x + 1; - } - binaryName = std::string(progName); - - std::vector<std::string> nonoptions; - options->parseOptionsRecursive(argc, argv, &nonoptions); - if(Debug.isOn("options")){ - for(std::vector<std::string>::const_iterator i = nonoptions.begin(), - iend = nonoptions.end(); i != iend; ++i){ - Debug("options") << "nonoptions " << *i << std::endl; - } - } - - return nonoptions; -} - -std::string suggestCommandLineOptions(const std::string& optionName) -{ - DidYouMean didYouMean; - - const char* opt; - for(size_t i = 0; (opt = cmdlineOptions[i].name) != nullptr; ++i) { - didYouMean.addWord(std::string("--") + cmdlineOptions[i].name); - } - - return didYouMean.getMatchAsString(optionName.substr(0, optionName.find('='))); -} - -void Options::parseOptionsRecursive(int argc, - char* argv[], - std::vector<std::string>* nonoptions) -{ - Options& opts = *this; - if(Debug.isOn("options")) { - Debug("options") << "starting a new parseOptionsRecursive with " - << argc << " arguments" << std::endl; - for( int i = 0; i < argc ; i++ ){ - Assert(argv[i] != NULL); - Debug("options") << " argv[" << i << "] = " << argv[i] << std::endl; - } - } - - // Reset getopt(), in the case of multiple calls to parseOptions(). - // This can be = 1 in newer GNU getopt, but older (< 2007) require = 0. - optind = 0; -#if HAVE_DECL_OPTRESET - optreset = 1; // on BSD getopt() (e.g. Mac OS), might need this -#endif /* HAVE_DECL_OPTRESET */ - - // We must parse the binary name, which is manually ignored below. Setting - // this to 1 leads to incorrect behavior on some platforms. - int main_optind = 0; - int old_optind; - - - while(true) { // Repeat Forever - - optopt = 0; - std::string option, optionarg; - - optind = main_optind; - old_optind = main_optind; - - // If we encounter an element that is not at zero and does not start - // with a "-", this is a non-option. We consume this element as a - // non-option. - if (main_optind > 0 && main_optind < argc && - argv[main_optind][0] != '-') { - Debug("options") << "enqueueing " << argv[main_optind] - << " as a non-option." << std::endl; - nonoptions->push_back(argv[main_optind]); - ++main_optind; - continue; - } - - - Debug("options") << "[ before, main_optind == " << main_optind << " ]" - << std::endl; - Debug("options") << "[ before, optind == " << optind << " ]" << std::endl; - Debug("options") << "[ argc == " << argc << ", argv == " << argv << " ]" - << std::endl; - // clang-format off - int c = getopt_long(argc, argv, - "+:${options_short}$", - cmdlineOptions, NULL); - // clang-format on - - main_optind = optind; - - Debug("options") << "[ got " << int(c) << " (" << char(c) << ") ]" - << "[ next option will be at pos: " << optind << " ]" - << std::endl; - - // The initial getopt_long call should always determine that argv[0] - // is not an option and returns -1. We always manually advance beyond - // this element. - if ( old_optind == 0 && c == -1 ) { - Assert(main_optind > 0); - continue; - } - - if ( c == -1 ) { - if(Debug.isOn("options")) { - Debug("options") << "done with option parsing" << std::endl; - for(int index = optind; index < argc; ++index) { - Debug("options") << "remaining " << argv[index] << std::endl; - } - } - break; - } - - option = argv[old_optind == 0 ? 1 : old_optind]; - optionarg = (optarg == NULL) ? "" : optarg; - - Debug("preemptGetopt") << "processing option " << c - << " (`" << char(c) << "'), " << option << std::endl; - - // clang-format off - switch(c) + +void Options::notifyListener(const std::string& key) + { + if (d_olisten != nullptr) { -${options_handler}$ - - case ':' : - // This can be a long or short option, and the way to get at the - // name of it is different. - throw OptionException(std::string("option `") + option - + "' missing its required argument"); - - case '?': - default: - throw OptionException(std::string("can't understand option `") + option - + "'" + suggestCommandLineOptions(option)); + d_olisten->notifySetOption(key); } } - // clang-format on - - Debug("options") << "got " << nonoptions->size() - << " non-option arguments." << std::endl; -} - -// clang-format off -std::vector<std::vector<std::string> > Options::getOptions() const -{ - std::vector< std::vector<std::string> > opts; - - ${options_getoptions}$ - - return opts; -} -// clang-format on - -void Options::setOption(const std::string& key, const std::string& optionarg) -{ - Trace("options") << "setOption(" << key << ", " << optionarg << ")" - << std::endl; - // first update this object - setOptionInternal(key, optionarg); - // then, notify the provided listener - if (d_olisten != nullptr) - { - d_olisten->notifySetOption(key); - } -} - -// clang-format off -void Options::setOptionInternal(const std::string& key, - const std::string& optionarg) -{ - options::OptionsHandler* handler = d_handler; - Options& opts = *this; - ${setoption_handlers}$ - throw UnrecognizedOptionException(key); -} -// clang-format on - -// clang-format off -std::string Options::getOption(const std::string& key) const -{ - Trace("options") << "Options::getOption(" << key << ")" << std::endl; - const Options& options = *this; - ${getoption_handlers}$ - - throw UnrecognizedOptionException(key); -} -// clang-format on } // namespace cvc5 |