DataFileInterface Class Reference

Interface for objects that need to resolve data file paths (MooseObject and Action) More...

#include <DataFileInterface.h>

Inheritance diagram for DataFileInterface:

Public Types
using	DataFileParameterType = DataFileName
	The parameter type this interface expects for a data file name.

Public Member Functions
	DataFileInterface (const ParallelParamObject &parent)
	Constructing the object.
std::string	getDataFileName (const std::string &param) const
	Deprecated method.
std::string	getDataFileNameByName (const std::string &relative_path) const
	Deprecated method.
std::string	getDataFilePath (const std::string &relative_path) const
	Returns the path of a data file for a given relative file path.

Private Attributes
const ParallelParamObject &	_parent

Detailed Description

Interface for objects that need to resolve data file paths (MooseObject and Action)

Definition at line 21 of file DataFileInterface.h.

Member Typedef Documentation

DataFileParameterType

using DataFileInterface::DataFileParameterType = DataFileName

The parameter type this interface expects for a data file name.

Definition at line 27 of file DataFileInterface.h.

Constructor & Destructor Documentation

DataFileInterface()

DataFileInterface::DataFileInterface

(

const ParallelParamObject &

parent

)

Constructing the object.

Parameters

parent

Parent object (either MooseObject or Action) for params and output

Definition at line 18 of file DataFileInterface.C.

: _parent(parent) {}

Member Function Documentation

getDataFileName()

std::string DataFileInterface::getDataFileName

(

const std::string &

param

)

const

Deprecated method.

The data file paths are now automatically set within the InputParameters object, so using getParam<DataFileName>("param_name") is now sufficient.

Definition at line 21 of file DataFileInterface.C.

{
  _parent.mooseDeprecated("getDataFileName() is deprecated. The file path is now directly set "
                          "within the InputParameters.\nUse getParam<DataFileName>(\"",
                          param,
                          "\") instead.");
  return _parent.getParam<DataFileName>(param);
}

getDataFileNameByName()

std::string DataFileInterface::getDataFileNameByName

(

const std::string &

relative_path

)

const

Deprecated method.

Use getDataFilePath() instead.

Definition at line 31 of file DataFileInterface.C.

{
  _parent.mooseDeprecated("getDataFileNameByName() is deprecated. Use getDataFilePath(\"",
                          relative_path,
                          "\") instead.");
  return getDataFilePath(relative_path);
}

getDataFilePath()

std::string DataFileInterface::getDataFilePath

(

const std::string &

relative_path

)

const

Returns the path of a data file for a given relative file path.

This can be used for hardcoded datafile names and will search the same locations as getDataFileName

Definition at line 40 of file DataFileInterface.C.

{
  // This should only ever be used with relative paths. There is no point to
  // use this search path with an absolute path.
  if (std::filesystem::path(relative_path).is_absolute())
    _parent.mooseWarning("While using getDataFilePath(\"",
                         relative_path,
                         "\"): This API should not be used for absolute paths.");
 
  // This will search the data paths for this relative path
  std::optional<std::string> error;
  Moose::DataFileUtils::Path found_path;
  {
    // Throw on error so that if getPath() fails, we can throw an error
    // with the context of _parent.mooseError()
    Moose::ScopedThrowOnError scoped_throw_on_error;
 
    try
    {
      found_path = Moose::DataFileUtils::getPath(relative_path);
    }
    catch (std::exception & e)
    {
      error = e.what();
    }
  }
 
  if (error)
    _parent.mooseError(*error);
 
  mooseAssert(found_path.context == Moose::DataFileUtils::Context::DATA,
              "Should only ever obtain data");
  mooseAssert(found_path.data_name, "Should be set");
 
  const std::string msg =
      "Using data file '" + found_path.path + "' from " + *found_path.data_name + " data";
  _parent.mooseInfo(msg);
 
  return found_path.path;
}

Referenced by getDataFileNameByName().

Member Data Documentation

_parent

const ParallelParamObject& DataFileInterface::_parent

private

Definition at line 58 of file DataFileInterface.h.

Referenced by getDataFileName(), getDataFileNameByName(), and getDataFilePath().

---

The documentation for this class was generated from the following files:

• include/interfaces/DataFileInterface.h
• src/interfaces/DataFileInterface.C