classiq 0.53.0__py3-none-any.whl → 0.55.0__py3-none-any.whl

classiq/interface/chemistry/operator.py

@@ -1,9 +1,7 @@
+from collections.abc import Collection
 from functools import reduce
 from typing import (
     Any,
-    Collection,
-    Dict,
-    List,
     Optional,
     Union,
     cast,
@@ -108,7 +106,7 @@ class PauliOperator(HashablePydanticBaseModel, VersionedModel):
 
     @pydantic.model_validator(mode="before")
     @classmethod
-    def _validate_hermitianity(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+    def _validate_hermitianity(cls, values: dict[str, Any]) -> dict[str, Any]:
         pauli_list = values.get("pauli_list", [])
         if PauliOperator.check_if_hermitian(pauli_list):
             values["is_hermitian"] = all(
@@ -153,7 +151,7 @@ class PauliOperator(HashablePydanticBaseModel, VersionedModel):
         )
 
     @staticmethod
-    def _is_sub_pauli_commutative(qubit_pauli_string: Union[List[str], str]) -> bool:
+    def _is_sub_pauli_commutative(qubit_pauli_string: Union[list[str], str]) -> bool:
         unique_paulis = set(qubit_pauli_string) - {"I"}
         return len(unique_paulis) <= 1
 
@@ -241,8 +239,8 @@ class PauliOperator(HashablePydanticBaseModel, VersionedModel):
     @classmethod
     def from_unzipped_lists(
         cls,
-        operators: List[List["Pauli"]],
-        coefficients: Optional[List[complex]] = None,
+        operators: list[list["Pauli"]],
+        coefficients: Optional[list[complex]] = None,
     ) -> "PauliOperator":
         if coefficients is None:
             coefficients = [1] * len(operators)
@@ -316,7 +314,7 @@ class PauliOperatorV1(HashablePydanticBaseModel):
 
     @pydantic.model_validator(mode="before")
     @classmethod
-    def _validate_hermitianity(cls, v: Dict[str, Any]) -> Dict[str, Any]:
+    def _validate_hermitianity(cls, v: dict[str, Any]) -> dict[str, Any]:
         pauli_list = cast(PydanticPauliList, v.get("pauli_list"))
         if all(isinstance(summand[1], complex) for summand in pauli_list):
             v["is_hermitian"] = all(
@@ -361,7 +359,7 @@ class PauliOperatorV1(HashablePydanticBaseModel):
         )
 
     @staticmethod
-    def _is_sub_pauli_commutative(qubit_pauli_string: Union[List[str], str]) -> bool:
+    def _is_sub_pauli_commutative(qubit_pauli_string: Union[list[str], str]) -> bool:
         unique_paulis = set(qubit_pauli_string) - {"I"}
         return len(unique_paulis) <= 1
 
@@ -445,8 +443,8 @@ class PauliOperatorV1(HashablePydanticBaseModel):
     @classmethod
     def from_unzipped_lists(
         cls,
-        operators: List[List["Pauli"]],
-        coefficients: Optional[List[complex]] = None,
+        operators: list[list["Pauli"]],
+        coefficients: Optional[list[complex]] = None,
     ) -> "PauliOperatorV1":
         if coefficients is None:
             coefficients = [1] * len(operators)
@@ -505,9 +503,9 @@ def validate_operator_has_no_complex_coefficients(
     return pauli_operator
 
 
-def pauli_integers_to_str(paulis: List[Pauli]) -> str:
+def pauli_integers_to_str(paulis: list[Pauli]) -> str:
     return "".join([Pauli(pauli).name for pauli in paulis])
 
 
 class PauliOperators(VersionedModel):
-    operators: List[PauliOperator]
+    operators: list[PauliOperator]

classiq/interface/combinatorial_optimization/examples/ascending_sequence.py

@@ -1,10 +1,8 @@
-from typing import List
-
 import numpy as np
 import pyomo.core as pyo
 
 
-def ascending_sequence(coeffs: List[int], bound: int) -> pyo.ConcreteModel:
+def ascending_sequence(coeffs: list[int], bound: int) -> pyo.ConcreteModel:
     model = pyo.ConcreteModel()
     model.x = pyo.Var(
         range(len(coeffs)), domain=pyo.NonNegativeIntegers, bounds=(0, bound)

classiq/interface/combinatorial_optimization/examples/integer_portfolio_optimization.py

@@ -1,16 +1,14 @@
-from typing import List, Tuple
-
 import numpy as np
 import pyomo.core as pyo
 
 
 def integer_portfolio_optimization(
-    covariances: np.ndarray, returns: np.ndarray, upper_bounds: List[int]
+    covariances: np.ndarray, returns: np.ndarray, upper_bounds: list[int]
 ) -> pyo.ConcreteModel:
     model = pyo.ConcreteModel()
     num_assets = len(returns)
 
-    def bounds(model: pyo.ConcreteModel, i: int) -> Tuple[int, int]:
+    def bounds(model: pyo.ConcreteModel, i: int) -> tuple[int, int]:
         return 0, upper_bounds[i]
 
     model.x = pyo.Var(range(num_assets), domain=pyo.NonNegativeIntegers, bounds=bounds)

classiq/interface/combinatorial_optimization/examples/knapsack.py

@@ -1,13 +1,13 @@
-from typing import List, Optional
+from typing import Optional
 
 import numpy as np
 import pyomo.core as pyo
 
 
 def knapsack(
-    values: List[int],
+    values: list[int],
     upper_bound: int,
-    weights: Optional[List[int]] = None,
+    weights: Optional[list[int]] = None,
     max_weight: Optional[int] = None,
 ) -> pyo.ConcreteModel:
     model = pyo.ConcreteModel()

classiq/interface/combinatorial_optimization/examples/mht.py

@@ -1,13 +1,12 @@
 import math
-from typing import Dict, Tuple
 
 import networkx as nx
 import pyomo.core as pyo
 import pyomo.core.expr.numeric_expr as pyo_expr
 
 Node = int
-Edge = Tuple[Node, Node]
-Pubo = Dict[Tuple[Edge, ...], float]
+Edge = tuple[Node, Node]
+Pubo = dict[tuple[Edge, ...], float]
 
 
 def build_mht_pyomo_model(

classiq/interface/combinatorial_optimization/examples/portfolio_variations.py

@@ -1,9 +1,9 @@
-from typing import List, Tuple, Union
+from typing import Union
 
 import numpy as np
 import pyomo.core as pyo
 
-BoundsList = List[Union[Tuple[int, int], int]]
+BoundsList = list[Union[tuple[int, int], int]]
 
 
 def portfolio_optimization_binary(

classiq/interface/combinatorial_optimization/examples/set_cover.py

@@ -1,11 +1,10 @@
 import itertools
-from typing import List
 
 import pyomo.core as pyo
 import pyomo.core.expr.numeric_expr as pyo_expr
 
 
-def set_cover(sub_sets: List[List[int]]) -> pyo.ConcreteModel:
+def set_cover(sub_sets: list[list[int]]) -> pyo.ConcreteModel:
     entire_set = set(itertools.chain(*sub_sets))
     n = max(entire_set)
     num_sets = len(sub_sets)

classiq/interface/combinatorial_optimization/mht_qaoa_input.py

@@ -1,5 +1,3 @@
-from typing import List
-
 import more_itertools
 import numpy as np
 import pydantic
@@ -24,7 +22,7 @@ class MhtQaoaInput(BaseModel):
     reps: pydantic.PositiveInt = pydantic.Field(
         default=3, description="Number of QAOA layers."
     )
-    plot_list: List[PlotData] = pydantic.Field(
+    plot_list: list[PlotData] = pydantic.Field(
         description="The list of (x,y,t) plots of the MHT problem."
     )
     misdetection_maximum_time_steps: pydantic.NonNegativeInt = pydantic.Field(
@@ -56,8 +54,8 @@ class MhtQaoaInput(BaseModel):
     @pydantic.field_validator("plot_list")
     @classmethod
     def round_plot_list_times_and_validate(
-        cls, plot_list: List[PlotData]
-    ) -> List[PlotData]:
+        cls, plot_list: list[PlotData]
+    ) -> list[PlotData]:
         MhtQaoaInput._check_all_ids_are_distinct(plot_list)
         MhtQaoaInput._round_to_tolerance_decimals(plot_list)
 
@@ -75,11 +73,11 @@ class MhtQaoaInput(BaseModel):
         return plot_list
 
     @staticmethod
-    def _round_to_tolerance_decimals(plot_list: List[PlotData]) -> None:
+    def _round_to_tolerance_decimals(plot_list: list[PlotData]) -> None:
         for plot in plot_list:
             plot.t = np.round(plot.t, decimals=_TOLERANCE_DECIMALS)
 
     @staticmethod
-    def _check_all_ids_are_distinct(plot_list: List[PlotData]) -> None:
+    def _check_all_ids_are_distinct(plot_list: list[PlotData]) -> None:
         if not more_itertools.all_unique(plot.plot_id for plot in plot_list):
             raise ClassiqValueError("Plot IDs should be unique.")

classiq/interface/combinatorial_optimization/optimization_problem.py

@@ -1,4 +1,4 @@
-from typing import Any, Dict
+from typing import Any
 
 import pydantic
 from pydantic import BaseModel
@@ -14,4 +14,4 @@ class MaxCutProblem(BaseModel):
         default_factory=CombinatorialOptimizer,
         description="preferences for the VQE execution",
     )
-    serialized_graph: Dict[str, Any]
+    serialized_graph: dict[str, Any]

classiq/interface/combinatorial_optimization/result.py

@@ -1,10 +1,8 @@
-from typing import List
-
 from classiq.interface.helpers.versioned_model import VersionedModel
 
 
 class AnglesResult(VersionedModel):
-    initial_point: List[float]
+    initial_point: list[float]
 
 
 class PyomoObjectResult(VersionedModel):

classiq/interface/debug_info/debug_info.py

@@ -1,13 +1,14 @@
 import json
-from typing import Any, Dict, Mapping, Optional, Tuple, Union
+from collections.abc import Mapping
+from typing import Any, Optional, Union
 from uuid import UUID
 
 from pydantic import BaseModel, Field
 
 from classiq.interface.generator.generated_circuit_data import (
     FunctionDebugInfoInterface,
+    OperationLevel,
 )
-from classiq.interface.ide.visual_model import OperationLevel
 
 ParameterValue = Union[float, int, str, None]
 
@@ -15,11 +16,11 @@ ParameterValue = Union[float, int, str, None]
 class FunctionDebugInfo(BaseModel):
     name: str
     # Parameters describe classical parameters passed to function
-    parameters: Dict[str, str]
+    parameters: dict[str, str]
     level: OperationLevel
     is_allocate_or_free: bool = Field(default=False)
     is_inverse: bool = Field(default=False)
-    port_to_passed_variable_map: Dict[str, str] = Field(default_factory=dict)
+    port_to_passed_variable_map: dict[str, str] = Field(default_factory=dict)
 
     @staticmethod
     def param_controller(value: Any) -> str:
@@ -38,7 +39,7 @@ class FunctionDebugInfo(BaseModel):
         self.port_to_passed_variable_map = new_port_to_passed_variable_map
 
     def update_map_from_inout_port_mapping(
-        self, port_mapping: Mapping[str, Tuple[str, str]]
+        self, port_mapping: Mapping[str, tuple[str, str]]
     ) -> None:
         new_port_to_passed_variable_map = self.port_to_passed_variable_map.copy()
         for old_key, (new_key1, new_key2) in port_mapping.items():
@@ -53,8 +54,8 @@ class DebugInfoCollection(BaseModel):
     # Pydantic only started supporting UUID as keys in Pydantic V2
     # See https://github.com/pydantic/pydantic/issues/2096#issuecomment-814860206
     # For now, we use strings as keys in the raw data and use UUID in the wrapper logic
-    data: Dict[str, FunctionDebugInfo] = Field(default={})
-    blackbox_data: Dict[str, FunctionDebugInfoInterface] = Field(default={})
+    data: dict[str, FunctionDebugInfo] = Field(default={})
+    blackbox_data: dict[str, FunctionDebugInfoInterface] = Field(default={})
 
     def __setitem__(self, key: UUID, value: FunctionDebugInfo) -> None:
         self.data[str(key)] = value

classiq/interface/exceptions.py

@@ -1,5 +1,6 @@
 import logging
-from typing import Iterable, List, Optional
+from collections.abc import Iterable
+from typing import Optional
 
 _logger = logging.getLogger(__name__)
 
@@ -26,7 +27,7 @@ class ClassiqExecutionError(ClassiqError):
 
 
 class ClassiqMissingOutputFormatError(ClassiqError):
-    def __init__(self, missing_formats: List[str]) -> None:
+    def __init__(self, missing_formats: list[str]) -> None:
         msg = (
             f"Cannot create program because output format is missing. "
             f"Expected one of the following formats: {missing_formats}"
@@ -146,7 +147,7 @@ class ClassiqCombOptNoSolutionError(ClassiqError):
 
 class ClassiqCombOptTrivialProblemError(ClassiqError):
 
-    def __init__(self, solution: List[int]) -> None:
+    def __init__(self, solution: list[int]) -> None:
         super().__init__(
             message=f"The problem doesn't have free decision variables. "
             f"The trivial solution is {solution}."
@@ -190,9 +191,10 @@ class ClassiqExpansionError(ClassiqError):
 
 class ClassiqInternalError(ClassiqError):
     def __init__(self, message: Optional[str] = None) -> None:
-        super().__init__(
-            "Internal error" if message is None else f"Internal error: {message}"
-        )
+        final_message = "Internal error occurred. Please contact Classiq support."
+        if message is not None:
+            final_message += f"\nError: {message}"
+        super().__init__(final_message)
 
 
 class ClassiqInternalExpansionError(ClassiqInternalError):

classiq/interface/execution/jobs.py

@@ -1,5 +1,5 @@
 from datetime import datetime
-from typing import List, Optional
+from typing import Optional
 
 from pydantic import BaseModel
 
@@ -25,4 +25,4 @@ class ExecutionJobDetailsV1(BaseModel, extra="ignore"):
 
 
 class ExecutionJobsQueryResultsV1(BaseModel, extra="ignore"):
-    results: List[ExecutionJobDetailsV1]
+    results: list[ExecutionJobDetailsV1]

classiq/interface/execution/primitives.py

@@ -1,4 +1,4 @@
-from typing import List, Optional
+from typing import Optional
 
 from pydantic import BaseModel, Field
 
@@ -9,9 +9,9 @@ from classiq.interface.helpers.custom_encoders import CUSTOM_ENCODERS
 
 class EstimateInput(BaseModel, json_encoders=CUSTOM_ENCODERS):
     hamiltonian: PauliOperator
-    parameters: List[Arguments]
+    parameters: list[Arguments]
 
 
 class PrimitivesInput(BaseModel, json_encoders=CUSTOM_ENCODERS):
-    sample: Optional[List[Arguments]] = Field(default=None)
+    sample: Optional[list[Arguments]] = Field(default=None)
     estimate: Optional[EstimateInput] = Field(default=None)

classiq/interface/executor/aws_execution_cost.py

@@ -1,6 +1,6 @@
 import datetime
 from datetime import date
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Optional, Union
 
 import pydantic
 from pydantic import BaseModel, ConfigDict, Field
@@ -52,7 +52,7 @@ class ExecutionCostForTimePeriod(BaseModel):
             raise ValueError('"end" date should be after "start" date')
         return v
 
-    def dict(self, **kwargs: Any) -> Dict[str, Any]:
+    def dict(self, **kwargs: Any) -> dict[str, Any]:
         data = super().model_dump(**kwargs)
         data["start"] = self.start.strftime("%Y-%m-%d")
         data["end"] = self.end.strftime("%Y-%m-%d")
@@ -80,11 +80,11 @@ class Total(pydantic.BaseModel):
 class ExecutedTaskForPeriodItem(pydantic.BaseModel):
     TimePeriod: TimePeriod
     Total: Total
-    Groups: Optional[List] = None
+    Groups: Optional[list] = None
     Estimated: Optional[bool] = None
 
     model_config = ConfigDict(extra="forbid")
 
 
 class ExecutionCostForTimePeriodResponse(pydantic.BaseModel):
-    executed_task_for_period: List[ExecutedTaskForPeriodItem]
+    executed_task_for_period: list[ExecutedTaskForPeriodItem]

classiq/interface/executor/execution_request.py

@@ -1,9 +1,8 @@
 from datetime import datetime
-from typing import List, Literal, Optional, Union
+from typing import Annotated, Literal, Optional, Union
 
 import pydantic
 from pydantic import BaseModel, Field
-from typing_extensions import Annotated
 
 from classiq.interface.executor.estimation import OperatorsEstimation
 from classiq.interface.executor.execution_preferences import ExecutionPreferences
@@ -63,4 +62,4 @@ class ExecutionJobDetails(VersionedModel):
 
 
 class ExecutionJobsQueryResults(VersionedModel):
-    results: List[ExecutionJobDetails]
+    results: list[ExecutionJobDetails]

classiq/interface/executor/execution_result.py

@@ -1,7 +1,7 @@
-from typing import Any, List, Literal, Union
+from typing import Annotated, Any, Literal, Union
 
 from pydantic import BaseModel, ConfigDict, Field
-from typing_extensions import Annotated, TypeAlias
+from typing_extensions import TypeAlias
 
 from classiq.interface.enum_utils import StrEnum
 from classiq.interface.executor.iqae_result import IQAEResult
@@ -104,7 +104,7 @@ SavedResult = Annotated[
     Field(..., discriminator="value_type"),
 ]
 
-ResultsCollection: TypeAlias = List[SavedResult]
+ResultsCollection: TypeAlias = list[SavedResult]
 
 
 class ExecuteGeneratedCircuitResults(VersionedModel):

classiq/interface/executor/iqae_result.py

@@ -1,5 +1,3 @@
-from typing import List
-
 from pydantic import BaseModel, Field
 
 from classiq.interface.executor.result import ExecutionDetails
@@ -14,6 +12,6 @@ class IQAEIterationData(BaseModel):
 
 class IQAEResult(VersionedModel, QmodPyObject):
     estimation: float
-    confidence_interval: List[float] = Field(min_length=2, max_length=2)
-    iterations_data: List[IQAEIterationData]
-    warnings: List[str]
+    confidence_interval: list[float] = Field(min_length=2, max_length=2)
+    iterations_data: list[IQAEIterationData]
+    warnings: list[str]

classiq/interface/executor/optimizer_preferences.py

@@ -1,4 +1,4 @@
-from typing import List, Optional
+from typing import Optional
 
 import pydantic
 from pydantic import BaseModel
@@ -45,7 +45,7 @@ class OptimizerPreferences(BaseModel):
         default=None,
         description="The random seed used for the generation",
     )
-    initial_point: Optional[List[float]] = pydantic.Field(
+    initial_point: Optional[list[float]] = pydantic.Field(
         default=None,
         description="Initial values for the ansatz parameters",
     )

classiq/interface/executor/quantum_code.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from pathlib import Path
-from typing import Any, Dict, Optional, Tuple, Union
+from typing import Any, Optional, Union
 
 import pydantic
 from pydantic import BaseModel, ConfigDict
@@ -16,12 +16,12 @@ from classiq.interface.generator.synthesis_metadata.synthesis_execution_data imp
     ExecutionData,
 )
 
-Arguments = Dict[PydanticArgumentNameType, Any]
-MultipleArguments = Tuple[Arguments, ...]
+Arguments = dict[PydanticArgumentNameType, Any]
+MultipleArguments = tuple[Arguments, ...]
 CodeType = str
-RegistersInitialization = Dict[str, RegisterInitialization]
-Qubits = Tuple[int, ...]
-OutputQubitsMap = Dict[str, Qubits]
+RegistersInitialization = dict[str, RegisterInitialization]
+Qubits = tuple[int, ...]
+OutputQubitsMap = dict[str, Qubits]
 
 
 class QuantumBaseCode(BaseModel):

classiq/interface/executor/register_initialization.py

@@ -1,5 +1,3 @@
-from typing import List
-
 import pydantic
 from typing_extensions import Self
 
@@ -13,7 +11,7 @@ _NON_INTEGER_INITIALIZATION_ERROR_MSG: str = (
 
 class RegisterInitialization(pydantic.BaseModel):
     name: str
-    qubits: List[int]
+    qubits: list[int]
     initial_condition: pydantic.NonNegativeInt
 
     @pydantic.field_validator("initial_condition", mode="before")
@@ -25,7 +23,7 @@ class RegisterInitialization(pydantic.BaseModel):
 
     @pydantic.model_validator(mode="after")
     def _validate_register_initialization(self) -> Self:
-        qubits: List[int] = self.qubits or []
+        qubits: list[int] = self.qubits or []
         initial_condition: int = self.initial_condition or 0
         name: str = self.name or ""