luna-quantum 1.0.2__cp312-cp312-macosx_10_12_x86_64.whl → 1.0.3__cp312-cp312-macosx_10_12_x86_64.whl

luna_quantum/__init__.py

@@ -1,6 +1,7 @@
 from luna_quantum._core import __luna_quantum_version__
 from luna_quantum.aqm_overwrites.model import Model
 from luna_quantum.client.controllers import LunaQ, LunaSolve
+from luna_quantum.config import config
 from luna_quantum.factories.luna_solve_client_factory import LunaSolveClientFactory
 from luna_quantum.factories.usecase_factory import UseCaseFactory
 from luna_quantum.solve import DefaultToken
@@ -107,6 +108,7 @@ __all__ = [
     "__version__",
     "algorithms",
     "backends",
+    "config",
     "constants",
     "debug_info",
     "errors",

luna_quantum/__init__.pyi

@@ -33,6 +33,7 @@ from .utils import quicksum
 from luna_quantum._core import __luna_quantum_version__
 from luna_quantum.aqm_overwrites.model import Model
 from luna_quantum.client.controllers import LunaQ, LunaSolve
+from luna_quantum.config import config
 from luna_quantum.solve import DefaultToken
 from luna_quantum.solve.parameters import algorithms, backends, constants
 from luna_quantum.util.debug_info import debug_info
@@ -73,6 +74,7 @@ __all__ = [
     "__version__",
     "algorithms",
     "backends",
+    "config",
     "constants",
     "debug_info",
     "errors",

luna_quantum/_core.pyi

@@ -205,6 +205,11 @@ class Variable:
         """
         ...
 
+    @property
+    def id(self, /) -> int:
+        """Get the id of the variable."""
+        ...
+
     @property
     def name(self, /) -> str:
         """Get the name of the variable."""
@@ -1409,6 +1414,7 @@ class Solution:
         timing: (Timing | None) = ...,
         sense: (Sense | None) = ...,
         bit_order: Literal["LTR", "RTL"] = "RTL",
+        raw_energies: (list[float] | None) = ...,
     ) -> Solution:
         """
         Create a `Solution` from a dict that maps measured bitstrings to counts.
@@ -1431,6 +1437,8 @@ class Solution:
             The sense the model the solution belongs to. Default: Sense.Min
         bit_order : Literal["LTR", "RTL"]
             The order of the bits in the bitstring. Default "RTL".
+        energies: list[float], optional
+            The raw energies for each sample. Default None.
 
         Returns
         -------
@@ -2167,6 +2175,18 @@ class Model:
         """
         ...
 
+    @property
+    def num_variables(self, /) -> int:
+        """
+        Return the number of variables defined in the model.
+
+        Returns
+        -------
+        int
+            Total number of variables.
+        """
+        ...
+
     @property
     def num_constraints(self, /) -> int:
         """
@@ -2369,6 +2389,10 @@ class Model:
         """
         ...
 
+    def vtypes(self, /) -> list[Vtype]:
+        """Get a list of all unique variable types of all variables in this model."""
+        ...
+
     def __str__(self, /) -> str: ...
     def __repr__(self, /) -> str: ...
     def __hash__(self, /) -> int: ...
@@ -2598,6 +2622,17 @@ class Expression:
         """
         ...
 
+    def variables(self, /) -> list[Variable]:
+        """
+        Get all variables that are part of this expression.
+
+        Returns
+        -------
+        list[Variable]
+            The list of active variables
+        """
+        ...
+
     def is_equal(self, /, other: Expression) -> bool:
         """
         Compare two expressions for equality.
@@ -3075,6 +3110,10 @@ class Expression:
         """
         ...
 
+    def degree(self, /) -> int:
+        """Get the degree of this expression."""
+        ...
+
     @property
     def _environment(self, /) -> Environment:
         """Get this expression's environment."""
@@ -3704,6 +3743,10 @@ class Constraints:
         """
         ...
 
+    def ctypes(self, /) -> list[Comparator]:
+        """Get all unique constraint types identified using their comparator."""
+        ...
+
 __version__: str
 __aq_model_version__: str
 __luna_quantum_version__: str

luna_quantum/client/controllers/luna_platform_client.py

@@ -48,7 +48,7 @@ class APIKeyAuth(httpx.Auth):
     def __init__(self, token: str) -> None:
         self.token = token
 
-    def auth_flow(self, request: Request) -> Generator[Request, Response, None]:
+    def auth_flow(self, request: Request) -> Generator[Request, Response]:
         """
         Authenticate a request to Luna platform.
 
@@ -89,7 +89,7 @@ class LunaPlatformClient(IService):
         self,
         api: LunaPrefixEnum,
         api_key: str | None = None,
-        base_url: str = os.getenv("LUNA_BASE_URL", "https://api.aqarios.com"),
+        base_url: str | None = None,
         timeout: float | None = 240.0,
     ) -> None:
         """
@@ -116,6 +116,8 @@ class LunaPlatformClient(IService):
             itself will time out after 240 seconds.
             Default: 240.0
         """
+        if base_url is None:
+            base_url = os.getenv("LUNA_BASE_URL", "https://api.aqarios.com")
         if os.getenv("LUNA_DISABLE_SUFFIX", "false").lower() == "true":
             self._base_url = f"{base_url}/api/v1"
         else:

luna_quantum/config.py

@@ -0,0 +1,11 @@
+from pydantic_settings import BaseSettings
+
+
+class Config(BaseSettings):
+    """Class for all config values."""
+
+    LUNA_LOG_DEFAULT_LEVEL: str = "INFO"
+    LUNA_LOG_DISABLE_SPINNER: bool = False
+
+
+config = Config()

luna_quantum/errors.pyi

@@ -239,6 +239,13 @@ class StartCannotBeInferredError(TypeError):
 class NoConstraintForKeyError(IndexError):
     """Raised getting a constraint from the constraints that does not exist."""
 
+    def __str__(self, /) -> str: ...
+
+class InternalPanicError(RuntimeError):
+    """Raised when an internal and unrecoverable error occurred."""
+
+    def __str__(self, /) -> str: ...
+
 __all__ = [
     "ComputationError",
     "ComputationError",
@@ -247,6 +254,7 @@ __all__ = [
     "DuplicateConstraintNameError",
     "EvaluationError",
     "IllegalConstraintNameError",
+    "InternalPanicError",
     "ModelNotQuadraticError",
     "ModelNotUnconstrainedError",
     "ModelSenseNotMinimizeError",

luna_quantum/solve/parameters/backends/qctrl.py

@@ -49,34 +49,6 @@ class Qctrl(QpuTokenBackend):
     https://docs.q-ctrl.com/fire-opal/topics/fire-opals-qaoa-solver)
     """
 
-    class IBMQ(BaseModel):
-        """
-        Configuration parameters for the IBM Quantum backend.
-
-        Attributes
-        ----------
-        hub: str, default="ibm-q"
-            The IBM Quantum hub to use for accessing quantum resources.
-            This defines your access level and available systems.
-
-        group: str, default="open"
-            The IBM Quantum group within your hub.
-            Groups help organize users and projects within a hub.
-
-        project: str, default="main"
-            The IBM Quantum project within your group.
-            Projects help organize work and resource allocation.
-
-        token: Union[str, None, QpuToken], default=None
-            The IBM API token.
-        """
-
-        hub: str = "ibm-q"
-        group: str = "open"
-        project: str = "main"
-
-        token: str | QpuToken | None = Field(repr=False, exclude=True, default=None)
-
     class IBMCloud(BaseModel):
         """
         Configuration parameters for the IBM Cloud backend.
@@ -90,14 +62,14 @@ class Qctrl(QpuTokenBackend):
             The IBM API token.
         """
 
-        instance: str
+        instance: str = ""
 
         token: str | QpuToken | None = Field(repr=False, exclude=True, default=None)
 
     organization_slug: Any = None
     backend_name: str | None = None
 
-    ibm_credentials: IBMQ | IBMCloud = Field(default=IBMQ())
+    ibm_credentials: IBMCloud = Field(default=IBMCloud())
 
     token: str | QpuToken | None = Field(repr=False, exclude=True, default=None)
 

luna_quantum/util/log_utils.py

@@ -3,13 +3,15 @@ from __future__ import annotations
 import logging
 from contextlib import contextmanager
 from functools import wraps
-from typing import TYPE_CHECKING, ClassVar, ParamSpec, TypeVar
+from typing import TYPE_CHECKING, ParamSpec, TypeVar
 
 from rich.console import Console
 from rich.logging import RichHandler
 from rich.progress import Progress, SpinnerColumn, TaskID, TextColumn
 from rich.theme import Theme
 
+from luna_quantum.config import config
+
 if TYPE_CHECKING:
     from collections.abc import Callable, Generator
 
@@ -27,7 +29,20 @@ class Logging:
     - Manage consistent logging behavior across the SDK
     """
 
-    _log_level: ClassVar[int] = logging.INFO
+    @staticmethod
+    def is_process_bar_shown() -> bool:
+        """
+        Return whether to use a process bar for progress bars.
+
+        Returns
+        -------
+        bool
+            Returns whether to use a process bar for progress bars.
+        """
+        return (
+            not config.LUNA_LOG_DISABLE_SPINNER
+            and Logging.get_level() != logging.NOTSET
+        )
 
     @staticmethod
     def set_level(log_level: int) -> None:
@@ -38,12 +53,12 @@ class Logging:
         log_level : int
             Logging level to set (e.g., logging.DEBUG, logging.INFO)
         """
+        config.LUNA_LOG_DEFAULT_LEVEL = logging.getLevelName(log_level)
+
         for logger_name in logging.root.manager.loggerDict:
             if logger_name.startswith("luna_quantum"):  # Only modify SDK loggers
                 logging.getLogger(logger_name).setLevel(log_level)
 
-        Logging._log_level = log_level
-
     @staticmethod
     def get_level() -> int:
         """Return the current logging level for the SDK.
@@ -54,7 +69,7 @@ class Logging:
             Current logging level as defined in the logging module
             (e.g., logging.DEBUG, logging.INFO, etc.)
         """
-        return Logging._log_level
+        return logging._nameToLevel.get(config.LUNA_LOG_DEFAULT_LEVEL, logging.INFO)  # noqa: SLF001 #No other way to map these log levels.
 
     @staticmethod
     def get_console() -> Console:
@@ -85,7 +100,7 @@ class Logging:
             Configured logger instance with appropriate handlers
         """
         logger = logging.getLogger(name)
-        logger.setLevel(Logging._log_level)
+        logger.setLevel(Logging.get_level())
         logger.propagate = False
 
         if logger.hasHandlers():
@@ -107,7 +122,7 @@ class Logging:
 @contextmanager
 def progress_bar(
     total: int | None, desc: str = "", unit: str = "steps"
-) -> Generator[tuple[Progress, TaskID], None, None]:
+) -> Generator[tuple[Progress, TaskID]]:
     """Create a progress bar using Rich as a context manager.
 
     Parameters
@@ -136,6 +151,7 @@ def progress_bar(
             )
         ),
         transient=True,
+        disable=not Logging.is_process_bar_shown(),
     ) as progress:
         task = progress.add_task(f"[blue]{desc}", total=total, unit=unit)
         yield progress, task  # Yield both progress and task for updates

{luna_quantum-1.0.2.dist-info → luna_quantum-1.0.3.dist-info}/METADATA

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: luna-quantum
-Version: 1.0.2
+Version: 1.0.3
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Scientific/Engineering
 Requires-Dist: httpx>=0.28.1,<0.29
 Requires-Dist: numpy>=1
+Requires-Dist: pydantic-settings>=2.10.1
 Requires-Dist: pydantic[email]>=2.11.3,<3
 Requires-Dist: python-dateutil>=2.9.0,<3
 Requires-Dist: rich>=14.0.0
@@ -15,7 +16,7 @@ License-File: NOTICE
 Summary: Python SDK for Aqarios' Luna Platform
 Keywords: aqarios,luna,quantum computing,quantum optimization,optimization,sdk
 Author-email: Aqarios <pypi@aqarios.com>
-License: Apache-2.0
+License-Expression: Apache-2.0
 Requires-Python: >=3.11.0, <3.14
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 Project-URL: Homepage, https://aqarios.com/

{luna_quantum-1.0.2.dist-info → luna_quantum-1.0.3.dist-info}/RECORD

@@ -1,11 +1,11 @@
-luna_quantum-1.0.2.dist-info/METADATA,sha256=9lTewsIfCY4ToenZtDn_98Dt5nRwB9evm7As2rgKUnk,1530
-luna_quantum-1.0.2.dist-info/WHEEL,sha256=KVbmEBK8XTzklTUWbxeuu65d5JTBhtdzc5NXYKGXnwg,106
-luna_quantum-1.0.2.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
-luna_quantum-1.0.2.dist-info/licenses/NOTICE,sha256=noPOS8eDj5XoyRO8ZrCxIOh5fSjk0RildIrrqxQlepY,588
-luna_quantum/__init__.py,sha256=VVqJBFKl8ET7gJmebXVnTsD33sIFfhxKm7_eB12YVkU,3170
-luna_quantum/__init__.pyi,sha256=dG3-NeEI8ApxHUcVq-Ov9Pa9D3Px_5yWUWkxhLsfL80,1608
-luna_quantum/_core.cpython-312-darwin.so,sha256=3vnycggN8ftURRpPts6yf7prqkBQ3T92jT-sKZl2lO4,4545372
-luna_quantum/_core.pyi,sha256=7HL0LZHypfEWlrnjzk3dT0kG3K92v3FkPylQmc9EITs,105472
+luna_quantum-1.0.3.dist-info/METADATA,sha256=WqZud5UbrQ8KLAVMwHQRW0nvWNBA1IsdGZiZKPkOtCw,1582
+luna_quantum-1.0.3.dist-info/WHEEL,sha256=3A4CNWchZH0MOUJN1Lb2j_exGriVkqYfe_9teGJ9S-Q,106
+luna_quantum-1.0.3.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+luna_quantum-1.0.3.dist-info/licenses/NOTICE,sha256=noPOS8eDj5XoyRO8ZrCxIOh5fSjk0RildIrrqxQlepY,588
+luna_quantum/__init__.py,sha256=RV92O-Th8ktm0S9kcpfRfECkeeORP-tbDKfpa4u1CiY,3223
+luna_quantum/__init__.pyi,sha256=tcM9H4ZAKxgt8KYnFmKH5OHSJZ0zv7J8dMdYMZp6m3s,1661
+luna_quantum/_core.cpython-312-darwin.so,sha256=FGNekSqzDAo4i7qABARABqdASQiYnDsA8dFM7xukMV0,5005316
+luna_quantum/_core.pyi,sha256=CMLYlowGnQD-ZS8JeG2_JUwEn4eOGi0fWMm2aWfs3qs,106566
 luna_quantum/algorithms/__init__.py,sha256=IX9ZpzY3Do3mTgKqto5vAWwdYrZrM-RemYSf64yxefg,69
 luna_quantum/aqm_overwrites/__init__.py,sha256=rteObr5JHDnTnRime0Euq9Qy2iDIp6VMpFNHTGVNBe0,46
 luna_quantum/aqm_overwrites/model.py,sha256=La5mh-aS2LNLaQFp_B1EnhrKUXVRRmIqGnIvX66uc8Y,6099
@@ -13,7 +13,7 @@ luna_quantum/backends/__init__.py,sha256=OaE9cTpXP07x2mhJ_kLFaHPYZJBzdEQhlP_ztnq
 luna_quantum/client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luna_quantum/client/controllers/__init__.py,sha256=yG8Gwatlm6f-OH2p3WLTyAsNePUER84eBxx67pkRi4A,156
 luna_quantum/client/controllers/luna_http_client.py,sha256=Siwtm0wQzdRZXw0ilkUmFXbD8tbRuJI7cEceWwfXos4,1057
-luna_quantum/client/controllers/luna_platform_client.py,sha256=IqkI3BKbwrtoCZk4pE_lTPFshMyWPEeKkkEm3C6Slvc,5158
+luna_quantum/client/controllers/luna_platform_client.py,sha256=-X16kNpuvmFmVZl_QE9y-Qyek8XB90M2uXDqHYCefss,5216
 luna_quantum/client/controllers/luna_q.py,sha256=S8-Uvv9TYKC-yRo67T-g0kwIlDoEmluoAQlAl4otrQ4,1930
 luna_quantum/client/controllers/luna_solve.py,sha256=oqG_dR_82ccysm5Q4Gp9x7vQBb1xvCb9-mRA8qD8xzE,3399
 luna_quantum/client/error/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -80,8 +80,9 @@ luna_quantum/client/schemas/wrappers/__init__.py,sha256=tfd-JKBLr-0FwVEGKJFfvY1y
 luna_quantum/client/schemas/wrappers/datetime_wrapper.py,sha256=8K2jexTarxGCgD1ukgVUW5TCroYGWXGfzDfjLcJfYlk,768
 luna_quantum/client/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luna_quantum/client/utils/qpu_token_utils.py,sha256=xeWIKcBwXGSQ0INfUY3NMTu6H90T03jkT85yHs2QXmk,4768
+luna_quantum/config.py,sha256=xx7DnjAvOeLUMlXvbXqQ4_EBAy53bjPYU1-QQO6I2lY,217
 luna_quantum/errors.py,sha256=yjeXB3i07LlTuuJ18IKgwsC5wmtJElN8cDwlg3JkcEs,1424
-luna_quantum/errors.pyi,sha256=daGAwiOdpgHPILYVSUy360AZQilRb-vdwh2pwAAn3CU,8900
+luna_quantum/errors.pyi,sha256=qrGBpkd_eOpgjHuNBAoIYJOk7s64jvVO4Bcipue4P3k,9111
 luna_quantum/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luna_quantum/exceptions/base_luna_quantum_error.py,sha256=qC712QkF04FiY_qwQ5HlIYVhg5P6WzXJ_chJDVTpWXI,89
 luna_quantum/exceptions/patch_class_field_exists_error.py,sha256=3TGKb-MNyjwntrJkbRaBKEvlsj68ROTwCltDt6Zg7Gg,398
@@ -174,7 +175,7 @@ luna_quantum/solve/parameters/backends/aws/rigetti.py,sha256=04Rg7CEz_70Aqd1f28O
 luna_quantum/solve/parameters/backends/dwave.py,sha256=ZIbZa0lY4TN1jYl5ddlAxhb5_lK4Zuuf1gyQ1fncf8w,358
 luna_quantum/solve/parameters/backends/dwave_qpu.py,sha256=8RJ4zPqLvplPsTmN3D8pNU5-XjwwAEYEvlIgTUPc5Ag,7314
 luna_quantum/solve/parameters/backends/ibm.py,sha256=pDw-0sifu_dfJS4zH2INu6txPh0NgaYDNxPQHEhaF7o,4231
-luna_quantum/solve/parameters/backends/qctrl.py,sha256=FEFd-FjLwS7QfrELs25-w_8L_9Ye5KLSZSN4xWFE0IE,4397
+luna_quantum/solve/parameters/backends/qctrl.py,sha256=BADuXCvZzFNS9d6MNQIKdPixeQM_2q-dBoRVwEglG7c,3503
 luna_quantum/solve/parameters/backends/zib.py,sha256=SqlLFYWCBHiPkxiCJGb1MH5JNtdKApllpd2f8lzn_D8,352
 luna_quantum/solve/parameters/constants.py,sha256=N1_p4zBN_a_rbdnNPxyinN5FygO8Sd7iVPN3vCTwtYA,510
 luna_quantum/solve/parameters/mixins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -250,9 +251,9 @@ luna_quantum/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU
 luna_quantum/util/active_waiting.py,sha256=MkLL7UEtWh8jU1Zwd9rYqfcReYPGB7FJLUjQe2v9_Tg,3029
 luna_quantum/util/class_patcher.py,sha256=-vD_7Auh1dQTOJXOKv-4sTQ5EzH3n6I0EsHDFQ_ZPOY,5456
 luna_quantum/util/debug_info.py,sha256=UjMcmX5waYEEH51cK8REUOdjpNX0D6HWSR0ns7yQp54,1755
-luna_quantum/util/log_utils.py,sha256=M8Gbt0Pb2CsQsG3fGyuKeT-rl264laEGGXcPCGfBhaQ,4918
+luna_quantum/util/log_utils.py,sha256=8WK0ivN3Dq3QntIYu-eGRBrGyiBoFnZkRiX_GCc-IHQ,5471
 luna_quantum/util/pretty_base.py,sha256=Vv3dYpMsydOPYFOm-0lCCuJIe-62oYkI64Zy_bahl3s,2115
 luna_quantum/util/pydantic_utils.py,sha256=nhl_SdLJVAizrtLVHvnbco84g8CdBVdVxN_jlXiv82w,1263
 luna_quantum/utils.py,sha256=pBOkGXNJXlOzxAwTJv8nCj32Q6WNeh3t6Ka3lmTgy9c,134
 luna_quantum/utils.pyi,sha256=afjDJhGiM9KmN2zqVkd6agP8JAsbwUxJBW9tEyiFrdY,1941
-luna_quantum-1.0.2.dist-info/RECORD,,
+luna_quantum-1.0.3.dist-info/RECORD,,

{luna_quantum-1.0.2.dist-info → luna_quantum-1.0.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.9.1)
+Generator: maturin (1.9.2)
 Root-Is-Purelib: false
 Tag: cp312-cp312-macosx_10_12_x86_64