qc-parallelizer 2.0.0__tar.gz → 2.1.0__tar.gz

{qc_parallelizer-2.0.0 → qc_parallelizer-2.1.0}/.pre-commit-config.yaml

@@ -12,7 +12,7 @@ repos:
   rev: v0.5.2
   hooks:
   - id: ruff
-    args: [ --fix ]
+    args: [ --fix, --show-fixes ]
     types_or: [ python, pyi ]
   - id: ruff-format
     types_or: [ python, pyi ]
@@ -26,7 +26,7 @@ repos:
   rev: v3.16.0
   hooks:
   - id: pyupgrade
-    args: [ --py310-plus ]
+    args: [ --py311-plus ]
 
 - repo: https://github.com/kynan/nbstripout
   rev: 0.8.1

{qc_parallelizer-2.0.0 → qc_parallelizer-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qc-parallelizer
-Version: 2.0.0
+Version: 2.1.0
 Summary: A module for optimally combining and distributing quantum circuits
 Author-email: Henri Ahola <firstname.lastname@vtt.fi>
 License-Expression: MIT
@@ -22,6 +22,7 @@ Requires-Dist: ipykernel; extra == "notebooks"
 Requires-Dist: matplotlib; extra == "notebooks"
 Requires-Dist: pylatexenc; extra == "notebooks"
 Requires-Dist: ipywidgets; extra == "notebooks"
+Requires-Dist: pennylane; extra == "notebooks"
 Provides-Extra: visualization
 Requires-Dist: matplotlib; extra == "visualization"
 Requires-Dist: pylatexenc; extra == "visualization"

{qc_parallelizer-2.0.0 → qc_parallelizer-2.1.0}/README.md

@@ -87,6 +87,9 @@ Result(
 )
 ```
 
+Likewise, the parallelized backend can be supplied to PennyLane with `.as_pennylane_device`. See
+[the PennyLane demo notebook](./notebooks/pennylane.ipynb) for an example.
+
 ## Development setup
 
 For the following commands, a virtual environment or equivalent isolation is recommended. This can
@@ -111,6 +114,30 @@ pip install .[tests]
 pip install .[notebooks]
 ```
 
+### Logging
+
+For debugging, it can be extremely useful to enable logging. The project uses an internal logging library with a global
+configurable log level. You can enable everything with
+```py
+from qc_parallelizer.util import Log
+Log.set_level("debug")
+```
+or use the other levels (`"info"`, `"warn"`, `"fail"`) for less verbose logging. By default, it writes nicely formatted
+and coloured output to stderr, but you can configure it with these two class attributes:
+```py
+Log.color: bool         # Enables color, True by default, but this can mess with some environments
+Log.force_builtin: bool # Forwards everything to Python's logging module, False by default
+```
+The log lines are interpreted as follows:
+```
+2026-06-03 11:28:14.488510 | [T0]~~~> vf2.py:70               | DBUG | VF2++ generator created with `id_order` = False.
+^^^^^^^^^^^^^^^^^^^^^^^^^^    ^^ ^^^^ ^^^^^^ ^^                 ^^^^   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  `--> Timestamp               \    \      \   `-> Line number    `-> Log level      `-> Message
+                                \    \      `-> Source file
+                                 \    `-> Relative stack depth
+                                  `-> Thread number (assigned T0, T1, T2, ... in order of appearance)
+```
+
 ## Testing
 
 Running all tests is as simple as installing the required dependencies (see above) and running

{qc_parallelizer-2.0.0 → qc_parallelizer-2.1.0}/notebooks/README.md

@@ -21,6 +21,12 @@ This folder contains example notebooks for demonstration and documentation purpo
   A list and documentation of circuit packers. Packers control the physical placement of circuits,
   considering the backend's topology and positioning relative to other circuits.
 
+## Application-specific
+
+- **[PennyLane](./pennylane.ipynb)**
+
+  A simple demonstration of computing expectation values in parallel with PennyLane.
+
 ## Other examples
 
 - **[Ring packing](./ring-packing.ipynb)**