The Battle for Wesnoth  1.15.12+dev
commandline_options.hpp
Go to the documentation of this file.
1 /*
2  Copyright (C) 2011 - 2018 by Lukasz Dobrogowski <lukasz.dobrogowski@gmail.com>
3  Part of the Battle for Wesnoth Project https://www.wesnoth.org/
4 
5  This program is free software; you can redistribute it and/or modify
6  it under the terms of the GNU General Public License as published by
7  the Free Software Foundation; either version 2 of the License, or
8  (at your option) any later version.
9  This program is distributed in the hope that it will be useful,
10  but WITHOUT ANY WARRANTY.
11 
12  See the COPYING file for more details.
13 */
14 
15 #pragma once
16 
17 #include <optional>
18 
19 #include <boost/program_options/options_description.hpp>
20 #include <iosfwd> // for ostream
21 #include <string> // for string
22 #include <tuple>
23 #include <vector> // for vector
24 
26 {
27 public:
28  bad_commandline_resolution(const std::string& resolution);
29 };
30 
32 {
33 public:
34  bad_commandline_tuple(const std::string& str,
35  const std::string& expected_format);
36 };
37 
38 class config;
39 
41 {
42  /** To be used for printing help to the commandline. */
43  friend std::ostream& operator<<(std::ostream &os, const commandline_options& cmdline_opts);
44 
45 public:
46  commandline_options(const std::vector<std::string>& args);
47 
48  config to_config() const; /* Used by lua scrips. Not all of the options need to be exposed here, just those exposed to lua */
49 
50  /** True if the --validate or any of the --validate-* options are given. */
51  bool any_validation_option() const;
52 
53  /** Non-empty if --bunzip2 was given on the command line. Uncompresses a .bz2 file and exits. */
54  std::optional<std::string> bunzip2;
55  /** Non-empty if --bzip2 was given on the command line. Compresses a file to .bz2 and exits. */
56  std::optional<std::string> bzip2;
57  /** Non-empty if --campaign was given on the command line. ID of the campaign we want to start. */
58  std::optional<std::string> campaign;
59  /** Non-empty if --campaign-difficulty was given on the command line. Numerical difficulty of the campaign to be played. Dependent on --campaign. */
60  std::optional<int> campaign_difficulty;
61  /** Non-empty if --campaign-scenario was given on the command line. Chooses starting scenario in the campaign to be played. Dependent on --campaign. */
62  std::optional<std::string> campaign_scenario;
63  /** True if --skip-story was given on the command line. Skips [story] and [message]s through the end of the "start" event. Dependent on --campaign. */
65  /** True if --clock was given on the command line. Enables */
66  bool clock;
67  /** Non-empty if --core was given on the command line. Chooses the core to be loaded. */
68  std::optional<std::string> core_id;
69  /** True if --data-path was given on the command line. Prints path to data directory and exits. */
70  bool data_path;
71  /** Non-empty if --data-dir was given on the command line. Sets the config dir to the specified one. */
72  std::optional<std::string> data_dir;
73  /** True if --debug was given on the command line. Enables debug mode. */
74  bool debug;
75  /** True if --debug-lua was given in the commandline. Enables some Lua debugging mechanisms. */
76  bool debug_lua;
77  /** True if --strict-lua was given in the commandline. Disallows use of deprecated APIs. */
78  bool strict_lua;
79 #ifdef DEBUG_WINDOW_LAYOUT_GRAPHS
80  /** Non-empty if --debug-dot-domain was given on the command line. */
81  std::optional<std::string> debug_dot_domain;
82  /** Non-empty if --debug-dot-level was given on the command line. */
83  std::optional<std::string> debug_dot_level;
84 #endif
85  /** Non-empty if --editor was given on the command line. Goes directly into editor. If string is longer than 0, it contains path to the file to edit. */
86  std::optional<std::string> editor;
87  /** True if --fps was given on the command line. Shows number of fps. */
88  bool fps;
89  /** True if --fullscreen was given on the command line. Starts Wesnoth in fullscreen mode. */
90  bool fullscreen;
91  /** Non-empty if --gunzip was given on the command line. Uncompresses a .gz file and exits. */
92  std::optional<std::string> gunzip;
93  /** Non-empty if --gzip was given on the command line. Compresses a file to .gz and exits. */
94  std::optional<std::string> gzip;
95  /** True if --help was given on the command line. Prints help and exits. */
96  bool help;
97  /** Non-empty if --language was given on the command line. Sets the language for this session. */
98  std::optional<std::string> language;
99  /**
100  * Contains parsed arguments of --log-* (e.g. --log-debug).
101  * Vector of pairs (severity, log domain).
102  */
103  std::optional<std::vector<std::pair<int, std::string>>> log;
104  /** Non-empty if --log-strict was given */
105  std::optional<int> log_strict_level;
106  /** Non-empty if --load was given on the command line. Savegame specified to load after start. */
107  std::optional<std::string> load;
108  /** Non-empty if --logdomains was given on the command line. Prints possible logdomains filtered by given string and exits. */
109  std::optional<std::string> logdomains;
110  /** True if --log-precise was given on the command line. Shows timestamps in log with more precision. */
112  /** True if --multiplayer was given on the command line. Goes directly into multiplayer mode. */
114  /** Non-empty if --ai-config was given on the command line. Vector of pairs (side number, value). Dependent on --multiplayer. */
115  std::optional<std::vector<std::pair<unsigned int, std::string>>> multiplayer_ai_config;
116  /** Non-empty if --algorithm was given on the command line. Vector of pairs (side number, value). Dependent on --multiplayer. */
117  std::optional<std::vector<std::pair<unsigned int, std::string>>> multiplayer_algorithm;
118  /** Non-empty if --controller was given on the command line. Vector of pairs (side number, controller). Dependent on --multiplayer. */
119  std::optional<std::vector<std::pair<unsigned int, std::string>>> multiplayer_controller;
120  /** Non-empty if --era was given on the command line. Dependent on --multiplayer. */
121  std::optional<std::string> multiplayer_era;
122  /** True if --exit-at-and was given on the command line. Dependent on --multiplayer. */
124  /** True if --ignore-map-settings was given at the command line. Do not use map settings. */
126  /** Non-empty if --label was given on the command line. Dependent on --multiplayer. */
127  std::optional<std::string> multiplayer_label;
128  /** Non-empty if --parm was given on the command line. Vector of pairs (side number, parm name, parm value). Dependent on --multiplayer. */
129  std::optional<std::vector<std::tuple<unsigned int, std::string, std::string>>> multiplayer_parm;
130  /** Repeats specified by --multiplayer-repeat option. Repeats a multiplayer game after it is finished. Dependent on --multiplayer. */
131  std::optional<unsigned int> multiplayer_repeat;
132  /** Non-empty if --scenario was given on the command line. Dependent on --multiplayer. */
133  std::optional<std::string> multiplayer_scenario;
134  /** Non-empty if --side was given on the command line. Vector of pairs (side number, faction id). Dependent on --multiplayer. */
135  std::optional<std::vector<std::pair<unsigned int, std::string>>> multiplayer_side;
136  /** Non-empty if --turns was given on the command line. Dependent on --multiplayer. */
137  std::optional<std::string> multiplayer_turns;
138  /** Max FPS specified by --max-fps option. */
139  std::optional<int> max_fps;
140  /** True if --noaddons was given on the command line. Disables the loading of all add-ons. */
141  bool noaddons;
142  /** True if --nocache was given on the command line. Disables cache usage. */
143  bool nocache;
144  /** True if --nodelay was given on the command line. */
145  bool nodelay;
146  /** True if --nogui was given on the command line. Disables GUI. */
147  bool nogui;
148  /** True if --nobanner was given on the command line. Disables startup banner. */
149  bool nobanner;
150  /** True if --nomusic was given on the command line. Disables music. */
151  bool nomusic;
152  /** True if --nosound was given on the command line. Disables sound. */
153  bool nosound;
154  /** True if --new-widgets was given on the command line. Hidden option to enable the new widget toolkit. */
156  /** True if --preprocess was given on the command line. Starts Wesnoth in preprocessor-only mode. */
158  /** Defines that were given to the --preprocess option. */
159  std::optional<std::vector<std::string>> preprocess_defines;
160  /** Non-empty if --preprocess-input-macros was given on the command line. Specifies a file that contains [preproc_define]s to be included before preprocessing. Dependent on --preprocess. */
161  std::optional<std::string> preprocess_input_macros;
162  /** Non-empty if --preprocess-output-macros was given on the command line. Outputs all preprocessed macros to the specified file. Dependent on --preprocess. */
163  std::optional<std::string> preprocess_output_macros;
164  /** Path to parse that was given to the --preprocess option. */
165  std::optional<std::string> preprocess_path;
166  /** Target (output) path that was given to the --preprocess option. */
167  std::optional<std::string> preprocess_target;
168  /** Pair of AxB values specified after --resolution. Changes Wesnoth resolution. */
169  std::optional<std::pair<int,int>> resolution;
170  /** RNG seed specified by --rng-seed option. Initializes RNG with given seed. */
171  std::optional<unsigned int> rng_seed;
172  /** Non-empty if --server was given on the command line. Connects Wesnoth to specified server. If no server was specified afterwards, contains an empty string. */
173  std::optional<std::string> server;
174  /** Non-empty if --username was given on the command line. Forces Wesnoth to use this network username. */
175  std::optional<std::string> username;
176  /** Non-empty if --password was given on the command line. Forces Wesnoth to use this network password. */
177  std::optional<std::string> password;
178  /** Image path to render. First parameter after --render-image */
179  std::optional<std::string> render_image;
180  /** Output file to put rendered image path in. Optional second parameter after --render-image */
181  std::optional<std::string> render_image_dst;
182  /** True if --screenshot was given on the command line. Starts Wesnoth in screenshot mode. */
184  /** Map file to make a screenshot of. First parameter given after --screenshot. */
185  std::optional<std::string> screenshot_map_file;
186  /** Output file to put screenshot in. Second parameter given after --screenshot. */
187  std::optional<std::string> screenshot_output_file;
188  /** File to load lua script from. */
189  std::optional<std::string> script_file;
190  /** File to load a lua plugin (similar to a script) from. Experimental / may replace script. */
191  std::optional<std::string> plugin_file;
192  /** Whether to load the "package" package for the scripting environment. (This allows to load arbitrary lua packages, and gives untrusted lua the same permissions as wesnoth executable) */
194  /** True if --strict-validation was given on the command line. Makes Wesnoth trust validation errors as fatal WML errors and create WML exception, if so. */
196  /** Non-empty if --test was given on the command line. Goes directly into test mode, into a scenario, if specified. */
197  std::optional<std::string> test;
198  /** Non-empty if --unit was given on the command line. Goes directly into unit test mode, into a scenario, if specified. */
199  std::vector<std::string> unit_test;
200  /** True if --unit is used and --showgui is not present. */
202  /** True if --noreplaycheck was given on the command line. Dependent on --unit. */
204  /** True if --mp-test was given on the command line. */
205  bool mptest;
206  /** True if --userconfig-path was given on the command line. Prints path to user config directory and exits. */
208  /** Non-empty if --userconfig-dir was given on the command line. Sets the user config dir to the specified one. */
209  std::optional<std::string> userconfig_dir;
210  /** True if --userdata-path was given on the command line. Prints path to user data directory and exits. */
212  /** Non-empty if --userdata-dir was given on the command line. Sets the user data dir to the specified one. */
213  std::optional<std::string> userdata_dir;
214  /** True if --validcache was given on the command line. Makes Wesnoth assume the cache is valid. */
216  /** True if --validate-core was given on the command line. Makes Wesnoth validate the core WML. */
218  /** Non-empty if --validate-addon was given on the command line. Makes Wesnoth validate an addon's WML. */
219  std::optional<std::string> validate_addon;
220  /** Non-empty if --validate-schema was given on the command line. Makes Wesnoth validate a WML schema. */
221  std::optional<std::string> validate_schema;
222  /** Non-empty if --validate was given on the command line. Makes Wesnoth validate a WML file against a schema. */
223  std::optional<std::string> validate_wml;
224  /** Non-empty if --use-schema was given on the command line. Specifies the schema for use with --validate. */
225  std::optional<std::string> validate_with;
226  /** Output filename for WML diff or preprocessing */
227  std::optional<std::string> output_file;
228  bool do_diff, do_patch;
229  /** Files for diffing or patching */
230  std::string diff_left, diff_right;
231  /** True if --version was given on the command line. Prints version and exits. */
232  bool version;
233  /** True if --report was given on the command line. Prints a bug report-style info dump and exits. */
234  bool report;
235  /** True if --windowed was given on the command line. Starts Wesnoth in windowed mode. */
236  bool windowed;
237  /** True if --with-replay was given on the command line. Shows replay of the loaded file. */
239  /** Non-empty if --all-translations or --translations-over is given on the command line. */
240  std::optional<unsigned int> translation_percent;
241 private:
242  void parse_log_domains_(const std::string &domains_string, const int severity);
243  void parse_log_strictness (const std::string &severity);
244  void parse_resolution_ (const std::string &resolution_string);
245  /** A helper function splitting vector of strings of format unsigned int:string to vector of tuples (unsigned int,string) */
246  std::vector<std::pair<unsigned int,std::string>> parse_to_uint_string_tuples_(const std::vector<std::string> &strings, char separator = ':');
247  /** A helper function splitting vector of strings of format unsigned int:string:string to vector of tuples (unsigned int,string,string) */
248  std::vector<std::tuple<unsigned int,std::string,std::string>> parse_to_uint_string_string_tuples_(const std::vector<std::string> &strings, char separator = ':');
249  std::vector<std::string> args_;
250  std::string args0_;
251  boost::program_options::options_description all_;
252  boost::program_options::options_description visible_;
253  boost::program_options::options_description hidden_;
254 };
bool log_precise_timestamps
True if –log-precise was given on the command line.
std::vector< std::string > args_
std::optional< std::string > preprocess_path
Path to parse that was given to the –preprocess option.
std::optional< std::string > output_file
Output filename for WML diff or preprocessing.
std::optional< std::string > core_id
Non-empty if –core was given on the command line.
std::optional< std::string > preprocess_output_macros
Non-empty if –preprocess-output-macros was given on the command line.
bool mptest
True if –mp-test was given on the command line.
boost::program_options::options_description all_
bool nogui
True if –nogui was given on the command line.
bool script_unsafe_mode
Whether to load the "package" package for the scripting environment.
std::optional< std::string > test
Non-empty if –test was given on the command line.
std::optional< std::vector< std::pair< unsigned int, std::string > > > multiplayer_ai_config
Non-empty if –ai-config was given on the command line.
std::optional< std::string > password
Non-empty if –password was given on the command line.
boost::program_options::options_description hidden_
static l_noret error(LoadState *S, const char *why)
Definition: lundump.cpp:40
bool noaddons
True if –noaddons was given on the command line.
std::optional< unsigned int > translation_percent
Non-empty if –all-translations or –translations-over is given on the command line.
bool userdata_path
True if –userdata-path was given on the command line.
bool multiplayer_ignore_map_settings
True if –ignore-map-settings was given at the command line.
std::optional< std::string > preprocess_target
Target (output) path that was given to the –preprocess option.
std::optional< std::string > preprocess_input_macros
Non-empty if –preprocess-input-macros was given on the command line.
std::optional< std::string > multiplayer_label
Non-empty if –label was given on the command line.
std::optional< std::vector< std::tuple< unsigned int, std::string, std::string > > > multiplayer_parm
Non-empty if –parm was given on the command line.
std::optional< std::string > userconfig_dir
Non-empty if –userconfig-dir was given on the command line.
bool fps
True if –fps was given on the command line.
std::vector< std::string > unit_test
Non-empty if –unit was given on the command line.
bool noreplaycheck
True if –noreplaycheck was given on the command line.
std::optional< std::string > load
Non-empty if –load was given on the command line.
std::optional< int > max_fps
Max FPS specified by –max-fps option.
bool preprocess
True if –preprocess was given on the command line.
bool with_replay
True if –with-replay was given on the command line.
bool headless_unit_test
True if –unit is used and –showgui is not present.
std::optional< std::string > render_image_dst
Output file to put rendered image path in.
bool report
True if –report was given on the command line.
std::optional< std::string > gzip
Non-empty if –gzip was given on the command line.
bool nodelay
True if –nodelay was given on the command line.
std::optional< unsigned int > rng_seed
RNG seed specified by –rng-seed option.
std::optional< std::vector< std::pair< int, std::string > > > log
Contains parsed arguments of –log-* (e.g.
std::optional< std::string > validate_addon
Non-empty if –validate-addon was given on the command line.
std::optional< int > campaign_difficulty
Non-empty if –campaign-difficulty was given on the command line.
std::optional< int > log_strict_level
Non-empty if –log-strict was given.
bool windowed
True if –windowed was given on the command line.
std::optional< std::string > bunzip2
Non-empty if –bunzip2 was given on the command line.
bool multiplayer
True if –multiplayer was given on the command line.
std::optional< std::vector< std::pair< unsigned int, std::string > > > multiplayer_algorithm
Non-empty if –algorithm was given on the command line.
std::ostream & operator<<(std::ostream &s, const ai::attack_result &r)
Definition: actions.cpp:1130
bool clock
True if –clock was given on the command line.
bool userconfig_path
True if –userconfig-path was given on the command line.
std::optional< std::string > bzip2
Non-empty if –bzip2 was given on the command line.
bool nobanner
True if –nobanner was given on the command line.
std::optional< std::string > logdomains
Non-empty if –logdomains was given on the command line.
std::optional< std::string > render_image
Image path to render.
bool nomusic
True if –nomusic was given on the command line.
std::optional< std::string > multiplayer_era
Non-empty if –era was given on the command line.
std::optional< std::string > campaign
Non-empty if –campaign was given on the command line.
bool debug
True if –debug was given on the command line.
bool debug_lua
True if –debug-lua was given in the commandline.
bool nocache
True if –nocache was given on the command line.
bool strict_lua
True if –strict-lua was given in the commandline.
bool new_widgets
True if –new-widgets was given on the command line.
std::optional< std::string > screenshot_output_file
Output file to put screenshot in.
std::optional< std::string > gunzip
Non-empty if –gunzip was given on the command line.
std::optional< std::vector< std::pair< unsigned int, std::string > > > multiplayer_side
Non-empty if –side was given on the command line.
std::optional< std::string > userdata_dir
Non-empty if –userdata-dir was given on the command line.
bad_commandline_resolution(const std::string &resolution)
std::optional< std::string > script_file
File to load lua script from.
std::optional< std::string > username
Non-empty if –username was given on the command line.
std::optional< std::string > data_dir
Non-empty if –data-dir was given on the command line.
std::optional< std::string > multiplayer_scenario
Non-empty if –scenario was given on the command line.
bool campaign_skip_story
True if –skip-story was given on the command line.
std::optional< std::string > server
Non-empty if –server was given on the command line.
bool data_path
True if –data-path was given on the command line.
bool screenshot
True if –screenshot was given on the command line.
bool version
True if –version was given on the command line.
bool validate_core
True if –validate-core was given on the command line.
std::optional< std::string > screenshot_map_file
Map file to make a screenshot of.
std::optional< std::string > validate_with
Non-empty if –use-schema was given on the command line.
std::optional< std::string > validate_wml
Non-empty if –validate was given on the command line.
bool fullscreen
True if –fullscreen was given on the command line.
bool validcache
True if –validcache was given on the command line.
bool strict_validation
True if –strict-validation was given on the command line.
std::optional< std::string > multiplayer_turns
Non-empty if –turns was given on the command line.
std::optional< std::string > editor
Non-empty if –editor was given on the command line.
point resolution()
Definition: general.cpp:387
std::optional< std::vector< std::string > > preprocess_defines
Defines that were given to the –preprocess option.
std::optional< unsigned int > multiplayer_repeat
Repeats specified by –multiplayer-repeat option.
bool nosound
True if –nosound was given on the command line.
std::optional< std::vector< std::pair< unsigned int, std::string > > > multiplayer_controller
Non-empty if –controller was given on the command line.
boost::program_options::options_description visible_
bool multiplayer_exit_at_end
True if –exit-at-and was given on the command line.
A config object defines a single node in a WML file, with access to child nodes.
Definition: config.hpp:59
std::optional< std::string > campaign_scenario
Non-empty if –campaign-scenario was given on the command line.
std::optional< std::string > validate_schema
Non-empty if –validate-schema was given on the command line.
std::optional< std::pair< int, int > > resolution
Pair of AxB values specified after –resolution.
bool help
True if –help was given on the command line.
std::optional< std::string > plugin_file
File to load a lua plugin (similar to a script) from.
std::optional< std::string > language
Non-empty if –language was given on the command line.