1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
// -*- mode:C++; tab-width:8; c-basic-offset:2; indent-tabs-mode:t -*-
// vim: ts=8 sw=2 smarttab
#include "tools/rbd/OptionPrinter.h"
#include "tools/rbd/IndentStream.h"
#include "include/ceph_assert.h"
namespace rbd {
namespace po = boost::program_options;
const std::string OptionPrinter::POSITIONAL_ARGUMENTS("Positional arguments");
const std::string OptionPrinter::OPTIONAL_ARGUMENTS("Optional arguments");
const size_t OptionPrinter::MAX_DESCRIPTION_OFFSET;
OptionPrinter::OptionPrinter(const OptionsDescription &positional,
const OptionsDescription &optional)
: m_positional(positional), m_optional(optional) {
}
void OptionPrinter::print_short(std::ostream &os, size_t initial_offset) {
size_t max_option_width = 0;
std::vector<std::string> optionals;
for (size_t i = 0; i < m_optional.options().size(); ++i) {
std::stringstream option;
bool required = m_optional.options()[i]->semantic()->is_required();
if (!required) {
option << "[";
}
option << "--" << m_optional.options()[i]->long_name();
if (m_optional.options()[i]->semantic()->max_tokens() != 0) {
option << " <" << m_optional.options()[i]->long_name() << ">";
}
if (!required) {
option << "]";
}
max_option_width = std::max(max_option_width, option.str().size());
optionals.emplace_back(option.str());
}
std::vector<std::string> positionals;
for (size_t i = 0; i < m_positional.options().size(); ++i) {
std::stringstream option;
// we overload po::value<std::string>()->default_value("") to signify
// an optional positional argument (purely for help printing purposes)
boost::any v;
bool required = !m_positional.options()[i]->semantic()->apply_default(v);
if (!required) {
auto ptr = boost::any_cast<std::string>(&v);
ceph_assert(ptr && ptr->empty());
option << "[";
}
option << "<" << m_positional.options()[i]->long_name() << ">";
if (m_positional.options()[i]->semantic()->max_tokens() > 1) {
option << " [<" << m_positional.options()[i]->long_name() << "> ...]";
}
if (!required) {
option << "]";
}
max_option_width = std::max(max_option_width, option.str().size());
positionals.emplace_back(option.str());
if (m_positional.options()[i]->semantic()->max_tokens() > 1) {
break;
}
}
size_t indent = std::min(initial_offset, MAX_DESCRIPTION_OFFSET) + 1;
if (indent + max_option_width + 2 > LINE_WIDTH) {
// decrease the indent so that we don't wrap past the end of the line
indent = LINE_WIDTH - max_option_width - 2;
}
IndentStream indent_stream(indent, initial_offset, LINE_WIDTH, os);
indent_stream.set_delimiter("[");
for (auto& option : optionals) {
indent_stream << option << " ";
}
if (optionals.size() > 0 || positionals.size() == 0) {
indent_stream << std::endl;
}
if (positionals.size() > 0) {
indent_stream.set_delimiter(" ");
for (auto& option : positionals) {
indent_stream << option << " ";
}
indent_stream << std::endl;
}
}
void OptionPrinter::print_optional(const OptionsDescription &global_opts,
size_t &name_width, std::ostream &os) {
std::string indent2(2, ' ');
for (size_t i = 0; i < global_opts.options().size(); ++i) {
std::string description = global_opts.options()[i]->description();
auto result = boost::find_first(description, "deprecated");
if (!result.empty()) {
continue;
}
std::stringstream ss;
ss << indent2
<< global_opts.options()[i]->format_name() << " "
<< global_opts.options()[i]->format_parameter();
std::cout << ss.str();
IndentStream indent_stream(name_width, ss.str().size(), LINE_WIDTH, std::cout);
indent_stream << global_opts.options()[i]->description() << std::endl;
}
}
void OptionPrinter::print_detailed(std::ostream &os) {
std::string indent_prefix(2, ' ');
size_t name_width = compute_name_width(indent_prefix.size());
if (m_positional.options().size() > 0) {
std::cout << POSITIONAL_ARGUMENTS << std::endl;
for (size_t i = 0; i < m_positional.options().size(); ++i) {
std::stringstream ss;
ss << indent_prefix << "<" << m_positional.options()[i]->long_name()
<< ">";
std::cout << ss.str();
IndentStream indent_stream(name_width, ss.str().size(), LINE_WIDTH, os);
indent_stream << m_positional.options()[i]->description() << std::endl;
}
std::cout << std::endl;
}
if (m_optional.options().size() > 0) {
std::cout << OPTIONAL_ARGUMENTS << std::endl;
print_optional(m_optional, name_width, os);
std::cout << std::endl;
}
}
size_t OptionPrinter::compute_name_width(size_t indent) {
size_t width = MIN_NAME_WIDTH;
std::vector<OptionsDescription> descs = {m_positional, m_optional};
for (size_t desc_idx = 0; desc_idx < descs.size(); ++desc_idx) {
const OptionsDescription &desc = descs[desc_idx];
for (size_t opt_idx = 0; opt_idx < desc.options().size(); ++opt_idx) {
size_t name_width = desc.options()[opt_idx]->format_name().size() +
desc.options()[opt_idx]->format_parameter().size()
+ 1;
width = std::max(width, name_width);
}
}
width += indent;
width = std::min(width, MAX_DESCRIPTION_OFFSET) + 1;
return width;
}
} // namespace rbd
|
