Subversion Repositories tpanel

/*

 * Copyright (C) 2020, 2021 by Andreas Theofilu <andreas@theosys.at>

 *

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation; either version 3 of the License, or

 * (at your option) any later version.

 *

 * This program 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 General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA

 */

#include <iostream>

#include <iomanip>

#include <string>

#include <vector>

#include <algorithm>

#include "tconfig.h"

#include "tsettings.h"

#include "tpagelist.h"

#include "tpage.h"

#include "tsubpage.h"

#include "tpagemanager.h"

#include "tqtmain.h"

using std::string;

using std::find;

using std::vector;

using std::cout;

using std::endl;

/**

 * @class InputParser

 * @brief The InputParser class parses the command line.

 *

 * This class takes the command line arguments and parses them. It creates an

 * internal vector array to hold the parameters.

 */

class InputParser

{

    public:

        /**

         * @brief InputParser is the constructor.

         *

         * The constructor requires the command line parameters. It immediately

         * starts to parse each parameter. It it finds the string `--` it stops

         * and ignores the rest of parameters. \p argc contains the rest of

         * the parameters after `--`, if there are any.

         *

         * @param argc  A pointer to the numbers of command line parameters.

         *              This parameter must not be `NULL`.

         * @param argv  The 2 dimensional array of command line parameters.

         *              This parameter must not be `NULL`.

         */

        InputParser(int *argc, char **argv)

        {

            int i;

            for (i = 1; i < *argc; ++i)

            {

                if (string(argv[i]).compare("--") == 0)

                    break;

                this->tokens.push_back(string(argv[i]));

            }

            *argc -= i;

            if (*argc <= 1)

                *argc = 1;

            else

            {

                *argc = *argc + 1;

                *(argv + i - 1) = *argv;

            }

        }

        /**

         * @brief getCmdOption searches for the command line option \p option.

         * @author iain

         *

         * The method searches for the command line option \p option and

         * returns the parameter after the option, if there is one.

         *

         * @param option    The name of a command line option. This is any

         *                  name starting with 1 or 2 dash (-). The name in

         *                  the parameter must include the dash(es) in front

         *                  of the name.\n

         *                  If the option was found and the next parameter on

         *                  the command line doesn't start with a dash, the

         *                  parameter is returned.

         *

         * @return Tf the option was found and the parameter on the command

         * line following the option doesn't start with a dash, it is returned.

         * Otherwise an empty string is returned.

         */

        const string& getCmdOption(const string &option) const

        {

            vector<string>::const_iterator itr;

            itr = find(this->tokens.begin(), this->tokens.end(), option);

            if (itr != this->tokens.end() && ++itr != this->tokens.end())

                return *itr;

            static const string empty_string("");

            return empty_string;

        }

        /**

         * @brief cmdOptionExists tests for an existing option.

         * @author iain

         *

         * This function tests whether the option \p option exists or not. If

         * the option was found, it returnes `true`.

         *

         * @param option    The name of a command line option. This is any

         *                  name starting with 1 or 2 dash (-). The name in

         *                  the parameter must include the dash(es) in front

         *                  of the name.\n

         *

         * @return If the command line option was found in the internal vector

         * array `true` is returned. Otherwise it returnes `false`.

         */

        bool cmdOptionExists(const string &option) const

        {

            return find(this->tokens.begin(), this->tokens.end(), option) != this->tokens.end();

        }

    private:

        vector <string> tokens;

};

/**

 * @brief usage displays on the standard output a small help.

 *

 * This function shows a short help with all available parameters and a brief

 * description of them.

 * \verbatim

 * NOTE: This function is not available on Android systems.

 * \endverbatim

 */

void usage()

{

#ifndef __ANDROID__

    cout << TConfig::getProgName() << " version " <<  V_MAJOR << "."  << V_MINOR << "." << V_PATCH << endl << endl;

    cout << "Usage: tpanel [-c <config file>]" << endl;

    cout << "-c | --config-file <file> The path and name of the configuration file." << endl;

    cout << "                          This parameter is optional. If it is omitted," << endl;

    cout << "                          The standard path is searched for the" << endl;

    cout << "                          configuration file." << endl << endl;

    cout << "-h | --help               This help." << endl << endl;

#endif

}

/**

 * @brief banner displays a shor banner with informations about this application.

 *

 * This function shows a short information about this application. It prints

 * this on the standard output.

 * \verbatim

 * NOTE: This function is not available on Android systems.

 * \endverbatim

 *

 * @param pname The name of this application.

 */

void banner(const string& pname)

{

#ifdef __ANDROID__

    return;

#else

    if (!TConfig::showBanner())

        return;

    cout << pname << " v" << V_MAJOR << "."  << V_MINOR << "." << V_PATCH << endl;

    cout << "(C) Andreas Theofilu <andreas@theosys.at>" << endl;

    cout << "This program is under the terms of GPL version 3" << endl << endl;

#endif

}

/**

 * @brief main is the main entry function.

 *

 * This is where the program starts.

 *

 * @param argc  The number of command line arguments.

 * @param argv  A pointer to a 2 dimensional array containing the command line

 *              parameters.

 *

 * @return 0 on success. This means that no errors occured.\n

 * In case of an error a number grater than 0 is returned.

 */

int main(int argc, char *argv[])

{

    string configFile;

    string pname = *argv;

    size_t pos = pname.find_last_of("/");

    if (pos != string::npos)

        pname = pname.substr(pos + 1);

    TConfig::setProgName(pname);    // Remember the name of this application.

    int oldArgc = argc;

    InputParser input(&argc, argv); // Parse the command line parameters.

    // Evaluate the command line parameters.

    if (input.cmdOptionExists("-h") || input.cmdOptionExists("--help"))

    {

        banner(pname);

        usage();

        return 0;

    }

    if (input.cmdOptionExists("-c") || input.cmdOptionExists("--config-file"))

    {

        configFile = input.getCmdOption("-c");

        if (configFile.empty())

            configFile = input.getCmdOption("--config-file");

        if (configFile.empty())

        {

            banner(pname);

            std::cerr << "Missing the path and name of the configuration file!" << std::endl;

            usage();

            return 1;

        }

    }

    TError::clear();                    // Clear all errors (initialize)

    TConfig config(configFile);         // Read the configuration file.

    if (TError::isError())              // Exit if the previous command failed.

        return 1;

    banner(pname);

    TError::clear();

    // Read in the pages

    TPageManager pageManager;

    if (TError::isError())

        return 1;

    // Prepare command line stack

    int pt = oldArgc - argc;

    // Start the graphical environment

    int ret = 0;

    if ((ret = qtmain(argc, &argv[pt], &pageManager)) != 0)

        return ret;

    return 0;

}