iqm-pulla 11.1.0__tar.gz → 11.3.0__tar.gz

{iqm_pulla-11.1.0 → iqm_pulla-11.3.0}/CHANGELOG.rst

@@ -2,6 +2,22 @@
 Changelog
 =========
 
+Version 11.3.0 (2025-09-12)
+===========================
+
+Features
+--------
+
+- Update dependency on station-control-client
+
+Version 11.2.0 (2025-09-12)
+===========================
+
+Features
+--------
+
+- Allow executing jobs in async fashion
+
 Version 11.1.0 (2025-09-12)
 ===========================
 

{iqm_pulla-11.1.0 → iqm_pulla-11.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-pulla
-Version: 11.1.0
+Version: 11.3.0
 Summary: Client library for pulse-level access to an IQM quantum computer
 Author-email: IQM Finland Oy <developers@meetiqm.com>
 License:                                  Apache License
@@ -217,30 +217,30 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
 License-File: AUTHORS.rst
 Requires-Dist: iqm-exa-common<27,>=26
-Requires-Dist: iqm-station-control-client<10,>=9
+Requires-Dist: iqm-station-control-client<11,>=10
 Requires-Dist: iqm-pulse<13,>=12
 Requires-Dist: iqm-data-definitions<3.0,>=2.13
 Requires-Dist: pylatexenc==2.10
 Requires-Dist: pydantic<3.0,>=2.10.4
 Provides-Extra: notebook
 Requires-Dist: iqm-exa-common<27,>=26; extra == "notebook"
-Requires-Dist: iqm-station-control-client<10,>=9; extra == "notebook"
+Requires-Dist: iqm-station-control-client<11,>=10; extra == "notebook"
 Requires-Dist: iqm-pulse<13,>=12; extra == "notebook"
 Requires-Dist: notebook<7,>=6.4.11; extra == "notebook"
 Requires-Dist: matplotlib<4,>=3.6.3; extra == "notebook"
 Requires-Dist: nbclient~=0.5.10; extra == "notebook"
 Provides-Extra: qir
 Requires-Dist: iqm-exa-common<27,>=26; extra == "qir"
-Requires-Dist: iqm-station-control-client<10,>=9; extra == "qir"
+Requires-Dist: iqm-station-control-client<11,>=10; extra == "qir"
 Requires-Dist: iqm-pulse<13,>=12; extra == "qir"
 Requires-Dist: iqm-pyqir==0.12.0; extra == "qir"
 Requires-Dist: iqm-qiskit-qir==0.8.0; extra == "qir"
 Provides-Extra: qiskit
 Requires-Dist: iqm-exa-common<27,>=26; extra == "qiskit"
-Requires-Dist: iqm-station-control-client<10,>=9; extra == "qiskit"
+Requires-Dist: iqm-station-control-client<11,>=10; extra == "qiskit"
 Requires-Dist: iqm-pulse<13,>=12; extra == "qiskit"
-Requires-Dist: iqm-client<32,>=31; extra == "qiskit"
 Requires-Dist: iqm-client[qiskit]<32,>=31; extra == "qiskit"
+Requires-Dist: iqm-client<32,>=31; extra == "qiskit"
 
 IQM Pulla
 #########

{iqm_pulla-11.1.0 → iqm_pulla-11.3.0}/docs/Quick Start.ipynb

@@ -388,6 +388,16 @@
     "print(f\"Qiskit result counts:\\n{qiskit_result.get_counts()}\\n\")"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "1778cf4c",
+   "metadata": {},
+   "source": [
+    "By default, `execute()` submits the job and waits for its completion by polling the server every second, until interrupted. If you pass `wait_completion=False`, then the method will terminate immediately after submitting the job and return a `StationControlResult` object with the job id in `PENDING` status. \n",
+    "\n",
+    "You can then manually retrieve job results by calling `get_execution_result()`. It will also, by default, wait for the job to complete until interrupted. If you pass `wait_completion=False`, then `get_execution_result()` will query the server only once and return the current state; it is then up to you to call `get_execution_result()` until the job is completed."
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "2014d3e7",

{iqm_pulla-11.1.0 → iqm_pulla-11.3.0}/requirements/base.txt

@@ -1,5 +1,5 @@
 iqm-exa-common>=26,<27
-iqm-station-control-client>=9,<10
+iqm-station-control-client>=10,<11
 iqm-pulse>=12,<13
 iqm-data-definitions >= 2.13, < 3.0
 pylatexenc == 2.10

{iqm_pulla-11.1.0 → iqm_pulla-11.3.0}/requirements/notebook.txt

@@ -1,5 +1,5 @@
 iqm-exa-common>=26,<27
-iqm-station-control-client>=9,<10
+iqm-station-control-client>=10,<11
 iqm-pulse>=12,<13
 notebook >= 6.4.11, < 7
 matplotlib >= 3.6.3, < 4

{iqm_pulla-11.1.0 → iqm_pulla-11.3.0}/requirements/qir.txt

@@ -1,5 +1,5 @@
 iqm-exa-common>=26,<27
-iqm-station-control-client>=9,<10
+iqm-station-control-client>=10,<11
 iqm-pulse>=12,<13
 iqm-pyqir==0.12.0
 iqm-qiskit-qir==0.8.0

iqm_pulla-11.3.0/requirements/qiskit.txt

@@ -0,0 +1,5 @@
+iqm-exa-common>=26,<27
+iqm-station-control-client>=10,<11
+iqm-pulse>=12,<13
+iqm-client[qiskit]>=31,<32
+iqm-client>=31,<32

{iqm_pulla-11.1.0 → iqm_pulla-11.3.0}/src/iqm/pulla/pulla.py

@@ -210,6 +210,7 @@ class Pulla:
         context: dict[str, Any],
         settings: SettingNode,
         verbose: bool = True,
+        wait_completion: bool = True,
     ) -> StationControlResult:
         """Executes a quantum circuit on the remote quantum computer.
 
@@ -218,6 +219,7 @@ class Pulla:
             context: Context object of the successful compiler run, containing the readout mappings.
             settings: Station settings.
             verbose: Whether to print results.
+            wait_completion: If True, returns immediately with job ID. If False, waits for completion.
 
         Returns:
             results of the execution
@@ -240,72 +242,130 @@ class Pulla:
             )
         )
         job_id = uuid.UUID(sweep_response["job_id"])
-        try:
-            logger.info("Created job in queue with ID: %s", job_id)
-            if href := sweep_response.get("job_href"):
-                logger.info("Job link: %s", href)
 
-            logger.info("Waiting for the job to finish...")
+        logger.info("Created job in queue with ID: %s", job_id)
+        if href := sweep_response.get("job_href"):
+            logger.info("Job link: %s", href)
 
-            while True:
-                job_data = self._station_control.get_job(job_id)
-                sc_result = StationControlResult(sweep_id=job_id, task_id=job_id, status=TaskStatus.PENDING)
+        if wait_completion:
+            return self.get_execution_result(job_id, context, verbose, wait_completion=True)
+        else:
+            return StationControlResult(sweep_id=job_id, task_id=job_id, status=TaskStatus.PENDING)
 
-                if job_data.job_status <= JobExecutorStatus.EXECUTION_STARTED:  # type: ignore[operator]
-                    # Wait in the task queue while showing a progress bar
+    def get_execution_result(
+        self,
+        job_id: uuid.UUID,
+        context: dict[str, Any],
+        verbose: bool = True,
+        wait_completion: bool = True,
+    ) -> StationControlResult:
+        """Get execution results.
 
-                    interrupted = self._station_control._wait_job_completion(str(job_id), get_progress_bar_callback())  # type: ignore[attr-defined]
-                    if interrupted:
-                        raise KeyboardInterrupt
-                else:
-                    # job is not in queue or executing, so we can query the sweep
-                    sweep_data = self._station_control.get_sweep(job_id)
-                    if job_data.job_status == JobExecutorStatus.READY:
-                        logger.info("Sweep status: %s", str(sweep_data.job_status))
-
-                        sc_result.status = TaskStatus.READY
-                        sc_result.result = map_sweep_results_to_logical_qubits(
-                            self._station_control.get_sweep_results(job_id),
-                            context["readout_mappings"],
-                            context["options"].heralding_mode,
-                        )
-                        sc_result.start_time = (
-                            sweep_data.begin_timestamp.isoformat() if sweep_data.begin_timestamp else None
-                        )
-                        sc_result.end_time = sweep_data.end_timestamp.isoformat() if sweep_data.end_timestamp else None
+        Args:
+            job_id: The ID of the job to process.
+            context: Context object of the successful compiler run, containing the readout mappings.
+            verbose: Whether to print results.
+            wait_completion: If True, waits for job completion. If False, returns current status.
 
-                        if verbose:
-                            # TODO: Consider using just 'logger.debug' here and remove 'verbose'
-                            logger.info(sc_result.result)
+        Returns:
+            The processed station control result.
 
-                        return sc_result
+        """
+        sc_result = StationControlResult(sweep_id=job_id, task_id=job_id, status=TaskStatus.PENDING)
 
-                    if job_data.job_status == JobExecutorStatus.FAILED:
-                        sc_result.status = TaskStatus.FAILED
-                        sc_result.start_time = (
-                            sweep_data.begin_timestamp.isoformat() if sweep_data.begin_timestamp else None
-                        )
-                        sc_result.end_time = sweep_data.end_timestamp.isoformat() if sweep_data.end_timestamp else None
-                        sc_result.message = str(job_data.job_error)
-                        logger.error("Submission failed! Error: %s", sc_result.message)
-                        return sc_result
+        try:
+            if wait_completion:
+                logger.info("Waiting for the job to finish...")
 
-                    if job_data.job_status == JobExecutorStatus.ABORTED:
-                        sc_result.status = TaskStatus.FAILED
-                        sc_result.start_time = (
-                            sweep_data.begin_timestamp.isoformat() if sweep_data.begin_timestamp else None
+            while True:
+                job_data = self._station_control.get_job(job_id)
+                sc_result.status = TaskStatus.PENDING
+
+                if job_data.job_status <= JobExecutorStatus.EXECUTION_STARTED:  # type: ignore[operator]
+                    if wait_completion:
+                        # Wait in the task queue while showing a progress bar
+                        interrupted = self._station_control._wait_job_completion(  # type: ignore[attr-defined]
+                            str(job_id), get_progress_bar_callback()
+                        )
+                        if interrupted:
+                            raise KeyboardInterrupt
+                    else:
+                        # Non-blocking check - return current status
+                        sc_result.status = (
+                            TaskStatus.PROGRESS
+                            if job_data.job_status == JobExecutorStatus.EXECUTION_STARTED
+                            else TaskStatus.PENDING
                         )
-                        sc_result.end_time = sweep_data.end_timestamp.isoformat() if sweep_data.end_timestamp else None
-                        sc_result.message = str(job_data.job_error)
-                        logger.error("Submission was revoked!")
                         return sc_result
-
-                time.sleep(1)
+                else:
+                    # job is not in queue or executing, so we can query the sweep
+                    result_or_nothing = self._get_result_of_started_job(
+                        context, job_data, job_id, sc_result, wait_completion, verbose
+                    )
+                    if result_or_nothing is not None:
+                        return result_or_nothing
+
+                if wait_completion:
+                    time.sleep(1)
+                else:
+                    break
 
         except KeyboardInterrupt as exc:
-            logger.info("Caught KeyboardInterrupt, revoking job %s", job_id)
-            self._station_control.abort_job(job_id)
+            if wait_completion:
+                logger.info("Caught KeyboardInterrupt, revoking job %s", job_id)
+                self._station_control.abort_job(job_id)
             raise KeyboardInterrupt from exc
 
+        return sc_result
+
+    def _get_result_of_started_job(
+        self,
+        context: dict[str, Any],
+        job_data: Any,
+        job_id: uuid.UUID,
+        sc_result: StationControlResult,
+        wait_completion: bool,
+        verbose: bool,
+    ) -> StationControlResult | None:
+        sweep_data = self._station_control.get_sweep(job_id)
+        if job_data.job_status == JobExecutorStatus.READY:
+            if wait_completion:
+                logger.info("Sweep status: %s", str(sweep_data.job_status))
+
+            sc_result.status = TaskStatus.READY
+            sc_result.result = map_sweep_results_to_logical_qubits(
+                self._station_control.get_sweep_results(job_id),
+                context["readout_mappings"],
+                context["options"].heralding_mode,
+            )
+            sc_result.start_time = sweep_data.begin_timestamp.isoformat() if sweep_data.begin_timestamp else None
+            sc_result.end_time = sweep_data.end_timestamp.isoformat() if sweep_data.end_timestamp else None
+
+            if verbose and wait_completion:
+                # TODO: Consider using just 'logger.debug' here and remove 'verbose'
+                logger.info(sc_result.result)
+
+            return sc_result
+
+        if job_data.job_status == JobExecutorStatus.FAILED:
+            sc_result.status = TaskStatus.FAILED
+            sc_result.start_time = sweep_data.begin_timestamp.isoformat() if sweep_data.begin_timestamp else None
+            sc_result.end_time = sweep_data.end_timestamp.isoformat() if sweep_data.end_timestamp else None
+            sc_result.message = str(job_data.job_error)
+            if wait_completion:
+                logger.error("Submission failed! Error: %s", sc_result.message)
+            return sc_result
+
+        if job_data.job_status == JobExecutorStatus.ABORTED:
+            sc_result.status = TaskStatus.FAILED
+            sc_result.start_time = sweep_data.begin_timestamp.isoformat() if sweep_data.begin_timestamp else None
+            sc_result.end_time = sweep_data.end_timestamp.isoformat() if sweep_data.end_timestamp else None
+            sc_result.message = str(job_data.job_error)
+            if wait_completion:
+                logger.error("Submission was revoked!")
+            return sc_result
+
+        return None
+
 
 init_loggers({"iqm": "INFO"})

{iqm_pulla-11.1.0 → iqm_pulla-11.3.0}/src/iqm_pulla.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-pulla
-Version: 11.1.0
+Version: 11.3.0
 Summary: Client library for pulse-level access to an IQM quantum computer
 Author-email: IQM Finland Oy <developers@meetiqm.com>
 License:                                  Apache License
@@ -217,30 +217,30 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
 License-File: AUTHORS.rst
 Requires-Dist: iqm-exa-common<27,>=26
-Requires-Dist: iqm-station-control-client<10,>=9
+Requires-Dist: iqm-station-control-client<11,>=10
 Requires-Dist: iqm-pulse<13,>=12
 Requires-Dist: iqm-data-definitions<3.0,>=2.13
 Requires-Dist: pylatexenc==2.10
 Requires-Dist: pydantic<3.0,>=2.10.4
 Provides-Extra: notebook
 Requires-Dist: iqm-exa-common<27,>=26; extra == "notebook"
-Requires-Dist: iqm-station-control-client<10,>=9; extra == "notebook"
+Requires-Dist: iqm-station-control-client<11,>=10; extra == "notebook"
 Requires-Dist: iqm-pulse<13,>=12; extra == "notebook"
 Requires-Dist: notebook<7,>=6.4.11; extra == "notebook"
 Requires-Dist: matplotlib<4,>=3.6.3; extra == "notebook"
 Requires-Dist: nbclient~=0.5.10; extra == "notebook"
 Provides-Extra: qir
 Requires-Dist: iqm-exa-common<27,>=26; extra == "qir"
-Requires-Dist: iqm-station-control-client<10,>=9; extra == "qir"
+Requires-Dist: iqm-station-control-client<11,>=10; extra == "qir"
 Requires-Dist: iqm-pulse<13,>=12; extra == "qir"
 Requires-Dist: iqm-pyqir==0.12.0; extra == "qir"
 Requires-Dist: iqm-qiskit-qir==0.8.0; extra == "qir"
 Provides-Extra: qiskit
 Requires-Dist: iqm-exa-common<27,>=26; extra == "qiskit"
-Requires-Dist: iqm-station-control-client<10,>=9; extra == "qiskit"
+Requires-Dist: iqm-station-control-client<11,>=10; extra == "qiskit"
 Requires-Dist: iqm-pulse<13,>=12; extra == "qiskit"
-Requires-Dist: iqm-client<32,>=31; extra == "qiskit"
 Requires-Dist: iqm-client[qiskit]<32,>=31; extra == "qiskit"
+Requires-Dist: iqm-client<32,>=31; extra == "qiskit"
 
 IQM Pulla
 #########

{iqm_pulla-11.1.0 → iqm_pulla-11.3.0}/src/iqm_pulla.egg-info/requires.txt

@@ -1,5 +1,5 @@
 iqm-exa-common<27,>=26
-iqm-station-control-client<10,>=9
+iqm-station-control-client<11,>=10
 iqm-pulse<13,>=12
 iqm-data-definitions<3.0,>=2.13
 pylatexenc==2.10
@@ -7,7 +7,7 @@ pydantic<3.0,>=2.10.4
 
 [notebook]
 iqm-exa-common<27,>=26
-iqm-station-control-client<10,>=9
+iqm-station-control-client<11,>=10
 iqm-pulse<13,>=12
 notebook<7,>=6.4.11
 matplotlib<4,>=3.6.3
@@ -15,14 +15,14 @@ nbclient~=0.5.10
 
 [qir]
 iqm-exa-common<27,>=26
-iqm-station-control-client<10,>=9
+iqm-station-control-client<11,>=10
 iqm-pulse<13,>=12
 iqm-pyqir==0.12.0
 iqm-qiskit-qir==0.8.0
 
 [qiskit]
 iqm-exa-common<27,>=26
-iqm-station-control-client<10,>=9
+iqm-station-control-client<11,>=10
 iqm-pulse<13,>=12
-iqm-client<32,>=31
 iqm-client[qiskit]<32,>=31
+iqm-client<32,>=31

iqm_pulla-11.3.0/version.txt

@@ -0,0 +1 @@
+11.3.0

iqm_pulla-11.1.0/requirements/qiskit.txt

@@ -1,5 +0,0 @@
-iqm-exa-common>=26,<27
-iqm-station-control-client>=9,<10
-iqm-pulse>=12,<13
-iqm-client>=31,<32
-iqm-client[qiskit]>=31,<32

iqm_pulla-11.1.0/version.txt

@@ -1 +0,0 @@
-11.1.0