quapp-common 0.0.14.dev4__tar.gz → 0.0.14.dev5__tar.gz

{quapp_common-0.0.14.dev4/quapp_common.egg-info → quapp_common-0.0.14.dev5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quapp-common
-Version: 0.0.14.dev4
+Version: 0.0.14.dev5
 Summary: Quapp common library supporting Quapp Platform for Quantum Computing
 Author-email: "CITYNOW Co. Ltd. " <corp@citynow.vn>
 License: The MIT License (MIT)
@@ -25,18 +25,15 @@ Requires-Dist: numpy
 Requires-Dist: matplotlib
 Requires-Dist: pylatexenc
 Requires-Dist: starlette
-Requires-Dist: qibo
-Requires-Dist: dimod
-Requires-Dist: qulacs
-Requires-Dist: qiskit
-Requires-Dist: pytket
-Requires-Dist: pennylane
 Provides-Extra: dev
 Requires-Dist: black; extra == "dev"
 Requires-Dist: bumpver; extra == "dev"
 Requires-Dist: isort; extra == "dev"
 Requires-Dist: pip-tools; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: qiskit; extra == "test"
 Dynamic: license-file
 
 # quapp-common
@@ -114,6 +111,61 @@ Notes:
 
 ## Recently Changes Highlights
 
+### v0.0.14.dev5 — Gỡ toàn bộ dependency SDK lượng tử
+
+`quapp-common` không còn phụ thuộc SDK nào. SDK thuộc về lib con.
+
+**Gỡ khỏi `dependencies`** — 6 package, chỉ được dùng trong `circuit_adapter.py`:
+`qiskit`, `pennylane`, `qibo`, `qulacs`, `dimod`, `pytket`.
+
+Còn lại: `loguru`, `requests`, `numpy`, `matplotlib`, `pylatexenc`, `starlette`
+— đều được chính code của `quapp-common` dùng (`matplotlib`/`pylatexenc` cần cho
+`CircuitExportTask.__convert()`, nơi gọi `circuit.draw(output='mpl')` rồi
+`savefig()`).
+
+**`circuit_adapter.py`: import SDK lazy.** Mỗi handler tự import SDK của nó ngay
+trước khi dùng, qua helper `_require()`. Trước đây 7 SDK được import ở module
+level, nên:
+
+- `from quapp_common.component.bridge import SubprocessBridge` đòi có **đủ cả 6
+  SDK cùng lúc**, kể cả khi function chỉ chạy Qiskit. Điều này vô hiệu hoá thiết
+  kế lazy-import của `js-*/index.py` trong `quapp-sdk-templates` — comment trong
+  đó ghi rõ ý định *"so the server can start even if optional dependencies are
+  missing"*;
+- buộc mọi function image tải cả 6 SDK, và cài chung chúng gây xung đột version
+  thật (`pytket`/`lark`, `pennylane-rigetti`/`pyquil` — xem
+  `revert/pennylane-to-0.0.4.dev6` trong `qapp-pennylane`).
+
+`_require()` raise `ModuleNotFoundError` với thông điệp nêu tên package cần thêm
+vào `requirements.txt`. Classifier map nó thành `DEPENDENCY_MISSING` nên user
+nhận được hướng dẫn cụ thể thay vì traceback import.
+
+**`tests/test_circuit_adapter.py`**: SDK được import trong từng test qua
+`pytest.importorskip`. Trước đây file này import `qiskit` + `qibo` + `qulacs` ở
+module level nên **cả file không collect được** nếu thiếu một SDK. Test
+`test_qulacs_falls_back_to_string_on_parse_error` đổi target patch từ
+`circuit_adapter.QiskitCircuit` (tên module-level đã bỏ) sang `_load_qasm_circuit`.
+
+**`tests/test_no_sdk_dependency.py`** (mới) — khoá hồi quy bằng AST: quét từng
+file, fail nếu có SDK nào được import ở module level; và đọc `pyproject.toml`,
+fail nếu `dependencies` khai báo SDK.
+
+Đã verify trong **venv sạch không có SDK nào**: 82/82 module import được, suite
+300 passed / 7 skipped. Với venv chỉ có `qiskit`: 302 passed / 5 skipped.
+
+> **Lib con cần bổ sung khai báo.** Hai lib đang dựa vào `quapp-common` kéo hộ và
+> sẽ vỡ đường OpenQASM sau bản này:
+> - `qapp-pyquil` — thiếu `pytket` (cần cho `_openqasm_to_pyquil`);
+> - `quapp-qulacs` — thiếu `qiskit` (cầu nối OpenQASM → Qulacs đi qua Qiskit).
+>
+> Ngoài ra `qapp-dwave-ocean` import `matplotlib` trực tiếp nhưng không khai báo;
+> hiện vẫn chạy vì `quapp-common` còn giữ `matplotlib`, nên nên khai báo tường
+> minh để không phụ thuộc may mắn.
+>
+> `pytket-braket` và `pytket-pyquil` chưa từng được khai báo ở đâu — code dùng
+> `importlib.import_module()` cho chúng từ trước. Cần thêm vào `qapp-braket` và
+> `qapp-pyquil`.
+
 ### v0.0.14.dev2 — Fix: log lỗi bị nhân đôi
 
 - **Fix**: mỗi lần lỗi phát **hai** dòng ERROR cùng `event=job_failed`, mỗi dòng

{quapp_common-0.0.14.dev4 → quapp_common-0.0.14.dev5}/README.md

@@ -73,6 +73,61 @@ Notes:
 
 ## Recently Changes Highlights
 
+### v0.0.14.dev5 — Gỡ toàn bộ dependency SDK lượng tử
+
+`quapp-common` không còn phụ thuộc SDK nào. SDK thuộc về lib con.
+
+**Gỡ khỏi `dependencies`** — 6 package, chỉ được dùng trong `circuit_adapter.py`:
+`qiskit`, `pennylane`, `qibo`, `qulacs`, `dimod`, `pytket`.
+
+Còn lại: `loguru`, `requests`, `numpy`, `matplotlib`, `pylatexenc`, `starlette`
+— đều được chính code của `quapp-common` dùng (`matplotlib`/`pylatexenc` cần cho
+`CircuitExportTask.__convert()`, nơi gọi `circuit.draw(output='mpl')` rồi
+`savefig()`).
+
+**`circuit_adapter.py`: import SDK lazy.** Mỗi handler tự import SDK của nó ngay
+trước khi dùng, qua helper `_require()`. Trước đây 7 SDK được import ở module
+level, nên:
+
+- `from quapp_common.component.bridge import SubprocessBridge` đòi có **đủ cả 6
+  SDK cùng lúc**, kể cả khi function chỉ chạy Qiskit. Điều này vô hiệu hoá thiết
+  kế lazy-import của `js-*/index.py` trong `quapp-sdk-templates` — comment trong
+  đó ghi rõ ý định *"so the server can start even if optional dependencies are
+  missing"*;
+- buộc mọi function image tải cả 6 SDK, và cài chung chúng gây xung đột version
+  thật (`pytket`/`lark`, `pennylane-rigetti`/`pyquil` — xem
+  `revert/pennylane-to-0.0.4.dev6` trong `qapp-pennylane`).
+
+`_require()` raise `ModuleNotFoundError` với thông điệp nêu tên package cần thêm
+vào `requirements.txt`. Classifier map nó thành `DEPENDENCY_MISSING` nên user
+nhận được hướng dẫn cụ thể thay vì traceback import.
+
+**`tests/test_circuit_adapter.py`**: SDK được import trong từng test qua
+`pytest.importorskip`. Trước đây file này import `qiskit` + `qibo` + `qulacs` ở
+module level nên **cả file không collect được** nếu thiếu một SDK. Test
+`test_qulacs_falls_back_to_string_on_parse_error` đổi target patch từ
+`circuit_adapter.QiskitCircuit` (tên module-level đã bỏ) sang `_load_qasm_circuit`.
+
+**`tests/test_no_sdk_dependency.py`** (mới) — khoá hồi quy bằng AST: quét từng
+file, fail nếu có SDK nào được import ở module level; và đọc `pyproject.toml`,
+fail nếu `dependencies` khai báo SDK.
+
+Đã verify trong **venv sạch không có SDK nào**: 82/82 module import được, suite
+300 passed / 7 skipped. Với venv chỉ có `qiskit`: 302 passed / 5 skipped.
+
+> **Lib con cần bổ sung khai báo.** Hai lib đang dựa vào `quapp-common` kéo hộ và
+> sẽ vỡ đường OpenQASM sau bản này:
+> - `qapp-pyquil` — thiếu `pytket` (cần cho `_openqasm_to_pyquil`);
+> - `quapp-qulacs` — thiếu `qiskit` (cầu nối OpenQASM → Qulacs đi qua Qiskit).
+>
+> Ngoài ra `qapp-dwave-ocean` import `matplotlib` trực tiếp nhưng không khai báo;
+> hiện vẫn chạy vì `quapp-common` còn giữ `matplotlib`, nên nên khai báo tường
+> minh để không phụ thuộc may mắn.
+>
+> `pytket-braket` và `pytket-pyquil` chưa từng được khai báo ở đâu — code dùng
+> `importlib.import_module()` cho chúng từ trước. Cần thêm vào `qapp-braket` và
+> `qapp-pyquil`.
+
 ### v0.0.14.dev2 — Fix: log lỗi bị nhân đôi
 
 - **Fix**: mỗi lần lỗi phát **hai** dòng ERROR cùng `event=job_failed`, mỗi dòng

{quapp_common-0.0.14.dev4 → quapp_common-0.0.14.dev5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quapp-common"
-version = "0.0.14.dev4"
+version = "0.0.14.dev5"
 description = "Quapp common library supporting Quapp Platform for Quantum Computing"
 readme = "README.md"
 authors = [{ name = "CITYNOW Co. Ltd. ", email = "corp@citynow.vn" }]
@@ -15,24 +15,29 @@ classifiers = [
     "Programming Language :: Python :: 3",
 ]
 keywords = ["quapp", "quapp-common", "quantum"]
+# KHÔNG khai báo SDK lượng tử ở đây. Mỗi lib con (quapp-qiskit, qapp-pennylane,
+# qapp-braket, ...) tự khai báo SDK của nó, và một function image chỉ cài đúng
+# SDK nó dùng. circuit_adapter.py import SDK lazy nên quapp-common không cần
+# chúng để import được.
+#
+# Lý do: cài chung qiskit + pennylane + qibo + qulacs + dimod + pytket gây xung
+# đột version thật (pytket/lark, pennylane-rigetti/pyquil), và bắt mọi function
+# tải cả 6 SDK dù chỉ dùng một.
 dependencies = [
     "loguru",
     "requests",
     "numpy",
     "matplotlib",
     "pylatexenc",
-    "starlette",
-    "qibo",
-    "dimod",
-    "qulacs",
-    "qiskit",
-    "pytket",
-    "pennylane"
+    "starlette"
 ]
 requires-python = ">=3.7"
 
 [project.optional-dependencies]
 dev = ["black", "bumpver", "isort", "pip-tools", "pytest"]
+# SDK chỉ để chạy test của chính quapp-common (tests/test_circuit_adapter.py
+# cần qiskit). KHÔNG phải runtime dependency.
+test = ["pytest", "qiskit"]
 
 [project.urls]
 Homepage = "https://citynow.asia/"

{quapp_common-0.0.14.dev4 → quapp_common-0.0.14.dev5}/quapp_common/component/circuit_adapter.py

@@ -2,38 +2,73 @@
 #  circuit_adapter.py
 #  Copyright © CITYNOW Co. Ltd. All rights reserved.
 
+"""Chuyển circuit từ định dạng trung gian (OpenQASM / QUBO / JSON) sang object
+native của từng SDK.
+
+Mọi SDK được import LAZY, ngay bên trong handler cần nó. Lý do:
+
+``quapp-common`` không được phụ thuộc SDK nào. Mỗi lib con
+(``quapp-qiskit``, ``qapp-pennylane``, ...) tự khai báo SDK của nó, và một
+function image chỉ cài đúng SDK nó dùng. Nếu file này import ở module level thì:
+
+- ``import quapp_common.component.bridge`` đòi có ĐỦ 6 SDK cùng lúc, kể cả khi
+  function chỉ chạy Qiskit -- điều này vô hiệu hoá thiết kế lazy-import của
+  ``js-*/index.py`` trong quapp-sdk-templates (comment trong đó ghi rõ ý định
+  "so the server can start even if optional dependencies are missing");
+- cài chung 6 SDK gây xung đột version thật, đã xảy ra với ``pytket``/``lark``
+  và ``pennylane-rigetti``/``pyquil``.
+
+Khi SDK thiếu, handler raise ``ModuleNotFoundError`` -- classifier map thành
+``DEPENDENCY_MISSING`` và user nhận được hướng dẫn thêm package vào
+requirements.txt.
+"""
+
 import importlib
 import re
 from typing import Any, Dict
 
-import numpy as np
-import pennylane as qml
-import pennylane.measurements as _plm
-try:
-    import qiskit.qasm2 as _qasm2
-except ImportError:
-    _qasm2 = None
-from dimod import BinaryQuadraticModel
-from pytket.qasm import circuit_from_qasm_str
-from qibo.models import Circuit
-from qiskit import QuantumCircuit as QiskitCircuit
-from qulacs import QuantumCircuit as QulacsCircuit
-from qulacs.gate import DenseMatrix as DenseMatrixGate
-
 from ..config.logging_config import logger
 from ..enum.sdk import Sdk
 
 logger = logger.bind(context=__name__)
 
 
-def _load_qasm_circuit(qasm_str: str) -> QiskitCircuit:
-    """Parse OpenQASM 2.0 string into a Qiskit QuantumCircuit.
+def _require(module_name: str, package_hint: str = None):
+    """Import module của SDK, báo lỗi rõ ràng nếu thiếu.
+
+    @param module_name: tên module cần import, ví dụ 'qiskit.qasm2'.
+    @param package_hint: tên package trên PyPI để nhắc user, nếu khác module.
+    @raise ModuleNotFoundError: giữ đúng kiểu này để classifier phân loại thành
+                                DEPENDENCY_MISSING.
+    """
+    try:
+        return importlib.import_module(module_name)
+    except ImportError as exception:
+        package = package_hint or module_name.split('.')[0]
+        raise ModuleNotFoundError(
+                f"SDK '{package}' chưa được cài trong function image nhưng "
+                f"circuit cần nó. Thêm '{package}' vào requirements.txt của "
+                f"function rồi deploy lại.") from exception
+
+
+def _qiskit_quantum_circuit():
+    return _require('qiskit').QuantumCircuit
+
 
-    Compatible with Qiskit >= 1.0 (qiskit.qasm2.loads) and < 1.0 (from_qasm_str).
+def _load_qasm_circuit(qasm_str: str):
+    """Parse OpenQASM 2.0 string thành Qiskit QuantumCircuit.
+
+    Tương thích Qiskit >= 1.0 (``qiskit.qasm2.loads``) và < 1.0
+    (``QuantumCircuit.from_qasm_str``).
     """
-    if _qasm2 is not None:
-        return _qasm2.loads(qasm_str)
-    return QiskitCircuit.from_qasm_str(qasm_str)
+    try:
+        qasm2 = importlib.import_module('qiskit.qasm2')
+    except ImportError:
+        qasm2 = None
+
+    if qasm2 is not None:
+        return qasm2.loads(qasm_str)
+    return _qiskit_quantum_circuit().from_qasm_str(qasm_str)
 
 
 def adapt(sdk: Sdk, result: dict):
@@ -91,7 +126,8 @@ def _adapt_qubo(sdk, qubo_raw: Dict[str, Any]):
             qubo_dict[(key, key)] = val
 
     logger.debug(f"QUBO parsed: {len(qubo_dict)} entries -> BinaryQuadraticModel")
-    return BinaryQuadraticModel.from_qubo(qubo_dict)
+    binary_quadratic_model = _require('dimod').BinaryQuadraticModel
+    return binary_quadratic_model.from_qubo(qubo_dict)
 
 
 def _count_qasm_qubits(qasm_str):
@@ -101,7 +137,9 @@ def _count_qasm_qubits(qasm_str):
 
 def _openqasm_to_braket(qasm_str):
     logger.debug("Converting OpenQASM via pytket -> tk_to_braket")
-    tk_to_braket = importlib.import_module("pytket.extensions.braket").tk_to_braket
+    circuit_from_qasm_str = _require('pytket.qasm', 'pytket').circuit_from_qasm_str
+    tk_to_braket = _require('pytket.extensions.braket',
+                            'pytket-braket').tk_to_braket
     result = tk_to_braket(circuit_from_qasm_str(qasm_str))
     # tk_to_braket returns (Circuit, n_shots) in pytket-braket >= 0.35
     is_tuple = isinstance(result, tuple)
@@ -122,10 +160,13 @@ def _openqasm_to_cuda_quantum(qasm_str):
 
 def _openqasm_to_pennylane(qasm_str):
     logger.debug("Converting OpenQASM via PennyLane qml.from_qasm wrapper")
+    qml = _require('pennylane')
+    measurements = _require('pennylane.measurements', 'pennylane')
+
     for _compat_name in ("Expectation", "Variance", "Sample", "Probability",
                          "State", "MidMeasure"):
-        if not hasattr(_plm, _compat_name):
-            setattr(_plm, _compat_name, _compat_name)
+        if not hasattr(measurements, _compat_name):
+            setattr(measurements, _compat_name, _compat_name)
 
     num_wires = _count_qasm_qubits(qasm_str)
     logger.debug(f"PennyLane: detected {num_wires} qubits; wrapping with qml.probs over all wires")
@@ -150,13 +191,15 @@ def _openqasm_to_pennylane(qasm_str):
 
 def _openqasm_to_pyquil(qasm_str):
     logger.debug("Converting OpenQASM via pytket -> tk_to_pyquil")
-    tk_to_pyquil = importlib.import_module("pytket.extensions.pyquil").tk_to_pyquil
+    circuit_from_qasm_str = _require('pytket.qasm', 'pytket').circuit_from_qasm_str
+    tk_to_pyquil = _require('pytket.extensions.pyquil',
+                            'pytket-pyquil').tk_to_pyquil
     return tk_to_pyquil(circuit_from_qasm_str(qasm_str))
 
 
 def _openqasm_to_qibo(qasm_str):
     logger.debug("Converting OpenQASM via Qibo Circuit.from_qasm")
-    return Circuit.from_qasm(qasm_str)
+    return _require('qibo.models', 'qibo').Circuit.from_qasm(qasm_str)
 
 
 def _openqasm_to_qiskit(qasm_str):
@@ -184,6 +227,9 @@ def _qiskit_to_pennylane(qasm_str, num_wires):
     Fallback for environments where qml.from_qasm is unavailable because
     pennylane-qiskit is not installed (PennyLane < 0.36).
     """
+    qml = _require('pennylane')
+    numpy = _require('numpy')
+
     qiskit_circ = _load_qasm_circuit(qasm_str)
     qubit_map = {bit: idx for idx, bit in enumerate(qiskit_circ.qubits)}
     logger.debug(
@@ -205,9 +251,9 @@ def _qiskit_to_pennylane(qasm_str, num_wires):
         'y': lambda q, p: qml.PauliY(wires=q[0]),
         'z': lambda q, p: qml.PauliZ(wires=q[0]),
         's': lambda q, p: qml.S(wires=q[0]),
-        'sdg': lambda q, p: qml.PhaseShift(-np.pi / 2, wires=q[0]),
+        'sdg': lambda q, p: qml.PhaseShift(-numpy.pi / 2, wires=q[0]),
         't': lambda q, p: qml.T(wires=q[0]),
-        'tdg': lambda q, p: qml.PhaseShift(-np.pi / 4, wires=q[0]),
+        'tdg': lambda q, p: qml.PhaseShift(-numpy.pi / 4, wires=q[0]),
         'cx': lambda q, p: qml.CNOT(wires=q),
         'cz': lambda q, p: qml.CZ(wires=q),
         'swap': lambda q, p: qml.SWAP(wires=q),
@@ -244,9 +290,12 @@ def _qiskit_to_qulacs(qiskit_circ):
     unrecognized gates fall back to DenseMatrix (unitary passthrough).
     Measurement, barrier, reset, and identity instructions are skipped.
     """
+    qulacs_quantum_circuit = _require('qulacs').QuantumCircuit
+    dense_matrix_gate = _require('qulacs.gate', 'qulacs').DenseMatrix
+
     n = qiskit_circ.num_qubits
     logger.debug(f"_qiskit_to_qulacs: num_qubits={n} num_instructions={len(qiskit_circ.data)}")
-    qulacs_circ = QulacsCircuit(n)
+    qulacs_circ = qulacs_quantum_circuit(n)
     qubit_map = {bit: idx for idx, bit in enumerate(qiskit_circ.qubits)}
 
     _SINGLE = {
@@ -280,7 +329,7 @@ def _qiskit_to_qulacs(qiskit_circ):
             # ambiguity; multi-qubit gates are passed with qulacs'
             # index order matching Qiskit's instruction qubit order.
             logger.debug(f"Gate '{name}' not in named map; converting via DenseMatrix on qubits={qubits}")
-            qulacs_circ.add_gate(DenseMatrixGate(qubits, gate.to_matrix()))
+            qulacs_circ.add_gate(dense_matrix_gate(qubits, gate.to_matrix()))
 
     logger.debug(f"_qiskit_to_qulacs: conversion complete")
     return qulacs_circ

{quapp_common-0.0.14.dev4 → quapp_common-0.0.14.dev5/quapp_common.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quapp-common
-Version: 0.0.14.dev4
+Version: 0.0.14.dev5
 Summary: Quapp common library supporting Quapp Platform for Quantum Computing
 Author-email: "CITYNOW Co. Ltd. " <corp@citynow.vn>
 License: The MIT License (MIT)
@@ -25,18 +25,15 @@ Requires-Dist: numpy
 Requires-Dist: matplotlib
 Requires-Dist: pylatexenc
 Requires-Dist: starlette
-Requires-Dist: qibo
-Requires-Dist: dimod
-Requires-Dist: qulacs
-Requires-Dist: qiskit
-Requires-Dist: pytket
-Requires-Dist: pennylane
 Provides-Extra: dev
 Requires-Dist: black; extra == "dev"
 Requires-Dist: bumpver; extra == "dev"
 Requires-Dist: isort; extra == "dev"
 Requires-Dist: pip-tools; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: qiskit; extra == "test"
 Dynamic: license-file
 
 # quapp-common
@@ -114,6 +111,61 @@ Notes:
 
 ## Recently Changes Highlights
 
+### v0.0.14.dev5 — Gỡ toàn bộ dependency SDK lượng tử
+
+`quapp-common` không còn phụ thuộc SDK nào. SDK thuộc về lib con.
+
+**Gỡ khỏi `dependencies`** — 6 package, chỉ được dùng trong `circuit_adapter.py`:
+`qiskit`, `pennylane`, `qibo`, `qulacs`, `dimod`, `pytket`.
+
+Còn lại: `loguru`, `requests`, `numpy`, `matplotlib`, `pylatexenc`, `starlette`
+— đều được chính code của `quapp-common` dùng (`matplotlib`/`pylatexenc` cần cho
+`CircuitExportTask.__convert()`, nơi gọi `circuit.draw(output='mpl')` rồi
+`savefig()`).
+
+**`circuit_adapter.py`: import SDK lazy.** Mỗi handler tự import SDK của nó ngay
+trước khi dùng, qua helper `_require()`. Trước đây 7 SDK được import ở module
+level, nên:
+
+- `from quapp_common.component.bridge import SubprocessBridge` đòi có **đủ cả 6
+  SDK cùng lúc**, kể cả khi function chỉ chạy Qiskit. Điều này vô hiệu hoá thiết
+  kế lazy-import của `js-*/index.py` trong `quapp-sdk-templates` — comment trong
+  đó ghi rõ ý định *"so the server can start even if optional dependencies are
+  missing"*;
+- buộc mọi function image tải cả 6 SDK, và cài chung chúng gây xung đột version
+  thật (`pytket`/`lark`, `pennylane-rigetti`/`pyquil` — xem
+  `revert/pennylane-to-0.0.4.dev6` trong `qapp-pennylane`).
+
+`_require()` raise `ModuleNotFoundError` với thông điệp nêu tên package cần thêm
+vào `requirements.txt`. Classifier map nó thành `DEPENDENCY_MISSING` nên user
+nhận được hướng dẫn cụ thể thay vì traceback import.
+
+**`tests/test_circuit_adapter.py`**: SDK được import trong từng test qua
+`pytest.importorskip`. Trước đây file này import `qiskit` + `qibo` + `qulacs` ở
+module level nên **cả file không collect được** nếu thiếu một SDK. Test
+`test_qulacs_falls_back_to_string_on_parse_error` đổi target patch từ
+`circuit_adapter.QiskitCircuit` (tên module-level đã bỏ) sang `_load_qasm_circuit`.
+
+**`tests/test_no_sdk_dependency.py`** (mới) — khoá hồi quy bằng AST: quét từng
+file, fail nếu có SDK nào được import ở module level; và đọc `pyproject.toml`,
+fail nếu `dependencies` khai báo SDK.
+
+Đã verify trong **venv sạch không có SDK nào**: 82/82 module import được, suite
+300 passed / 7 skipped. Với venv chỉ có `qiskit`: 302 passed / 5 skipped.
+
+> **Lib con cần bổ sung khai báo.** Hai lib đang dựa vào `quapp-common` kéo hộ và
+> sẽ vỡ đường OpenQASM sau bản này:
+> - `qapp-pyquil` — thiếu `pytket` (cần cho `_openqasm_to_pyquil`);
+> - `quapp-qulacs` — thiếu `qiskit` (cầu nối OpenQASM → Qulacs đi qua Qiskit).
+>
+> Ngoài ra `qapp-dwave-ocean` import `matplotlib` trực tiếp nhưng không khai báo;
+> hiện vẫn chạy vì `quapp-common` còn giữ `matplotlib`, nên nên khai báo tường
+> minh để không phụ thuộc may mắn.
+>
+> `pytket-braket` và `pytket-pyquil` chưa từng được khai báo ở đâu — code dùng
+> `importlib.import_module()` cho chúng từ trước. Cần thêm vào `qapp-braket` và
+> `qapp-pyquil`.
+
 ### v0.0.14.dev2 — Fix: log lỗi bị nhân đôi
 
 - **Fix**: mỗi lần lỗi phát **hai** dòng ERROR cùng `event=job_failed`, mỗi dòng

{quapp_common-0.0.14.dev4 → quapp_common-0.0.14.dev5}/quapp_common.egg-info/SOURCES.txt

@@ -100,4 +100,5 @@ tests/test_json_parser_utils.py
 tests/test_language_dispatcher.py
 tests/test_log_secret_leak.py
 tests/test_logging_config.py
+tests/test_no_sdk_dependency.py
 tests/test_result_serializer.py

{quapp_common-0.0.14.dev4 → quapp_common-0.0.14.dev5}/quapp_common.egg-info/requires.txt

@@ -4,12 +4,6 @@ numpy
 matplotlib
 pylatexenc
 starlette
-qibo
-dimod
-qulacs
-qiskit
-pytket
-pennylane
 
 [dev]
 black
@@ -17,3 +11,7 @@ bumpver
 isort
 pip-tools
 pytest
+
+[test]
+pytest
+qiskit