https://mooseframework.inl.gov
MooseServer.h
Go to the documentation of this file.
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 #pragma once
11 
12 #include "MooseApp.h"
13 #include "wasplsp/LSP.h"
14 #include "wasplsp/ServerImpl.h"
15 #include "wasplsp/Connection.h"
16 #include "libmesh/ignore_warnings.h"
17 #include "wasplsp/IOStreamConnection.h"
18 #include "libmesh/restore_warnings.h"
19 #include "waspcore/Object.h"
20 #include "wasphit/HITNodeView.h"
21 #include "waspsiren/SIRENInterpreter.h"
22 #include "waspsiren/SIRENResultSet.h"
23 #include "waspplot/CustomPlotFile.h"
24 #include <string>
25 #include <memory>
26 #include <set>
27 #include <map>
28 
29 class MooseServer : public wasp::lsp::ServerImpl
30 {
31 public:
32  MooseServer(MooseApp & moose_app);
33 
34  virtual ~MooseServer() = default;
35 
40  std::shared_ptr<wasp::lsp::Connection> getConnection() { return _connection; }
41 
42 private:
46  using SortedLocationNodes =
47  std::set<wasp::HITNodeView,
48  std::function<bool(const wasp::HITNodeView &, const wasp::HITNodeView &)>>;
49 
55  bool parseDocumentForDiagnostics(wasp::DataArray & diagnosticsList);
56 
67  bool updateDocumentTextChanges(const std::string & replacement_text,
68  int start_line,
69  int start_character,
70  int end_line,
71  int end_character,
72  int range_length);
73 
82  bool gatherDocumentCompletionItems(wasp::DataArray & completionItems,
83  bool & is_incomplete,
84  int line,
85  int character);
86 
93  void getExistingInput(wasp::HITNodeView parent_node,
94  std::set<std::string> & existing_params,
95  std::set<std::string> & existing_subblocks);
96 
104  void getAllValidParameters(InputParameters & valid_params,
105  const std::string & object_path,
106  const std::string & object_type,
107  std::set<std::string> & obj_act_tasks);
108 
115  void getActionParameters(InputParameters & valid_params,
116  const std::string & object_path,
117  std::set<std::string> & obj_act_tasks);
118 
125  void getObjectParameters(InputParameters & valid_params,
126  std::string object_type,
127  const std::set<std::string> & obj_act_tasks);
128 
141  bool addParametersToList(wasp::DataArray & completionItems,
142  const InputParameters & valid_params,
143  const std::set<std::string> & existing_params,
144  int replace_line_beg,
145  int replace_char_beg,
146  int replace_line_end,
147  int replace_char_end,
148  const std::string & filtering_prefix);
149 
161  bool addSubblocksToList(wasp::DataArray & completionItems,
162  const std::string & object_path,
163  int replace_line_beg,
164  int replace_char_beg,
165  int replace_line_end,
166  int replace_char_end,
167  const std::string & filtering_prefix,
168  bool request_on_block_decl);
169 
185  bool addValuesToList(wasp::DataArray & completionItems,
186  const InputParameters & valid_params,
187  const std::set<std::string> & existing_params,
188  const std::set<std::string> & existing_subblocks,
189  const std::string & param_name,
190  const std::set<std::string> & obj_act_tasks,
191  const std::string & object_path,
192  int replace_line_beg,
193  int replace_char_beg,
194  int replace_line_end,
195  int replace_char_end);
196 
202  template <typename MooseEnumType>
203  void getEnumsAndDocs(MooseEnumType & moose_enum_param,
204  std::map<std::string, std::string> & options_and_descs);
205 
213  bool
214  gatherDocumentDefinitionLocations(wasp::DataArray & definitionLocations, int line, int character);
215 
223  const std::string & clean_type,
224  const std::string & val_string);
225 
232  bool addLocationNodesToList(wasp::DataArray & defsOrRefsLocations,
233  const SortedLocationNodes & location_nodes);
234 
242  bool getHoverDisplayText(std::string & display_text, int line, int character);
243 
252  bool gatherDocumentReferencesLocations(wasp::DataArray & referencesLocations,
253  int line,
254  int character,
255  bool include_declaration);
256 
264  void getNodesByValueAndTypes(SortedLocationNodes & match_nodes,
265  wasp::HITNodeView view_parent,
266  const std::string & target_value,
267  const std::set<std::string> & target_types);
268 
276  bool gatherDocumentFormattingTextEdits(wasp::DataArray & formattingTextEdits,
277  int tab_size,
278  bool insert_spaces);
279 
287  std::string formatDocument(wasp::HITNodeView parent, std::size_t & prev_line, std::size_t level);
288 
294  bool gatherDocumentSymbols(wasp::DataArray & documentSymbols);
295 
302  bool traverseParseTreeAndFillSymbols(wasp::HITNodeView view_parent,
303  wasp::DataObject & data_parent);
304 
313  int getCompletionItemKind(const InputParameters & valid_params,
314  const std::string & param_name,
315  const std::string & clean_type,
316  bool is_param);
317 
323  int getDocumentSymbolKind(wasp::HITNodeView symbol_node);
324 
333  std::string getRequiredParamsText(const std::string & subblock_path,
334  const std::string & subblock_type,
335  const std::set<std::string> & existing_params,
336  const std::string & indent_spaces);
337 
346  bool gatherExtensionResponses(wasp::DataArray & extensionResponses,
347  const std::string & extensionMethod,
348  int line,
349  int character);
350 
358  bool gatherPlottingResponses(wasp::DataArray & plottingResponses, int line, int character);
359 
367  void buildLineGraphPlot(wasp::CustomPlot & plot_object,
368  const std::string & plot_title,
369  const std::vector<double> & graph_keys,
370  const std::vector<double> & graph_vals);
371 
377  bool connectionRead(wasp::DataObject & object) { return _connection->read(object, errors); }
378 
384  bool connectionWrite(wasp::DataObject & object) { return _connection->write(object, errors); }
385 
391  bool rootIsValid() const;
392 
396  struct CheckState
397  {
398  CheckState(std::shared_ptr<Parser> & parser) : parser(parser) {}
399  std::shared_ptr<Parser> parser;
400  std::unique_ptr<MooseApp> app;
401  };
402 
406  const CheckState * queryCheckState() const;
410 
413  const MooseApp * queryCheckApp() const;
417 
420  const Parser * queryCheckParser() const;
424 
427  const hit::Node * queryRoot() const;
431  const std::string * queryDocumentText() const;
432 
436  MooseApp & getCheckApp();
441  const hit::Node & getRoot() const;
442 
446  const std::string & getDocumentText() const;
447 
452 
456  std::map<std::string, CheckState> _check_state;
457 
461  std::shared_ptr<wasp::lsp::IOStreamConnection> _connection;
462 
466  std::map<std::string, std::set<std::string>> _syntax_to_subblocks;
467 
471  std::map<std::string, std::set<std::string>> _type_to_input_paths;
472 
476  std::map<std::string, std::set<std::string>> _input_path_to_types;
477 
481  std::size_t _formatting_tab_size;
482 };
int getDocumentSymbolKind(wasp::HITNodeView symbol_node)
Get document symbol kind value that client may use for outline icon.
Definition: MooseServer.C:1552
std::map< std::string, std::set< std::string > > _type_to_input_paths
_type_to_input_paths - map of parameter types to lookup paths
Definition: MooseServer.h:471
void getInputLookupDefinitionNodes(SortedLocationNodes &location_nodes, const std::string &clean_type, const std::string &val_string)
Get set of nodes from associated path lookups matching value string.
Definition: MooseServer.C:1032
std::string getRequiredParamsText(const std::string &subblock_path, const std::string &subblock_type, const std::set< std::string > &existing_params, const std::string &indent_spaces)
Get required parameter completion text list for given subblock path.
Definition: MooseServer.C:1590
std::map< std::string, std::set< std::string > > _input_path_to_types
_type_to_input_paths - map of lookup paths to parameter types
Definition: MooseServer.h:476
const std::string & getDocumentText() const
Definition: MooseServer.C:1833
MooseServer(MooseApp &moose_app)
Definition: MooseServer.C:38
void buildLineGraphPlot(wasp::CustomPlot &plot_object, const std::string &plot_title, const std::vector< double > &graph_keys, const std::vector< double > &graph_vals)
Build CustomPlot graph with provided keys, values, and plot title.
Definition: MooseServer.C:1691
bool addValuesToList(wasp::DataArray &completionItems, const InputParameters &valid_params, const std::set< std::string > &existing_params, const std::set< std::string > &existing_subblocks, const std::string &param_name, const std::set< std::string > &obj_act_tasks, const std::string &object_path, int replace_line_beg, int replace_char_beg, int replace_line_end, int replace_char_end)
Add parameter values to completion list for request line and column.
Definition: MooseServer.C:754
MooseApp & getCheckApp()
Definition: MooseServer.C:1812
bool gatherDocumentSymbols(wasp::DataArray &documentSymbols)
Gather document symbols - specific to this server implemention.
Definition: MooseServer.C:1413
bool addParametersToList(wasp::DataArray &completionItems, const InputParameters &valid_params, const std::set< std::string > &existing_params, int replace_line_beg, int replace_char_beg, int replace_line_end, int replace_char_end, const std::string &filtering_prefix)
Add parameters that were previously gathered to list for completion.
Definition: MooseServer.C:542
std::shared_ptr< Parser > parser
Definition: MooseServer.h:399
Base class for MOOSE-based applications.
Definition: MooseApp.h:103
The main MOOSE class responsible for handling user-defined parameters in almost every MOOSE system...
const hit::Node & getRoot() const
Definition: MooseServer.C:1825
const std::string * queryDocumentText() const
Definition: MooseServer.C:1800
bool getHoverDisplayText(std::string &display_text, int line, int character)
Get hover display text - logic specific to this server implemention.
Definition: MooseServer.C:1105
bool updateDocumentTextChanges(const std::string &replacement_text, int start_line, int start_character, int end_line, int end_character, int range_length)
Update document text changes - specific to this server implemention.
Definition: MooseServer.C:241
const CheckState * queryCheckState() const
Definition: MooseServer.C:1760
std::set< wasp::HITNodeView, std::function< bool(const wasp::HITNodeView &, const wasp::HITNodeView &)> > SortedLocationNodes
SortedLocationNodes - type alias for set of nodes sorted by location.
Definition: MooseServer.h:48
void getObjectParameters(InputParameters &valid_params, std::string object_type, const std::set< std::string > &obj_act_tasks)
Get all object parameters using requested object path to collection.
Definition: MooseServer.C:489
void getNodesByValueAndTypes(SortedLocationNodes &match_nodes, wasp::HITNodeView view_parent, const std::string &target_value, const std::set< std::string > &target_types)
Recursively walk input to gather all nodes matching value and types.
Definition: MooseServer.C:1263
std::shared_ptr< wasp::lsp::Connection > getConnection()
Get read / write connection - specific to this server implemention.
Definition: MooseServer.h:40
bool rootIsValid() const
std::shared_ptr< wasp::lsp::IOStreamConnection > _connection
_connection - shared pointer to this server&#39;s read / write iostream
Definition: MooseServer.h:461
CheckState(std::shared_ptr< Parser > &parser)
Definition: MooseServer.h:398
const Parser * queryCheckParser() const
Definition: MooseServer.C:1773
const MooseApp * queryCheckApp() const
Definition: MooseServer.C:1786
void getAllValidParameters(InputParameters &valid_params, const std::string &object_path, const std::string &object_type, std::set< std::string > &obj_act_tasks)
Get all global parameters, action parameters, and object parameters.
Definition: MooseServer.C:432
Helper for storing the state for a single document.
Definition: MooseServer.h:396
bool gatherDocumentFormattingTextEdits(wasp::DataArray &formattingTextEdits, int tab_size, bool insert_spaces)
Gather formatting text edits - specific to this server implemention.
Definition: MooseServer.C:1308
void getActionParameters(InputParameters &valid_params, const std::string &object_path, std::set< std::string > &obj_act_tasks)
Get all action parameters using requested object path to collection.
Definition: MooseServer.C:444
bool traverseParseTreeAndFillSymbols(wasp::HITNodeView view_parent, wasp::DataObject &data_parent)
Recursively fill document symbols from the given node.
Definition: MooseServer.C:1469
bool gatherExtensionResponses(wasp::DataArray &extensionResponses, const std::string &extensionMethod, int line, int character)
Gather extension responses - specific to this server implemention.
Definition: MooseServer.C:1620
MooseApp & _moose_app
_moose_app - reference to parent application that owns this server
Definition: MooseServer.h:451
bool addSubblocksToList(wasp::DataArray &completionItems, const std::string &object_path, int replace_line_beg, int replace_char_beg, int replace_line_end, int replace_char_end, const std::string &filtering_prefix, bool request_on_block_decl)
Add subblocks to completion list for request path, line, and column.
Definition: MooseServer.C:652
bool gatherDocumentCompletionItems(wasp::DataArray &completionItems, bool &is_incomplete, int line, int character)
Gather document completion items - specific to this server implemention.
Definition: MooseServer.C:255
std::unique_ptr< MooseApp > app
Definition: MooseServer.h:400
bool gatherDocumentReferencesLocations(wasp::DataArray &referencesLocations, int line, int character, bool include_declaration)
Gather references locations - specific to this server implemention.
Definition: MooseServer.C:1189
std::size_t _formatting_tab_size
_formatting_tab_size - number of indent spaces for formatting
Definition: MooseServer.h:481
bool gatherPlottingResponses(wasp::DataArray &plottingResponses, int line, int character)
Build CustomPlot extension responses when method name is plotting.
Definition: MooseServer.C:1633
bool connectionRead(wasp::DataObject &object)
Read from connection into object - specific to this server&#39;s connection.
Definition: MooseServer.h:377
bool parseDocumentForDiagnostics(wasp::DataArray &diagnosticsList)
Parse document for diagnostics - specific to this server implemention.
Definition: MooseServer.C:55
bool gatherDocumentDefinitionLocations(wasp::DataArray &definitionLocations, int line, int character)
Gather definition locations - specific to this server implemention.
Definition: MooseServer.C:927
bool addLocationNodesToList(wasp::DataArray &defsOrRefsLocations, const SortedLocationNodes &location_nodes)
Add set of nodes sorted by location to definition or reference list.
Definition: MooseServer.C:1078
bool connectionWrite(wasp::DataObject &object)
Write object json to connection - specific to this server&#39;s connection.
Definition: MooseServer.h:384
std::map< std::string, std::set< std::string > > _syntax_to_subblocks
_syntax_to_subblocks - map of syntax paths to valid subblocks
Definition: MooseServer.h:466
virtual ~MooseServer()=default
int getCompletionItemKind(const InputParameters &valid_params, const std::string &param_name, const std::string &clean_type, bool is_param)
Get completion item kind value that client may use for icon in list.
Definition: MooseServer.C:1521
void getEnumsAndDocs(MooseEnumType &moose_enum_param, std::map< std::string, std::string > &options_and_descs)
Fill map of all options and descriptions if parameter is moose enum.
Definition: MooseServer.C:915
Class for parsing input files.
Definition: Parser.h:87
std::map< std::string, CheckState > _check_state
_check_state - map from document paths to state (parser, app, text)
Definition: MooseServer.h:456
const hit::Node * queryRoot() const
Definition: MooseServer.C:1744
std::string formatDocument(wasp::HITNodeView parent, std::size_t &prev_line, std::size_t level)
Recursively walk down whole nodeview tree while formatting document.
Definition: MooseServer.C:1354
void getExistingInput(wasp::HITNodeView parent_node, std::set< std::string > &existing_params, std::set< std::string > &existing_subblocks)
Get names of parameters and subblocks specified in given input node.
Definition: MooseServer.C:414