args.h

Go to the documentation of this file.

#ifndef ARGS_H
#define ARGS_H
 
#include <memory>
#include <optional>
#include <ostream>
#include <string>
#include <unordered_map>
#include <vector>
 
namespace mazes {
 
class args final {
public:
 
    static constexpr const char* ALGO_ID_FLAG_STR = "-a";
    static constexpr const char* ALGO_ID_OPTION_STR = "--algo";
    static constexpr const char* ALGO_ID_WORD_STR = "algo";
    static constexpr const char* ALGO_ID_SHORT_STR = "a";
 
    static constexpr const char* BLOCK_ID_FLAG_STR = "-b";
    static constexpr const char* BLOCK_ID_OPTION_STR = "--block";
    static constexpr const char* BLOCK_ID_WORD_STR = "block";
    static constexpr const char* BLOCK_ID_SHORT_STR = "b";
 
    static constexpr const char* ROW_FLAG_STR = "-r";
    static constexpr const char* ROW_OPTION_STR = "--rows";
    static constexpr const char* ROW_WORD_STR = "rows";
    static constexpr const char* ROW_SHORT_STR = "r";
    
    static constexpr const char* COLUMN_FLAG_STR = "-c";
    static constexpr const char* COLUMN_OPTION_STR = "--columns";
    static constexpr const char* COLUMN_WORD_STR = "columns";
    static constexpr const char* COLUMN_SHORT_STR = "c";
 
    static constexpr const char* LEVEL_FLAG_STR = "-l";
    static constexpr const char* LEVEL_OPTION_STR = "--levels";
    static constexpr const char* LEVEL_WORD_STR = "levels";
    static constexpr const char* LEVEL_SHORT_STR = "l";
    
    // JSON related constants
    static constexpr const char* JSON_FLAG_STR = "-j";
    static constexpr const char* JSON_OPTION_STR = "--json";
    static constexpr const char* JSON_WORD_STR = "json";
    static constexpr const char* JSON_SHORT_STR = "j";
    
    // Output related constants
    static constexpr const char* OUTPUT_ID_FLAG_STR = "-o";
    static constexpr const char* OUTPUT_ID_OPTION_STR = "--output";
    static constexpr const char* OUTPUT_ID_WORD_STR = "output";
    static constexpr const char* OUTPUT_ID_SHORT_STR = "o";
    static constexpr const char* DEFAULT_OUTPUT_FILENAME = "output.json";
    
    // Seed related constants
    static constexpr const char* SEED_FLAG_STR = "-s";
    static constexpr const char* SEED_OPTION_STR = "--seed";
    static constexpr const char* SEED_WORD_STR = "seed";
    static constexpr const char* SEED_SHORT_STR = "s";
    
    // Distances related constants
    static constexpr const char* DISTANCES_FLAG_STR = "-d";
    static constexpr const char* DISTANCES_OPTION_STR = "--distances";
    static constexpr const char* DISTANCES_WORD_STR = "distances";
    static constexpr const char* DISTANCES_SHORT_STR = "d";
    static constexpr const char* DISTANCES_START_STR = "distances_start";
    static constexpr const char* DISTANCES_END_STR = "distances_end";
    static constexpr const char* DISTANCES_DEFAULT_START = "0";
    static constexpr const char* DISTANCES_DEFAULT_END = "-1";
    
    // Help related constants
    static constexpr const char* HELP_FLAG_STR = "-h";
    static constexpr const char* HELP_OPTION_STR = "--help";
    static constexpr const char* HELP_WORD_STR = "help";
    static constexpr const char* HELP_SHORT_STR = "h";
    
    // Version related constants
    static constexpr const char* VERSION_FLAG_STR = "-v";
    static constexpr const char* VERSION_OPTION_STR = "--version";
    static constexpr const char* VERSION_WORD_STR = "version";
    static constexpr const char* VERSION_SHORT_STR = "v";
    
    // Special values
    static constexpr const char* TRUE_VALUE = "true";
 
    args() noexcept;
 
    ~args();
 
    args(const args& other);
 
    args& operator=(const args& other);
 
    args(args&& other) noexcept = default;
 
    args& operator=(args&& other) noexcept = default;
 
    bool parse(const std::vector<std::string>& arguments) noexcept;
 
    bool parse(const std::string& arguments) noexcept;
    
    bool parse(int argc, char** argv) noexcept;
 
    void clear() noexcept;
 
    std::optional<std::string> get(const std::string& key) const noexcept;
 
    const std::unordered_map<std::string, std::string>& get() const noexcept;
 
    bool has_multiple_configurations() const noexcept;
 
    size_t get_configuration_count() const noexcept;
 
    std::optional<std::unordered_map<std::string, std::string>> get_configuration(size_t index) const noexcept;
 
    std::vector<std::unordered_map<std::string, std::string>> get_all_configurations() const noexcept;
 
    bool add_option(const std::string& flags, const std::string& description) noexcept;
 
    bool add_flag(const std::string& flags, const std::string& description) noexcept;
 
private:
 
    bool parse_sliced_array(const std::string& value, std::unordered_map<std::string, std::string>& args_map) noexcept;
 
    std::string generate_output_filename(const std::string& input_value, bool is_string_input) const noexcept;
    
    bool process_json_input(const std::string& json_input, bool is_string_input, const std::string& key) noexcept;
    
    // Private implementation class (PIMPL idiom)
    class impl;
    std::unique_ptr<impl> pimpl;
};
 
}
#endif // ARGS_H