cmdline.h

/***********************************************************************
 cmdline.h - Declares the interface to the MySQL++'s command line
        parsing logic, used by the examples and the utility programs.
        Not intended for use by third parties!  If it breaks, you
        get to keep all the pieces.
 
 Copyright (c) 2007-2009 by Educational Technology Resources, Inc.
 Others may also hold copyrights on code in this file.  See the
 CREDITS.txt file in the top directory of the distribution for details.
 
 This file is part of MySQL++.
 
 MySQL++ is free software; you can redistribute it and/or modify it
 under the terms of the GNU Lesser General Public License as published
 by the Free Software Foundation; either version 2.1 of the License, or
 (at your option) any later version.
 
 MySQL++ is distributed in the hope that it will be useful, but WITHOUT
 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
 License for more details.
 
 You should have received a copy of the GNU Lesser General Public
 License along with MySQL++; if not, write to the Free Software
 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
 USA
***********************************************************************/
 
#if !defined(MYSQLPP_CMDLINE_H)
#define MYSQLPP_CMDLINE_H
 
#include "common.h"
 
#include <string>
#include <vector>
 
#include <assert.h>
 
namespace mysqlpp {
        class MYSQLPP_EXPORT CommandLineBase
        {
        public:
                typedef std::vector<std::string> ArgumentList;
                typedef ArgumentList::const_iterator ArgumentListIt;
 
                const ArgumentList& extra_args() const 
                                { return extra_args_; }
 
                operator void*() const
                {
                        return successful_ ? const_cast<bool*>(&successful_) : 0;
                }
 
        protected:
                CommandLineBase(int argc, char* const argv[], const char* opts) :
                argc_(argc),
                argv_(argv),
                opts_(opts),
                successful_(argc > 0 && argv && opts)
                {
                        assert(successful_);
                }
                virtual ~CommandLineBase() { }
 
                void finish_parse();
 
                const char* option_argument() const;
                int option_index() const;
 
                void parse_error(const char* message = 0);
 
                int parse_next() const;
 
                virtual void print_usage() const = 0;
 
                const char* program_name() const { return argv_[0]; }
 
                bool successful() const { return successful_; }
 
        private:
                int argc_;
                char* const* argv_;
                const char* opts_;
                bool successful_;
                ArgumentList extra_args_;
        };
 
 
        namespace examples {
                extern MYSQLPP_EXPORT const char* db_name;
 
                class MYSQLPP_EXPORT CommandLine : public CommandLineBase
                {
                public:
                        CommandLine(int argc, char* const argv[],
                                        const char* user = 0, const char* pass = 0,
                                        const char* usage_extra = 0);
 
                        void print_usage() const { print_usage(usage_extra_); }
 
                        void print_usage(const char* extra) const;
 
                        bool dtest_mode() const { return dtest_mode_; }
 
                        const char* pass() const { return pass_; }
 
                        int run_mode() const { return run_mode_; }
 
                        const char* server() const { return server_; }
 
                        const char* user() const { return user_; }
 
                private:
                        // Examples-specific command line parse results
                        bool dtest_mode_;
                        int run_mode_;
                        const char* server_;
                        const char* user_;
                        const char* pass_;
                        const char* usage_extra_;
                };
        } // end namespace mysqlpp::examples
 
 
        namespace ssqlsxlat {
                class MYSQLPP_EXPORT CommandLine : public CommandLineBase
                {
                public:
                        enum SourceSink {
                                ss_unknown,     
                                ss_ssqls1,      
                                ss_ssqls2,      
                                ss_table        
                        };
 
                        CommandLine(int argc, char* const argv[]);
 
                        void print_usage() const;
 
                        const char* input() const { return input_; }
 
                        SourceSink input_source() const { return input_source_; }
 
                        SourceSink output_sink() const { return output_sink_; }
 
                        const char* output() const { return output_; }
 
                        const char* pass() const { return pass_; }
 
                        const char* server() const { return server_; }
 
                        const char* user() const { return user_; }
 
                private:
                        const char* input_;
                        const char* output_;
                        const char* pass_;
                        const char* server_;
                        const char* user_;
                        SourceSink input_source_;
                        SourceSink output_sink_;
                };
        } // end namespace mysqlpp::ssqlsxlat
} // end namespace mysqlpp
 
#endif // !defined(MYSQLPP_CMDLINE_H)