Ѯh# XddlmZmZmZddlmZmZmZedZGddeeZ y))ExplainMetricsExplainOptionsQueryExplainError)ListOptionalTypeVarTcjeZdZdZ d dedeedeeffd Ze deefdZ defdZ xZ S) QueryResultsLista\A list of received query results from the query call. This is a subclass of the built-in list. A new property `explain_metrics` is added to return the query profile results. Args: docs (list): The list of query results. explain_options (Optional[:class:`~google.cloud.firestore_v1.query_profile.ExplainOptions`]): Options to enable query profiling for this query. When set, explain_metrics will be available on the returned generator. explain_metrics (Optional[ExplainMetrics]): Query profile results. docsexplain_optionsexplain_metricsc|t||| | td| | td||_||_y)Nz=If explain_options is set, explain_metrics must be non-empty.z;If explain_options is empty, explain_metrics must be empty.)super__init__ ValueError_explain_options_explain_metrics)selfr r r __class__s y/home/www/academy-backend.kofcorporation.com/venv/lib/python3.12/site-packages/google/cloud/firestore_v1/query_results.pyrzQueryResultsList.__init__+s^   &?+BO  $)DM !0 /returnc|jS)z8Query profiling options for getting these query results.)rrs rr z QueryResultsList.explain_options@s$$$rcv|j td|j td|jS)a@ Get the metrics associated with the query execution. Metrics are only available when explain_options is set on the query. If ExplainOptions.analyze is False, only plan_summary is available. If it is True, execution_stats is also available. :rtype: :class:`~google.cloud.firestore_v1.query_profile.ExplainMetrics` :returns: The metrics associated with the query execution. :raises: :class:`~google.cloud.firestore_v1.query_profile.QueryExplainError` if explain_metrics is not available on the query. z!explain_options not set on query.z8explain_metrics is empty despite explain_options is set.)rrrrs rget_explain_metricsz$QueryResultsList.get_explain_metricsEsF  (#$GH H  " " *#J (( (r)NN) __name__ __module__ __qualname____doc__rrrrrpropertyr r __classcell__)rs@rr r sg&5948 00".10".1 0*%.!9%%)^)rr N) 'google.cloud.firestore_v1.query_profilerrrtypingrrrr r rrr's0 +* CL=)tAw=)r