CLI11
C++11 Command Line Interface Parser
Loading...
Searching...
No Matches
FormatterFwd.hpp
1// Copyright (c) 2017-2025, University of Cincinnati, developed by Henry Schreiner
2// under NSF AWARD 1414736 and by the respective contributors.
3// All rights reserved.
4//
5// SPDX-License-Identifier: BSD-3-Clause
6
7#pragma once
8
9// IWYU pragma: private, include "CLI/CLI.hpp"
10
11// [CLI11:public_includes:set]
12#include <functional>
13#include <map>
14#include <string>
15#include <utility>
16#include <vector>
17// [CLI11:public_includes:end]
18
19#include "StringTools.hpp"
20
21namespace CLI {
22// [CLI11:formatter_fwd_hpp:verbatim]
23
24class Option;
25class App;
26
31
32enum class AppFormatMode : std::uint8_t {
33 Normal,
34 All,
35 Sub,
36};
37
43 protected:
46
48 std::size_t column_width_{30};
49
51 std::size_t right_column_width_{65};
52
55
57 std::size_t footer_paragraph_width_{80};
58
61 bool enable_footer_formatting_{true};
62
65 std::map<std::string, std::string> labels_{};
66
70
71 public:
72 FormatterBase() = default;
73 FormatterBase(const FormatterBase &) = default;
74 FormatterBase(FormatterBase &&) = default;
75 FormatterBase &operator=(const FormatterBase &) = default;
76 FormatterBase &operator=(FormatterBase &&) = default;
77
79 virtual ~FormatterBase() noexcept {} // NOLINT(modernize-use-equals-default)
80
82 virtual std::string make_help(const App *, std::string, AppFormatMode) const = 0;
83
87
89 void label(std::string key, std::string val) { labels_[key] = val; }
90
92 void column_width(std::size_t val) { column_width_ = val; }
93
95 void right_column_width(std::size_t val) { right_column_width_ = val; }
96
99
101 void footer_paragraph_width(std::size_t val) { footer_paragraph_width_ = val; }
105 void enable_footer_formatting(bool value = true) { enable_footer_formatting_ = value; }
109
111 CLI11_NODISCARD std::string get_label(std::string key) const {
112 if(labels_.find(key) == labels_.end())
113 return key;
114 return labels_.at(key);
115 }
116
118 CLI11_NODISCARD std::size_t get_column_width() const { return column_width_; }
119
121 CLI11_NODISCARD std::size_t get_right_column_width() const { return right_column_width_; }
122
124 CLI11_NODISCARD std::size_t get_description_paragraph_width() const { return description_paragraph_width_; }
125
127 CLI11_NODISCARD std::size_t get_footer_paragraph_width() const { return footer_paragraph_width_; }
128
131
133 CLI11_NODISCARD bool is_footer_paragraph_formatting_enabled() const { return enable_footer_formatting_; }
134
136};
137
139class FormatterLambda final : public FormatterBase {
140 using funct_t = std::function<std::string(const App *, std::string, AppFormatMode)>;
141
143 funct_t lambda_;
144
145 public:
147 explicit FormatterLambda(funct_t funct) : lambda_(std::move(funct)) {}
148
150 ~FormatterLambda() noexcept override {} // NOLINT(modernize-use-equals-default)
151
153 std::string make_help(const App *app, std::string name, AppFormatMode mode) const override {
154 return lambda_(app, name, mode);
155 }
156};
157
160class Formatter : public FormatterBase {
161 public:
162 Formatter() = default;
163 Formatter(const Formatter &) = default;
164 Formatter(Formatter &&) = default;
165 Formatter &operator=(const Formatter &) = default;
166 Formatter &operator=(Formatter &&) = default;
167
170
173 CLI11_NODISCARD virtual std::string
174 make_group(std::string group, bool is_positional, std::vector<const Option *> opts) const;
175
177 virtual std::string make_positionals(const App *app) const;
178
180 std::string make_groups(const App *app, AppFormatMode mode) const;
181
183 virtual std::string make_subcommands(const App *app, AppFormatMode mode) const;
184
186 virtual std::string make_subcommand(const App *sub) const;
187
189 virtual std::string make_expanded(const App *sub, AppFormatMode mode) const;
190
192 virtual std::string make_footer(const App *app) const;
193
195 virtual std::string make_description(const App *app) const;
196
198 virtual std::string make_usage(const App *app, std::string name) const;
199
201 std::string make_help(const App *app, std::string, AppFormatMode mode) const override;
202
206
208 virtual std::string make_option(const Option *, bool) const;
209
211 virtual std::string make_option_name(const Option *, bool) const;
212
214 virtual std::string make_option_opts(const Option *) const;
215
217 virtual std::string make_option_desc(const Option *) const;
218
220 virtual std::string make_option_usage(const Option *opt) const;
221
223};
224
225// [CLI11:formatter_fwd_hpp:end]
226} // namespace CLI
Creates a command line program, with very few defaults.
Definition App.hpp:98
Definition FormatterFwd.hpp:42
void footer_paragraph_width(std::size_t val)
Set the footer paragraph width.
Definition FormatterFwd.hpp:101
std::size_t column_width_
The width of the left column (options/flags/subcommands)
Definition FormatterFwd.hpp:48
void right_column_width(std::size_t val)
Set the right column width (description of options/flags/subcommands)
Definition FormatterFwd.hpp:95
std::map< std::string, std::string > labels_
The required help printout labels (user changeable) Values are Needs, Excludes, etc.
Definition FormatterFwd.hpp:65
std::size_t footer_paragraph_width_
The width of the footer paragraph.
Definition FormatterFwd.hpp:57
CLI11_NODISCARD std::size_t get_column_width() const
Get the current left column width (options/flags/subcommands)
Definition FormatterFwd.hpp:118
CLI11_NODISCARD std::size_t get_footer_paragraph_width() const
Get the current footer paragraph width.
Definition FormatterFwd.hpp:127
CLI11_NODISCARD std::string get_label(std::string key) const
Get the current value of a name (REQUIRED, etc.)
Definition FormatterFwd.hpp:111
CLI11_NODISCARD std::size_t get_description_paragraph_width() const
Get the current description paragraph width at the top of help.
Definition FormatterFwd.hpp:124
void enable_description_formatting(bool value=true)
enable formatting for description paragraph
Definition FormatterFwd.hpp:103
void label(std::string key, std::string val)
Set the "REQUIRED" or other labels.
Definition FormatterFwd.hpp:89
bool enable_description_formatting_
options controlling formatting for footer and descriptions
Definition FormatterFwd.hpp:60
void enable_footer_formatting(bool value=true)
disable formatting for footer paragraph
Definition FormatterFwd.hpp:105
CLI11_NODISCARD bool is_description_paragraph_formatting_enabled() const
Get the current status of description paragraph formatting.
Definition FormatterFwd.hpp:130
CLI11_NODISCARD std::size_t get_right_column_width() const
Get the current right column width (description of options/flags/subcommands)
Definition FormatterFwd.hpp:121
virtual ~FormatterBase() noexcept
Adding a destructor in this form to work around bug in GCC 4.7.
Definition FormatterFwd.hpp:79
virtual std::string make_help(const App *, std::string, AppFormatMode) const =0
This is the key method that puts together help.
void column_width(std::size_t val)
Set the left column width (options/flags/subcommands)
Definition FormatterFwd.hpp:92
std::size_t right_column_width_
The width of the right column (description of options/flags/subcommands)
Definition FormatterFwd.hpp:51
std::size_t description_paragraph_width_
The width of the description paragraph at the top of help.
Definition FormatterFwd.hpp:54
CLI11_NODISCARD bool is_footer_paragraph_formatting_enabled() const
Get the current status of whether footer paragraph formatting is enabled.
Definition FormatterFwd.hpp:133
void description_paragraph_width(std::size_t val)
Set the description paragraph width at the top of help.
Definition FormatterFwd.hpp:98
Definition FormatterFwd.hpp:160
std::string make_groups(const App *app, AppFormatMode mode) const
This prints out all the groups of options.
Definition Formatter_inl.hpp:45
virtual std::string make_usage(const App *app, std::string name) const
This displays the usage line.
Definition Formatter_inl.hpp:95
virtual std::string make_option_name(const Option *, bool) const
This is the name part of an option, Default: left column.
Definition Formatter_inl.hpp:355
virtual std::string make_expanded(const App *sub, AppFormatMode mode) const
This prints out a subcommand in help-all.
Definition Formatter_inl.hpp:238
std::string make_help(const App *app, std::string, AppFormatMode mode) const override
This puts everything together.
Definition Formatter_inl.hpp:154
virtual CLI11_NODISCARD std::string make_group(std::string group, bool is_positional, std::vector< const Option * > opts) const
Definition Formatter_inl.hpp:24
virtual std::string make_option(const Option *, bool) const
This prints out an option help line, either positional or optional form.
Definition Formatter_inl.hpp:265
virtual std::string make_footer(const App *app) const
This prints out all the groups of options.
Definition Formatter_inl.hpp:146
virtual std::string make_option_usage(const Option *opt) const
This is used to print the name on the USAGE line.
Definition Formatter_inl.hpp:399
virtual std::string make_subcommand(const App *sub) const
This prints out a subcommand.
Definition Formatter_inl.hpp:227
virtual std::string make_positionals(const App *app) const
This prints out just the positionals "group".
Definition Formatter_inl.hpp:35
virtual std::string make_subcommands(const App *app, AppFormatMode mode) const
This prints out all the subcommands.
Definition Formatter_inl.hpp:185
virtual std::string make_description(const App *app) const
This displays the description line.
Definition Formatter_inl.hpp:70
virtual std::string make_option_desc(const Option *) const
This is the description. Default: Right column, on new line if left column too large.
Definition Formatter_inl.hpp:397
virtual std::string make_option_opts(const Option *) const
This is the options part of the name, Default: combined into left column.
Definition Formatter_inl.hpp:362
This is a specialty override for lambda functions.
Definition FormatterFwd.hpp:139
std::string make_help(const App *app, std::string name, AppFormatMode mode) const override
This will simply call the lambda function.
Definition FormatterFwd.hpp:153
~FormatterLambda() noexcept override
Adding a destructor (mostly to make GCC 4.7 happy)
Definition FormatterFwd.hpp:150
FormatterLambda(funct_t funct)
Create a FormatterLambda with a lambda function.
Definition FormatterFwd.hpp:147
Definition Option.hpp:231