find_latest
- gwdatafind.find_latest(site, frametype, urltype='file', on_missing='error', host=None, session=None, **request_kw)
Query a GWDataFind host for the latest file in a given dataset.
- Parameters
site (
str
) – single-character name of site to matchframetype (
str
) – name of dataset to matchurltype (
str
, optional) – URL scheme to search foron_missing (
str
, optional) –what to do when the requested file isn’t found, one of:
'error'
: raise aRuntimeError
'warn'
: print a warning but return an emptylist
'ignore'
: return an emptylist
with no warnings
host (
str
, optional) – the URL/name of the GWDataFind host to query; if not givenget_default_host()
will be used to discover the default host.session (
requests.Session
, optional) – the connection session to use; if not given, aigwn_auth_utils.requests.Session
will be created on-the-fly**request_kw – other keywords are passed to
igwn_auth_utils.requests.get()
- Returns
urls (
list
ofstr
) – a list of URLs for the latest file found- Raises
requests.RequestsException – if the request fails for any reason
RuntimeError – if no latest file is found and
on_missing="error"
was given
Examples
>>> find_latest('H', 'H1_GWOSC_O2_4KHZ_R1', urltype='file', host='datafind.gw-openscience.org')) ['file://localhost/cvmfs/gwosc.osgstorage.org/gwdata/O2/strain.4k/frame.v1/H1/1186988032/H-H1_GWOSC_O2_4KHZ_R1-1187733504-4096.gwf']