quapp-pennylane

Quapp PennyLane library supporting the Quapp Platform for Quantum Computing with providers, devices, circuit export, invocation, and job fetching utilities.

Overview

quapp-pennylane is a Python library that integrates the Quapp Platform with PennyLane-based quantum backends and simulators. It provides common abstractions for providers and devices, helpers for circuit construction and export, robust job submission and result fetching flows, and consistent job-scoped logging across all components.

Features

• Provider & device factories — PennyLane-compatible factories for local simulators (e.g., default.qubit) and vendor-backed hardware (Rigetti QVM, AWS Braket, IBM Quantum).
• Circuit export — PennylaneCircuitExportTask with a _PennylaneDrawableCircuit adapter that satisfies the CircuitExportTask.draw() contract using qml.draw_mpl.
• Job execution — QAppPennylaneDevice drives the full execution pipeline: tape construction, device selection, QNode creation, probability histogram generation, and timing metrics.
• Rigetti QVM support — dynamic device-name derivation for N-qubit QVM topologies (Nq-qvm, Nq-pyqvm) alongside fixed 9-qubit variants.
• Structured logging — job-scoped, instance-bound loggers emit structured key=value fields at every major step for traceability and debugging.
• Compatibility shims — quapp_pennylane/__init__.py patches API breaks between pennylane-rigetti==0.36.0 and PennyLane 0.37–0.42+ at import time (see Compatibility below).

Installation

pip install quapp-pennylane

Requirements

Project Structure

quapp_pennylane/
├── __init__.py                          # Compatibility shims (loaded at import)
├── async_tasks/
│   └── pennylane_circuit_export_task.py # PennylaneCircuitExportTask + adapter
├── component/
│   └── backend/
│       └── pennylane_invocation.py
├── factory/
│   ├── pennylane_device_factory.py
│   ├── pennylane_handler_factory.py
│   └── pennylane_provider_factory.py
├── handler/
│   └── invocation_handler.py
└── model/
    ├── device/
    │   ├── qapp_pennylane_device.py     # Core execution device
    │   ├── aws_braket_device.py
    │   └── ibm_quantum_device.py
    └── provider/
        ├── qapp_pennylane_provider.py
        ├── aws_braket_provider.py
        ├── ibm_cloud_provider.py
        └── ibm_quantum_provider.py

Compatibility

quapp_pennylane/__init__.py applies the following shims at import time so that pennylane-rigetti==0.36.0 works against PennyLane 0.37–0.42+:

pydantic is pinned to >=1.7.2,<2.0.0 in pyproject.toml to make the v1 requirement of qcs-api-client<0.22.0 explicit and prevent pip from resolving v2.

Recent Changes

0.0.5.dev2

• fix(export): Fix _PennylaneDrawableCircuit.draw() — qml.draw_mpl requires a QNode, not a bare callable; now captures the circuit into a QuantumTape, derives wires, creates a default.qubit device, and wraps in a QNode before rendering with qml.draw_mpl.
• build: Bump version to 0.0.5.dev2.

0.0.5.dev1

• feat(device): Add structured key=value log fields to QAppPennylaneDevice at every execution stage — initialization, tape diagnostics, device resolution, QNode setup, execution timing, histogram generation, and finalization.
• feat(device): Default shots fallback — shots=None or shots=0 in CircuitRunningOption falls back to 1024 with a warning instead of raising.
• feat(export): Introduce _PennylaneDrawableCircuit adapter in PennylaneCircuitExportTask to wrap PennyLane circuits for the CircuitExportTask.draw() contract using qml.draw_mpl.
• feat(export): Emit Python runtime information and duration timing in _transpile_circuit.
• fix(compat): Patch pydantic.BaseModel.__config__ at import time for Pydantic v2 environments — qcs-api-client<0.22.0 accesses self.__config__.env_prefix (a Pydantic v1 inner Config class removed in v2).
• fix(deps): Pin pydantic>=1.7.2,<2.0.0 in pyproject.toml to prevent pip from resolving Pydantic v2.
• fix(compat): Extend compatibility shims for pennylane-rigetti==0.36.0 against PennyLane 0.37–0.42+: measurements.Expectation, operation.Tensor, and pennylane.QubitDevice.
• build: Bump version to 0.0.5.dev1.

For detailed API references, refer to the in-code documentation or contact the maintainers at corp@citynow.vn.