query_versions¶

dqsegdb2.query_versions(flag, host=None, raw=False, **request_kwargs)¶

Query for defined versions for the given flag.

Parameters:

flag (str) – The name for which to query.
host (str, optional) – The URL of the DQSegDB server; if None get_default_host() will be used to discover the default host.
raw (bool, optional) – Return the full JSON response from the request.
request_kwargs – Other keyword arguments are passed to igwn_auth_utils.get().

Returns:

list of int – If raw=False (default), the list of defined versions for the given flag.
dict – If raw=True: the full JSON response is returned.

Examples

>>> from dqsegdb2.query import query_versions
>>> query_versions('G1:GEO-SCIENCE')
[1, 2, 3]
>>> query_versions('G1:GEO-SCIENCE', raw=True)
{'resource_type': 'version', 'version': [1, 2, 3],
 'query_information': ...}