Module _utils

Returns the object to process the given format according to the mapping.

Arguments:
format -- Lower case string denoting one of the supported formats.
mapping -- Dictionary of format and object name mapping.

Returns a getter property with a cascading setter.

This is used for the `id` and `description` properties of the container
objects. These items have their own private attributes that stores query
and/or hit ID and description. To keep the container items' query and/or
hit ID and description in-sync, the setter cascades any new value given
to the items' values as well.

Returns a getter property with a cascading setter.

This is similar to `partialcascade`, but for SearchIO containers that have
at least one item (Hit and HSP). The getter always retrieves the attribute
value from the first item. If the items have more than one attribute values,
an error will be raised. The setter behaves like `partialcascade`, except
that it only sets attributes to items in the object, not the object itself.

Returns a getter property with a cascading setter.

This is similar to `fullcascade`, but for SearchIO containers that have
at zero or more items. The getter always tries to retrieve the attribute
value from the first item, but falls back to the value in the container.
If the items have more than one attribute values, an error will be raised.
The setter behaves like `partialcascade`.

Returns a getter property with cascading setter, for HSPFragment objects.

Similar to `partialcascade`, but for HSPFragment objects and acts on `query`
or `hit` properties of the object if they are not None.