cli.h

Go to the documentation of this file.

 
#pragma once
 
#include <algorithm>
#include <optional>
#include <span>
#include <string>
#include <string_view>
#include <vector>
 
#include <rex/platform.h>
#include <rex/types.h>
 
namespace rex {
 
struct CLIOption {
  std::string name;
  std::optional<std::string> value;
};

class REX_API CLIArgList {
 public:
  static CLIArgList Parse(i32 argc, char** argv);

  static CLIArgList Parse(std::span<const std::string> args);

  bool Has(std::string_view name) const;

  std::optional<std::string_view> Get(std::string_view name) const;

  std::span<const CLIOption> GetOptions() const;

  std::span<const std::string> GetPositionals() const;

  std::span<const std::string> GetAll() const;
 
 private:
  std::vector<std::string> all_;
  std::vector<CLIOption> options_;
  std::vector<std::string> positionals_;
};

struct CLIAction {
  std::string_view name; 
  std::string_view description;
};
 
struct CLIActionHit {
  CLIAction action;
  CLIOption option;
};
 
namespace detail {

constexpr bool IsActionChar(char c) {
  return (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_' || c == '-';
}

constexpr bool IsActionName(std::string_view name) {
  return !name.empty() && name.front() >= 'a' && name.front() <= 'z' &&
         std::ranges::all_of(name, IsActionChar);
}

consteval CLIAction MakeAction(std::string_view name, std::string_view description) {
  if (!IsActionName(name)) {
    throw "an action name is lowercase letters, digits, underscores and hyphens";
  }
  return CLIAction{name, description};
}
 
}  // namespace detail
 
}  // namespace rex

#define REX_CLI_ACTION(name, description) ::rex::detail::MakeAction(#name, description)