spatial-computing 0.5.0__tar.gz → 0.6.0__tar.gz

{spatial_computing-0.5.0/spatial_computing.egg-info → spatial_computing-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spatial-computing
-Version: 0.5.0
+Version: 0.6.0
 Summary: Spatial Computing: open-source infrastructure efficiency toolkit. Measure, decide, prove (compute, tiered memory, runtime routing, hybrid quantum language)
 Author: Spatial Computing contributors
 License-Expression: Apache-2.0
@@ -24,6 +24,9 @@ Requires-Dist: qiskit-qasm3-import>=0.5; extra == "quantum"
 Requires-Dist: pyqir>=0.10; extra == "quantum"
 Provides-Extra: build
 Requires-Dist: ziglang>=0.13; extra == "build"
+Provides-Extra: qpu
+Requires-Dist: qiskit>=2.0; extra == "qpu"
+Requires-Dist: qiskit-ibm-runtime>=0.40; extra == "qpu"
 Provides-Extra: dev
 Requires-Dist: pytest>=8; extra == "dev"
 Dynamic: license-file
@@ -34,19 +37,25 @@ Dynamic: license-file
 
 Spatial Computing chooses where and how a workload should run from measurements, and claims a gain only when it is measured. It does not add RAM, cores or GPUs: it compares execution strategies on the hardware you have, trades one resource for another in numbers, and says plainly what it cannot do.
 
-> **Status: v0.5.0, early-stage open-source toolkit.** Everything here was built and measured on a single 2017 MacBook Pro (Intel i7-7660U, 2 cores, 16 GB). Nothing has been proven on a second machine, a data-center GPU or a real quantum computer. See [Limitations](docs/LIMITATIONS.md) and the [site](https://spatial-computing-ecru.vercel.app).
+> **Status: v0.6.0, early-stage open-source toolkit.** Everything here was built and measured on a single 2017 MacBook Pro (Intel i7-7660U, 2 cores, 16 GB). Nothing has been proven on a second machine, a data-center GPU or a real quantum computer. See [Limitations](docs/LIMITATIONS.md) and the [site](https://spatial-computing-ecru.vercel.app).
 
 [Français](README.fr.md)
 
 ## Install
 
-Python 3.10 or newer. Not on PyPI yet: install from source.
+Python 3.10 or newer.
 
 ```bash
-git clone https://github.com/abraham1116/spatial-computing && cd spatial-computing
 python3 -m venv .venv && source .venv/bin/activate
-pip install -e ".[quantum,dev]"
+pip install "spatial-computing[quantum]"
 spatial audit
+```
+
+From source, to develop:
+
+```bash
+git clone https://github.com/abraham1116/spatial-computing && cd spatial-computing
+pip install -e ".[quantum,dev]"
 pytest
 ```
 

{spatial_computing-0.5.0 → spatial_computing-0.6.0}/README.md

@@ -4,19 +4,25 @@
 
 Spatial Computing chooses where and how a workload should run from measurements, and claims a gain only when it is measured. It does not add RAM, cores or GPUs: it compares execution strategies on the hardware you have, trades one resource for another in numbers, and says plainly what it cannot do.
 
-> **Status: v0.5.0, early-stage open-source toolkit.** Everything here was built and measured on a single 2017 MacBook Pro (Intel i7-7660U, 2 cores, 16 GB). Nothing has been proven on a second machine, a data-center GPU or a real quantum computer. See [Limitations](docs/LIMITATIONS.md) and the [site](https://spatial-computing-ecru.vercel.app).
+> **Status: v0.6.0, early-stage open-source toolkit.** Everything here was built and measured on a single 2017 MacBook Pro (Intel i7-7660U, 2 cores, 16 GB). Nothing has been proven on a second machine, a data-center GPU or a real quantum computer. See [Limitations](docs/LIMITATIONS.md) and the [site](https://spatial-computing-ecru.vercel.app).
 
 [Français](README.fr.md)
 
 ## Install
 
-Python 3.10 or newer. Not on PyPI yet: install from source.
+Python 3.10 or newer.
 
 ```bash
-git clone https://github.com/abraham1116/spatial-computing && cd spatial-computing
 python3 -m venv .venv && source .venv/bin/activate
-pip install -e ".[quantum,dev]"
+pip install "spatial-computing[quantum]"
 spatial audit
+```
+
+From source, to develop:
+
+```bash
+git clone https://github.com/abraham1116/spatial-computing && cd spatial-computing
+pip install -e ".[quantum,dev]"
 pytest
 ```
 

{spatial_computing-0.5.0 → spatial_computing-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "spatial-computing"
-version = "0.5.0"
+version = "0.6.0"
 description = "Spatial Computing: open-source infrastructure efficiency toolkit. Measure, decide, prove (compute, tiered memory, runtime routing, hybrid quantum language)"
 readme = "README.md"
 license = "Apache-2.0"
@@ -17,6 +17,7 @@ dependencies = ["numpy>=1.26,<2.2", "psutil>=5.9", "numba>=0.59,<0.62", "lz4>=4.
 [project.optional-dependencies]
 quantum = ["qiskit>=2.0", "qiskit-aer>=0.17", "qiskit-qasm3-import>=0.5", "pyqir>=0.10"]
 build = ["ziglang>=0.13"]
+qpu = ["qiskit>=2.0", "qiskit-ibm-runtime>=0.40"]
 dev = ["pytest>=8"]
 
 [project.urls]

{spatial_computing-0.5.0 → spatial_computing-0.6.0}/spatial/__init__.py

@@ -3,4 +3,4 @@
 Status of every engine is declared in spatial.core.registry and must be backed
 by a test or benchmark before being set to OPERATIONAL.
 """
-__version__ = "0.5.0"
+__version__ = "0.6.0"

{spatial_computing-0.5.0 → spatial_computing-0.6.0}/spatial/q/backends/__init__.py

@@ -103,16 +103,64 @@ class Qasm3Export(Backend):
         raise BackendUnavailable("qasm3 is an export target; use Circuit.to_qasm3()")
 
 
+def _ibm_token() -> str | None:
+    import os
+    from pathlib import Path
+    tok = os.environ.get("IBM_QUANTUM_TOKEN")
+    if tok:
+        return tok
+    f = Path.home() / ".spatial" / "secrets.env"
+    if f.exists():
+        for line in f.read_text().splitlines():
+            if line.startswith("IBM_QUANTUM_TOKEN="):
+                return line.split("=", 1)[1].strip() or None
+    return None
+
+
 class QpuBackend(Backend):
-    """Real quantum hardware. No provider credentials are configured in this prototype, so
-    this backend refuses to run instead of silently falling back to a simulator."""
+    """Real quantum hardware through IBM Quantum (qiskit-ibm-runtime, SamplerV2).
+
+    Needs: the `qiskit-ibm-runtime` package, a token in IBM_QUANTUM_TOKEN (or
+    ~/.spatial/secrets.env) and an IBM Quantum instance on the account. When any of these is
+    missing it raises BackendUnavailable with the real reason; it never falls back to a
+    simulator. Jobs wait in the provider's queue: a call can block for a long time.
+    """
     name = "qpu"
     kind = "qpu"
 
+    def __init__(self):
+        self.last_job: dict | None = None
+
+    def _service(self):
+        try:
+            from qiskit_ibm_runtime import QiskitRuntimeService
+        except ImportError:
+            raise BackendUnavailable("qiskit-ibm-runtime is not installed (pip install qiskit-ibm-runtime)")
+        tok = _ibm_token()
+        if not tok:
+            raise BackendUnavailable(
+                "no QPU provider configured: set IBM_QUANTUM_TOKEN or add it to ~/.spatial/secrets.env. "
+                "The circuit can be exported with to_qasm3() or to_qir().")
+        try:
+            return QiskitRuntimeService(channel="ibm_quantum_platform", token=tok)
+        except Exception as e:
+            raise BackendUnavailable(f"IBM Quantum refused the account: {type(e).__name__}: {str(e)[:200]}")
+
     def sample(self, c, shots, seed=None):
-        raise BackendUnavailable(
-            "no QPU provider configured (needs an account/API token with IBM Quantum, IonQ, "
-            "Quantinuum, AWS Braket...). The circuit can be exported with to_qasm3().")
+        from qiskit import transpile
+        from qiskit_ibm_runtime import SamplerV2
+        svc = self._service()
+        try:
+            backend = svc.least_busy(operational=True, simulator=False, min_num_qubits=c.n_qubits)
+        except Exception as e:
+            raise BackendUnavailable(f"no real backend available for {c.n_qubits} qubits: {str(e)[:200]}")
+        qc = transpile(to_qiskit(c), backend, optimization_level=1)
+        job = SamplerV2(mode=backend).run([qc], shots=shots)
+        res = job.result()[0]
+        counts = res.data.c.get_counts()
+        self.last_job = {"backend": backend.name, "job_id": job.job_id(), "shots": shots,
+                         "physical_qubits": backend.num_qubits}
+        return {k: int(v) for k, v in counts.items()}
 
 
 def get(name: str) -> Backend:

{spatial_computing-0.5.0 → spatial_computing-0.6.0}/spatial/q/runtime.py

@@ -82,7 +82,8 @@ class Runtime:
         counts = b.sample(c, shots, self.seed, noise=self.noise) if self.noise else b.sample(c, shots, self.seed)
         self.trace.append({"op": "sample", "kernel": name, "backend": b.name, "why": self._last_reason,
                            "shots": shots, "wall_s": time.perf_counter() - t0, "resources": est.to_dict(),
-                           "optimizer": info, **({"noise": self.noise} if self.noise else {})})
+                           "optimizer": info, **({"noise": self.noise} if self.noise else {}),
+                           **({"qpu_job": b.last_job} if getattr(b, "last_job", None) else {})})
         return counts
 
     def _expect(self, pauli, name, args, backend):

{spatial_computing-0.5.0 → spatial_computing-0.6.0/spatial_computing.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spatial-computing
-Version: 0.5.0
+Version: 0.6.0
 Summary: Spatial Computing: open-source infrastructure efficiency toolkit. Measure, decide, prove (compute, tiered memory, runtime routing, hybrid quantum language)
 Author: Spatial Computing contributors
 License-Expression: Apache-2.0
@@ -24,6 +24,9 @@ Requires-Dist: qiskit-qasm3-import>=0.5; extra == "quantum"
 Requires-Dist: pyqir>=0.10; extra == "quantum"
 Provides-Extra: build
 Requires-Dist: ziglang>=0.13; extra == "build"
+Provides-Extra: qpu
+Requires-Dist: qiskit>=2.0; extra == "qpu"
+Requires-Dist: qiskit-ibm-runtime>=0.40; extra == "qpu"
 Provides-Extra: dev
 Requires-Dist: pytest>=8; extra == "dev"
 Dynamic: license-file
@@ -34,19 +37,25 @@ Dynamic: license-file
 
 Spatial Computing chooses where and how a workload should run from measurements, and claims a gain only when it is measured. It does not add RAM, cores or GPUs: it compares execution strategies on the hardware you have, trades one resource for another in numbers, and says plainly what it cannot do.
 
-> **Status: v0.5.0, early-stage open-source toolkit.** Everything here was built and measured on a single 2017 MacBook Pro (Intel i7-7660U, 2 cores, 16 GB). Nothing has been proven on a second machine, a data-center GPU or a real quantum computer. See [Limitations](docs/LIMITATIONS.md) and the [site](https://spatial-computing-ecru.vercel.app).
+> **Status: v0.6.0, early-stage open-source toolkit.** Everything here was built and measured on a single 2017 MacBook Pro (Intel i7-7660U, 2 cores, 16 GB). Nothing has been proven on a second machine, a data-center GPU or a real quantum computer. See [Limitations](docs/LIMITATIONS.md) and the [site](https://spatial-computing-ecru.vercel.app).
 
 [Français](README.fr.md)
 
 ## Install
 
-Python 3.10 or newer. Not on PyPI yet: install from source.
+Python 3.10 or newer.
 
 ```bash
-git clone https://github.com/abraham1116/spatial-computing && cd spatial-computing
 python3 -m venv .venv && source .venv/bin/activate
-pip install -e ".[quantum,dev]"
+pip install "spatial-computing[quantum]"
 spatial audit
+```
+
+From source, to develop:
+
+```bash
+git clone https://github.com/abraham1116/spatial-computing && cd spatial-computing
+pip install -e ".[quantum,dev]"
 pytest
 ```
 

{spatial_computing-0.5.0 → spatial_computing-0.6.0}/spatial_computing.egg-info/requires.txt

@@ -10,6 +10,10 @@ ziglang>=0.13
 [dev]
 pytest>=8
 
+[qpu]
+qiskit>=2.0
+qiskit-ibm-runtime>=0.40
+
 [quantum]
 qiskit>=2.0
 qiskit-aer>=0.17

{spatial_computing-0.5.0 → spatial_computing-0.6.0}/tests/test_q.py

@@ -169,8 +169,10 @@ def test_classical_distributed_example_uses_worker_when_told():
     assert {t["where"] for t in rt.trace if t["op"] == "workload"} == {"cpu", "worker"}
 
 
-def test_qpu_backend_refuses_instead_of_faking():
-    with pytest.raises(BackendUnavailable, match="no QPU provider"):
+def test_qpu_backend_refuses_instead_of_faking(monkeypatch, tmp_path):
+    monkeypatch.delenv("IBM_QUANTUM_TOKEN", raising=False)
+    monkeypatch.setattr("pathlib.Path.home", lambda: tmp_path)        # no secrets file either
+    with pytest.raises(BackendUnavailable, match="no QPU provider|not installed"):
         _run("quantum k() { qubit q[1]; h q[0]; } main { let c = sample k() shots 10 on qpu; }")