# aiida.orm.nodes.data.remote.stash package¶

Module with data plugins that represent files of completed calculations jobs that have been stashed.

class aiida.orm.nodes.data.remote.stash.RemoteStashData(stash_mode: aiida.common.datastructures.StashMode, **kwargs)[source]

Data plugin that models an archived folder on a remote computer.

A stashed folder is essentially an instance of RemoteData that has been archived. Archiving in this context can simply mean copying the content of the folder to another location on the same or another filesystem as long as it is on the same machine. In addition, the folder may have been compressed into a single file for efficiency or even written to tape. The stash_mode attribute will distinguish how the folder was stashed which will allow the implementation to also unstash it and transform it back into a RemoteData such that it can be used as an input for new CalcJobs.

This class is a non-storable base class that merely registers the stash_mode attribute. Only its subclasses, that actually implement a certain stash mode, can be instantiated and therefore stored. The reason for this design is that because the behavior of the class can change significantly based on the mode employed to stash the files and implementing all these variants in the same class will lead to an unintuitive interface where certain properties or methods of the class will only be available or function properly based on the stash_mode.

__abstractmethods__ = frozenset({})
__init__(stash_mode: aiida.common.datastructures.StashMode, **kwargs)[source]

Construct a new instance

Parameters

stash_mode – the stashing mode with which the data was stashed on the remote.

__module__ = 'aiida.orm.nodes.data.remote.stash.base'
_abc_impl = <_abc_data object>
_logger: Optional[logging.Logger] = <Logger aiida.orm.nodes.data.remote.stash.base.RemoteStashData (REPORT)>
_plugin_type_string = 'data.remote.stash.RemoteStashData.'
_query_type_string = 'data.remote.stash.'
_storable = False
property stash_mode

Return the mode with which the data was stashed on the remote.

Returns

the stash mode.

class aiida.orm.nodes.data.remote.stash.RemoteStashFolderData(stash_mode: aiida.common.datastructures.StashMode, target_basepath: str, source_list: List, **kwargs)[source]

Data plugin that models a folder with files of a completed calculation job that has been stashed through a copy.

This data plugin can and should be used to stash files if and only if the stash mode is StashMode.COPY.

__abstractmethods__ = frozenset({})
__init__(stash_mode: aiida.common.datastructures.StashMode, target_basepath: str, source_list: List, **kwargs)[source]

Construct a new instance

Parameters
• stash_mode – the stashing mode with which the data was stashed on the remote.

• target_basepath – the target basepath.

• source_list – the list of source files.

__module__ = 'aiida.orm.nodes.data.remote.stash.folder'
_abc_impl = <_abc_data object>
_logger: Optional[logging.Logger] = <Logger aiida.orm.nodes.data.remote.stash.folder.RemoteStashFolderData (REPORT)>
_plugin_type_string = 'data.remote.stash.folder.RemoteStashFolderData.'
_query_type_string = 'data.remote.stash.folder.'
_storable = True
property source_list

Return the list of source files that were stashed.

Returns

the list of source files.

property target_basepath

Return the target basepath.

Returns

the target basepath.

## Submodules¶

Data plugin that models an archived folder on a remote computer.

class aiida.orm.nodes.data.remote.stash.base.RemoteStashData(stash_mode: aiida.common.datastructures.StashMode, **kwargs)[source]

Data plugin that models an archived folder on a remote computer.

A stashed folder is essentially an instance of RemoteData that has been archived. Archiving in this context can simply mean copying the content of the folder to another location on the same or another filesystem as long as it is on the same machine. In addition, the folder may have been compressed into a single file for efficiency or even written to tape. The stash_mode attribute will distinguish how the folder was stashed which will allow the implementation to also unstash it and transform it back into a RemoteData such that it can be used as an input for new CalcJobs.

This class is a non-storable base class that merely registers the stash_mode attribute. Only its subclasses, that actually implement a certain stash mode, can be instantiated and therefore stored. The reason for this design is that because the behavior of the class can change significantly based on the mode employed to stash the files and implementing all these variants in the same class will lead to an unintuitive interface where certain properties or methods of the class will only be available or function properly based on the stash_mode.

__abstractmethods__ = frozenset({})
__init__(stash_mode: aiida.common.datastructures.StashMode, **kwargs)[source]

Construct a new instance

Parameters

stash_mode – the stashing mode with which the data was stashed on the remote.

__module__ = 'aiida.orm.nodes.data.remote.stash.base'
_abc_impl = <_abc_data object>
_logger: Optional[logging.Logger] = <Logger aiida.orm.nodes.data.remote.stash.base.RemoteStashData (REPORT)>
_plugin_type_string = 'data.remote.stash.RemoteStashData.'
_query_type_string = 'data.remote.stash.'
_storable = False
property stash_mode

Return the mode with which the data was stashed on the remote.

Returns

the stash mode.

Data plugin that models a stashed folder on a remote computer.

class aiida.orm.nodes.data.remote.stash.folder.RemoteStashFolderData(stash_mode: aiida.common.datastructures.StashMode, target_basepath: str, source_list: List, **kwargs)[source]

Data plugin that models a folder with files of a completed calculation job that has been stashed through a copy.

This data plugin can and should be used to stash files if and only if the stash mode is StashMode.COPY.

__abstractmethods__ = frozenset({})
__init__(stash_mode: aiida.common.datastructures.StashMode, target_basepath: str, source_list: List, **kwargs)[source]

Construct a new instance

Parameters
• stash_mode – the stashing mode with which the data was stashed on the remote.

• target_basepath – the target basepath.

• source_list – the list of source files.

__module__ = 'aiida.orm.nodes.data.remote.stash.folder'
_abc_impl = <_abc_data object>
_logger: Optional[logging.Logger] = <Logger aiida.orm.nodes.data.remote.stash.folder.RemoteStashFolderData (REPORT)>
_plugin_type_string = 'data.remote.stash.folder.RemoteStashFolderData.'
_query_type_string = 'data.remote.stash.folder.'
_storable = True
property source_list

Return the list of source files that were stashed.

Returns

the list of source files.

property target_basepath

Return the target basepath.

Returns

the target basepath.