quapp-pennylane 0.0.5.dev1

Quapp pennylane library supporting Quapp Platform for Quantum Computing

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

Dependency	Version
Python	≥ 3.10
quapp-common	0.0.11.dev7
pennylane	0.37.0
PennyLane-Rigetti	0.36.0
PennyLane-Lightning	0.37.0
pydantic	≥ 1.7.2, < 2.0.0
autoray	0.6.11

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+:

Symbol	Change	Shim
measurements.Expectation	Renamed to ExpectationMP in PennyLane 0.37+	Alias Expectation → ExpectationMP
operation.Tensor	Removed in PennyLane 0.40+; replaced by ops.Prod	Alias Tensor → Prod for isinstance checks
pennylane.QubitDevice	Moved to pennylane.devices in PennyLane ~0.40+	Re-export at top-level namespace
pydantic.BaseModel.__config__	Removed in Pydantic v2; qcs-api-client<0.22.0 reads self.__config__.env_prefix	Inject a stub __config__ with env_prefix='' onto BaseModel

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.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 info 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 [e-mail].