command.hpp

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Klaus Reimer <k@ailis.de>
// SPDX-License-Identifier: MIT
 
#pragma once
 
#include <cstddef>
#include <memory>
#include <optional>
#include <ostream>
#include <string>
#include <string_view>
#include <utility>
#include <vector>
 
#include <kaycxx/cli/args.hpp>
#include <kaycxx/cli/flag.hpp>
#include <kaycxx/cli/flag_handle.hpp>
#include <kaycxx/cli/option.hpp>
#include <kaycxx/cli/option_handle.hpp>
#include <kaycxx/cli/parameter.hpp>
#include <kaycxx/cli/parameter_base.hpp>
#include <kaycxx/cli/parameter_handle.hpp>
#include <kaycxx/cli/parameters.hpp>
#include <kaycxx/cli/parameters_handle.hpp>
#include <kaycxx/cli/repeatable_option_handle.hpp>
#include <kaycxx/cli/switch_base.hpp>
 
namespace kaycxx::cli {
 
struct command_options {
    std::optional<std::string_view> version = std::nullopt;
 
    std::optional<std::string_view> description = std::nullopt;
 
    std::optional<std::string_view> author = std::nullopt;
 
    std::optional<std::string_view> email = std::nullopt;
 
    std::optional<std::string_view> bugs = std::nullopt;
 
    std::optional<std::string_view> copyright = std::nullopt;
 
    std::optional<std::string_view> license = std::nullopt;
};
 
class command {
public:
    explicit command(std::string_view name, command_options options = command_options());
 
    command(command const&) = delete;
 
    command& operator=(command const&) = delete;
 
    command(command&& other) noexcept = default;
 
    command& operator=(command&& other) noexcept = default;
 
    [[nodiscard]] std::string const& name() const noexcept;
 
    [[nodiscard]] std::optional<std::string> const& version() const noexcept;
 
    [[nodiscard]] std::optional<std::string> const& author() const noexcept;
 
    [[nodiscard]] std::optional<std::string> const& email() const noexcept;
 
    [[nodiscard]] std::optional<std::string> const& bugs() const noexcept;
 
    [[nodiscard]] std::optional<std::string> const& copyright() const noexcept;
 
    [[nodiscard]] std::optional<std::string> const& license() const noexcept;
 
    [[nodiscard]] std::optional<std::string> const& description() const noexcept;
 
    [[nodiscard]] cli::flag_handle flag(std::string_view name, std::optional<std::string_view> description = std::nullopt);
 
    [[nodiscard]] cli::flag_handle flag(std::string_view name, char alias, std::optional<std::string_view> description = std::nullopt);
 
    template <parseable_value T>
    [[nodiscard]] cli::option_handle<T> option(
        std::string_view name,
        std::string_view value_name,
        std::optional<std::string_view> description = std::nullopt
    ) {
        auto item = std::make_unique<cli::option<T>>(name, value_name, description);
        auto& definition = *item;
        add_switch(std::move(item));
        return cli::option_handle<T>(definition);
    }
 
    template <parseable_value T>
    [[nodiscard]] cli::option_handle<T> option(
        std::string_view name,
        char alias,
        std::string_view value_name,
        std::optional<std::string_view> description = std::nullopt
    ) {
        auto item = std::make_unique<cli::option<T>>(name, alias, value_name, description);
        auto& definition = *item;
        add_switch(std::move(item));
        return cli::option_handle<T>(definition);
    }
 
    template <parseable_value T>
    [[nodiscard]] cli::repeatable_option_handle<T> repeatable_option(
        std::string_view name,
        std::string_view value_name,
        std::optional<std::string_view> description = std::nullopt
    ) {
        auto item = std::make_unique<cli::option<T>>(name, value_name, description);
        item->mark_as_repeatable();
        auto& definition = *item;
        add_switch(std::move(item));
        return cli::repeatable_option_handle<T>(definition);
    }
 
    template <parseable_value T>
    [[nodiscard]] cli::repeatable_option_handle<T> repeatable_option(
        std::string_view name,
        char alias,
        std::string_view value_name,
        std::optional<std::string_view> description = std::nullopt
    ) {
        auto item = std::make_unique<cli::option<T>>(name, alias, value_name, description);
        item->mark_as_repeatable();
        auto& definition = *item;
        add_switch(std::move(item));
        return cli::repeatable_option_handle<T>(definition);
    }
 
    template <parseable_value T>
    [[nodiscard]] cli::parameter_handle<T> parameter(std::string_view name, std::optional<std::string_view> description = std::nullopt) {
        auto item = std::make_unique<cli::parameter<T>>(name, description);
        auto& definition = *item;
        parameters_.push_back(std::move(item));
        return cli::parameter_handle<T>(definition);
    }
 
    template <parseable_value T>
    [[nodiscard]] cli::parameters_handle<T> parameters(std::string_view name, std::optional<std::string_view> description = std::nullopt) {
        auto item = std::make_unique<cli::parameters<T>>(name, description);
        auto& definition = *item;
        parameters_.push_back(std::move(item));
        return cli::parameters_handle<T>(definition);
    }
 
    [[nodiscard]] cli::args parse(int argc, char *argv[]) const;
 
    [[nodiscard]] int print_help() const;
 
    [[nodiscard]] int print_help(std::ostream& out) const;
 
    [[nodiscard]] int print_version() const;
 
    [[nodiscard]] int print_version(std::ostream& out) const;
 
private:
    void add_switch(std::unique_ptr<switch_base> item);
 
    [[nodiscard]] switch_base const* find_switch(std::string_view name) const noexcept;
 
    [[nodiscard]] switch_base const* find_switch(char alias) const noexcept;
 
    [[nodiscard]] bool has_described_switches() const noexcept;
 
    [[nodiscard]] bool has_described_parameters() const noexcept;
 
    [[nodiscard]] std::size_t max_switch_usage_length() const;
 
    [[nodiscard]] std::size_t max_parameter_usage_length() const;
 
    void apply_option_defaults(args& result) const;
 
    std::string name_;
 
    std::optional<std::string> version_;
 
    std::optional<std::string> author_;
 
    std::optional<std::string> email_;
 
    std::optional<std::string> bugs_;
 
    std::optional<std::string> copyright_;
 
    std::optional<std::string> license_;
 
    std::optional<std::string> description_;
 
    std::vector<std::unique_ptr<switch_base>> switches_;
 
    std::vector<std::unique_ptr<parameter_base>> parameters_;
};
 
} // namespace kaycxx::cli