ores.cpp.service-app.config_parser_impl

{{! GENERATED FILE — tangled from projects/ores.codegen/library/templates/cpp_service_app.org. Edit the org source. }}
{{{cpp_license}}}
{{#component}}
#include "{{full_name}}/config/parser.hpp"

#include <ostream>
#include <boost/program_options.hpp>
#include <boost/throw_exception.hpp>
#include "{{full_name}}/config/parser_exception.hpp"
#include "ores.service/config/standard_service_options.hpp"
#include "ores.utility/version/version.hpp"

namespace {

const std::string more_information("Try '--help' for more information.");
const std::string product_version("{{full_name}} v" ORES_VERSION);
const std::string build_info(ores::utility::version::build_info());
const std::string usage_error_msg("Usage error: ");

using boost::program_options::options_description;

using {{namespace}}::config::options;
using {{namespace}}::config::parser_exception;

void print_help(const options_description& od, std::ostream& info) {
    info << "{{brief}}" << std::endl << std::endl
         << "Usage: {{full_name}} [options]" << std::endl << std::endl
         << od << std::endl;
}

void version(std::ostream& info) {
    info << product_version << std::endl
         << "Copyright (C) 2026 Marco Craveiro." << std::endl
         << "License GPLv3: GNU GPL version 3 or later "
         << "<http://gnu.org/licenses/gpl.html>." << std::endl
         << "This is free software: you are free to change and redistribute it."
         << std::endl << "There is NO WARRANTY, to the extent permitted by law."
         << std::endl;

    if (!build_info.empty()) {
        info << build_info << std::endl;
        info << "IMPORTANT: build details are NOT for security purposes."
             << std::endl;
    }
}

std::optional<options>
parse_arguments(const std::vector<std::string>& arguments, std::ostream& info) {
    using ores::service::config::standard_service_options;

    // Add any app-specific options here and pass them as the second
    // argument to make_options_description, e.g.:
    //   options_description my_opts("My options");
    //   my_opts.add_options()(...);
    //   const auto od(standard_service_options::make_options_description(
    //       "{{full_name}}.log", my_opts));
    const auto od(standard_service_options::make_options_description("{{full_name}}.log"));
    const auto vm(standard_service_options::parse(od, arguments, "SERVICE"));

    if (standard_service_options::wants_help(vm)) {
        print_help(od, info);
        return {};
    }

    if (standard_service_options::wants_version(vm)) {
        version(info);
        return {};
    }

    const auto std_opts(standard_service_options::read_options(vm));
    options r;
    r.logging = std_opts.logging;
    r.nats = std_opts.nats;
    r.database = std_opts.database;
    return r;
}

}

namespace {{namespace}}::config {

std::optional<options>
parser::parse(const std::vector<std::string>& arguments,
    std::ostream& info, std::ostream& err) const {

    try {
        return parse_arguments(arguments, info);
    } catch(const parser_exception& e) {
        err << usage_error_msg << e.what() << std::endl
            << more_information << std::endl;
        BOOST_THROW_EXCEPTION(e);
    } catch (const boost::program_options::error& e) {
        err << usage_error_msg << e.what() << std::endl
            << more_information << std::endl;
        BOOST_THROW_EXCEPTION(parser_exception(e.what()));
    }
}

}
{{/component}}