Extend the functionalities of the command line parameters

arcane/src/arcane/core/CaseOptionBase.cc

@@ -1,11 +1,11 @@
 // -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
 //-----------------------------------------------------------------------------
-// Copyright 2000-2023 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
+// Copyright 2000-2025 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
 // See the top-level COPYRIGHT file for details.
 // SPDX-License-Identifier: Apache-2.0
 //-----------------------------------------------------------------------------
 /*---------------------------------------------------------------------------*/
-/* CaseOptionBase.cc                                           (C) 2000-2023 */
+/* CaseOptionBase.cc                                           (C) 2000-2025 */
 /*                                                                           */
 /* Gestion des options du jeu de données.                                    */
 /*---------------------------------------------------------------------------*/
@@ -54,6 +54,7 @@ class CaseOptionBasePrivate
   String m_default_value; //!< Valeur par défaut
   Integer m_min_occurs; //!< Nombre minimum d'occurences
   Integer m_max_occurs; //!< Nombre maximum d'occurences (-1 == unbounded)
+  bool m_is_optional;
   bool m_is_initialized; //!< \a true si initialisé
   bool m_is_override_default; //!< \a true si la valeur par défaut est surchargée
   //! Liste des noms d'options par langue.
@@ -77,6 +78,7 @@ CaseOptionBasePrivate(const CaseOptionBuildInfo& cob)
 , m_default_value(m_axl_default_value)
 , m_min_occurs(cob.minOccurs())
 , m_max_occurs(cob.maxOccurs())
