Fast forward experimental-0.2

.github/workflows/integration-tests-qiskit-main.yml

@@ -0,0 +1,52 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2024.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+name: Integration Tests (Qiskit Main)
+on:
+  schedule:
+    # run integration tests against Qiskit main once a week
+    - cron: '0 0 * * 0'
+  workflow_dispatch:
+jobs:
+  integration-tests:
+    if: github.repository_owner == 'Qiskit'
+    name: Run integration tests - ${{ matrix.environment }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      # avoid cancellation of in-progress jobs if any matrix job fails
+      fail-fast: false
+      matrix:
+        python-version: [ 3.9 ]
+        os: [ "ubuntu-latest" ]
+        environment: [ "ibm-quantum-production", "ibm-quantum-staging", "ibm-cloud-production", "ibm-cloud-staging" ]
+    environment: ${{ matrix.environment }}
+    env:
+      QISKIT_IBM_TOKEN: ${{ secrets.QISKIT_IBM_TOKEN }}
+      QISKIT_IBM_URL: ${{ secrets.QISKIT_IBM_URL }}
+      QISKIT_IBM_INSTANCE: ${{ secrets.QISKIT_IBM_INSTANCE }}
+      LOG_LEVEL: DEBUG
+      STREAM_LOG: True
+      QISKIT_IN_PARALLEL: True
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -c constraints.txt -r requirements-dev.txt -e . git+https://github.com/Qiskit/qiskit.git
+      - name: Run integration tests
+        run: make integration-test

.pylintrc

@@ -379,6 +379,7 @@ function-naming-style=snake_case
 good-names=i,
            j,
            k,
+           dt,
            ex,
            Run,
            _

docs/apidocs/fake_provider.rst

@@ -0,0 +1,4 @@
+.. automodule:: qiskit_ibm_runtime.fake_provider
+   :no-members:
+   :no-inherited-members:
+   :no-special-members:

docs/apidocs/ibm-runtime.rst

@@ -9,3 +9,5 @@ qiskit-ibm-runtime API reference
 
    runtime_service
    options
+   transpiler
+   fake_provider

docs/apidocs/transpiler.rst

@@ -0,0 +1,4 @@
+.. automodule:: qiskit_ibm_runtime.transpiler
+   :no-members:
+   :no-inherited-members:
+   :no-special-members:

docs/conf.py

@@ -25,8 +25,7 @@
 # The short X.Y version
 version = ''
 # The full version, including alpha/beta/rc tags
-docs_url_prefix = "ecosystem/ibm-runtime"
-release = '0.18.1'
+release = '0.19.2'
 
 # -- General configuration ---------------------------------------------------
 
@@ -41,6 +40,7 @@
     'reno.sphinxext',
     'nbsphinx',
     'sphinxcontrib.katex',
+    'matplotlib.sphinxext.plot_directive',
 ]
 templates_path = ['_templates']
 

qiskit_ibm_runtime/VERSION.txt

@@ -1 +1 @@
-0.18.1
+0.19.2

qiskit_ibm_runtime/accounts/account.py

@@ -18,8 +18,8 @@
 from urllib.parse import urlparse
 
 from requests.auth import AuthBase
-from qiskit_ibm_provider.proxies import ProxyConfiguration
-from qiskit_ibm_provider.utils.hgp import from_instance_format
+from ..proxies import ProxyConfiguration
+from ..utils.hgp import from_instance_format
 
 from .exceptions import InvalidAccountError, CloudResourceNameResolutionError
 from ..api.auth import QuantumAuth, CloudAuth

qiskit_ibm_runtime/accounts/management.py

@@ -15,8 +15,7 @@
 import os
 from typing import Optional, Dict
 
-from qiskit_ibm_provider.proxies import ProxyConfiguration
-
+from ..proxies import ProxyConfiguration
 from .exceptions import AccountNotFoundError
 from .account import Account, ChannelType
 from .storage import save_config, read_config, delete_config

qiskit_ibm_runtime/api/client_parameters.py

@@ -13,7 +13,7 @@
 """Represent IBM Quantum account client parameters."""
 
 from typing import Dict, Optional, Any, Union
-from qiskit_ibm_provider.proxies import ProxyConfiguration
+from ..proxies import ProxyConfiguration
 
 from ..utils import get_runtime_api_base_url
 from ..api.auth import QuantumAuth, CloudAuth

qiskit_ibm_runtime/api/clients/__init__.py

@@ -12,8 +12,8 @@
 
 """IBM Quantum API clients."""
 
-from qiskit_ibm_provider.api.clients.base import BaseClient, WebsocketClientCloseCode
-from qiskit_ibm_provider.api.clients.auth import AuthClient
-from qiskit_ibm_provider.api.clients.version import VersionClient
-from qiskit_ibm_provider.api.clients.runtime_ws import RuntimeWebsocketClient
+from .base_websocket_client import WebsocketClientCloseCode
+from .auth import AuthClient
+from .version import VersionClient
+from .runtime_ws import RuntimeWebsocketClient
 from .runtime import RuntimeClient

qiskit_ibm_runtime/api/clients/auth.py

