azure-quantum 1.1.2.dev0__tar.gz → 1.2.1__tar.gz

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: azure-quantum
-Version: 1.1.2.dev0
+Version: 1.2.1
 Summary: Python client for Azure Quantum
 Home-page: https://github.com/microsoft/azure-quantum-python
 Author: Microsoft

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/_client/_version.py

@@ -6,4 +6,4 @@
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
-VERSION = "1.1.2.dev0"
+VERSION = "1.2.1"

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/_workspace_connection_params.py

@@ -541,4 +541,5 @@ class WorkspaceConnectionParams:
             location=get_value('location'),
             quantum_endpoint=get_value('quantum_endpoint'),
             api_key=get_value('api_key'),
+            arm_endpoint=get_value('arm_endpoint'),
         )

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/job/__init__.py

@@ -8,7 +8,7 @@
 from azure.quantum._client.models import JobDetails
 from .base_job import BaseJob
 from .filtered_job import FilteredJob
-from .job import Job
+from .job import Job, ContentType
 from .job_failed_with_results_error import JobFailedWithResultsError
 from .workspace_item import WorkspaceItem
 from .workspace_item_factory import WorkspaceItemFactory
@@ -17,6 +17,7 @@ from .session import Session, SessionHost, SessionDetails, SessionStatus, Sessio
 __all__ = [
     "Job",
     "JobDetails",
+    "ContentType",
     "BaseJob",
     "FilteredJob",
     "WorkspaceItem",
@@ -24,5 +25,6 @@ __all__ = [
     "SessionHost",
     "SessionDetails",
     "SessionStatus",
-    "SessionJobFailurePolicy"
+    "SessionJobFailurePolicy",
+    "JobFailedWithResultsError"
     ]

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/job/job.py

@@ -105,13 +105,16 @@ class Job(BaseJob, FilteredJob):
     def get_results(self, timeout_secs: float = DEFAULT_TIMEOUT):
         """Get job results by downloading the results blob from the
         storage container linked via the workspace.
-
+        
         Raises :class:`RuntimeError` if job execution fails.
+        
+        Raises :class:`azure.quantum.job.JobFailedWithResultsError` if job execution fails, 
+                but failure results could still be retrieved (e.g. for jobs submitted against "microsoft.dft" target).
 
         :param timeout_secs: Timeout in seconds, defaults to 300
         :type timeout_secs: float
         :return: Results dictionary with histogram shots, or raw results if not a json object.
-        :rtype: Any
+        :rtype: typing.Any
         """
         if self.results is not None:
             return self.results

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/job/job_failed_with_results_error.py

@@ -2,14 +2,22 @@ import json
 from typing import Any, Dict, Union
 
 class JobFailedWithResultsError(RuntimeError):
-    """
-    Error produced when Job completes with status "Failed" and the Job
+    """Error produced when Job completes with status "Failed" and the Job
     supports producing failure results.
 
-    The failure results can be accessed with get_failure_results() method
+    The failure results can be accessed with get_failure_results() method.
     """
-    
+
     def __init__(self, message: str, failure_results: Any, *args: object) -> None:
+        """Initializes error produced when Job completes with status "Failed" and the Job
+        supports producing failure results.
+
+        :param message: Error message.
+        :type message: str
+        :param failure_results: Failure results produced by the job.
+        :type failure_results: Any
+        """
+
         self._set_error_details(message, failure_results)
         super().__init__(message, *args)
 

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/qiskit/__init__.py

@@ -5,10 +5,11 @@
 
 """Azure Quantum Qiskit Provider"""
 
-from .provider import AzureQuantumProvider
+from .provider import AzureQuantumProvider, AzureQuantumJob
 from azure.quantum import __version__
 
 __all__ = [
     "AzureQuantumProvider",
+    "AzureQuantumJob",
     "__version__"
 ]

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/qiskit/backends/__init__.py

@@ -43,3 +43,9 @@ from azure.quantum.qiskit.backends.microsoft import (
     MicrosoftBackend,
     MicrosoftResourceEstimationBackend,
 )
+
+from .backend import AzureBackendBase
+
+__all__ = [
+    "AzureBackendBase"
+]

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/qiskit/backends/backend.py

@@ -129,6 +129,7 @@ class AzureBackendBase(Backend, SessionHost):
         if self._can_send_shots_input_param():
             options_shots = options.pop(self.__class__._SHOTS_PARAM_NAME, None)
 
+            final_shots = None
             # First we check for the explicitly specified 'shots' parameter, then for a provider-specific
             # field in options, then for a backend's default value. 
 
@@ -142,7 +143,7 @@ class AzureBackendBase(Backend, SessionHost):
             
             elif shots is not None:
                 final_shots = shots
-            else:
+            elif options_shots is not None:
                 warnings.warn(
                     f"Parameter '{self.__class__._SHOTS_PARAM_NAME}' is subject to change in future versions. "
                     "Please, use 'shots' parameter instead."

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/qiskit/backends/quantinuum.py

@@ -14,6 +14,7 @@ from qiskit import QuantumCircuit
 from qiskit.providers.models import BackendConfiguration
 from qiskit.providers import Options
 from qiskit.providers import Provider
+from qiskit.qasm2 import dumps
 
 import logging
 
@@ -243,7 +244,7 @@ class QuantinuumBackend(AzureBackend):
 
     def _translate_input(self, circuit):
         """Translates the input values to the format expected by the AzureBackend."""
-        return circuit.qasm()
+        return dumps(circuit)
 
     def estimate_cost(
         self, circuit: QuantumCircuit, shots: int = None, count: int = None
@@ -267,7 +268,7 @@ class QuantinuumBackend(AzureBackend):
         if shots is None:
             raise ValueError("Missing input argument 'shots'.")
 
-        input_data = circuit.qasm()
+        input_data = dumps(circuit)
         workspace = self.provider().get_workspace()
         target = workspace.get_targets(self.name())
         return target.estimate_cost(input_data, shots=shots)

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/qiskit/provider.py

@@ -6,7 +6,7 @@
 import warnings
 import inspect
 from itertools import groupby
-from typing import Dict, List, Tuple, Type
+from typing import Dict, List, Optional, Tuple, Type
 from azure.quantum import Workspace
 
 try:
@@ -24,17 +24,13 @@ from azure.quantum.qiskit.backends.backend import AzureBackendBase
 from azure.quantum.qiskit.job import AzureQuantumJob
 from azure.quantum.qiskit.backends import *
 
-
 QISKIT_USER_AGENT = "azure-quantum-qiskit"
 
-
 class AzureQuantumProvider(Provider):
-    """
-    Class for interfacing with the Azure Quantum service
-    using Qiskit quantum circuits
-    """
-    def __init__(self, workspace: Workspace=None, **kwargs):
-        """AzureQuantumService class
+    
+    def __init__(self, workspace: Optional[Workspace]=None, **kwargs):
+        """Class for interfacing with the Azure Quantum service
+        using Qiskit quantum circuits.
 
         :param workspace: Azure Quantum workspace. If missing it will create a new Workspace passing `kwargs` to the constructor. Defaults to None. 
         :type workspace: Workspace
@@ -66,7 +62,7 @@ class AzureQuantumProvider(Provider):
             name (str): name of the backend.
             **kwargs: dict used for filtering.
         Returns:
-            Backend: a backend matching the filtering.
+            azure.quantum.qiskit.backends.AzureBackendBase: a backend matching the filtering.
         Raises:
             QiskitBackendNotFoundError: if no backend could be found or
                 more than one backend matches the filtering criteria.
@@ -110,7 +106,7 @@ see https://aka.ms/AQ/Docs/AddProvider"
             name (str): name of the backend.
             **kwargs: dict used for filtering.
         Returns:
-            typing.List[qiskit.providers.BackendV1]: a list of Backends that match the filtering
+            typing.List[azure.quantum.qiskit.backends.AzureBackendBase]: a list of Backends that match the filtering
                 criteria.
         """
 
@@ -143,7 +139,13 @@ see https://aka.ms/AQ/Docs/AddProvider"
         return backends
 
     def get_job(self, job_id) -> AzureQuantumJob:
-        """Returns the Job instance associated with the given id."""
+        """Returns the Job instance associated with the given id.
+        
+        Args:
+            job_id (str): Id of the Job to return.
+        Returns:
+            AzureQuantumJob: Job instance.
+        """
         azure_job = self._workspace.get_job(job_id)
         backend = self.get_backend(azure_job.details.target)
         return AzureQuantumJob(backend, azure_job)

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/target/microsoft/elements/dft/job.py

@@ -27,8 +27,10 @@ class MicrosoftElementsDftJob(Job):
 
         :param timeout_secs: Timeout in seconds, defaults to 300
         :type timeout_secs: float
-        :raises: :class:`RuntimeError` Raises RuntimeError if job execution failed
-        :return: Results dictionary with histogram shots, or raw results if not a json object.
+        :raises: :class:`RuntimeError` if job execution failed.
+        :raises: :class:`azure.quantum.job.JobFailedWithResultsError` if job execution failed,
+                but failure results could still be retrieved.
+        :return: Results dictionary.
         """
 
         try:

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/target/pasqal/result.py

@@ -26,16 +26,16 @@ class Result:
        job = Job(...)  # This job should come from a Pasqal target
        job.wait_until_completed()
        result = Result(job)
-
     """
 
     def __init__(self, job: Job) -> None:
         """
         Decode the results of a Job with output type of "pasqal.pulser-results.v1"
 
-        :param job: Azure Quantum job
-        :type job: Job
-        :raises: RuntimeError if the job has not completed successfully
+        Args:
+            job (Job): Azure Quantum job
+        Raises:
+            RuntimeError: if the job has not completed successfully
         """
 
         if job.details.status != "Succeeded":

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/target/pasqal/target.py

@@ -25,6 +25,8 @@ class PasqalTarget(str, Enum):
     """
 
     SIM_EMU_TN = "pasqal.sim.emu-tn"
+    """pasqal.sim.emu-tn target"""
+
     QPU_FRESNEL = "pasqal.qpu.fresnel"
     """A simulator target for Quil. See https://github.com/quil-lang/qvm for more info."""
 
@@ -52,7 +54,11 @@ class PasqalTarget(str, Enum):
 
 @dataclass
 class InputParams:
-    """Input parameters"""
+    """Input parameters
+
+    Args:
+        runs (int): The number of times to run the experiment.
+    """
 
     runs: int = 1
     """The number of times to run the experiment."""
@@ -79,6 +85,25 @@ class Pasqal(Target):
         encoding: str = "",
         **kwargs,
     ):
