Source code for spawn.simulation_inputs.simulation_input
# spawn
# Copyright (C) 2018-2019, Simmovation Ltd.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software Foundation,
# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
"""Abstract base class for simulation inputs
"""
from abc import abstractmethod
[docs]class SimulationInput:
"""Handler of inputs for a simulation that will typically be parsed from and written to a file"""
[docs] @classmethod
def from_file(cls, file_path):
"""Creates a :class:`SimulationInput` by loading a file
:param file_path: The file path to load
:type file_path: path-like
:returns: The simulation input object
:rtype: An instance of :class:`SimulationInput`
"""
raise NotImplementedError()
[docs] @abstractmethod
def to_file(self, file_path):
"""Writes the contents of the input file to disk
:param file_path: The path of the file to write
:type file_path: path-like
"""
raise NotImplementedError()
[docs] @abstractmethod
def hash(self):
"""Returns a hash of the contents of the file
:returns: The hash
:rtype: str
"""
raise NotImplementedError()
@abstractmethod
def __setitem__(self, key, value):
raise NotImplementedError()
@abstractmethod
def __getitem__(self, key):
raise NotImplementedError()