CLI.cpp

#include <fstream>
#include <functional>
#include <iostream>
#include <limits>
#include <map>
#include <sstream>
#include <string>

#include "CLI.h"
#include "Error.h"
#include "Param.h"

void parse_string(std::string const& input, std::string& output)
{
	output = input;
}

void parse_read_file(std::string const& input, std::string& output)
{
	// check to see if the file exists and error out if it doesn't
	if (static_cast<bool>(std::ifstream(input)) == false)
	{
		ERR_CRITICAL_FMT("%s is not a file\n", input.c_str());
	}
	output = input;
}

void parse_write_dir(std::string const& input, std::string& output)
{
	// check to see if this prefix already exists as a file and error out
	if (static_cast<bool>(std::ifstream(input)) == true)
	{
		ERR_CRITICAL_FMT("Cannot use this prefix, this path already exists"
						 " as a file: %s\n", input.c_str());
	}
	// TODO: add a platform-independent check to see if the prefix could
	// be added as a directory or file
	output = input;
}

void parse_integer(std::string const& input, int& output)
{
	try
	{
		std::size_t pos;
		output = std::stoi(input, &pos);
		if (pos != input.size())
		{
			ERR_CRITICAL_FMT("Detected invalid characters after parsed integer: %s\n", input.c_str());
		}
	}
	catch (const std::invalid_argument& e)
	{
		ERR_CRITICAL_FMT("%s: Expected integer got %s\n", input.c_str(), e.what());
	}
	catch (const std::out_of_range& e)
	{
		ERR_CRITICAL_FMT("%s: Input integer is out of range. Expected %d to %d. Got %s\n", e.what(),
						std::numeric_limits<int>::min(), std::numeric_limits<int>::max(), input.c_str());
	}
}

void parse_double(std::string const& input, double& output)
{
	try
	{
		std::size_t pos;
		output = std::stod(input, &pos);
		if (pos != input.size())
		{
			ERR_CRITICAL_FMT("Detected invalid characters after parsed double: %s\n", input.c_str());
		}
	}
	catch (const std::invalid_argument& e)
	{
		ERR_CRITICAL_FMT("%s, expected double got %s\n", e.what(), input.c_str());
	}
	catch (const std::out_of_range& e)
	{
		ERR_CRITICAL_FMT("%s: Input integer is out of range. Expected %.4e to %.4e. Got %s\n",
						e.what(), std::numeric_limits<double>::min(), std::numeric_limits<double>::max(), input.c_str());
	}
}

void CmdLineArgs::add_custom_option(std::string const& option, ParserFn func, std::string const& doc)
{
	if (option_map_.find(option) != option_map_.cend())
	{
		ERR_CRITICAL_FMT("Duplicate option specified %s\n", option.c_str());
	}
	option_map_.emplace(option, func);
	doc_map_.emplace(option, doc);
}

void CmdLineArgs::add_double_option(std::string const& option, double& output, std::string const& doc)
{
	add_custom_option(option, std::bind(parse_double, std::placeholders::_1, std::ref(output)), doc);
}

void CmdLineArgs::add_integer_option(std::string const& option, int& output, std::string const& doc)
{
	add_custom_option(option, std::bind(parse_integer, std::placeholders::_1, std::ref(output)), doc);
}

void CmdLineArgs::add_string_option(std::string const& option, StringParserFn func, std::string& output, std::string const& doc)
{
	add_custom_option(option, std::bind(func, std::placeholders::_1, std::ref(output)), doc);
}

void CmdLineArgs::parse(int argc, char* argv[], Param& params)
{
	// Detect if the user wants to print out the full help output
	if (argc >= 2)
	{
		std::string first(argv[1]);
		if (first.length() == 2 && first.compare("/H") == 0)
		{
			print_detailed_help_and_exit();
		}
	}
	if (argc < 7)
	{
		std::cerr << "Minimum number of arguments not met. Expected 6 got "
				  << (argc - 1) << "\n" << std::endl;
		print_help_and_exit();
	}

	// Get seeds.
	int i = argc - 4;
	parse_integer(argv[i], params.setupSeed1);
	parse_integer(argv[i+1], params.setupSeed2);
	parse_integer(argv[i+2], params.runSeed1);
	parse_integer(argv[i+3], params.runSeed2);

	for (i = 1; i < argc - 4; i++)
	{
		std::string argument(argv[i]);
		if (argument[0] != '/')
		{
			std::cerr << "Argument \"" << argument << "\" does not start with '/'" << std::endl;
			print_help_and_exit();
		}
		auto pos = argument.find_first_of(':');
		if (pos == std::string::npos)
		{
			std::cerr << "Argument \"" << argument << "\" did not have a ':' character" << std::endl;
			print_help_and_exit();
		}
		std::string option = argument.substr(1, pos - 1); // everything after / and up to :
		std::string value = argument.substr(pos + 1); // everything after :

		auto it = option_map_.find(option);
		if (it == option_map_.cend())
		{
			std::cout << "Unknown option \"" << option << "\". Skipping" << std::endl;
			continue;
		}

		it->second(value);
	}
}

static const std::string USAGE =
R"(SetupSeed1 SetupSeed2 RunSeed1 RunSeed2

All '/' arguments are followed by a colon ':' and then the value.
More detailed information can be found in docs/inputs-and-outputs.md.
)";

static const std::string DETAILED_USAGE =
R"(Named arguments:

		SetupSeed*	  RNG seeds when initializing
		RunSeed*		RNG seeds when running

Optional arguments:
)";

void CmdLineArgs::print_help()
{
	// Wes: Temporary hack to reduce the number of /CLP: on the help text.
	int clp_flag = 0;
	const std::string CLP = "CLP";
	std::stringstream ss;

	ss << "CovidSim";
	for (auto const& it : option_map_)
	{
		std::string option = it.first;
		std::string option_first_3 = option.substr(0, 3);

		if (option_first_3.compare(CLP) == 0) {
			if (clp_flag == 0) {
				ss << " [/CLP:00] .. [/CLP:99]";
				clp_flag = 1;
			}
		}
		else {
			ss << " [/" << option << ']';
		}
	}
	std::cerr << ss.str() << ' ' << USAGE << std::endl;
}

void CmdLineArgs::print_help_and_exit()
{
	print_help();
	std::cerr << "Use the '/H' argument to get a detailed listing of arguments." << std::endl;
	std::exit(1);
}

void CmdLineArgs::print_detailed_help()
{
	print_help();
	std::stringstream ss;
	for (auto const& it : doc_map_)
	{
		ss << '\t' << it.first << '\t' << it.second << '\n';
	}
	std::cerr << DETAILED_USAGE << '\n' << ss.str() << std::endl;
}

void CmdLineArgs::print_detailed_help_and_exit()
{
	print_detailed_help();
	std::exit(1);
}