- classmethod VSMFile.load(*args, **kargs)¶
Create a new
DataFilefrom a file on disc guessing a better subclass if necessary.
filename (string or None) – path to file to load
- Keyword Arguments
auto_load (bool) – If True (default) then the load routine tries all the subclasses of
DataFilein turn to load the file
DataFile, str) – If not none then tries using filetype as the loader.
(Data) – A new instance of
Stoner.Dataor a s subclass of
Stoner.DataFileif loaded_class is True.
If filetype is a string, then it is first tried as an exact match to a subclass name, otherwise it is used as a partial match and the first class in priority order is that matches is used.
Some subclasses can be found in the
Each subclass is scanned in turn for a class attribute priority which governs the order in which they are tried. Subclasses which can make an early positive determination that a file has the correct format can have higher priority levels. Classes should return a suitable expcetion if they fail to load the file.
If no class can load a file successfully then a StonerUnrecognisedFormat exception is raised.