From 12be7ab4876f77fecfab903df70791623219b3da Mon Sep 17 00:00:00 2001 From: Georgios Pinitas Date: Tue, 3 Jul 2018 12:06:23 +0100 Subject: COMPMID-1310: Create graph validation executables. Change-Id: I9e0b57b1b83fe5a95777cdaeddba6ecef650bafc Reviewed-on: https://eu-gerrit-1.euhpc.arm.com/138697 Reviewed-by: Anthony Barbier Tested-by: Jenkins --- utils/command_line/CommandLineOptions.h | 33 +++++ utils/command_line/CommandLineParser.h | 234 ++++++++++++++++++++++++++++++++ utils/command_line/EnumListOption.h | 150 ++++++++++++++++++++ utils/command_line/EnumOption.h | 136 +++++++++++++++++++ utils/command_line/ListOption.h | 118 ++++++++++++++++ utils/command_line/Option.h | 141 +++++++++++++++++++ utils/command_line/SimpleOption.h | 118 ++++++++++++++++ utils/command_line/ToggleOption.h | 82 +++++++++++ 8 files changed, 1012 insertions(+) create mode 100644 utils/command_line/CommandLineOptions.h create mode 100644 utils/command_line/CommandLineParser.h create mode 100644 utils/command_line/EnumListOption.h create mode 100644 utils/command_line/EnumOption.h create mode 100644 utils/command_line/ListOption.h create mode 100644 utils/command_line/Option.h create mode 100644 utils/command_line/SimpleOption.h create mode 100644 utils/command_line/ToggleOption.h (limited to 'utils/command_line') diff --git a/utils/command_line/CommandLineOptions.h b/utils/command_line/CommandLineOptions.h new file mode 100644 index 0000000000..8f82815020 --- /dev/null +++ b/utils/command_line/CommandLineOptions.h @@ -0,0 +1,33 @@ +/* + * Copyright (c) 2017-2018 ARM Limited. + * + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to + * deal in the Software without restriction, including without limitation the + * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + * sell copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in all + * copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ +#ifndef ARM_COMPUTE_UTILS_COMMANDLINEOPTIONS +#define ARM_COMPUTE_UTILS_COMMANDLINEOPTIONS + +#include "EnumListOption.h" +#include "EnumOption.h" +#include "ListOption.h" +#include "Option.h" +#include "ToggleOption.h" + +#endif /* ARM_COMPUTE_UTILS_COMMANDLINEOPTIONS */ diff --git a/utils/command_line/CommandLineParser.h b/utils/command_line/CommandLineParser.h new file mode 100644 index 0000000000..06c4bf5e2f --- /dev/null +++ b/utils/command_line/CommandLineParser.h @@ -0,0 +1,234 @@ +/* + * Copyright (c) 2017-2018 ARM Limited. + * + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to + * deal in the Software without restriction, including without limitation the + * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + * sell copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in all + * copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ +#ifndef ARM_COMPUTE_UTILS_COMMANDLINEPARSER +#define ARM_COMPUTE_UTILS_COMMANDLINEPARSER + +#include "Option.h" +#include "arm_compute/core/utils/misc/Utility.h" +#include "support/ToolchainSupport.h" + +#include +#include +#include +#include +#include +#include +#include + +namespace arm_compute +{ +namespace utils +{ +/** Class to parse command line arguments. */ +class CommandLineParser final +{ +public: + /** Default constructor. */ + CommandLineParser() = default; + + /** Function to add a new option to the parser. + * + * @param[in] name Name of the option. Will be available under --name=VALUE. + * @param[in] args Option specific configuration arguments. + * + * @return Pointer to the option. The option is owned by the parser. + */ + template + T *add_option(const std::string &name, As &&... args); + + /** Function to add a new positional argument to the parser. + * + * @param[in] args Option specific configuration arguments. + * + * @return Pointer to the option. The option is owned by the parser. + */ + template + T *add_positional_option(As &&... args); + + /** Parses the command line arguments and updates the options accordingly. + * + * @param[in] argc Number of arguments. + * @param[in] argv Arguments. + */ + void parse(int argc, char **argv); + + /** Validates the previously parsed command line arguments. + * + * Validation fails if not all required options are provided. Additionally + * warnings are generated for options that have illegal values or unknown + * options. + * + * @return True if all required options have been provided. + */ + bool validate() const; + + /** Prints a help message for all configured options. + * + * @param[in] program_name Name of the program to be used in the help message. + */ + void print_help(const std::string &program_name) const; + +private: + using OptionsMap = std::map>; + using PositionalOptionsVector = std::vector>; + + OptionsMap _options{}; + PositionalOptionsVector _positional_options{}; + std::vector _unknown_options{}; + std::vector _invalid_options{}; +}; + +template +inline T *CommandLineParser::add_option(const std::string &name, As &&... args) +{ + auto result = _options.emplace(name, support::cpp14::make_unique(name, std::forward(args)...)); + return static_cast(result.first->second.get()); +} + +template +inline T *CommandLineParser::add_positional_option(As &&... args) +{ + _positional_options.emplace_back(support::cpp14::make_unique(std::forward(args)...)); + return static_cast(_positional_options.back().get()); +} + +inline void CommandLineParser::parse(int argc, char **argv) +{ + const std::regex option_regex{ "--((?:no-)?)([^=]+)(?:=(.*))?" }; + + const auto set_option = [&](const std::string & option, const std::string & name, const std::string & value) + { + if(_options.find(name) == _options.end()) + { + _unknown_options.push_back(option); + return; + } + + const bool success = _options[name]->parse(value); + + if(!success) + { + _invalid_options.push_back(option); + } + }; + + unsigned int positional_index = 0; + + for(int i = 1; i < argc; ++i) + { + std::string mixed_case_opt{ argv[i] }; + int equal_sign = mixed_case_opt.find('='); + int pos = (equal_sign == -1) ? strlen(argv[i]) : equal_sign; + + const std::string option = arm_compute::utility::tolower(mixed_case_opt.substr(0, pos)) + mixed_case_opt.substr(pos); + std::smatch option_matches; + + if(std::regex_match(option, option_matches, option_regex)) + { + // Boolean option + if(option_matches.str(3).empty()) + { + set_option(option, option_matches.str(2), option_matches.str(1).empty() ? "true" : "false"); + } + else + { + // Can't have "no-" and a value + if(!option_matches.str(1).empty()) + { + _invalid_options.emplace_back(option); + } + else + { + set_option(option, option_matches.str(2), option_matches.str(3)); + } + } + } + else + { + if(positional_index >= _positional_options.size()) + { + _invalid_options.push_back(mixed_case_opt); + } + else + { + _positional_options[positional_index]->parse(mixed_case_opt); + ++positional_index; + } + } + } +} + +inline bool CommandLineParser::validate() const +{ + bool is_valid = true; + + for(const auto &option : _options) + { + if(option.second->is_required() && !option.second->is_set()) + { + is_valid = false; + std::cerr << "ERROR: Option '" << option.second->name() << "' is required but not given!\n"; + } + } + + for(const auto &option : _positional_options) + { + if(option->is_required() && !option->is_set()) + { + is_valid = false; + std::cerr << "ERROR: Option '" << option->name() << "' is required but not given!\n"; + } + } + + for(const auto &option : _unknown_options) + { + std::cerr << "WARNING: Skipping unknown option '" << option << "'!\n"; + } + + for(const auto &option : _invalid_options) + { + std::cerr << "WARNING: Skipping invalid option '" << option << "'!\n"; + } + + return is_valid; +} + +inline void CommandLineParser::print_help(const std::string &program_name) const +{ + std::cout << "usage: " << program_name << " \n"; + + for(const auto &option : _options) + { + std::cout << option.second->help() << "\n"; + } + + for(const auto &option : _positional_options) + { + //FIXME: Print help string as well + std::cout << option->name() << "\n"; + } +} +} // namespace utils +} // namespace arm_compute +#endif /* ARM_COMPUTE_UTILS_COMMANDLINEPARSER */ diff --git a/utils/command_line/EnumListOption.h b/utils/command_line/EnumListOption.h new file mode 100644 index 0000000000..834becbaef --- /dev/null +++ b/utils/command_line/EnumListOption.h @@ -0,0 +1,150 @@ +/* + * Copyright (c) 2017-2018 ARM Limited. + * + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to + * deal in the Software without restriction, including without limitation the + * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + * sell copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in all + * copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ +#ifndef ARM_COMPUTE_UTILS_ENUMLISTOPTION +#define ARM_COMPUTE_UTILS_ENUMLISTOPTION + +#include "Option.h" + +#include +#include +#include +#include +#include +#include + +namespace arm_compute +{ +namespace utils +{ +/** Implementation of an option that accepts any number of values from a fixed set. */ +template +class EnumListOption : public Option +{ +public: + /** Construct option with allowed values. + * + * @param[in] name Name of the option. + * @param[in] allowed_values Set of allowed values for the option. + */ + EnumListOption(std::string name, std::set allowed_values); + + /** Construct option with allowed values, a fixed number of accepted values and default values for the option. + * + * @param[in] name Name of the option. + * @param[in] allowed_values Set of allowed values for the option. + * @param[in] default_values Default values. + */ + EnumListOption(std::string name, std::set allowed_values, std::initializer_list &&default_values); + + bool parse(std::string value) override; + std::string help() const override; + + /** Get the values of the option. + * + * @return a list of the selected option values. + */ + const std::vector &value() const; + +private: + std::vector _values{}; + std::set _allowed_values{}; +}; + +template +inline EnumListOption::EnumListOption(std::string name, std::set allowed_values) + : Option{ std::move(name) }, _allowed_values{ std::move(allowed_values) } +{ +} + +template +inline EnumListOption::EnumListOption(std::string name, std::set allowed_values, std::initializer_list &&default_values) + : Option{ std::move(name), false, true }, _values{ std::forward>(default_values) }, _allowed_values{ std::move(allowed_values) } +{ +} + +template +bool EnumListOption::parse(std::string value) +{ + // Remove default values + _values.clear(); + _is_set = true; + + std::stringstream stream{ value }; + std::string item; + + while(!std::getline(stream, item, ',').fail()) + { + try + { + std::stringstream item_stream(item); + T typed_value{}; + + item_stream >> typed_value; + + if(!item_stream.fail()) + { + if(_allowed_values.count(typed_value) == 0) + { + _is_set = false; + continue; + } + + _values.emplace_back(typed_value); + } + + _is_set = _is_set && !item_stream.fail(); + } + catch(const std::invalid_argument &) + { + _is_set = false; + } + } + + return _is_set; +} + +template +std::string EnumListOption::help() const +{ + std::stringstream msg; + msg << "--" + name() + "={"; + + for(const auto &value : _allowed_values) + { + msg << value << ","; + } + + msg << "}[,{...}[,...]] - " << _help; + + return msg.str(); +} + +template +inline const std::vector &EnumListOption::value() const +{ + return _values; +} +} // namespace utils +} // namespace arm_compute +#endif /* ARM_COMPUTE_UTILS_ENUMLISTOPTION */ diff --git a/utils/command_line/EnumOption.h b/utils/command_line/EnumOption.h new file mode 100644 index 0000000000..b775db23fb --- /dev/null +++ b/utils/command_line/EnumOption.h @@ -0,0 +1,136 @@ +/* + * Copyright (c) 2017-2018 ARM Limited. + * + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to + * deal in the Software without restriction, including without limitation the + * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + * sell copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in all + * copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ +#ifndef ARM_COMPUTE_UTILS_ENUMOPTION +#define ARM_COMPUTE_UTILS_ENUMOPTION + +#include "SimpleOption.h" + +#include +#include +#include +#include + +namespace arm_compute +{ +namespace utils +{ +/** Implementation of a simple option that accepts a value from a fixed set. */ +template +class EnumOption : public SimpleOption +{ +public: + /** Construct option with allowed values. + * + * @param[in] name Name of the option. + * @param[in] allowed_values Set of allowed values for the option. + */ + EnumOption(std::string name, std::set allowed_values); + + /** Construct option with allowed values, a fixed number of accepted values and default values for the option. + * + * @param[in] name Name of the option. + * @param[in] allowed_values Set of allowed values for the option. + * @param[in] default_value Default value. + */ + EnumOption(std::string name, std::set allowed_values, T default_value); + + bool parse(std::string value) override; + std::string help() const override; + + /** Get the selected value. + * + * @return get the selected enum value. + */ + const T &value() const; + +private: + std::set _allowed_values{}; +}; + +template +inline EnumOption::EnumOption(std::string name, std::set allowed_values) + : SimpleOption{ std::move(name) }, _allowed_values{ std::move(allowed_values) } +{ +} + +template +inline EnumOption::EnumOption(std::string name, std::set allowed_values, T default_value) + : SimpleOption{ std::move(name), std::move(default_value) }, _allowed_values{ std::move(allowed_values) } +{ +} + +template +bool EnumOption::parse(std::string value) +{ + try + { + std::stringstream stream{ value }; + T typed_value{}; + + stream >> typed_value; + + if(!stream.fail()) + { + if(_allowed_values.count(typed_value) == 0) + { + return false; + } + + this->_value = std::move(typed_value); + this->_is_set = true; + return true; + } + + return false; + } + catch(const std::invalid_argument &) + { + return false; + } +} + +template +std::string EnumOption::help() const +{ + std::stringstream msg; + msg << "--" + this->name() + "={"; + + for(const auto &value : _allowed_values) + { + msg << value << ","; + } + + msg << "} - " << this->_help; + + return msg.str(); +} + +template +inline const T &EnumOption::value() const +{ + return this->_value; +} +} // namespace utils +} // namespace arm_compute +#endif /* ARM_COMPUTE_UTILS_ENUMOPTION */ diff --git a/utils/command_line/ListOption.h b/utils/command_line/ListOption.h new file mode 100644 index 0000000000..209a85d968 --- /dev/null +++ b/utils/command_line/ListOption.h @@ -0,0 +1,118 @@ +/* + * Copyright (c) 2017-2018 ARM Limited. + * + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to + * deal in the Software without restriction, including without limitation the + * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + * sell copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in all + * copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ +#ifndef ARM_COMPUTE_UTILS_LISTOPTION +#define ARM_COMPUTE_UTILS_LISTOPTION + +#include "Option.h" + +#include +#include +#include +#include +#include + +namespace arm_compute +{ +namespace utils +{ +/** Implementation of an option that accepts any number of values. */ +template +class ListOption : public Option +{ +public: + using Option::Option; + + /** Construct the option with the given default values. + * + * @param[in] name Name of the option. + * @param[in] default_values Default values. + */ + ListOption(std::string name, std::initializer_list &&default_values); + + bool parse(std::string value) override; + std::string help() const override; + + /** Get the list of option values. + * + * @return get the list of option values. + */ + const std::vector &value() const; + +private: + std::vector _values{}; +}; + +template +inline ListOption::ListOption(std::string name, std::initializer_list &&default_values) + : Option{ std::move(name), false, true }, _values{ std::forward>(default_values) } +{ +} + +template +bool ListOption::parse(std::string value) +{ + _is_set = true; + + try + { + std::stringstream stream{ value }; + std::string item; + + while(!std::getline(stream, item, ',').fail()) + { + std::stringstream item_stream(item); + T typed_value{}; + + item_stream >> typed_value; + + if(!item_stream.fail()) + { + _values.emplace_back(typed_value); + } + + _is_set = _is_set && !item_stream.fail(); + } + + return _is_set; + } + catch(const std::invalid_argument &) + { + return false; + } +} + +template +inline std::string ListOption::help() const +{ + return "--" + name() + "=VALUE[,VALUE[,...]] - " + _help; +} + +template +inline const std::vector &ListOption::value() const +{ + return _values; +} +} // namespace utils +} // namespace arm_compute +#endif /* ARM_COMPUTE_UTILS_LISTOPTION */ diff --git a/utils/command_line/Option.h b/utils/command_line/Option.h new file mode 100644 index 0000000000..b9469a5cc3 --- /dev/null +++ b/utils/command_line/Option.h @@ -0,0 +1,141 @@ +/* + * Copyright (c) 2017-2018 ARM Limited. + * + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to + * deal in the Software without restriction, including without limitation the + * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + * sell copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in all + * copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ +#ifndef ARM_COMPUTE_UTILS_OPTIONBASE +#define ARM_COMPUTE_UTILS_OPTIONBASE + +#include + +namespace arm_compute +{ +namespace utils +{ +/** Abstract base class for a command line option. */ +class Option +{ +public: + /** Constructor. + * + * @param[in] name Name of the option. + */ + Option(std::string name); + + /** Constructor. + * + * @param[in] name Name of the option. + * @param[in] is_required Is the option required? + * @param[in] is_set Has a value been assigned to the option? + */ + Option(std::string name, bool is_required, bool is_set); + + /** Default destructor. */ + virtual ~Option() = default; + + /** Parses the given string. + * + * @param[in] value String representation as passed on the command line. + * + * @return True if the value could be parsed by the specific subclass. + */ + virtual bool parse(std::string value) = 0; + + /** Help message for the option. + * + * @return String representing the help message for the specific subclass. + */ + virtual std::string help() const = 0; + + /** Name of the option. + * + * @return Name of the option. + */ + std::string name() const; + + /** Set whether the option is required. + * + * @param[in] is_required Pass true if the option is required. + */ + void set_required(bool is_required); + + /** Set the help message for the option. + * + * @param[in] help Option specific help message. + */ + void set_help(std::string help); + + /** Is the option required? + * + * @return True if the option is required. + */ + bool is_required() const; + + /** Has a value been assigned to the option? + * + * @return True if a value has been set. + */ + bool is_set() const; + +protected: + std::string _name; + bool _is_required{ false }; + bool _is_set{ false }; + std::string _help{}; +}; + +inline Option::Option(std::string name) + : _name{ std::move(name) } +{ +} + +inline Option::Option(std::string name, bool is_required, bool is_set) + : _name{ std::move(name) }, _is_required{ is_required }, _is_set{ is_set } +{ +} + +inline std::string Option::name() const +{ + return _name; +} + +inline void Option::set_required(bool is_required) +{ + _is_required = is_required; +} + +inline void Option::set_help(std::string help) +{ + _help = std::move(help); +} + +inline bool Option::is_required() const +{ + return _is_required; +} + +inline bool Option::is_set() const +{ + return _is_set; +} +} // namespace utils +} // namespace arm_compute +#endif /* ARM_COMPUTE_UTILS_OPTIONBASE */ diff --git a/utils/command_line/SimpleOption.h b/utils/command_line/SimpleOption.h new file mode 100644 index 0000000000..543759259a --- /dev/null +++ b/utils/command_line/SimpleOption.h @@ -0,0 +1,118 @@ +/* + * Copyright (c) 2017-2018 ARM Limited. + * + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to + * deal in the Software without restriction, including without limitation the + * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + * sell copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in all + * copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ +#ifndef ARM_COMPUTE_UTILS_SIMPLEOPTION +#define ARM_COMPUTE_UTILS_SIMPLEOPTION + +#include "Option.h" + +#include +#include +#include + +namespace arm_compute +{ +namespace utils +{ +/** Implementation of an option that accepts a single value. */ +template +class SimpleOption : public Option +{ +public: + using Option::Option; + + /** Construct the option with the given default value. + * + * @param[in] name Name of the option. + * @param[in] default_value Default value. + */ + SimpleOption(std::string name, T default_value); + + /** Parses the given string. + * + * @param[in] value String representation as passed on the command line. + * + * @return True if the value could be parsed by the specific subclass. + */ + bool parse(std::string value) override; + + /** Help message for the option. + * + * @return String representing the help message for the specific subclass. + */ + std::string help() const override; + + /** Get the option value. + * + * @return the option value. + */ + const T &value() const; + +protected: + T _value{}; +}; + +template +inline SimpleOption::SimpleOption(std::string name, T default_value) + : Option{ std::move(name), false, true }, _value{ std::move(default_value) } +{ +} + +template +bool SimpleOption::parse(std::string value) +{ + try + { + std::stringstream stream{ std::move(value) }; + stream >> _value; + _is_set = !stream.fail(); + return _is_set; + } + catch(const std::invalid_argument &) + { + return false; + } +} + +template <> +inline bool SimpleOption::parse(std::string value) +{ + _value = std::move(value); + _is_set = true; + return true; +} + +template +inline std::string SimpleOption::help() const +{ + return "--" + name() + "=VALUE - " + _help; +} + +template +inline const T &SimpleOption::value() const +{ + return _value; +} +} // namespace utils +} // namespace arm_compute +#endif /* ARM_COMPUTE_UTILS_SIMPLEOPTION */ diff --git a/utils/command_line/ToggleOption.h b/utils/command_line/ToggleOption.h new file mode 100644 index 0000000000..b1d2a32c64 --- /dev/null +++ b/utils/command_line/ToggleOption.h @@ -0,0 +1,82 @@ +/* + * Copyright (c) 2017-2018 ARM Limited. + * + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to + * deal in the Software without restriction, including without limitation the + * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + * sell copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in all + * copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ +#ifndef ARM_COMPUTE_UTILS_TOGGLEOPTION +#define ARM_COMPUTE_UTILS_TOGGLEOPTION + +#include "SimpleOption.h" + +#include + +namespace arm_compute +{ +namespace utils +{ +/** Implementation of an option that can be either true or false. */ +class ToggleOption : public SimpleOption +{ +public: + using SimpleOption::SimpleOption; + + /** Construct the option with the given default value. + * + * @param[in] name Name of the option. + * @param[in] default_value Default value. + */ + ToggleOption(std::string name, bool default_value); + + bool parse(std::string value) override; + std::string help() const override; +}; + +inline ToggleOption::ToggleOption(std::string name, bool default_value) + : SimpleOption +{ + std::move(name), default_value +} +{ +} + +inline bool ToggleOption::parse(std::string value) +{ + if(value == "true") + { + _value = true; + _is_set = true; + } + else if(value == "false") + { + _value = false; + _is_set = true; + } + + return _is_set; +} + +inline std::string ToggleOption::help() const +{ + return "--" + name() + ", --no-" + name() + " - " + _help; +} +} // namespace utils +} // namespace arm_compute +#endif /* ARM_COMPUTE_UTILS_TOGGLEOPTION */ -- cgit v1.2.1