clicamp.hpp

Go to the documentation of this file.

//==================================================================================================
/// \file
/// This header file is part of module \alib_cli of the \aliblong.
///
/// \emoji :copyright: 2013-2024 A-Worx GmbH, Germany.
/// Published under \ref mainpage_license "Boost Software License".
//==================================================================================================
#ifndef HPP_ALIB_CLI_CAMP
#define HPP_ALIB_CLI_CAMP 1
#pragma once
#include "alib/lang/message/exception.hpp"
#include "alib/lang/basecamp/camp.hpp"
 
ALIB_ASSERT_MODULE(CLI)
 
namespace alib {  namespace  cli {
 
class CommandLine;
 
//==================================================================================================
/// The module class for module \alib_cli_nl.
///
/// This is a strict singleton class. The only instance is found with namespace variable
/// \ref alib::CLI.
//==================================================================================================
class CliCamp : public lang::Camp
{
    public:
        //==========================================================================================
        /// Constructor.<br>
        /// While this is public, it must not be invoked as this is a strict singleton type.
        /// (See notes in \ref alib_manual_camp_modules_campmodule).
        //==========================================================================================
        CliCamp();
 
    protected:
        //==========================================================================================
        /// Initializes this camp.
        ///
        /// @param phase  The initialization phase to perform.
        //==========================================================================================
        virtual void    bootstrap( BootstrapPhases phase )                                 override;
 
        //==========================================================================================
        /// Terminates this camp. (Nothing to do.)
        /// @param phase  The shutdown phase to perform.
        //==========================================================================================
        virtual void    shutdown( ShutdownPhases phase )                override   { (void) phase; }
 
}; // class CliCamp
 
//==================================================================================================
/// Exceptions of module #alib::cli.
/// As usual with class \alib{lang;Exception}, some of the exceptions are "inner exceptions" that
/// are caught internally and re-thrown with more information and a different exception code.
///
/// The in this respect "external" exceptions that have to be caught by users of the library, are:
///
/// - \b %NoCommandGiven,
/// - \b %UnknownCommand,
/// - \b %ParsingOptions and
/// - \b %ParsingCommand.
//==================================================================================================
enum class Exceptions
{
    // main exceptions  to be handled by the user
    NoCommandGiven                = 1, ///< Unknown command given.
    UnknownCommand                = 2, ///< Unknown command given.
    ParsingOptions                =10, ///< General option parse error. Adds option help text.
    ParsingCommand                =20, ///< General parameter parse error. Adds command help text.
 
    // inner exceptions
    MissingOptionValue            =11, ///< Missing argument when reading option.
                                       ///< (Will be generalized with ParsingOptions.)
    IllegalOptionNameContinuation =12, ///< An option was given in long name, but continued after
                                       ///< its name in an undefined way.
                                       ///< (Will be generalized with ParsingOptions.)
 
    MissingParameterValue         =21, ///< Missing argument when reading parameter.
                                       ///< (Will be generalized with ParameterError.)
 
    END_OF_ENUM
};
 
//==================================================================================================
/// Dry run modes.
//==================================================================================================
enum class DryRunModes
{
    Off            , ///< No dry run
    CLIArgs        , ///< Displays the results of the command line argument parsing.
    CLIDeclarations, ///< Just displays the cli setup. This is more for debugging or interested users.
    Application    , ///< Dry run on application level: Given commands are invoked, nothing is
                     ///< executed, but probably log information is written. Application specific behavior.
                     ///< This is the default if no argument is given to the dry-run opton
};
 
 
} // namespace alib[::cli]
 
/// The singleton instance of \alibcamp class \alib{cli;CliCamp}.
extern ALIB_API cli::CliCamp CLI;
 
} // namespace [alib]
 
ALIB_ENUMS_ASSIGN_RECORD(   alib::cli::DryRunModes, alib::enums::ERSerializable )
ALIB_BOXING_VTABLE_DECLARE( alib::cli::Exceptions , vt_cli_exceptions )
ALIB_ENUMS_ASSIGN_RECORD(   alib::cli::Exceptions , alib::lang::ERException  )
ALIB_RESOURCED_IN_MODULE(   alib::cli::Exceptions , alib::CLI, "E"     )
 
#endif // HPP_ALIB_CLI_CAMP