def read_inventory(path_or_file_object=None, format=None):
"""
Function to read inventory files.
:param path_or_file_object: Filename or file like object. If this
attribute is omitted, an example :class:`Inventory`
object will be returned.
:type format: str, optional
:param format: Format of the file to read (e.g. ``"STATIONXML"``).
"""
if path_or_file_object is None:
# if no pathname or URL specified, return example catalog
return _createExampleInventory()
return _readFromPlugin("inventory", path_or_file_object, format=format)[0]
def read_inventory(path_or_file_object=None, format=None):
"""
Function to read inventory files.
:param path_or_file_object: File name or file like object. If this
attribute is omitted, an example :class:`Inventory`
object will be returned.
:type format: str, optional
:param format: Format of the file to read (e.g. ``"STATIONXML"``).
"""
if path_or_file_object is None:
# if no pathname or URL specified, return example catalog
return _createExampleInventory()
return _readFromPlugin("inventory", path_or_file_object, format=format)[0]
def read_inventory(path_or_file_object, format=None):
"""
Function to read inventory files.
:param path_or_file_object: Filename or file like object.
"""
# if pathname starts with /path/to/ try to search in examples
if isinstance(path_or_file_object, (str, native_str)) and \
path_or_file_object.startswith('/path/to/'):
try:
path_or_file_object = getExampleFile(path_or_file_object[9:])
except:
# otherwise just try to read the given /path/to folder
pass
return _readFromPlugin("inventory", path_or_file_object, format=format)[0]
