text: /*
  Copyright (c) 2017-2021,
  Battelle Memorial Institute; Lawrence Livermore National Security, LLC; Alliance for Sustainable
  Energy, LLC.  See the top-level NOTICE for additional details. All rights reserved.
  SPDX-License-Identifier: BSD-3-Clause
  */
  #pragma once
  
  #include "../application_api/CombinationFederate.hpp"
  
  #include <memory>
  #include <string>
  #include <vector>
  
  namespace CLI {
  class App;
  }  // namespace CLI
  namespace Json {
  class Value;
  }  // namespace Json
  
  namespace helics {
  namespace apps {
      /** class defining a basic helics App
  @details  the App class is not thread-safe in non-const methods,  don't try to use it from multiple
  threads without external protection, that will result in undefined behavior
  */
      class HELICS_CXX_EXPORT App {
        public:
          /** default constructor*/
          App() = default;
          /** construct from command line arguments in a vector
     @param defaultAppName the name to use if not specified in one of the arguments
     @param args the command line arguments to pass in a reverse vector
     */
          App(const std::string& defaultAppName, std::vector<std::string> args);
          /** construct from command line arguments
      @param defaultAppName the name to use if not specified in one of the arguments
      @param argc the number of arguments
      @param argv the strings in the input
      */
          App(const std::string& defaultAppName, int argc, char* argv[]);
          /** construct from a federate info object
      @param appName the name of the application, can be left empty to use a name specified in fi
      @param fi a pointer info object containing information on the desired federate configuration
      */
          App(const std::string& appName, const FederateInfo& fi);
          /**constructor taking a federate information structure and using the given core
      @param appName the name of the application, can be left empty to use a name specified in fi
      @param core a pointer to core object which the federate can join
      @param fi  a federate information structure
      */
          App(const std::string& appName, const std::shared_ptr<Core>& core, const FederateInfo& fi);
          /**constructor taking a federate information structure and using the given coreApp
      @param appName the name of the application, can be left empty to use a name specified in fi
      @param core a pointer to core object which the federate can join
      @param fi  a federate information structure
      */
          App(const std::string& appName, CoreApp& core, const FederateInfo& fi);
          /**constructor taking a file with the required information
      @param appName the name of the application, can be left empty to use a name specified in
      jsonString
      @param jsonString file or JSON string defining the federate information and other configuration
      */
          App(const std::string& appName, const std::string& jsonString);
  
          /** move construction*/
          App(App&& other_app) = default;
          /** don't allow the copy constructor*/
          App(const App& other_app) = delete;
          /** move assignment*/
          App& operator=(App&& app) = default;
          /** don't allow the copy assignment,  the default would fail anyway since federates are not
           * copyable either*/
          App& operator=(const App& app) = delete;
          virtual ~App();
  
          /** load a file containing publication information
      @param filename the file containing the configuration and Player data  accepted format are JSON,
      xml, and a Player format which is tab delimited or comma delimited*/
          void loadFile(const std::string& filename);
          /** initialize the Player federate
      @details generate all the publications and organize the points, the final publication count will
      be available after this time and the Player will enter the initialization mode, which means it
      will not be possible to add more publications calling run will automatically do this if
      necessary
      */
          virtual void initialize();
          /*run the Player*/
          virtual void run();
  
          /** run the Player until the specified time
      @param stopTime_input the desired stop time
      */
          virtual void runTo(Time stopTime_input) = 0;
  
          /** finalize the Player federate*/
          virtual void finalize();
  
          /** check if the Player is ready to run*/
          bool isActive() const { return !deactivated; }
          /** get a const reference to the federate*/
          const CombinationFederate& accessUnderlyingFederate() const { return *fed; }
  
        protected:
          /** load from a jsonString
      @param jsonString either a JSON filename or a string containing JSON
      */
          virtual void loadJsonFile(const std::string& jsonString);
          /** load from a jsonString and check a field named appName for configuration options
      @param appName the name of the app which may be used in section of the JSON for some local
      configuration
      @param jsonString either a JSON filename or a string containing JSON
      */
          void loadJsonFileConfiguration(const std::string& appName, const std::string& jsonString);
          /** load a text file*/
          virtual void loadTextFile(const std::string& textFile);
  
        private:
          void loadConfigOptions(const Json::Value& element);
          /** generate the command line parser*/
          std::unique_ptr<helicsCLI11App> generateParser();
          /** process the command line arguments */
          void processArgs(std::unique_ptr<helicsCLI11App>& app, const std::string& defaultAppName);
  
        protected:
          std::shared_ptr<CombinationFederate> fed;  //!< the federate created for the Player
          Time stopTime = Time::maxVal();  //!< the time the Player should stop
          std::string masterFileName;  //!< the name of the master file used to do the construction
          bool useLocal{false};
          bool fileLoaded{false};
          bool deactivated{false};
          bool quietMode{false};
          bool helpMode{false};
          std::vector<std::string> remArgs;
      };
  }  // namespace apps
  }  // namespace helics
  