swh.web.utils.query module

swh.web.utils.query.parse_hash(q)

Detect the hash type of a user submitted query string.

Parameters:

• format (query string with the following) – “[HASH_TYPE:]HEX_CHECKSUM”,

• optional (where HASH_TYPE is)

• "sha1" (defaults to)

• of (and can be one)

• swh.model.hashutil.ALGORITHMS

Returns:

A pair (hash_algorithm, byte hash value)

Raises:

• ValueError if the given query string does not correspond to a valid –

• hash value –

swh.web.utils.query.parse_hash_with_algorithms_or_throws(q, accepted_algo, error_msg)

Parse a query but only accepts accepted_algo. Otherwise, raise the exception with message error_msg.

Parameters:

• q (-) – query string with the following format: “[HASH_TYPE:]HEX_CHECKSUM”

• optional (where HASH_TYPE is)

• "sha1" (defaults to)

• of (and can be one)

• swh.model.hashutil.ALGORITHMS.

• accepted_algo (-) – array of strings representing the names of accepted

• algorithms.

• error_msg (-) – error message to raise as BadInputExc if the algo of

• match. (the query does not)

Returns:

A pair (hash_algorithm, byte hash value)

Raises:

• BadInputExc when the inputs is invalid or does not –

• validate the accepted algorithms. –