arg_parser.h

Go to the documentation of this file.

// SPDX-License-Identifier: GPL-2.0-only
//
// Copyright (c) 2024-present FERS Contributors (see AUTHORS.md).
//
// See the GNU GPLv2 LICENSE file in the FERS project root for more information.
 
/**
 * @file arg_parser.h
 * @brief Command-line argument parsing utilities for the application.
 *
 * This header file provides utilities for parsing command-line arguments,
 * displaying help, version information, and configuring the application via a configuration structure.
 */
 
#pragma once
 
#include <cstdint>
#include <expected>
#include <libfers/api.h>
#include <optional>
#include <string>
#include <thread>
 
namespace core
{
    /**
     * @class Config
     * @brief Configuration structure for the application.
     */
    struct Config
    {
        std::string script_file; ///< Path to the script file.
        fers_log_level_t log_level = FERS_LOG_INFO; ///< Logging level.
        unsigned num_threads = std::thread::hardware_concurrency(); ///< Number of threads to use.
        bool validate = true; ///< Validate the input .fersxml file by default.
        std::optional<std::string> log_file; ///< Optional log file path for logging output.
        bool generate_kml = false; ///< Optional flag to generate KML visualization output.
        std::optional<std::string> kml_file; ///< Optional specific file path for KML output.
        std::optional<std::string> output_dir; ///< Optional output directory for simulation results.
        bool vita49_enabled = false; ///< True when VITA 49.2 UDP output is selected.
        std::string vita49_host; ///< VITA 49.2 UDP destination host.
        uint16_t vita49_port = 0; ///< VITA 49.2 UDP destination port.
        std::optional<double> vita49_fullscale; ///< Fixed ADC full-scale for VITA int16 IQ output.
        std::optional<uint64_t> vita49_epoch_unix_nanoseconds; ///< Optional deterministic VITA epoch.
        std::optional<uint16_t> vita49_max_udp_payload; ///< Optional VITA UDP payload cap in bytes.
        std::optional<uint32_t> vita49_queue_depth; ///< Optional VITA sender queue depth in packets.
    };
 
    /**
     * @brief Displays the help message.
     *
     * @param programName The name of the program.
     */
    void showHelp(const char* programName) noexcept;
 
    /**
     * @brief Displays the version information.
     */
    void showVersion() noexcept;
 
    /**
     * @brief Parses command-line arguments.
     *
     * Processes the command-line arguments, validating them and extracting
     * configurations like script file, logging level, and thread count.
     *
     * @param argc The argument count.
     * @param argv The argument vector.
     * @return std::expected<Config, std::string> Parsed configuration or an error message.
     */
    std::expected<Config, std::string> parseArguments(int argc, char* argv[]) noexcept;
}