+        """
+        Initializes a new target.
+
+        :param workspace: Associated workspace
+        :type workspace: Workspace
+        :param name: Target name
+        :type name: str
+        :param input_data_format: Format of input data (ex. "pasqal.pulser.v1")
+        :type input_data_format: str
+        :param output_data_format: Format of output data (ex. "pasqal.pulser-results.v1")
+        :type output_data_format: str
+        :param capability: QIR capability
+        :type capability: str
+        :param provider_id: Id of provider (ex. "pasqal")
+        :type provider_id: str
+        :param encoding: "Content-Encoding" attribute value to set on input blob (ex. "gzip")
+        :type encoding: str
+        """
+
         super().__init__(
             workspace=workspace,
             name=name,

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/target/rigetti/result.py

@@ -21,22 +21,26 @@ RawData = Union[int, float, List[float]]
 class Result:
     """Downloads the data of a completed Job and extracts the ``Readout`` for each register.
 
-    >>> from azure.quantum.job import Job
-    >>> from azure.quantum.target.rigetti import Result
-    >>> job = Job(...)  # This job should come from a Rigetti target
-    >>> job.wait_until_completed()
-    >>> result = Result(job)
-    >>> ro_data = result["ro"]
-    >>> first_shot_data = ro_data[0]
+    .. highlight:: python
+    .. code-block::
+    
+       from azure.quantum.job import Job
+       from azure.quantum.target.rigetti import Result
+       job = Job(...)  # This job should come from a Rigetti target
+       job.wait_until_completed()
+       result = Result(job)
+       ro_data = result["ro"]
+       first_shot_data = ro_data[0]
     """
 
     def __init__(self, job: Job) -> None:
         """
         Decode the results of a Job with output type of "rigetti.quil-results.v1"
 
-        :param job: Azure Quantum Job
-        :type job: Job
-        :raises: RuntimeError if the job has not completed successfully
+        Args:
+            job (Job): Azure Quantum job
+        Raises:
+            RuntimeError: if the job has not completed successfully
         """
 
         if job.details.status != "Succeeded":
@@ -53,6 +57,7 @@ class Result:
 
 
 T = TypeVar("T", bound=Union[int, float, complex])
+
 Readout = List[List[T]]
 """Contains the data of a declared "readout" memory region, usually the ``ro`` register.
 

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/target/rigetti/target.py

@@ -146,6 +146,25 @@ class Rigetti(Target):
         encoding: str = "",
         **kwargs,
     ):
+        """
+        Initializes a new target.
+
+        :param workspace: Associated workspace
+        :type workspace: Workspace
+        :param name: Target name
+        :type name: str
+        :param input_data_format: Format of input data (ex. "rigetti.quil.v1")
+        :type input_data_format: str
+        :param output_data_format: Format of output data (ex. "rigetti.quil-results.v1")
+        :type output_data_format: str
+        :param capability: QIR capability
+        :type capability: str
+        :param provider_id: Id of provider (ex. "rigetti")
+        :type provider_id: str
+        :param encoding: "Content-Encoding" attribute value to set on input blob (ex. "gzip")
+        :type encoding: str
+        """
+                
         super().__init__(
             workspace=workspace,
             name=name,

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/target/target.py

@@ -77,7 +77,7 @@ class Target(abc.ABC, SessionHost):
         :param provider_id: Id of provider (ex. "microsoft-qc")
         :type provider_id: str
         :param content_type: "Content-Type" attribute value to set on input blob (ex. "application/json")
-        :type content_type: ContentType
+        :type content_type: azure.quantum.job.ContentType
         :param encoding: "Content-Encoding" attribute value to set on input blob (ex. "gzip")
         :type encoding: str
         :param average_queue_time: Set average queue time (for internal use)

{azure-quantum-1.1.2.dev0 → azure-quantum-1.2.1}/azure/quantum/version.py

@@ -5,4 +5,4 @@
 # Copyright (c) Microsoft Corporation. All rights reserved.
 # Licensed under the MIT License.
 ##
-__version__ = "1.1.2.dev0"
+__version__ = "1.2.1"