gdZddlmZddlZddlmZmZddlmZm Z m Z ddl m Z ddl mZddlmZdd lmZmZe rdd lmZGd d ZGd deeZdS)zJob abstract interface.) annotationsN)ABCabstractmethod)CallableOptional TYPE_CHECKING) QiskitError)Backend)JobTimeoutError)JOB_FINAL_STATES JobStatus)ResultceZdZdZdZdS)Joba.Base common type for all versioned Job abstract classes. Note this class should not be inherited from directly, it is intended to be used for type checking. When implementing a provider you should use the versioned abstract classes as the parent class and not this class directly. rN)__name__ __module__ __qualname____doc__versionJ/granary/edev/quantum/lib/python3.11/site-packages/qiskit/providers/job.pyrrsGGGrrceZdZdZdZdZd"d Zd#d Zd$d Zd%dZ d%dZ d%dZ d%dZ d&d'dZ edZed(dZdZed)d!ZdS)*JobV1apClass to handle jobs This first version of the Backend abstract class is written to be mostly backwards compatible with the legacy providers interface. This was done to ease the transition for users and provider maintainers to the new versioned providers. Expect, future versions of this abstract class to change the data model and interface. TbackendOptional[Backend]job_idstrreturnNonec 0||_||_||_dS)aInitializes the asynchronous job. Args: backend: the backend used to run the job. job_id: a unique id in the context of the backend used to run the job. kwargs: Any key value metadata to associate with this job. N)_job_id_backendmetadata)selfrrkwargss r__init__zJobV1.__init__7s   rc|jS)z'Return a unique id identifying the job.)r#r&s rrz JobV1.job_idDs |rr c<|jtd|jS)z/Return the backend where this job was executed.Nz"The job does not have any backend.)r$r r*s rrz JobV1.backendHs! = BCC C}rboolcF|tjkS)z,Return whether the job has successfully run.)statusr DONEr*s rdonez JobV1.doneNs{{}} ..rcF|tjkS)z+Return whether the job is actively running.)r.r RUNNINGr*s rrunningz JobV1.runningRs{{}} 111rcF|tjkS)z*Return whether the job has been cancelled.)r.r CANCELLEDr*s r cancelledzJobV1.cancelledVs{{}} 333rc8|tvS)zMReturn whether the job is in a final job state such as ``DONE`` or ``ERROR``.)r.r r*s rin_final_statezJobV1.in_final_stateZs{{}} 000rNtimeoutOptional[float]waitfloatcallbackOptional[Callable]c|jsdStj}|}|tvrtj|z }|+||kr%t d|d|r||||tj||}|tvdS)aPoll the job status until it progresses to a final state such as ``DONE`` or ``ERROR``. Args: timeout: Seconds to wait for the job. If ``None``, wait indefinitely. wait: Seconds between queries. callback: Callback function invoked after each query. The following positional arguments are provided to the callback function: * job_id: Job ID * job_status: Status of the job from the last query * job: This BaseJob instance Note: different subclass might provide different arguments to the callback function. Raises: JobTimeoutError: If the job does not reach a final state before the specified timeout. NzTimeout while waiting for job .)_asynctimer.r r rsleep)r&r:r<r> start_timer. elapsed_times rwait_for_final_statezJobV1.wait_for_final_state^s,{  FY[[ ,,,9;;3L"|w'>'>%&Wt{{}}&W&W&WXXX 6555 Jt   [[]]F,,, rcdS)z,Submit the job to the backend for execution.Nrr*s rsubmitz JobV1.submit  rrcdS)zReturn the results of the job.Nrr*s rresultz JobV1.resultrJrct)zAttempt to cancel the job.)NotImplementedErrorr*s rcancelz JobV1.cancels!!rr cdS)z@Return the status of the job, among the values of ``JobStatus``.Nrr*s rr.z JobV1.statusrJr)rrrrr r!)r r)r r )r r,)Nr9N)r:r;r<r=r>r?r r!)r r)r r )rrrrrrBr(rrr0r3r6r8rGrrIrLrOr.rrrrr*sAG F     ////222244441111 `d"""""H  ^    ^ """   ^   rr)r __future__rrCabcrrtypingrrrqiskit.exceptionsr qiskit.providers.backendr qiskit.providers.exceptionsr qiskit.providers.jobstatusr r qiskit.resultrrrrrrrYs."""""" ########4444444444)))))),,,,,,777777BBBBBBBB%$$$$$$        i i i i i Ci i i i i r