#include <stdexcept>
#include "parameter.h"
+#include "exception/missingOptionValue.h"
+#include "exception/optionFailedConversion.h"
namespace command {
/**
* Class responsible for handling commandline options.
- * Options are non-required, named parameters of program.
+ * Options are named parameters of program.
*
* Example:
- * ./myprog OptionName=OptionValue
+ * - ./myprog OptionName=OptionValue
+ * - ./myprog -f=/some/file
+ * - ./myprog --level=15
*/
- template<typename OptionType>
+ template<typename ParameterType>
class Option
- : public Parameter, public Callable<OptionType> {
+ : public Parameter, public Callable<ParameterType> {
public:
typedef std::string OptionName;
protected:
/**
* Current Option name
*/
- OptionName name;
+ const OptionName name;
/**
* Current Option value
*/
- OptionType value;
-
- /** Variable indicating if current Option was already used or not */
- bool used = false;
+ ParameterType value;
public:
/**
* @param description Description of current Option
* @param function Function used to handle current Option.
*/
- Option(std::string name, const std::string & description, void (*function)(OptionType))
- : Parameter(description), Callable<OptionType>(function), name(name) {
+ Option(const std::string & name, const std::string & description, void (*function)(ParameterType))
+ : Parameter(description), Callable<ParameterType>(function), name(name) {
}
/**
virtual ~Option() { }
/**
- *
+ * \inheritdoc
*/
virtual void handle() {
this->call(value);
+ used = true;
}
/**
* If no equal sign is after OptionName part,
* std::invalid_argument exception with appropriate message is thrown
*
- * If conversion of OptionValue part to OptionType failed,
+ * If conversion of OptionValue part to ParameterType failed,
* std::invalid_argument exception with appropriate message is thrown
*
* @param argv command line value against which test will be made.
*
* @return If passed argv succesfully detected OptionName part as a
* current option and its OptionValue part has been succesfully
- * converted to OptionType, returns true and Option is set as used one.
+ * converted to ParameterType, returns true and Option is set as used one.
* Otherwise returns false and can be used to check against next value.
*
- * @throw std::invalid_argument when OptionName part has no equal sign
- * after itself
- * @throw std::invalid_argument when OptionValue part failed conversion
- * to OptionType
+ * @throw MissingOptionValue when OptionValue part is missing after
+ * equal sign
+ * @throw OptionFailedConversion when OptionValue part failed conversion
+ * to ParameterType
*/
virtual bool understand(const std::string & argv) {
- if ((!used) &&
- (argv.find(name) == 0)) {
+
+ if (argv.find(name) == 0) {
std::size_t pos = argv.find("=");
+
if (pos != name.size()) {
- throw std::invalid_argument("Option: " + name + " requires value but no one has been provided");
+ throw MissingOptionValue("Option: " + name + " requires value but no one has been provided");
}
std::stringstream ss;
-
ss << argv.substr(pos + 1);
ss >> value;
if (ss.fail()) {
- throw std::invalid_argument("Value for option: " + name + " failed conversion to the required type");
+ throw OptionFailedConversion("Value for option: " + name + " failed conversion to the required type");
}
- used = true;
+ return true;
+ }
+ return false;
+ }
+ };
+
+ /**
+ * Template class responsible for handling commandline options.
+ * Options are non-required, named parameters of program.
+ * This template specialization allows Options to work like switches.
+ * It means that just named parameter is needed to invoke command. No value
+ * is used.
+ *
+ * Example:
+ * ./myprog OptionName
+ * ./myprog -h
+ * ./myprog --help
+ */
+ template<>
+ class Option<void>
+ : public Parameter, public Callable<void> {
+ public:
+ typedef std::string OptionName;
+ protected:
+ /**
+ * Current Option name
+ */
+ const OptionName name;
+ public:
+ /**
+ * Default constructor.
+ *
+ * @param name Name of the current Option
+ * @param description Description of current Option
+ * @param function Function used to handle current Option.
+ */
+ Option(const std::string & name, const std::string & description, void (*function)(void))
+ : Parameter(description), Callable<void>(function), name(name) {
+ }
+
+ /**
+ *
+ */
+ virtual void handle() {
+ this->call();
+ used = true;
+ }
+
+ /**
+ * Method used for checking if Option understands given user value.
+ * If so, current Option is flagged as used and no more checks against
+ * it will be done in future.
+ *
+ * Passed value should be in form of:
+ * OptionName
+ *
+ * @param argv command line value against which test will be made.
+ * User value should be in format: OptionName.
+ *
+ * @return If passed argv succesfully detected OptionName returns true
+ * and Option is set as used one. Otherwise returns false and can be
+ * used to check against next value.
+ */
+ virtual bool understand(const std::string & argv) {
+ if (argv == name) {
return true;
}
return false;