+, m_is_optional(cob.isOptional())
 , m_is_initialized(false)
 , m_is_override_default(false)
 {
@@ -227,6 +229,15 @@ maxOccurs() const
 /*---------------------------------------------------------------------------*/
 /*---------------------------------------------------------------------------*/
 
+bool CaseOptionBase::
+isOptional() const
+{
+  return m_p->m_is_optional;
+}
+
+/*---------------------------------------------------------------------------*/
+/*---------------------------------------------------------------------------*/
+
 void CaseOptionBase::
 _setTranslatedName()
 {
@@ -349,6 +360,11 @@ _checkMinMaxOccurs(Integer nb_occur)
 {
   Integer min_occurs = m_p->m_min_occurs;
   Integer max_occurs = m_p->m_max_occurs;
+  bool is_optional = m_p->m_is_optional;
+
+  if (nb_occur == 0 && is_optional) {
+    return;
+  }
 
   if (nb_occur<min_occurs){
     StringBuilder msg = "Bad number of occurences (less than min)";

arcane/src/arcane/core/CaseOptionBase.h

@@ -1,11 +1,11 @@
 // -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
 //-----------------------------------------------------------------------------
-// Copyright 2000-2023 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
+// Copyright 2000-2025 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
 // See the top-level COPYRIGHT file for details.
 // SPDX-License-Identifier: Apache-2.0
 //-----------------------------------------------------------------------------
 /*---------------------------------------------------------------------------*/
-/* CaseOptionBase.h                                            (C) 2000-2023 */
+/* CaseOptionBase.h                                            (C) 2000-2025 */
 /*                                                                           */
 /* Classe d'une base d'une option du jeu de donnés.                          */
 /*---------------------------------------------------------------------------*/
@@ -108,7 +108,10 @@ class ARCANE_CORE_EXPORT CaseOptionBase
 
   //! Nombre maximum d'occurences (pour une option multiple) (-1 == unbounded)
   Integer maxOccurs() const;
-
+
+  //! Permet de savoir si une option est optionnelle.
+  bool isOptional() const;
+
   /*! \brief Met à jour la valeur de l'option à partir d'une fonction.
    *
    * Si l'option n'est pas liée à une table de marche, ne fait rien.

arcane/src/arcane/core/CaseOptionExtended.cc

@@ -1,11 +1,11 @@
 // -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
 //-----------------------------------------------------------------------------
-// Copyright 2000-2023 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
+// Copyright 2000-2025 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
 // See the top-level COPYRIGHT file for details.
 // SPDX-License-Identifier: Apache-2.0
 //-----------------------------------------------------------------------------
 /*---------------------------------------------------------------------------*/
-/* CaseOptionExtended.cc                                       (C) 2000-2023 */
+/* CaseOptionExtended.cc                                       (C) 2000-2025 */
 /*                                                                           */
 /* Option du jeu de données de type 'Extended'.                              */
 /*---------------------------------------------------------------------------*/
@@ -15,12 +15,22 @@
 
 #include "arcane/utils/ITraceMng.h"
 #include "arcane/utils/FatalErrorException.h"
+#include "arcane/utils/ApplicationInfo.h"
+#include "arcane/utils/CommandLineArguments.h"
+#include "arcane/utils/ParameterList.h"
+#include "arcane/utils/ParameterCaseOption.h"
+#include "arcane/utils/StringBuilder.h"
 
+#include "arcane/core/IApplication.h"
+#include "arcane/core/ICaseMng.h"
 #include "arcane/core/CaseOptionError.h"
 #include "arcane/core/ICaseDocumentVisitor.h"
 #include "arcane/core/XmlNodeList.h"
 #include "arcane/core/ICaseOptionList.h"
 #include "arcane/core/MeshHandle.h"
+#include "arcane/core/ICaseDocument.h"
+#include "arcane/core/CaseOptionException.h"
+#include "arcane/core/internal/StringVariableReplace.h"
 
 /*---------------------------------------------------------------------------*/
 /*---------------------------------------------------------------------------*/
@@ -41,25 +51,107 @@
 void CaseOptionMultiExtended::
 _search(bool is_phase1)
 {
-  XmlNodeList elem_list = rootElement().children(name());
   ITraceMng* tm = traceMng();
+  const ParameterList& params = caseMng()->application()->applicationInfo().commandLineArguments().parameters();
+  const ParameterCaseOption pco{ params.getParameterCaseOption(caseDocumentFragment()->language()) };
+  String full_xpath = String::format("{0}/{1}", rootElement().xpathFullName(), name());
+
+  // !!! En XML, on commence par 1 et non 0.
+  UniqueArray<Integer> option_in_param;
 
+  pco.indexesInParam(full_xpath, option_in_param, false);
+
+  XmlNodeList elem_list = rootElement().children(name());
   Integer size = elem_list.size();
-  _checkMinMaxOccurs(size);
-  if (size==0)
+  bool is_optional = isOptional();
+
+  if (size == 0 && option_in_param.empty() && is_optional) {
     return;
+  }
+
+  Integer min_occurs = minOccurs();
+  Integer max_occurs = maxOccurs();
+
+  Integer max_in_param = 0;
+
+  // On regarde si l'utilisateur n'a pas mis un indice trop élevé pour l'option dans la ligne de commande.
+  if (!option_in_param.empty()) {
+    max_in_param = option_in_param[0];
+    for (Integer index : option_in_param) {
+      if (index > max_in_param)
+        max_in_param = index;
+    }
+    if (max_occurs >= 0) {
+      if (max_in_param > max_occurs) {
+        StringBuilder msg = "Bad number of occurences in command line (greater than max)";
+        msg += " index_max_in_param=";
+        msg += max_in_param;
+        msg += " max_occur=";
+        msg += max_occurs;
+        msg += " option=";
+        msg += full_xpath;
+        throw CaseOptionException(A_FUNCINFO, msg.toString(), true);
+      }
+    }
+  }
 
-  if (is_phase1){
-    _allocate(size);
-    m_values.resize(size);
+  if (max_occurs >= 0) {
+    if (size > max_occurs) {
+      StringBuilder msg = "Bad number of occurences (greater than max)";
+      msg += " nb_occur=";
+      msg += size;
+      msg += " max_occur=";
+      msg += max_occurs;
+      msg += " option=";
+      msg += full_xpath;
+      throw CaseOptionException(A_FUNCINFO, msg.toString(), true);
+    }
+  }
+
+  // Il y aura toujours au moins min_occurs options.
+  // S'il n'y a pas assez l'options dans le jeu de données et dans les paramètres de la
+  // ligne de commande, on ajoute des services par défaut (si pas de défaut, il y aura un plantage).
+  Integer final_size = std::max(size, std::max(min_occurs, max_in_param));
+
+  if (is_phase1) {
+    _allocate(final_size);
+    m_values.resize(final_size);
   }
-  else{
-    //cerr << "** MULTI SEARCH " << size << endl;
-    for( Integer i=0; i<size; ++i ){
-      XmlNode velem = elem_list[i];
-      // Si l'option n'est pas présente dans le jeu de donnée, on prend
-      // l'option par défaut.
-      String str_val = (velem.null()) ? _defaultValue() : velem.value();
+  else {
+    // D'abord, on aura les options du jeu de données : comme on ne peut pas définir un indice
+    // pour les options dans le jeu de données, elles seront forcément au début et seront contigües.
+    // Puis, s'il manque des options pour atteindre le min_occurs, on ajoute des options par défaut.
+    // S'il n'y a pas d'option par défaut, il y aura une exception.
+    // Enfin, l'utilisateur peut avoir ajouté des options à partir de la ligne de commande. On les ajoute alors.
+    // Si l'utilisateur souhaite modifier des valeurs du jeu de données à partir de la ligne de commande, on
+    // remplace les options au fur et à mesure de la lecture.
+    for (Integer i = 0; i < final_size; ++i) {
+      String str_val;
+
+      // Partie paramètres de la ligne de commande.
+      if (option_in_param.contains(i + 1)) {
+        str_val = pco.getParameterOrNull(full_xpath, i + 1, false);
+      }
+
+      // Partie jeu de données.
+      else if (i < size) {
+        XmlNode velem = elem_list[i];
+        if (!velem.null()) {
+          str_val = velem.value();
+        }
+      }
+
+      // Valeur par défaut.
+      if (str_val.null()) {
+        str_val = _defaultValue();
+      }
+      else {
+        // Dans un else : Le remplacement de symboles ne s'applique pas pour les valeurs par défault du .axl.
+        str_val = StringVariableReplace::replaceWithCmdLineArgs(params, str_val, true);
+      }
+
+      // Maintenant, ce plantage concerne aussi le cas où il n'y a pas de valeurs par défaut et qu'il n'y a
+      // pas assez d'options pour atteindre le min_occurs.
       if (str_val.null()) {
         CaseOptionError::addOptionNotFoundError(caseDocumentFragment(),A_FUNCINFO,
                                                 name(),rootElement());

arcane/src/arcane/core/CaseOptionList.cc

@@ -1,11 +1,11 @@
 // -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
 //-----------------------------------------------------------------------------
-// Copyright 2000-2023 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
+// Copyright 2000-2025 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
 // See the top-level COPYRIGHT file for details.
 // SPDX-License-Identifier: Apache-2.0
 //-----------------------------------------------------------------------------
 /*---------------------------------------------------------------------------*/
-/* CaseOptionList.cc                                           (C) 2000-2023 */
+/* CaseOptionList.cc                                           (C) 2000-2025 */
 /*                                                                           */
 /* Liste d'options de configuration d'un service ou module.                  */
 /*---------------------------------------------------------------------------*/
@@ -216,6 +216,9 @@
   bool isOptional() const override { return m_is_optional; }
   void setOptional(bool v) { m_is_optional = v; }
 
+  Integer minOccurs() const override { return m_is_optional ? 0 : 1; }
+  Integer maxOccurs() const override { return 1; }
+
   void setRootElementWithParent(XmlNode parent_element) override
   {
     _setRootElement(false,parent_element);
@@ -564,6 +567,8 @@
  public:
 
   bool isOptional() const override { return true; }
+  Integer minOccurs() const override { return m_min_occurs; }
+  Integer maxOccurs() const override { return m_max_occurs; }
   void readChildren(bool is_phase1) override;
   void addInvalidChildren(XmlNodeList& nlist) override;
   void printChildren(const String& lang,int indent) override;
@@ -608,10 +613,11 @@
 
     m_root_element_list = m_parent_element.children(rootTagName());
     m_case_config_list.clear();
-    Integer s = m_root_element_list.size();
-    _checkMinMaxOccurs(s);
-    if (s!=0)
-      m_case_option_multi->multiAllocate(m_root_element_list);
+    // Ces vérifications sont faites dans multiAllocate().
+    //Integer s = m_root_element_list.size();
+    //_checkMinMaxOccurs(s);
+    //if (s!=0)
+    m_case_option_multi->multiAllocate(m_root_element_list);
     // Récupère les options créées lors de l'appel à 'multiAllocate' et
     // les ajoute à la liste.
     Integer nb_children = m_case_option_multi->nbChildren();