diff options
Diffstat (limited to 'migrate')
-rw-r--r-- | migrate/migrate-options.cxx | 955 | ||||
-rw-r--r-- | migrate/migrate-options.hxx | 420 | ||||
-rw-r--r-- | migrate/migrate-options.ixx | 263 |
3 files changed, 1638 insertions, 0 deletions
diff --git a/migrate/migrate-options.cxx b/migrate/migrate-options.cxx new file mode 100644 index 0000000..a8a4497 --- /dev/null +++ b/migrate/migrate-options.cxx @@ -0,0 +1,955 @@ +// -*- C++ -*- +// +// This file was generated by CLI, a command line interface +// compiler for C++. +// + +// Begin prologue. +// +// +// End prologue. + +#include <migrate/migrate-options.hxx> + +#include <map> +#include <set> +#include <string> +#include <vector> +#include <utility> +#include <ostream> +#include <sstream> +#include <cstring> + +namespace cli +{ + // unknown_option + // + unknown_option:: + ~unknown_option () noexcept + { + } + + void unknown_option:: + print (::std::ostream& os) const + { + os << "unknown option '" << option ().c_str () << "'"; + } + + const char* unknown_option:: + what () const noexcept + { + return "unknown option"; + } + + // unknown_argument + // + unknown_argument:: + ~unknown_argument () noexcept + { + } + + void unknown_argument:: + print (::std::ostream& os) const + { + os << "unknown argument '" << argument ().c_str () << "'"; + } + + const char* unknown_argument:: + what () const noexcept + { + return "unknown argument"; + } + + // missing_value + // + missing_value:: + ~missing_value () noexcept + { + } + + void missing_value:: + print (::std::ostream& os) const + { + os << "missing value for option '" << option ().c_str () << "'"; + } + + const char* missing_value:: + what () const noexcept + { + return "missing option value"; + } + + // invalid_value + // + invalid_value:: + ~invalid_value () noexcept + { + } + + void invalid_value:: + print (::std::ostream& os) const + { + os << "invalid value '" << value ().c_str () << "' for option '" + << option ().c_str () << "'"; + + if (!message ().empty ()) + os << ": " << message ().c_str (); + } + + const char* invalid_value:: + what () const noexcept + { + return "invalid option value"; + } + + // eos_reached + // + void eos_reached:: + print (::std::ostream& os) const + { + os << what (); + } + + const char* eos_reached:: + what () const noexcept + { + return "end of argument stream reached"; + } + + // scanner + // + scanner:: + ~scanner () + { + } + + // argv_scanner + // + bool argv_scanner:: + more () + { + return i_ < argc_; + } + + const char* argv_scanner:: + peek () + { + if (i_ < argc_) + return argv_[i_]; + else + throw eos_reached (); + } + + const char* argv_scanner:: + next () + { + if (i_ < argc_) + { + const char* r (argv_[i_]); + + if (erase_) + { + for (int i (i_ + 1); i < argc_; ++i) + argv_[i - 1] = argv_[i]; + + --argc_; + argv_[argc_] = 0; + } + else + ++i_; + + ++start_position_; + return r; + } + else + throw eos_reached (); + } + + void argv_scanner:: + skip () + { + if (i_ < argc_) + { + ++i_; + ++start_position_; + } + else + throw eos_reached (); + } + + std::size_t argv_scanner:: + position () + { + return start_position_; + } + + template <typename X> + struct parser + { + static void + parse (X& x, bool& xs, scanner& s) + { + using namespace std; + + const char* o (s.next ()); + if (s.more ()) + { + string v (s.next ()); + istringstream is (v); + if (!(is >> x && is.peek () == istringstream::traits_type::eof ())) + throw invalid_value (o, v); + } + else + throw missing_value (o); + + xs = true; + } + }; + + template <> + struct parser<bool> + { + static void + parse (bool& x, bool& xs, scanner& s) + { + const char* o (s.next ()); + + if (s.more ()) + { + const char* v (s.next ()); + + if (std::strcmp (v, "1") == 0 || + std::strcmp (v, "true") == 0 || + std::strcmp (v, "TRUE") == 0 || + std::strcmp (v, "True") == 0) + x = true; + else if (std::strcmp (v, "0") == 0 || + std::strcmp (v, "false") == 0 || + std::strcmp (v, "FALSE") == 0 || + std::strcmp (v, "False") == 0) + x = false; + else + throw invalid_value (o, v); + } + else + throw missing_value (o); + + xs = true; + } + }; + + template <> + struct parser<std::string> + { + static void + parse (std::string& x, bool& xs, scanner& s) + { + const char* o (s.next ()); + + if (s.more ()) + x = s.next (); + else + throw missing_value (o); + + xs = true; + } + }; + + template <typename X> + struct parser<std::pair<X, std::size_t> > + { + static void + parse (std::pair<X, std::size_t>& x, bool& xs, scanner& s) + { + x.second = s.position (); + parser<X>::parse (x.first, xs, s); + } + }; + + template <typename X> + struct parser<std::vector<X> > + { + static void + parse (std::vector<X>& c, bool& xs, scanner& s) + { + X x; + bool dummy; + parser<X>::parse (x, dummy, s); + c.push_back (x); + xs = true; + } + }; + + template <typename X, typename C> + struct parser<std::set<X, C> > + { + static void + parse (std::set<X, C>& c, bool& xs, scanner& s) + { + X x; + bool dummy; + parser<X>::parse (x, dummy, s); + c.insert (x); + xs = true; + } + }; + + template <typename K, typename V, typename C> + struct parser<std::map<K, V, C> > + { + static void + parse (std::map<K, V, C>& m, bool& xs, scanner& s) + { + const char* o (s.next ()); + + if (s.more ()) + { + std::size_t pos (s.position ()); + std::string ov (s.next ()); + std::string::size_type p = ov.find ('='); + + K k = K (); + V v = V (); + std::string kstr (ov, 0, p); + std::string vstr (ov, (p != std::string::npos ? p + 1 : ov.size ())); + + int ac (2); + char* av[] = + { + const_cast<char*> (o), + 0 + }; + + bool dummy; + if (!kstr.empty ()) + { + av[1] = const_cast<char*> (kstr.c_str ()); + argv_scanner s (0, ac, av, false, pos); + parser<K>::parse (k, dummy, s); + } + + if (!vstr.empty ()) + { + av[1] = const_cast<char*> (vstr.c_str ()); + argv_scanner s (0, ac, av, false, pos); + parser<V>::parse (v, dummy, s); + } + + m[k] = v; + } + else + throw missing_value (o); + + xs = true; + } + }; + + template <typename K, typename V, typename C> + struct parser<std::multimap<K, V, C> > + { + static void + parse (std::multimap<K, V, C>& m, bool& xs, scanner& s) + { + const char* o (s.next ()); + + if (s.more ()) + { + std::size_t pos (s.position ()); + std::string ov (s.next ()); + std::string::size_type p = ov.find ('='); + + K k = K (); + V v = V (); + std::string kstr (ov, 0, p); + std::string vstr (ov, (p != std::string::npos ? p + 1 : ov.size ())); + + int ac (2); + char* av[] = + { + const_cast<char*> (o), + 0 + }; + + bool dummy; + if (!kstr.empty ()) + { + av[1] = const_cast<char*> (kstr.c_str ()); + argv_scanner s (0, ac, av, false, pos); + parser<K>::parse (k, dummy, s); + } + + if (!vstr.empty ()) + { + av[1] = const_cast<char*> (vstr.c_str ()); + argv_scanner s (0, ac, av, false, pos); + parser<V>::parse (v, dummy, s); + } + + m.insert (typename std::multimap<K, V, C>::value_type (k, v)); + } + else + throw missing_value (o); + + xs = true; + } + }; + + template <typename X, typename T, T X::*M> + void + thunk (X& x, scanner& s) + { + parser<T>::parse (x.*M, s); + } + + template <typename X, bool X::*M> + void + thunk (X& x, scanner& s) + { + s.next (); + x.*M = true; + } + + template <typename X, typename T, T X::*M, bool X::*S> + void + thunk (X& x, scanner& s) + { + parser<T>::parse (x.*M, x.*S, s); + } +} + +#include <map> + +// options +// + +options:: +options () +: recreate_ (), + drop_ (), + db_user_ (), + db_user_specified_ (false), + db_password_ (), + db_password_specified_ (false), + db_name_ (), + db_name_specified_ (false), + db_host_ (), + db_host_specified_ (false), + db_port_ (0), + db_port_specified_ (false), + pager_ (), + pager_specified_ (false), + pager_option_ (), + pager_option_specified_ (false), + help_ (), + version_ () +{ +} + +options:: +options (int& argc, + char** argv, + bool erase, + ::cli::unknown_mode opt, + ::cli::unknown_mode arg) +: recreate_ (), + drop_ (), + db_user_ (), + db_user_specified_ (false), + db_password_ (), + db_password_specified_ (false), + db_name_ (), + db_name_specified_ (false), + db_host_ (), + db_host_specified_ (false), + db_port_ (0), + db_port_specified_ (false), + pager_ (), + pager_specified_ (false), + pager_option_ (), + pager_option_specified_ (false), + help_ (), + version_ () +{ + ::cli::argv_scanner s (argc, argv, erase); + _parse (s, opt, arg); +} + +options:: +options (int start, + int& argc, + char** argv, + bool erase, + ::cli::unknown_mode opt, + ::cli::unknown_mode arg) +: recreate_ (), + drop_ (), + db_user_ (), + db_user_specified_ (false), + db_password_ (), + db_password_specified_ (false), + db_name_ (), + db_name_specified_ (false), + db_host_ (), + db_host_specified_ (false), + db_port_ (0), + db_port_specified_ (false), + pager_ (), + pager_specified_ (false), + pager_option_ (), + pager_option_specified_ (false), + help_ (), + version_ () +{ + ::cli::argv_scanner s (start, argc, argv, erase); + _parse (s, opt, arg); +} + +options:: +options (int& argc, + char** argv, + int& end, + bool erase, + ::cli::unknown_mode opt, + ::cli::unknown_mode arg) +: recreate_ (), + drop_ (), + db_user_ (), + db_user_specified_ (false), + db_password_ (), + db_password_specified_ (false), + db_name_ (), + db_name_specified_ (false), + db_host_ (), + db_host_specified_ (false), + db_port_ (0), + db_port_specified_ (false), + pager_ (), + pager_specified_ (false), + pager_option_ (), + pager_option_specified_ (false), + help_ (), + version_ () +{ + ::cli::argv_scanner s (argc, argv, erase); + _parse (s, opt, arg); + end = s.end (); +} + +options:: +options (int start, + int& argc, + char** argv, + int& end, + bool erase, + ::cli::unknown_mode opt, + ::cli::unknown_mode arg) +: recreate_ (), + drop_ (), + db_user_ (), + db_user_specified_ (false), + db_password_ (), + db_password_specified_ (false), + db_name_ (), + db_name_specified_ (false), + db_host_ (), + db_host_specified_ (false), + db_port_ (0), + db_port_specified_ (false), + pager_ (), + pager_specified_ (false), + pager_option_ (), + pager_option_specified_ (false), + help_ (), + version_ () +{ + ::cli::argv_scanner s (start, argc, argv, erase); + _parse (s, opt, arg); + end = s.end (); +} + +options:: +options (::cli::scanner& s, + ::cli::unknown_mode opt, + ::cli::unknown_mode arg) +: recreate_ (), + drop_ (), + db_user_ (), + db_user_specified_ (false), + db_password_ (), + db_password_specified_ (false), + db_name_ (), + db_name_specified_ (false), + db_host_ (), + db_host_specified_ (false), + db_port_ (0), + db_port_specified_ (false), + pager_ (), + pager_specified_ (false), + pager_option_ (), + pager_option_specified_ (false), + help_ (), + version_ () +{ + _parse (s, opt, arg); +} + +::cli::usage_para options:: +print_usage (::std::ostream& os, ::cli::usage_para p) +{ + CLI_POTENTIALLY_UNUSED (os); + + if (p != ::cli::usage_para::none) + os << ::std::endl; + + os << "\033[1mOPTIONS\033[0m" << ::std::endl; + + os << std::endl + << "\033[1m--recreate\033[0m Recreate the database schema (all the existing data will be" << ::std::endl + << " lost)." << ::std::endl; + + os << std::endl + << "\033[1m--drop\033[0m Drop the database schema (all the existing data will be" << ::std::endl + << " lost)." << ::std::endl; + + os << std::endl + << "\033[1m--db-user\033[0m|\033[1m-u\033[0m \033[4muser\033[0m Database user name. If not specified, then operating system" << ::std::endl + << " (login) name is used." << ::std::endl; + + os << std::endl + << "\033[1m--db-password\033[0m \033[4mpass\033[0m Database password. If not specified, then login without" << ::std::endl + << " password is expected to work." << ::std::endl; + + os << std::endl + << "\033[1m--db-name\033[0m|\033[1m-n\033[0m \033[4mname\033[0m Database name. If not specified, then it is implicitly" << ::std::endl + << " derived by prefixing the schema name with \033[1mbrep_\033[0m." << ::std::endl; + + os << std::endl + << "\033[1m--db-host\033[0m|\033[1m-h\033[0m \033[4mhost\033[0m Database host name, address, or socket. If not specified," << ::std::endl + << " then connect to \033[1mlocalhost\033[0m using the operating system-default" << ::std::endl + << " mechanism (Unix-domain socket, etc)." << ::std::endl; + + os << std::endl + << "\033[1m--db-port\033[0m|\033[1m-p\033[0m \033[4mport\033[0m Database port number. If not specified, the default port is" << ::std::endl + << " used." << ::std::endl; + + os << std::endl + << "\033[1m--pager\033[0m \033[4mpath\033[0m The pager program to be used to show long text. Commonly" << ::std::endl + << " used pager programs are \033[1mless\033[0m and \033[1mmore\033[0m. You can also specify" << ::std::endl + << " additional options that should be passed to the pager" << ::std::endl + << " program with \033[1m--pager-option\033[0m. If an empty string is specified" << ::std::endl + << " as the pager program, then no pager will be used. If the" << ::std::endl + << " pager program is not explicitly specified, then" << ::std::endl + << " \033[1mbrep-migrate\033[0m will try to use \033[1mless\033[0m. If it is not available," << ::std::endl + << " then no pager will be used." << ::std::endl; + + os << std::endl + << "\033[1m--pager-option\033[0m \033[4mopt\033[0m Additional option to be passed to the pager program. See" << ::std::endl + << " \033[1m--pager\033[0m for more information on the pager program. Repeat" << ::std::endl + << " this option to specify multiple pager options." << ::std::endl; + + os << std::endl + << "\033[1m--help\033[0m Print usage information and exit." << ::std::endl; + + os << std::endl + << "\033[1m--version\033[0m Print version and exit." << ::std::endl; + + p = ::cli::usage_para::option; + + return p; +} + +typedef +std::map<std::string, void (*) (options&, ::cli::scanner&)> +_cli_options_map; + +static _cli_options_map _cli_options_map_; + +struct _cli_options_map_init +{ + _cli_options_map_init () + { + _cli_options_map_["--recreate"] = + &::cli::thunk< options, &options::recreate_ >; + _cli_options_map_["--drop"] = + &::cli::thunk< options, &options::drop_ >; + _cli_options_map_["--db-user"] = + &::cli::thunk< options, std::string, &options::db_user_, + &options::db_user_specified_ >; + _cli_options_map_["-u"] = + &::cli::thunk< options, std::string, &options::db_user_, + &options::db_user_specified_ >; + _cli_options_map_["--db-password"] = + &::cli::thunk< options, std::string, &options::db_password_, + &options::db_password_specified_ >; + _cli_options_map_["--db-name"] = + &::cli::thunk< options, std::string, &options::db_name_, + &options::db_name_specified_ >; + _cli_options_map_["-n"] = + &::cli::thunk< options, std::string, &options::db_name_, + &options::db_name_specified_ >; + _cli_options_map_["--db-host"] = + &::cli::thunk< options, std::string, &options::db_host_, + &options::db_host_specified_ >; + _cli_options_map_["-h"] = + &::cli::thunk< options, std::string, &options::db_host_, + &options::db_host_specified_ >; + _cli_options_map_["--db-port"] = + &::cli::thunk< options, std::uint16_t, &options::db_port_, + &options::db_port_specified_ >; + _cli_options_map_["-p"] = + &::cli::thunk< options, std::uint16_t, &options::db_port_, + &options::db_port_specified_ >; + _cli_options_map_["--pager"] = + &::cli::thunk< options, std::string, &options::pager_, + &options::pager_specified_ >; + _cli_options_map_["--pager-option"] = + &::cli::thunk< options, std::vector<std::string>, &options::pager_option_, + &options::pager_option_specified_ >; + _cli_options_map_["--help"] = + &::cli::thunk< options, &options::help_ >; + _cli_options_map_["--version"] = + &::cli::thunk< options, &options::version_ >; + } +}; + +static _cli_options_map_init _cli_options_map_init_; + +bool options:: +_parse (const char* o, ::cli::scanner& s) +{ + _cli_options_map::const_iterator i (_cli_options_map_.find (o)); + + if (i != _cli_options_map_.end ()) + { + (*(i->second)) (*this, s); + return true; + } + + return false; +} + +bool options:: +_parse (::cli::scanner& s, + ::cli::unknown_mode opt_mode, + ::cli::unknown_mode arg_mode) +{ + // Can't skip combined flags (--no-combined-flags). + // + assert (opt_mode != ::cli::unknown_mode::skip); + + bool r = false; + bool opt = true; + + while (s.more ()) + { + const char* o = s.peek (); + + if (std::strcmp (o, "--") == 0) + { + opt = false; + s.skip (); + r = true; + continue; + } + + if (opt) + { + if (_parse (o, s)) + { + r = true; + continue; + } + + if (std::strncmp (o, "-", 1) == 0 && o[1] != '\0') + { + // Handle combined option values. + // + std::string co; + if (const char* v = std::strchr (o, '=')) + { + co.assign (o, 0, v - o); + ++v; + + int ac (2); + char* av[] = + { + const_cast<char*> (co.c_str ()), + const_cast<char*> (v) + }; + + ::cli::argv_scanner ns (0, ac, av); + + if (_parse (co.c_str (), ns)) + { + // Parsed the option but not its value? + // + if (ns.end () != 2) + throw ::cli::invalid_value (co, v); + + s.next (); + r = true; + continue; + } + else + { + // Set the unknown option and fall through. + // + o = co.c_str (); + } + } + + // Handle combined flags. + // + char cf[3]; + { + const char* p = o + 1; + for (; *p != '\0'; ++p) + { + if (!((*p >= 'a' && *p <= 'z') || + (*p >= 'A' && *p <= 'Z') || + (*p >= '0' && *p <= '9'))) + break; + } + + if (*p == '\0') + { + for (p = o + 1; *p != '\0'; ++p) + { + std::strcpy (cf, "-"); + cf[1] = *p; + cf[2] = '\0'; + + int ac (1); + char* av[] = + { + cf + }; + + ::cli::argv_scanner ns (0, ac, av); + + if (!_parse (cf, ns)) + break; + } + + if (*p == '\0') + { + // All handled. + // + s.next (); + r = true; + continue; + } + else + { + // Set the unknown option and fall through. + // + o = cf; + } + } + } + + switch (opt_mode) + { + case ::cli::unknown_mode::skip: + { + s.skip (); + r = true; + continue; + } + case ::cli::unknown_mode::stop: + { + break; + } + case ::cli::unknown_mode::fail: + { + throw ::cli::unknown_option (o); + } + } + + break; + } + } + + switch (arg_mode) + { + case ::cli::unknown_mode::skip: + { + s.skip (); + r = true; + continue; + } + case ::cli::unknown_mode::stop: + { + break; + } + case ::cli::unknown_mode::fail: + { + throw ::cli::unknown_argument (o); + } + } + + break; + } + + return r; +} + +::cli::usage_para +print_usage (::std::ostream& os, ::cli::usage_para p) +{ + CLI_POTENTIALLY_UNUSED (os); + + if (p != ::cli::usage_para::none) + os << ::std::endl; + + os << "\033[1mSYNOPSIS\033[0m" << ::std::endl + << ::std::endl + << "\033[1mbrep-migrate --help\033[0m" << ::std::endl + << "\033[1mbrep-migrate --version\033[0m" << ::std::endl + << "\033[1mbrep-migrate\033[0m [\033[4moptions\033[0m] \033[4mschema\033[0m\033[0m" << ::std::endl + << ::std::endl + << "\033[1mDESCRIPTION\033[0m" << ::std::endl + << ::std::endl + << "In its default mode \033[1mbrep-migrate\033[0m creates the database schema if it doesn't" << ::std::endl + << "already exist. Otherwise, it migrates the existing schema and data to the" << ::std::endl + << "current version, if needed. The valid schema names are \033[1mpackage\033[0m and \033[1mbuild\033[0m." << ::std::endl + << ::std::endl + << "If the \033[1m--recreate\033[0m option is specified, then \033[1mbrep-migrate\033[0m instead recreates the" << ::std::endl + << "database schema. That is, it drops all the existing tables (and their data) and" << ::std::endl + << "then creates them from scratch." << ::std::endl + << ::std::endl + << "If the \033[1m--drop\033[0m option is specified, then \033[1mbrep-migrate\033[0m drops all the existing" << ::std::endl + << "tables (and their data)." << ::std::endl + << ::std::endl + << "The \033[1m--recreate\033[0m and \033[1m--drop\033[0m options are mutually exclusive. When specified, they" << ::std::endl + << "will cause \033[1mbrep-migrate\033[0m to fail if the database schema requires migration. In" << ::std::endl + << "this case you can either migrate the database first or drop the entire database" << ::std::endl + << "using, for example, \033[1mpsql(1)\033[0m." << ::std::endl; + + p = ::options::print_usage (os, ::cli::usage_para::text); + + if (p != ::cli::usage_para::none) + os << ::std::endl; + + os << "\033[1mEXIT STATUS\033[0m" << ::std::endl + << ::std::endl + << "\033[1m0\033[0m" << ::std::endl + << " Success." << ::std::endl + << "\033[1m1\033[0m" << ::std::endl + << " Fatal error." << ::std::endl + << "\033[1m2\033[0m" << ::std::endl + << " An instance of \033[1mbrep-migrate\033[0m or some other \033[1mbrep\033[0m utility is already running." << ::std::endl + << " Try again." << ::std::endl + << "\033[1m3\033[0m" << ::std::endl + << " Recoverable database error. Try again." << ::std::endl; + + p = ::cli::usage_para::text; + + return p; +} + +// Begin epilogue. +// +// +// End epilogue. + diff --git a/migrate/migrate-options.hxx b/migrate/migrate-options.hxx new file mode 100644 index 0000000..f901e93 --- /dev/null +++ b/migrate/migrate-options.hxx @@ -0,0 +1,420 @@ +// -*- C++ -*- +// +// This file was generated by CLI, a command line interface +// compiler for C++. +// + +#ifndef MIGRATE_MIGRATE_OPTIONS_HXX +#define MIGRATE_MIGRATE_OPTIONS_HXX + +// Begin prologue. +// +// +// End prologue. + +#include <iosfwd> +#include <string> +#include <cstddef> +#include <exception> + +#ifndef CLI_POTENTIALLY_UNUSED +# if defined(_MSC_VER) || defined(__xlC__) +# define CLI_POTENTIALLY_UNUSED(x) (void*)&x +# else +# define CLI_POTENTIALLY_UNUSED(x) (void)x +# endif +#endif + +namespace cli +{ + class usage_para + { + public: + enum value + { + none, + text, + option + }; + + usage_para (value); + + operator value () const + { + return v_; + } + + private: + value v_; + }; + + class unknown_mode + { + public: + enum value + { + skip, + stop, + fail + }; + + unknown_mode (value); + + operator value () const + { + return v_; + } + + private: + value v_; + }; + + // Exceptions. + // + + class exception: public std::exception + { + public: + virtual void + print (::std::ostream&) const = 0; + }; + + ::std::ostream& + operator<< (::std::ostream&, const exception&); + + class unknown_option: public exception + { + public: + virtual + ~unknown_option () noexcept; + + unknown_option (const std::string& option); + + const std::string& + option () const; + + virtual void + print (::std::ostream&) const; + + virtual const char* + what () const noexcept; + + private: + std::string option_; + }; + + class unknown_argument: public exception + { + public: + virtual + ~unknown_argument () noexcept; + + unknown_argument (const std::string& argument); + + const std::string& + argument () const; + + virtual void + print (::std::ostream&) const; + + virtual const char* + what () const noexcept; + + private: + std::string argument_; + }; + + class missing_value: public exception + { + public: + virtual + ~missing_value () noexcept; + + missing_value (const std::string& option); + + const std::string& + option () const; + + virtual void + print (::std::ostream&) const; + + virtual const char* + what () const noexcept; + + private: + std::string option_; + }; + + class invalid_value: public exception + { + public: + virtual + ~invalid_value () noexcept; + + invalid_value (const std::string& option, + const std::string& value, + const std::string& message = std::string ()); + + const std::string& + option () const; + + const std::string& + value () const; + + const std::string& + message () const; + + virtual void + print (::std::ostream&) const; + + virtual const char* + what () const noexcept; + + private: + std::string option_; + std::string value_; + std::string message_; + }; + + class eos_reached: public exception + { + public: + virtual void + print (::std::ostream&) const; + + virtual const char* + what () const noexcept; + }; + + // Command line argument scanner interface. + // + // The values returned by next() are guaranteed to be valid + // for the two previous arguments up until a call to a third + // peek() or next(). + // + // The position() function returns a monotonically-increasing + // number which, if stored, can later be used to determine the + // relative position of the argument returned by the following + // call to next(). Note that if multiple scanners are used to + // extract arguments from multiple sources, then the end + // position of the previous scanner should be used as the + // start position of the next. + // + class scanner + { + public: + virtual + ~scanner (); + + virtual bool + more () = 0; + + virtual const char* + peek () = 0; + + virtual const char* + next () = 0; + + virtual void + skip () = 0; + + virtual std::size_t + position () = 0; + }; + + class argv_scanner: public scanner + { + public: + argv_scanner (int& argc, + char** argv, + bool erase = false, + std::size_t start_position = 0); + + argv_scanner (int start, + int& argc, + char** argv, + bool erase = false, + std::size_t start_position = 0); + + int + end () const; + + virtual bool + more (); + + virtual const char* + peek (); + + virtual const char* + next (); + + virtual void + skip (); + + virtual std::size_t + position (); + + protected: + std::size_t start_position_; + int i_; + int& argc_; + char** argv_; + bool erase_; + }; + + template <typename X> + struct parser; +} + +#include <vector> + +#include <string> + +#include <cstdint> + +class options +{ + public: + options (); + + options (int& argc, + char** argv, + bool erase = false, + ::cli::unknown_mode option = ::cli::unknown_mode::fail, + ::cli::unknown_mode argument = ::cli::unknown_mode::stop); + + options (int start, + int& argc, + char** argv, + bool erase = false, + ::cli::unknown_mode option = ::cli::unknown_mode::fail, + ::cli::unknown_mode argument = ::cli::unknown_mode::stop); + + options (int& argc, + char** argv, + int& end, + bool erase = false, + ::cli::unknown_mode option = ::cli::unknown_mode::fail, + ::cli::unknown_mode argument = ::cli::unknown_mode::stop); + + options (int start, + int& argc, + char** argv, + int& end, + bool erase = false, + ::cli::unknown_mode option = ::cli::unknown_mode::fail, + ::cli::unknown_mode argument = ::cli::unknown_mode::stop); + + options (::cli::scanner&, + ::cli::unknown_mode option = ::cli::unknown_mode::fail, + ::cli::unknown_mode argument = ::cli::unknown_mode::stop); + + // Option accessors. + // + const bool& + recreate () const; + + const bool& + drop () const; + + const std::string& + db_user () const; + + bool + db_user_specified () const; + + const std::string& + db_password () const; + + bool + db_password_specified () const; + + const std::string& + db_name () const; + + bool + db_name_specified () const; + + const std::string& + db_host () const; + + bool + db_host_specified () const; + + const std::uint16_t& + db_port () const; + + bool + db_port_specified () const; + + const std::string& + pager () const; + + bool + pager_specified () const; + + const std::vector<std::string>& + pager_option () const; + + bool + pager_option_specified () const; + + const bool& + help () const; + + const bool& + version () const; + + // Print usage information. + // + static ::cli::usage_para + print_usage (::std::ostream&, + ::cli::usage_para = ::cli::usage_para::none); + + // Implementation details. + // + protected: + bool + _parse (const char*, ::cli::scanner&); + + private: + bool + _parse (::cli::scanner&, + ::cli::unknown_mode option, + ::cli::unknown_mode argument); + + public: + bool recreate_; + bool drop_; + std::string db_user_; + bool db_user_specified_; + std::string db_password_; + bool db_password_specified_; + std::string db_name_; + bool db_name_specified_; + std::string db_host_; + bool db_host_specified_; + std::uint16_t db_port_; + bool db_port_specified_; + std::string pager_; + bool pager_specified_; + std::vector<std::string> pager_option_; + bool pager_option_specified_; + bool help_; + bool version_; +}; + +// Print page usage information. +// +::cli::usage_para +print_usage (::std::ostream&, + ::cli::usage_para = ::cli::usage_para::none); + +#include <migrate/migrate-options.ixx> + +// Begin epilogue. +// +// +// End epilogue. + +#endif // MIGRATE_MIGRATE_OPTIONS_HXX diff --git a/migrate/migrate-options.ixx b/migrate/migrate-options.ixx new file mode 100644 index 0000000..feebd8e --- /dev/null +++ b/migrate/migrate-options.ixx @@ -0,0 +1,263 @@ +// -*- C++ -*- +// +// This file was generated by CLI, a command line interface +// compiler for C++. +// + +// Begin prologue. +// +// +// End prologue. + +#include <cassert> + +namespace cli +{ + // usage_para + // + inline usage_para:: + usage_para (value v) + : v_ (v) + { + } + + // unknown_mode + // + inline unknown_mode:: + unknown_mode (value v) + : v_ (v) + { + } + + // exception + // + inline ::std::ostream& + operator<< (::std::ostream& os, const exception& e) + { + e.print (os); + return os; + } + + // unknown_option + // + inline unknown_option:: + unknown_option (const std::string& option) + : option_ (option) + { + } + + inline const std::string& unknown_option:: + option () const + { + return option_; + } + + // unknown_argument + // + inline unknown_argument:: + unknown_argument (const std::string& argument) + : argument_ (argument) + { + } + + inline const std::string& unknown_argument:: + argument () const + { + return argument_; + } + + // missing_value + // + inline missing_value:: + missing_value (const std::string& option) + : option_ (option) + { + } + + inline const std::string& missing_value:: + option () const + { + return option_; + } + + // invalid_value + // + inline invalid_value:: + invalid_value (const std::string& option, + const std::string& value, + const std::string& message) + : option_ (option), + value_ (value), + message_ (message) + { + } + + inline const std::string& invalid_value:: + option () const + { + return option_; + } + + inline const std::string& invalid_value:: + value () const + { + return value_; + } + + inline const std::string& invalid_value:: + message () const + { + return message_; + } + + // argv_scanner + // + inline argv_scanner:: + argv_scanner (int& argc, + char** argv, + bool erase, + std::size_t sp) + : start_position_ (sp + 1), + i_ (1), + argc_ (argc), + argv_ (argv), + erase_ (erase) + { + } + + inline argv_scanner:: + argv_scanner (int start, + int& argc, + char** argv, + bool erase, + std::size_t sp) + : start_position_ (sp + static_cast<std::size_t> (start)), + i_ (start), + argc_ (argc), + argv_ (argv), + erase_ (erase) + { + } + + inline int argv_scanner:: + end () const + { + return i_; + } +} + +// options +// + +inline const bool& options:: +recreate () const +{ + return this->recreate_; +} + +inline const bool& options:: +drop () const +{ + return this->drop_; +} + +inline const std::string& options:: +db_user () const +{ + return this->db_user_; +} + +inline bool options:: +db_user_specified () const +{ + return this->db_user_specified_; +} + +inline const std::string& options:: +db_password () const +{ + return this->db_password_; +} + +inline bool options:: +db_password_specified () const +{ + return this->db_password_specified_; +} + +inline const std::string& options:: +db_name () const +{ + return this->db_name_; +} + +inline bool options:: +db_name_specified () const +{ + return this->db_name_specified_; +} + +inline const std::string& options:: +db_host () const +{ + return this->db_host_; +} + +inline bool options:: +db_host_specified () const +{ + return this->db_host_specified_; +} + +inline const std::uint16_t& options:: +db_port () const +{ + return this->db_port_; +} + +inline bool options:: +db_port_specified () const +{ + return this->db_port_specified_; +} + +inline const std::string& options:: +pager () const +{ + return this->pager_; +} + +inline bool options:: +pager_specified () const +{ + return this->pager_specified_; +} + +inline const std::vector<std::string>& options:: +pager_option () const +{ + return this->pager_option_; +} + +inline bool options:: +pager_option_specified () const +{ + return this->pager_option_specified_; +} + +inline const bool& options:: +help () const +{ + return this->help_; +} + +inline const bool& options:: +version () const +{ + return this->version_; +} + +// Begin epilogue. +// +// +// End epilogue. |