ci: fixes to the Lab environment publishing flow

[TheGupta2012]

Summary of changes

Follow-up to #455. This PR collects fixes to the Lab environment publishing flow (publish-lab-env.yml, bin/publish_lab_env.py). It stays open while the staging and production runs find what needs to change.

Changes so far

• Environment name: pyqasm (vX.Y.Z) instead of pyqasm X.Y.Z, to match the existing pyqasm environments. The kernel display name is Python 3 [pyqasm vX.Y.Z]. The preflight duplicate-name check follows the new name.
• Backport rule: the rule that keeps an older release from becoming the group's latest now reads the version from both name formats, in any case. Before, it did not recognise pyqasm (v1.2.1) as pyqasm.
• Only user-facing extras: the first staging run (run) built an environment with 100 packages. The test, lint and docs extras added about 50 developer packages: pytest, pylint, mypy, black, sphinx and a second qbraid-cli. The environment now gets pyqasm with every other extra the release declares, plus ipykernel.

Install	Linux packages
Before: all extras, ipykernel, matplotlib	100
Now: pyqasm[cli,pulse,visualization], ipykernel	48
Live 1.2.1 environment	41

The 7 extra packages over 1.2.1 come from the cli extra (typer, rich, click helpers) and the pulse extra (openpulse). A new user-facing extra is picked up from PyPI without a code change.

• pyqasm logo: qbraid envs create --logo only takes a qBraid provider name, and pyqasm is not a provider. The script now sets the pyqasm light and dark PNGs from qbraid-static-assets as the logo by default (pyqasm-light-no-text.png, pyqasm-dark-no-text.png). An optional variable, QBRAID_ENV_LOGO_URL, takes the https URL of a PNG and overrides both. QBRAID_ENV_LOGO is gone.

  • Preflight checks that each logo URL serves image/png. Lab saves kernel icons as PNG files.
  • After create, the URLs go on the local registry entry, which upload sends to the API. The light logo is also written as the local kernel icon.
  • After create, the script removes the Python logo-svg.svg that the CLI copies into the kernel directory. JupyterLab shows logo-svg ahead of the PNGs, so the launcher kept the Python icon.
  • Lab downloads the kernel icon from the API's light logo on install, so users see the pyqasm icon.
  • If the API logo differs after upload, the script sets it through the environment update route.

  Neither GitHub Environment sets QBRAID_ENV_LOGO_URL, so runs use the defaults.

First staging run

Every step passed:

• built on ubuntu-24.04 with the system Python 3.12.3
• smoke test passed
• uploaded as pyqasm_vq5daq, approved, and set as the latest of the default qBraid environment group

The environment has since been deleted from staging.

Testing

• A real create run with qbraid-cli[envs]==0.16.10 accepted the new name. The stored kernel display name is Python 3 [pyqasm v1.3.0]. The same run installed the new package set, and the smoke test passed on it.
• A real create run with a logo URL wrote it as the kernel icon and stored it on the registry entry. Both default URLs serve image/png, and the light one downloads byte for byte as the kernel icon.
• black, pylint (10.00) and actionlint pass. Mocked unit tests (46) pass, including a create test that fails without the SVG removal. They cover both name formats, the dev-extras exclusion, the default logos and override, the logo checks, and the upload fallback.

[argus-eye]

Argus review

Auto-review is off for this repo. Tick the box below to run a review on this PR.

• Trigger Argus review

Estimated cost

• Files changed: 2
• Diff lines (±): 8
• Historical avg: ~350.7k tokens · ~$1.38 · across last 13 review(s)

Tip: you can also comment @argus-eye review at any time.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

• Configuration used: Repository: qBraid/pyqasm/.coderabbit.yaml
• Review profile: CHILL
• Plan: Advanced
• Run ID: e9cbbf96-05dd-402f-bdfc-14ceaf4d2878

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[TheGupta2012]

staging publish works, merging