SNode.C
Loading...
Searching...
No Matches
ConfigInstance.cpp
Go to the documentation of this file.
1/*
2 * SNode.C - A Slim Toolkit for Network Communication
3 * Copyright (C) Volker Christian <me@vchrist.at>
4 * 2020, 2021, 2022, 2023, 2024, 2025
5 *
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU Lesser General Public License as published
8 * by the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
18 */
19
20/*
21 * MIT License
22 *
23 * Permission is hereby granted, free of charge, to any person obtaining a copy
24 * of this software and associated documentation files (the "Software"), to deal
25 * in the Software without restriction, including without limitation the rights
26 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
27 * copies of the Software, and to permit persons to whom the Software is
28 * furnished to do so, subject to the following conditions:
29 *
30 * The above copyright notice and this permission notice shall be included in
31 * all copies or substantial portions of the Software.
32 *
33 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
34 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
35 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
36 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
37 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
38 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
39 * THE SOFTWARE.
40 */
41
42#include "net/config/ConfigInstance.h"
43
44#ifndef DOXYGEN_SHOULD_SKIP_THIS
45
46#include "utils/Config.h"
47
48#include <cstddef>
49#include <functional>
50#include <memory>
51
52#ifdef __GNUC__
53#pragma GCC diagnostic push
54#pragma GCC diagnostic ignored "-Wfloat-equal"
55#ifdef __has_warning
56#if __has_warning("-Wweak-vtables")
57#pragma GCC diagnostic ignored "-Wweak-vtables"
58#endif
59#if __has_warning("-Wcovered-switch-default")
60#pragma GCC diagnostic ignored "-Wcovered-switch-default"
61#endif
62#endif
63#endif
64#include "utils/CLI11.hpp"
65#ifdef __GNUC__
66#pragma GCC diagnostic pop
67#endif
68
69#endif /* DOXYGEN_SHOULD_SKIP_THIS */
70
71namespace net::config {
72
73 const std::string ConfigInstance::nameAnonymous = "<anonymous>";
74
75 ConfigInstance::ConfigInstance(const std::string& instanceName, Role role)
76 : instanceName(instanceName)
77 , role(role) {
78 instanceSc = utils::Config::addInstance(instanceName,
79 std::string("Configuration for ")
80 .append(role == Role::SERVER ? "server" : "client")
81 .append(" instance '")
82 .append(instanceName)
83 .append("'"),
84 "Instances");
85
87 ->add_flag_function(
88 "--disabled{true}",
89 [this](std::size_t) {
90 utils::Config::disabled(instanceSc, disableOpt->as<bool>());
91 },
92 "Disable this instance")
93 ->multi_option_policy(CLI::MultiOptionPolicy::TakeLast)
94 ->trigger_on_parse()
95 ->default_str("false")
96 ->type_name("bool")
97 ->check(CLI::IsMember({"true", "false"}))
98 ->group(instanceSc->get_formatter()->get_label("Persistent Options"));
99 }
100
102 utils::Config::removeInstance(instanceSc);
103 }
104
106 return role;
107 }
108
109 const std::string& ConfigInstance::getInstanceName() const {
110 return instanceName.empty() ? nameAnonymous : instanceName;
111 }
112
113 void ConfigInstance::setInstanceName(const std::string& instanceName) {
114 this->instanceName = instanceName;
115 }
116
117 CLI::App* ConfigInstance::addSection(const std::string& name, const std::string& description, const std::string& group) {
118 CLI::App* sectionSc = instanceSc //
119 ->add_subcommand(name, description)
120 ->fallthrough()
121 ->configurable(false)
122 ->allow_extras(false)
123 ->group(group)
124 ->ignore_case(false)
125 ->disabled(this->instanceName.empty() || name.empty());
126
127 sectionSc //
128 ->option_defaults()
129 ->configurable(!sectionSc->get_disabled());
130
131 if (!sectionSc->get_disabled()) {
132 utils::Config::addStandardFlags(sectionSc);
133 utils::Config::addSimpleHelp(sectionSc);
134 }
135
136 return sectionSc;
137 }
138
139 void ConfigInstance::required(CLI::App* section, bool req) {
140 if (req != section->get_required()) {
141 if (req) {
143 instanceSc //
144 ->needs(section);
145 } else {
147 instanceSc //
148 ->remove_needs(section);
149 }
150
151 section //
152 ->required(req);
153 section //
154 ->ignore_case(req);
155
156 if (!getDisabled()) {
157 utils::Config::required(instanceSc, requiredCount > 0);
158 }
159 }
160 }
161
163 return requiredCount > 0;
164 }
165
166 CLI::App* ConfigInstance::getSection(const std::string& name, bool onlyGot, bool recursive) const {
167 CLI::App* resultSc = (instanceSc->got_subcommand(name) || !onlyGot) ? instanceSc->get_subcommand_no_throw(name) : nullptr;
168
169 if (resultSc == nullptr && recursive) {
170 CLI::App* parentSc = instanceSc->get_parent();
171 resultSc =
172 (parentSc != nullptr && (parentSc->got_subcommand(name) || !onlyGot)) ? parentSc->get_subcommand_no_throw(name) : nullptr;
173 }
174
175 return resultSc;
176 }
177
178 bool ConfigInstance::gotSection(const std::string& name, bool recursive) const {
179 return instanceSc //
180 ->got_subcommand(name) ||
181 (recursive && instanceSc->get_parent()->got_subcommand(name));
182 }
183
185 return disableOpt //
186 ->as<bool>();
187 }
188
189 void ConfigInstance::setDisabled(bool disabled) {
190 disableOpt //
191 ->default_str(disabled ? "true" : "false")
192 ->clear();
193
194 utils::Config::disabled(instanceSc, disabled);
195 }
196
197} // namespace net::config
CLI::App * addSection(const std::string &name, const std::string &description, const std::string &group="Sections")
CLI::App * getSection(const std::string &name, bool onlyGot=false, bool recursive=false) const
void setDisabled(bool disabled=true)
void setInstanceName(const std::string &instanceName)
ConfigInstance(const std::string &instanceName, Role role)
static const std::string nameAnonymous
const std::string & getInstanceName() const
bool gotSection(const std::string &name, bool recursive=false) const
void required(CLI::App *section, bool req=true)