COMPS.Data.QueryCriteria module

class COMPS.Data.QueryCriteria.QueryCriteria

Bases: object

A helper class to control query return-sets by filtering on basic properties and tags, as well as controlling which properties and child-objects to fill for returned objects.

property fields

property children

property filters

property tag_filters

property xparams

select(fields)

Set which basic properties to fill for returned objects.

Parameters

fields – A list of basic properties to fill; e.g. [‘id’,’description’].

Returns

A reference to this object so calls can be chained.

select_children(children)

Set which child objects to fill for returned objects.

Parameters

children – A list of child objects to fill; e.g. [‘tags’,’hpc_jobs’].

Returns

A reference to this object so calls can be chained.

where(filters)

Set filter criteria for basic properties.

For string filter values, ‘~’ is used for the “like”-operator (i.e. string-contains). For numeric filter values, standard arithmetic operators are allowed.

Parameters

filters – A list of basic property filter-criteria; e.g. [‘name~Test’,’state=Failed’].

Returns

A reference to this object so calls can be chained.

where_tag(tag_filters)

Set filter criteria for tags.

For string filter values, ‘~’ is used for the “like”-operator (i.e. string-contains). For numeric filter values, standard arithmetic operators are allowed.

Parameters

tag_filters – A list of tag filter-criteria; e.g. [‘Replicate=3’,’DiseaseType~Malaria’].

Returns

A reference to this object so calls can be chained.

orderby(orderby_field)

Set which basic property to sort returned results-set by.

Parameters

orderby_field – A string containing the basic property name to sort by. By default, ascending-sort is assumed, but descending-sort can be specified by appending a space and ‘desc’ to this argument; e.g. ‘date_created desc’.

Returns

A reference to this object so calls can be chained.

offset(offset_num)

Set the offset within the results-set to start returning results from.

Parameters

offset_num – An int to specify offset within the results-set.

Returns

A reference to this object so calls can be chained.

count(count_num)

Set the maximum number of results to return in the results-set.

Parameters

count_num – An int to specify maximum number of results to return.

Returns

A reference to this object so calls can be chained.

add_extra_params(xp_dict)

Set any parameters that aren’t otherwise explicitly supported. This allows taking advantage of future potential changes to COMPS even if pyCOMPS support is not yet implemented or using an older version of pyCOMPS.

Parameters

xp_dict – A dictionary of additional parameters and values to pass to the COMPS API.

Returns

A reference to this object so calls can be chained.

to_param_dict(ent_type)