v1.4.4

source/game/StarRootLoader.hpp

@@ -0,0 +1,71 @@
+#ifndef STAR_ROOT_LOADER_HPP
+#define STAR_ROOT_LOADER_HPP
+
+#include "StarVersionOptionParser.hpp"
+#include "StarRoot.hpp"
+
+namespace Star {
+
+// Parses command line flags and loads and returns the Root singleton based on
+// them.
+//
+// It is designed to load settings first from the settings passed into the
+// constructor, then from the required boot config file , then from any passed
+// in command line flags.  Besides -version, the accepted command line flags
+// are:
+//
+// -bootconfig <bootconfig> - sets path to the boot configuration file, defaults to sbinit.config
+// -logfile <logfile> - sets path to logfile, if any, relative to root storage directory
+// -loglevel <level> - sets logging level
+// -quiet - turns off stdout logging
+// -verbose - turns on stdout logging
+// -runtimeconfig - sets the path to the runtime configuration storage file, relative to root storage directory
+//
+// The boot config file can contain the following options:
+// 'assetDirectories' - Asset source search directories
+// 'logFileBackups' - Number of rotated backups of the target log file
+// 'storageDirectory' - Primary Root storage directory
+// 'assetsSettings' - Merged with base assets settings
+// 'defaultConfiguration' - Merged with base default configuration
+class RootLoader : public VersionOptionParser {
+public:
+  struct Defaults {
+    // Merged on top of the base assets settings hard-coded in RootLoader.
+    Json additionalAssetsSettings;
+
+    // Merged on top of the base default configuration hard-coded in RootLoader.
+    Json additionalDefaultConfiguration;
+
+    // Name of the log file that should be written, if any, relative to the
+    // storage directory
+    Maybe<String> logFile;
+
+    // The minimum log level to write to any log sink
+    LogLevel logLevel;
+
+    // If true, doesn't write any logging to stdout, only to the log file if
+    // given.
+    bool quiet;
+
+    // If given, will write changed configuration to the given file within the
+    // storage directory.
+    Maybe<String> runtimeConfigFile;
+  };
+
+  RootLoader(Defaults defaults);
+
+  pair<Root::Settings, Options> parseOrDie(StringList const& cmdLineArguments) const;
+  pair<RootUPtr, Options> initOrDie(StringList const& cmdLineArguments) const;
+
+  pair<Root::Settings, Options> commandParseOrDie(int argc, char** argv);
+  pair<RootUPtr, Options> commandInitOrDie(int argc, char** argv);
+
+private:
+  Root::Settings rootSettingsForOptions(Options const& options) const;
+
+  Defaults m_defaults;
+};
+
+}
+
+#endif