Handler events handler

Receive events on handler

class luna_handlers.app.handlers.handler_events_handler.HandlerEventsHandler(request)

Receiver of events.

Resource: “/{api_version}/handlers/{handlerId}/events”

async getDataFromMultipart(imageType=ImageType.rawImage)

Get data from multipart request :param imageType: image type

Returns

list of Images or list warps and optionally dict with policies (for multipart request with policies)

Return type

Tuple[Union[List[SDKDetectableImage], List[FaceWarp]], Optional[dict]]

getEventTimes()

Get event times from header.

Supported headers:

Luna-Event-Time - event creation time Luna-Event-End-Time - event end time

Returns

tuple with create and end event times

Return type

tuple[str, str]

async getInputEstimationData(request, validationModel, imageType=ImageType.rawImage, autoOrient=True, allowRawDescriptors=True)

Get images from request body to detect faces and, optionally, policies for a dynamic handler. :param request: request :param imageType: imageType :param validationModel: validation model :param autoOrient: whether to use orientation from exif or not :param allowRawDescriptors: whether raw descriptor mimetypes allowed or not

Returns

list of Images or list warps and, optionally, policies for a dynamic handler.

Return type

Tuple[Union[List[SDKDetectableImage], List[FaceWarp]], Optional[dict]]

async loadHandlerAndInputImages(handlerId)

Prepare handler and input images for processing.

If handler is static, policies are loaded from the database. If handler is dynamic, policies are required to be in the input request (multipart).

Parameters

handlerId – handler id

Returns

tuple with handler object, input images, version of cached handler or None

Return type

tuple[CachedHandlerModel, Union[List[SDKDetectableImage], List[FaceWarp]], datetime]

loadLocation()

Load location data from the query parameters.

Returns

location

Return type

Location

parseTimeFromHeader(name, defaultTime)

Parse datetime from header by name.

Parameters

• name – header name

• defaultTime – default time

Returns

user datetime if correct header or default datetime

Return type

datetime

async post(handlerId)

Receive events handler. See spec receive_events.

Parameters

handlerId – handler id

Returns

Response with events and detections

Raises

VLException(Error.BadMultipartInput, 400, isCriticalError=False) – if failed to read multipart

Return type

HTTPResponse