Files
klammertext/mac/argv.h
Andy Kopra 8a2699a253 Typed arguments, calculated tables, spans, closed-world fonts, top-level fnt/ and env/
Sync with klammertext-dev through b90b0e09:

- Argument types end to end: :python_cast values are applied (Python
  @eval receives real bools/numbers/lists), argument values are
  validated against their argtype patterns with the argtype's
  description as the error message, argtypes can declare :default
  (overridable per declaration), and parameterized type families are
  supported: rest(N) casts a rest argument to an N-dimensional list
  (bar-count = dimension).
- Unified indexed_range syntax (selector with parenthesized subsets,
  composable mnemonic names) for table lines and spans.
- Table klammer: caption fonts fixed in both targets, :column_width /
  :leading / :colsep wired, :colspan and :rowspan render (HTML
  attributes; \multicolumn / \multirow), calculated cell values (:calc)
  with prefix operators, display-precision semantics, :calc_format and
  :decimal period|comma.
- Fonts: closed-world resolution on the Klammertext font store
  (infrastructure in mac/font_store; no Google Fonts links or fetch).
  Default fonts live in the top-level fnt/; additional fonts install
  into KLAMMERTEXT_FONTS directories via kdesc --font (list, samples,
  preview, install — classification by font metadata).  CSS font family
  names are quoted (digit-initial families were silently lost).
- Environment files moved from mac/env/ to the top-level env/; shell
  profiles source env/runtime.env.  Dead per-host variants removed.
- Container: fnt/ ships in the image; curl removed (no network use).
2026-07-22 18:17:43 +02:00

118 lines
4.4 KiB
C++

#pragma once
// Delusions of generality, but it's really just for Klammertext commands.
#include <map>
#include <set>
#include <ranges>
#include <algorithm>
#include <regex>
inline std::map<std::string, std::string> regex_symbols {
{"'text'", R"((^[^-](?:\s|.)*))" },
{"'word'", R"((([^\s]+)))" },
{"'list'", R"((^[^-]?(?:\s|.)*))" },
// {"int", R"((\d))" },
// {"ints", R"((\d[ \d]*))" },
{"'verbosity'", R"(([01234]))" },
// {"targets", R"((html|tex|pdf|txt))" },
//{"'katom_display'", R"((none ?|all ?|type ?|index ?|ignored ?|replaced ?)*)" },
{"'katom_display'", R"(( *|none|all|type|index|ignored|replaced)*)" },
};
inline std::map<std::string, std::string> regex_desc {
{"'verbosity'", "Verbosity during processing (0,1,2,3,4); default is 0." }
};
std::regex make_regex(const std::string& key);
class Arg
{
public:
std::string symbol();
void make_regex(const std::string& key);
std::string m_type {};
std::string m_name {};
std::string m_pattern {};
std::string m_rgx_symbol {};
std::regex m_rgx {};
std::string m_default_value {};
std::string m_parameter {};
std::string m_syntax {};
std::string m_desc {};
std::string m_value {};
};
std::ostream& operator<<(std::ostream& os, const Arg& arg);
class Argv
{
public:
static std::string delimiter;
void flag(const std::string& name, const std::string& desc);
void req(const std::string& name, const std::string& desc, const std::string& regex_pattern="'text'");
void opt(const std::string& name, const std::string& desc="", const std::string& parameter="", const std::string& default_value="", const std::string& regex_pattern="text");
// A variadic option: --name collects every following word up to the
// next -/-- token (zero or more). get(name) returns the words
// space-joined; given(name) distinguishes "--name with no words"
// from an absent --name. Used for subcommand-style interfaces
// (kdesc --font install <dir>).
void var(const std::string& name, const std::string& desc);
void update_width(Arg arg);
void check_flags_and_options(std::string command, std::vector<std::string>& words);
void parse_flags(std::vector<std::string>& words, std::map<std::string, std::string>& named_args);
void parse_optional(std::vector<std::string>& words, std::map<std::string, std::string>& named_args);
void parse_vars(std::vector<std::string>& words, std::map<std::string, std::string>& named_args);
// True when the named variadic option appeared on the command line
// (even with no following words).
bool given(const std::string& name) { return m_given.contains(name); };
void parse_positional(
std::string command, // std::vector<std::string> words,
std::string pos_args, std::map<std::string, std::string>& named_args);
std::map<std::string, std::string> classify_arguments(int argc, char* argv[], bool full_parse=true);
void check_required(
const std::vector<std::string>& req_args, const std::string& command_name);
void check_flags(const std::map<std::string, std::string>& arg_map, const std::string& command_name);
void parse(int argc, char* argv[], bool full_parse=true);
std::string get(const std::string& name, bool missing_is_error=true);
bool as_bool(const std::string& name);
int as_int(const std::string& name);
int as_integer_range(const std::string& name, int low, int high);
int as_verbosity(const std::string& name);
std::string as_string(const std::string& name);
std::vector<std::string> as_vector(const std::string& name);
std::pair<std::string, std::vector<std::string>> as_input(const std::string& name, bool allow_empty=false);
void usage_line(Arg arg);
void usage(const std::string& command_name);
void describe();
// void describe(Argv original);
bool is_flag(std::string name) {
return std::ranges::count(m_flag_names, name) > 0;
}
bool is_opt(std::string name) {
return std::ranges::count(m_opt_names, name) > 0;
}
std::string m_command {};
std::map<std::string, Arg> m_args {};
std::vector<std::string> m_names {};
std::vector<std::string> m_req_names {};
std::vector<std::string> m_flag_names {};
std::vector<std::string> m_opt_names {};
std::vector<std::string> m_var_names {};
std::set<std::string> m_given {};
std::vector<std::string> m_hyphen_markers {};
long unsigned int m_syntax_size = 0;
};