ArcaneLauncher.h

// -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
//-----------------------------------------------------------------------------
// Copyright 2000-2026 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
// See the top-level COPYRIGHT file for details.
// SPDX-License-Identifier: Apache-2.0
//-----------------------------------------------------------------------------
/*---------------------------------------------------------------------------*/
/* ArcaneLauncher.h                                            (C) 2000-2026 */
/*                                                                           */
/* Class managing execution.                                                 */
/*---------------------------------------------------------------------------*/
#ifndef ARCANE_LAUNCHER_ARCANELAUNCHER_H
#define ARCANE_LAUNCHER_ARCANELAUNCHER_H
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#include "arcane/launcher/LauncherGlobal.h"
 
// The following files are not directly used in this '.h'
// but are added so that user code only needs to include
// 'ArcaneLauncher.h'.
#include "arcane/utils/ApplicationInfo.h"
#include "arcane/utils/CommandLineArguments.h"
 
#include "arcane/core/ApplicationBuildInfo.h"
#include "arcane/core/DotNetRuntimeInitialisationInfo.h"
#include "arcane/core/AcceleratorRuntimeInitialisationInfo.h"
 
#include "arcane/launcher/DirectExecutionContext.h"
#include "arcane/launcher/DirectSubDomainExecutionContext.h"
#include "arcane/launcher/IDirectExecutionContext.h"
#include "arcane/launcher/StandaloneAcceleratorMng.h"
#include "arcane/launcher/StandaloneSubDomain.h"
 
#include <functional>
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arcane
{
class IMainFactory;
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class ARCANE_LAUNCHER_EXPORT ArcaneLauncher
{
  friend StandaloneSubDomain;
 
 public:

  static void init(const CommandLineArguments& args);

  static bool isInitialized();

  static int run();

  static int run(std::function<int(DirectExecutionContext&)> func);

  static int run(std::function<int(DirectSubDomainExecutionContext&)> func);

  static void setDefaultMainFactory(IMainFactory* mf);

  static ApplicationInfo& applicationInfo();

  static ApplicationBuildInfo& applicationBuildInfo();

  static DotNetRuntimeInitialisationInfo& dotNetRuntimeInitialisationInfo();

  static AcceleratorRuntimeInitialisationInfo& acceleratorRuntimeInitialisationInfo();

  static String getExeDirectory();

  static StandaloneAcceleratorMng createStandaloneAcceleratorMng();

  static StandaloneSubDomain createStandaloneSubDomain(const String& case_file_name,
                                                       Span<const std::byte> file_content = {});

  static bool needHelp();

  static bool printHelp();
 
 public:

  ARCCORE_DEPRECATED_2020("Use run(func) instead")
  static int runDirect(std::function<int(IDirectExecutionContext*)> func);

  ARCCORE_DEPRECATED_2020("Use init(args) instead")
  static void setCommandLineArguments(const CommandLineArguments& args)
  {
    init(args);
  }
 
 private:
 
  static void _initStandalone();
  static void _notifyRemoveStandaloneSubDomain();
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // End namespace Arcane
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#endif