qcs-sdk-python 0.26.1rc2__tar.gz → 0.26.2rc0__tar.gz

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/Cargo.lock

@@ -3247,7 +3247,7 @@ dependencies = [
 
 [[package]]
 name = "qcs"
-version = "0.26.1-rc.2"
+version = "0.26.2-rc.0"
 dependencies = [
  "assert2",
  "async-trait",

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qcs-sdk-python
-Version: 0.26.1rc2
+Version: 0.26.2rc0
 Classifier: Development Status :: 3 - Alpha
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3.10

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/crates/lib/CHANGELOG.md

@@ -1,3 +1,20 @@
+## 0.26.2-rc.0 (2026-04-22)
+
+### Fixes
+
+- expose list_isas and use it in Python tests (#585)
+
+## 0.26.1 (2026-03-30)
+
+### Features
+
+- upgrade qcs-api-client dependencies (#581)
+
+### Fixes
+
+- selecting an accessor should not prefer None to Some({ rank: None }) (#579)
+- use gzip compression for grpc (#526)
+
 ## 0.26.1-rc.2 (2026-03-30)
 
 ### Features

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/crates/lib/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "qcs"
 description = "High level interface for running Quil on a QPU"
-version = "0.26.1-rc.2"
+version = "0.26.2-rc.0"
 edition = "2018"
 license = "Apache-2.0"
 repository = "https://github.com/rigetti/qcs-sdk-rust"

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/crates/lib/src/python/errors.rs

@@ -151,6 +151,14 @@ exception!(
     "Errors raised due to failure to get an ISA."
 );
 
+exception!(
+    crate::qpu::ListISAsError,
+    qcs_sdk.qpu.isa,
+    ListISAsError,
+    QcsSdkError,
+    "API Errors encountered when trying to list available ISAs."
+);
+
 exception!(
     crate::qpu::isa::python::SerializeIsaError,
     qcs_sdk.qpu.isa,

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/crates/lib/src/qpu/isa/python.rs

@@ -10,7 +10,11 @@ use pyo3_stub_gen::{
 
 use qcs_api_client_openapi::models;
 
-use crate::{client::Qcs, python::errors, qpu::get_isa};
+use crate::{
+    client::Qcs,
+    python::errors,
+    qpu::{get_isa, list_isas},
+};
 
 create_init_submodule! {
     classes: [
@@ -24,8 +28,17 @@ create_init_submodule! {
         OperationSite,
         Parameter
     ],
-    errors: [ errors::SerializeISAError, errors::GetISAError ],
-    funcs: [ py_get_instruction_set_architecture, py_get_instruction_set_architecture_async ],
+    errors: [
+        errors::SerializeISAError,
+        errors::GetISAError,
+        errors::ListISAsError
+    ],
+    funcs: [
+        py_get_instruction_set_architecture,
+        py_get_instruction_set_architecture_async,
+        py_list_instruction_set_architectures,
+        py_list_instruction_set_architectures_async
+    ],
 }
 
 impl_repr!(Architecture);
@@ -622,3 +635,22 @@ py_function_sync_async! {
             .map_err(Into::into)
     }
 }
+
+py_function_sync_async! {
+    /// Fetch the names of available ``InstructionSetArchitecture``s (ISAs) from the QCS API.
+    ///
+    /// :param client: The ``Qcs`` client to use. Creates one using environment configuration if unset - see https://docs.rigetti.com/qcs/references/qcs-client-configuration
+    ///
+    /// :raises LoadClientError: If ``client`` was not provided to the function, and failed to load internally.
+    /// :raises ListISAsError: If there was an issue fetching the ISAs from the QCS API.
+    #[cfg_attr(feature = "stubs", gen_stub_pyfunction(module = "qcs_sdk.qpu.isa"))]
+    #[pyfunction]
+    #[pyo3(signature = (client = None))]
+    async fn list_instruction_set_architectures(client: Option<Qcs>) -> PyResult<Vec<String>> {
+        let client = client.unwrap_or_else(Qcs::load);
+
+        list_isas(&client, None)
+            .await
+            .map_err(Into::into)
+    }
+}

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/crates/lib/src/qpu/mod.rs

@@ -107,3 +107,55 @@ pub async fn list_quantum_processors(
     })
     .await?
 }
+
+/// API Errors encountered when trying to list available ISAs.
+#[derive(Debug, thiserror::Error)]
+pub enum ListISAsError {
+    /// Failed the http call
+    #[error("Failed to list processors via API: {0}")]
+    ApiError(#[from] OpenApiError<quantum_processors_api::ListInstructionSetArchitecturesError>),
+
+    /// Pagination did not finish before timeout
+    #[error("API pagination did not finish before timeout.")]
+    TimeoutError(#[from] Elapsed),
+}
+
+/// Query QCS for the names of all available ISAs.
+pub async fn list_isas(
+    client: &Qcs,
+    timeout: Option<Duration>,
+) -> Result<Vec<String>, ListISAsError> {
+    #[cfg(feature = "tracing")]
+    tracing::debug!("listing instruction set architectures");
+
+    let timeout = timeout.unwrap_or(DEFAULT_HTTP_API_TIMEOUT);
+
+    tokio::time::timeout(timeout, async move {
+        let mut quantum_processors = vec![];
+        let mut page_token = None;
+
+        loop {
+            let result = quantum_processors_api::list_instruction_set_architectures(
+                &client.get_openapi_client(),
+                Some(5),
+                page_token.as_deref(),
+            )
+            .await?;
+
+            let mut data = result
+                .instruction_set_architectures
+                .into_iter()
+                .map(|isa| isa.name)
+                .collect::<Vec<_>>();
+            quantum_processors.append(&mut data);
+
+            page_token = result.next_page_token;
+            if page_token.is_none() {
+                break;
+            }
+        }
+
+        Ok(quantum_processors)
+    })
+    .await?
+}

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/crates/lib/tests_py/conftest.py

@@ -1,3 +1,4 @@
+import asyncio
 import datetime
 import os
 from typing import List
@@ -8,12 +9,14 @@ from _pytest.config.argparsing import Parser
 from _pytest.nodes import Item
 
 from qcs_sdk.client import QCSClient
-from qcs_sdk.qpu.api import APIExecutionOptions, APIExecutionOptionsBuilder, ExecutionOptions
-from qcs_sdk.qpu.isa import InstructionSetArchitecture
+from qcs_sdk.qpu.api import APIExecutionOptions, ExecutionOptions
+from qcs_sdk.qpu.isa import (
+    list_instruction_set_architectures_async,
+    InstructionSetArchitecture
+)
 from qcs_sdk.qvm import QVMClient
 from qcs_sdk.compiler.quilc import QuilcClient
 
-
 TEST_ROOT_DIR = os.path.dirname(os.path.realpath(__file__))
 TEST_CONFIG_DIR = os.path.join(TEST_ROOT_DIR, "./_qcs_config")
 TEST_FIXTURE_DIR = os.path.join(TEST_ROOT_DIR, "./_fixtures")
@@ -61,9 +64,17 @@ def _read_fixture(relpath: str) -> str:
     return contents
 
 
+@pytest.fixture(scope="session")
+def available_ids() -> list[str]:
+    async def _list_isas():
+        return await list_instruction_set_architectures_async(client=QCSClient())
+    return asyncio.run(_list_isas())
+
+
 @pytest.fixture
-def quantum_processor_id() -> str:
-    return os.getenv("TEST_LIVE_QUANTUM_PROCESSOR_ID", "Ankaa-3")
+def quantum_processor_id(available_ids: list[str]) -> str:
+    default = "Cepheus-1-108Q" if len(available_ids) == 0 else available_ids[0]
+    return os.getenv("TEST_LIVE_QUANTUM_PROCESSOR_ID", default)
 
 
 @pytest.fixture

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/crates/lib/tests_py/qpu/test_isa.py

@@ -34,8 +34,15 @@ def test_instruction_set_architecture_serialization_error():
         InstructionSetArchitecture.from_raw('{ "fail": true }')
 
 
-def test_get_instruction_set_actitecture_public(quantum_processor_id: str):
+def test_get_instruction_set_architecture_public(quantum_processor_id: str):
     """Successfully get a known public ISA without authentication."""
     isa = get_instruction_set_architecture(quantum_processor_id, client=QCSClient())
     assert type(isa) is InstructionSetArchitecture
 
+
+@pytest.mark.asyncio
+async def test_get_instruction_set_architecture_public_async(quantum_processor_id: str):
+    """Successfully get a known public ISA without authentication."""
+    isa = await get_instruction_set_architecture_async(quantum_processor_id, client=QCSClient())
+    assert type(isa) is InstructionSetArchitecture
+

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/pyproject.toml

@@ -1,7 +1,7 @@
 # This is the metadata Maturin uploads to PyPI on publish
 [project]
 name = "qcs-sdk-python"
-version = "0.26.1-rc.2"
+version = "0.26.2-rc.0"
 requires-python = ">=3.10,<4"
 description = "Python interface for the QCS Rust SDK"
 readme = "README-py.md"

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/python/qcs_sdk/qpu/api.pyi

@@ -125,7 +125,7 @@ class ConnectionStrategy:
         def __getitem__(self, key: builtins.int) -> typing.Any: ...
         def __len__(self) -> builtins.int: ...
         def __new__(cls, _0: builtins.str) -> ConnectionStrategy.EndpointAddress: ...
-        
+    
     @typing.final
     class EndpointId(ConnectionStrategy):
         r"""

{qcs_sdk_python-0.26.1rc2 → qcs_sdk_python-0.26.2rc0}/python/qcs_sdk/qpu/isa.pyi

@@ -263,6 +263,12 @@ class InstructionSetArchitecture:
         Returns [`SerializeIsaError`] if the ISA could not be serialized.
         """
 
+class ListISAsError(QcsSdkError):
+    r"""
+    API Errors encountered when trying to list available ISAs.
+    """
+    ...
+
 @typing.final
 class Node:
     r"""
@@ -470,3 +476,23 @@ def get_instruction_set_architecture_async(quantum_processor_id: builtins.str, c
     :raises GetISAError: If there was an issue fetching the ISA from the QCS API.
     """
 
+def list_instruction_set_architectures(client: typing.Optional[QCSClient] = None) -> builtins.list[builtins.str]:
+    r"""
+    Fetch the names of available ``InstructionSetArchitecture``s (ISAs) from the QCS API.
+    
+    :param client: The ``Qcs`` client to use. Creates one using environment configuration if unset - see https://docs.rigetti.com/qcs/references/qcs-client-configuration
+    
+    :raises LoadClientError: If ``client`` was not provided to the function, and failed to load internally.
+    :raises ListISAsError: If there was an issue fetching the ISAs from the QCS API.
+    """
+
+def list_instruction_set_architectures_async(client: typing.Optional[QCSClient] = None) -> collections.abc.Awaitable[builtins.list[builtins.str]]:
+    r"""
+    Fetch the names of available ``InstructionSetArchitecture``s (ISAs) from the QCS API.
+    
+    :param client: The ``Qcs`` client to use. Creates one using environment configuration if unset - see https://docs.rigetti.com/qcs/references/qcs-client-configuration
+    
+    :raises LoadClientError: If ``client`` was not provided to the function, and failed to load internally.
+    :raises ListISAsError: If there was an issue fetching the ISAs from the QCS API.
+    """
+