Add preliminary support for qml.labs module sandboxing

.github/workflows/module-validation.yml

@@ -0,0 +1,35 @@
+name: Ensures module-level imports are valid
+on:
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - ready_for_review
+
+jobs:
+  tach:
+    if: github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Cancel Previous Runs
+        uses: styfle/cancel-workflow-action@0.12.1
+        with:
+          access_token: ${{ github.token }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: pip install tach==0.13.1
+
+      - uses: actions/checkout@v4
+
+      - name: Run tach
+        run: |
+          tach report pennylane/labs
+          tach check
+

.pre-commit-config.yaml

@@ -31,6 +31,10 @@ repos:
           "--filter-files",
         ]
       files: ^(pennylane/|tests/)
+-   repo: https://github.com/gauge-sh/tach-pre-commit
+    rev: v0.13.1
+    hooks:
+    -   id: tach
 - repo: local
   hooks:
     - id: pylint

doc/releases/changelog-dev.md

@@ -35,6 +35,9 @@
 
 <h3>Improvements 🛠</h3>
 
+* Module-level sandboxing added to `qml.labs` via pre-commit hooks.
+  [(#6369)](https://github.com/PennyLaneAI/pennylane/pull/6369)
+
 * PennyLane is now compatible with NumPy 2.0.
   [(#6061)](https://github.com/PennyLaneAI/pennylane/pull/6061)
   [(#6258)](https://github.com/PennyLaneAI/pennylane/pull/6258)

pennylane/labs/__init__.py

@@ -13,3 +13,6 @@
 # limitations under the License.
 """:code:`pennylane/labs/` module contains experimental features enabling
 advanced quantum computing research."""
+
+
+__all__ = []

requirements-ci.txt

@@ -13,3 +13,4 @@ matplotlib
 requests
 rich
 tomli # Drop once minimum Python version is 3.11
+tach

requirements-dev.txt

@@ -12,3 +12,4 @@ tomli~=2.0.0 # Drop once minimum Python version is 3.11
 isort==5.13.2
 pylint==2.7.4
 rich>=13.7.1
+tach==0.13.1

requirements.txt

@@ -15,3 +15,4 @@ opt_einsum~=3.3
 requests~=2.31.0
 typing_extensions~=4.5.0
 tomli~=2.0.0 # Drop once minimum Python version is 3.11
+tach~=0.13.1

tach.toml

@@ -0,0 +1,16 @@
+exclude = [
+    ".*__pycache__",
+    ".*egg-info",
+    "docs",
+    "tests",
+]
+source_roots = [
+    ".",
+    "pennylane",
+]
+
+[[modules]]
+path = "pennylane.labs"
+depends_on = [
+    { path = "<root>" },
+]