CQCExtractorJob¶
-
class
CQCExtractorJob
(job_id, client, parameters=None)[source]¶ Bases:
object
Representation of an asynchronous call to the CQC extractor.
An instance of this class is returned when you call
run_async_ext1()
,run_async_ext2()
, orretrieve_job()
method of theCQCExtractor
class.If the job is successfully submitted, you can inspect the job’s status by calling
status()
.Some of the methods in this class are blocking, which means control may not be returned immediately.
block_until_ready()
is an example of a blocking method, which waits until the job completes:job = extractor.run_async_ext1(...) random_bits = job.block_until_ready()
Note
An error may occur when querying the remote server to get job information. The most common errors are temporary network failures and server errors, in which case an
RequestsApiError
is raised. These errors usually clear quickly, so retrying the operation is likely to succeed.CQCExtractorJob constructor.
- Parameters
job_id (
str
) – Job ID.client (
RandomClient
) – Object for connecting to the server.parameters (
Optional
[Dict
]) – Parameters used for this job.
Methods
Wait for the job to finish and return the result.
Query the server for the latest job status.
Attributes
-
extractor_method
¶ Return the extractor method used.
- Return type
str
- Returns
Extractor method used.
-
parameters
¶ Return the parameters passed to the extractor.
- Return type
Dict
- Returns
Parameters passed to the extractor.