@@ -0,0 +1,172 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2021.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+"""Client for accessing IBM Quantum authentication services."""
+
+from typing import Dict, List, Optional, Any, Union
+from requests.exceptions import RequestException
+
+from ..auth import QuantumAuth
+from ..exceptions import AuthenticationLicenseError, RequestsApiError
+from ..rest import Api
+from ..session import RetrySession
+from ..client_parameters import ClientParameters
+
+
+class AuthClient:
+    """Client for accessing IBM Quantum authentication services."""
+
+    def __init__(self, client_params: ClientParameters) -> None:
+        """AuthClient constructor.
+
+        Args:
+            client_params: Parameters used for server connection.
+        """
+        self.api_token = client_params.token
+        self.auth_url = client_params.url
+        self._service_urls = {}  # type: ignore[var-annotated]
+
+        self.auth_api = Api(RetrySession(self.auth_url, **client_params.connection_parameters()))
+        self.base_api = self._init_service_clients(**client_params.connection_parameters())
+
+    def _init_service_clients(self, **request_kwargs: Any) -> Api:
+        """Initialize the clients used for communicating with the API.
+
+        Args:
+            **request_kwargs: Arguments for the request ``Session``.
+
+        Returns:
+            Client for the API server.
+        """
+        # Request an access token.
+        self.access_token = self._request_access_token()
+        self.auth_api.session.auth = QuantumAuth(access_token=self.access_token)
+        self._service_urls = self.user_urls()
+
+        # Create the api server client, using the access token.
+        base_api = Api(
+            RetrySession(
+                self._service_urls["http"],
+                auth=QuantumAuth(access_token=self.access_token),
+                **request_kwargs,
+            )
+        )
+
+        return base_api
+
+    def _request_access_token(self) -> str:
+        """Request a new access token from the API authentication service.
+
+        Returns:
+            A new access token.
+
+        Raises:
+            AuthenticationLicenseError: If the user hasn't accepted the license agreement.
+            RequestsApiError: If the request failed.
+        """
+        try:
+            response = self.auth_api.login(self.api_token)
+            return response["id"]
+        except RequestsApiError as ex:
+            # Get the original exception that raised.
+            original_exception = ex.__cause__
+
+            if isinstance(original_exception, RequestException):
+                # Get the response from the original request exception.
+                error_response = (
+                    # pylint: disable=no-member
+                    original_exception.response
+                )
+                if error_response is not None and error_response.status_code == 401:
+                    try:
+                        error_code = error_response.json()["error"]["name"]
+                        if error_code == "ACCEPT_LICENSE_REQUIRED":
+                            message = error_response.json()["error"]["message"]
+                            raise AuthenticationLicenseError(message)
+                    except (ValueError, KeyError):
+                        # the response did not contain the expected json.
+                        pass
+            raise
+
+    # User account-related public functions.
+
+    def user_urls(self) -> Dict[str, str]:
+        """Retrieve the API URLs from the authentication service.
+
+        Returns:
+            A dict with the base URLs for the services. Currently
+            supported keys are:
+
+                * ``http``: The API URL for HTTP communication.
+                * ``ws``: The API URL for websocket communication.
+                * ``services`: The API URL for additional services.
+        """
+        response = self.auth_api.user_info()
+        return response["urls"]
+
+    def user_hubs(self) -> List[Dict[str, str]]:
+        """Retrieve the hub/group/project sets available to the user.
+
+        The first entry in the list will be the default set, as indicated by
+        the ``isDefault`` field from the API.
+
+        Returns:
+            A list of dictionaries with the hub, group, and project values keyed by
+            ``hub``, ``group``, and ``project``, respectively.
+        """
+        response = self.base_api.hubs()
+
+        hubs = []  # type: ignore[var-annotated]
+        for hub in response:
+            hub_name = hub["name"]
+            for group_name, group in hub["groups"].items():
+                for project_name, project in group["projects"].items():
+                    entry = {
+                        "hub": hub_name,
+                        "group": group_name,
+                        "project": project_name,
+                    }
+
+                    # Move to the top if it is the default h/g/p.
+                    if project.get("isDefault"):
+                        hubs.insert(0, entry)
+                    else:
+                        hubs.append(entry)
+
+        return hubs
+
+    # Miscellaneous public functions.
+
+    def api_version(self) -> Dict[str, Union[str, bool]]:
+        """Return the version of the API.
+
+        Returns:
+            API version.
+        """
+        return self.base_api.version()
+
+    def current_access_token(self) -> Optional[str]:
+        """Return the current access token.
+
+        Returns:
+            The access token in use.
+        """
+        return self.access_token
+
+    def current_service_urls(self) -> Dict:
+        """Return the current service URLs.
+
+        Returns:
+            A dict with the base URLs for the services, in the same
+            format as :meth:`user_urls()`.
+        """
+        return self._service_urls

qiskit_ibm_runtime/api/clients/backend.py

@@ -17,12 +17,10 @@
 from datetime import datetime as python_datetime
 from abc import ABC, abstractmethod
 
-from qiskit_ibm_provider.api.clients.base import BaseClient
-
 logger = logging.getLogger(__name__)
 
 
-class BaseBackendClient(BaseClient, ABC):
+class BaseBackendClient(ABC):
     """Client for accessing backend information."""
 
     @abstractmethod