Line data    Source code

       1             : //* This file is part of the MOOSE framework
       2             : //* https://mooseframework.inl.gov
       3             : //*
       4             : //* All rights reserved, see COPYRIGHT for full restrictions
       5             : //* https://github.com/idaholab/moose/blob/master/COPYRIGHT
       6             : //*
       7             : //* Licensed under LGPL 2.1, please see LICENSE for details
       8             : //* https://www.gnu.org/licenses/lgpl-2.1.html
       9             : 
      10             : #include "YAMLFormatter.h"
      11             : 
      12             : // MOOSE includes
      13             : #include "MooseEnum.h"
      14             : #include "MultiMooseEnum.h"
      15             : #include "Parser.h"
      16             : 
      17             : #include "libmesh/vector_value.h"
      18             : #include "libmesh/point.h"
      19             : 
      20             : // C++ includes
      21             : #include <sstream>
      22             : #include <vector>
      23             : 
      24          20 : YAMLFormatter::YAMLFormatter(bool dump_mode) : SyntaxTree(true), _dump_mode(dump_mode) {}
      25             : 
      26             : std::string
      27          20 : YAMLFormatter::preamble() const
      28             : {
      29             :   // important: start and end yaml data delimiters used by python
      30          40 :   return "**START YAML DATA**\n";
      31             : }
      32             : 
      33             : std::string
      34          20 : YAMLFormatter::postscript() const
      35             : {
      36          40 :   return "**END YAML DATA**\n";
      37             : }
      38             : 
      39             : std::string
      40       57034 : YAMLFormatter::printParams(const std::string & prefix,
      41             :                            const std::string & /*fully_qualified_name*/,
      42             :                            InputParameters & params,
      43             :                            short depth,
      44             :                            const std::string & search_string,
      45             :                            bool & found)
      46             : {
      47       57034 :   std::ostringstream oss;
      48       57034 :   std::string indent(depth * 2, ' ');
      49             : 
      50     1985964 :   for (auto & iter : params)
      51             :   {
      52     1928930 :     std::string name = iter.first;
      53             :     // First make sure we want to see this parameter, also block active and type
      54     2943452 :     if (params.isPrivate(iter.first) || name == "active" ||
      55     2943452 :         (search_string != "" && search_string != iter.first) || haveSeenIt(prefix, iter.first))
      56     1408637 :       continue;
      57             : 
      58      520293 :     found = true;
      59             : 
      60             :     // Mark it as "seen"
      61      520293 :     seenIt(prefix, iter.first);
      62             : 
      63             :     // Block params may be required and will have a doc string
      64      520293 :     std::string required = params.isParamRequired(iter.first) ? "Yes" : "No";
      65             : 
      66      520293 :     oss << indent << "  - name: " << name << "\n";
      67      520293 :     oss << indent << "    required: " << required << "\n";
      68      520293 :     oss << indent << "    default: !!str ";
      69             : 
      70             :     // Only output default if it has one
      71      520293 :     if (params.isParamValid(iter.first))
      72             :     {
      73             :       // prints the value, which is the default value when dumping the tree
      74             :       // because it hasn't been changed
      75             : 
      76             :       // Output stream, performing special operations for writing objects such as Points and
      77             :       // RealVectorValues
      78      353076 :       std::ostringstream toss;
      79      353076 :       buildOutputString(toss, iter);
      80             : 
      81             :       // remove additional '\n' possibly generated in output (breaks YAML parsing)
      82      353076 :       std::string tmp_str = toss.str();
      83     1953727 :       for (auto & ch : tmp_str)
      84     1600651 :         if (ch == '\n')
      85           0 :           ch = ' ';
      86      353076 :       if (tmp_str == ",")
      87          70 :         oss << "\"" << tmp_str << "\"";
      88             :       else
      89      353006 :         oss << tmp_str;
      90      353076 :     }
      91      167217 :     else if (params.hasDefaultCoupledValue(iter.first))
      92         424 :       oss << params.defaultCoupledValue(iter.first);
      93             : 
      94      520293 :     std::string doc = params.getDocString(iter.first);
      95      520293 :     MooseUtils::escape(doc);
      96             :     // Print the type
      97             :     oss << "\n"
      98      520293 :         << indent << "    cpp_type: " << params.type(iter.first) << "\n"
      99      520293 :         << indent << "    group_name: ";
     100      520293 :     std::string group_name = params.getGroupName(iter.first);
     101      520293 :     if (!group_name.empty())
     102      316302 :       oss << "'" << group_name << "'";
     103      520293 :     oss << "\n";
     104             : 
     105      520293 :     oss << indent << "    doc_unit: ";
     106      520293 :     std::string doc_unit = params.getDocUnit(iter.first);
     107      520293 :     if (!doc_unit.empty())
     108           0 :       oss << "'" << doc_unit << "'";
     109      520293 :     oss << "\n";
     110             : 
     111      520293 :     if (params.have_parameter<MooseEnum>(name))
     112       27164 :       addEnumOptionsAndDocs(oss, params.get<MooseEnum>(name), indent);
     113      520293 :     if (params.have_parameter<MultiMooseEnum>(name))
     114       17032 :       addEnumOptionsAndDocs(oss, params.get<MultiMooseEnum>(name), indent);
     115      520293 :     if (params.have_parameter<ExecFlagEnum>(name))
     116       12412 :       addEnumOptionsAndDocs(oss, params.get<ExecFlagEnum>(name), indent);
     117      520293 :     if (params.have_parameter<std::vector<MooseEnum>>(name))
     118          80 :       addEnumOptionsAndDocs(oss, params.get<std::vector<MooseEnum>>(name)[0], indent);
     119             : 
     120      520293 :     oss << indent << "    description: |\n      " << indent << doc << std::endl;
     121     1928930 :   }
     122             : 
     123      114068 :   return oss.str();
     124       57034 : }
     125             : 
     126             : template <typename T>
     127             : void
     128       56688 : YAMLFormatter::addEnumOptionsAndDocs(std::ostringstream & oss,
     129             :                                      T & param,
     130             :                                      const std::string & indent)
     131             : {
     132       56688 :   oss << indent << "    options: " << param.getRawNames() << '\n';
     133       56688 :   const auto & docs = param.getItemDocumentation();
     134       56688 :   if (!docs.empty())
     135             :   {
     136         142 :     oss << indent << "    option_docs:\n";
     137         538 :     for (const auto & doc : docs)
     138             :     {
     139         396 :       oss << indent << "    - name: " << doc.first.name() << "\n";
     140         396 :       oss << indent << "      description: |\n";
     141         396 :       oss << indent << "        " << doc.second << "\n";
     142             :     }
     143             :   }
     144       56688 : }
     145             : 
     146             : std::string
     147       58294 : YAMLFormatter::preTraverse(short depth) const
     148             : {
     149       58294 :   std::string indent(depth * 2, ' ');
     150             : 
     151      116588 :   return indent + "  subblocks:\n";
     152       58294 : }
     153             : 
     154             : std::string
     155       58294 : YAMLFormatter::printBlockOpen(const std::string & name, short depth, const std::string & doc)
     156             : {
     157       58294 :   std::ostringstream oss;
     158       58294 :   std::string indent(depth * 2, ' ');
     159             : 
     160       58294 :   std::string docEscaped = doc;
     161       58294 :   MooseUtils::escape(docEscaped);
     162             : 
     163       58294 :   oss << indent << "- name: " << name << "\n";
     164       58294 :   oss << indent << "  description: |\n" << indent << "    " << docEscaped << "\n";
     165       58294 :   oss << indent << "  parameters:\n";
     166             : 
     167      116588 :   return oss.str();
     168       58294 : }
     169             : 
     170             : std::string
     171       58294 : YAMLFormatter::printBlockClose(const std::string & /*name*/, short /*depth*/) const
     172             : {
     173       58294 :   return std::string();
     174             : }
     175             : 
     176             : void
     177      353076 : YAMLFormatter::buildOutputString(
     178             :     std::ostringstream & output,
     179             :     const std::iterator_traits<InputParameters::iterator>::value_type & p)
     180             : {
     181      353076 :   libMesh::Parameters::Value * val = MooseUtils::get(p.second);
     182             : 
     183             :   // Account for Point
     184      353076 :   InputParameters::Parameter<Point> * ptr0 = dynamic_cast<InputParameters::Parameter<Point> *>(val);
     185             : 
     186             :   // Account for RealVectorValues
     187             :   InputParameters::Parameter<RealVectorValue> * ptr1 =
     188      353076 :       dynamic_cast<InputParameters::Parameter<RealVectorValue> *>(val);
     189             : 
     190             :   // Output the Point components
     191      353076 :   if (ptr0)
     192         270 :     output << ptr0->get().operator()(0) << " " << ptr0->get().operator()(1) << " "
     193         270 :            << ptr0->get().operator()(2);
     194             : 
     195             :   // Output the RealVectorValue components
     196      352806 :   else if (ptr1)
     197         168 :     output << ptr1->get().operator()(0) << " " << ptr1->get().operator()(1) << " "
     198         168 :            << ptr1->get().operator()(2);
     199             : 
     200             :   // General case, call the print operator
     201             :   else
     202      352638 :     p.second->print(output);
     203      353076 : }