Skip to content

Commit 06a3681

Browse files
authored
update squin docs (#267)
* update squin docs * update changelog
1 parent 877524f commit 06a3681

2 files changed

Lines changed: 29 additions & 19 deletions

File tree

CHANGELOG.md

Lines changed: 1 addition & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -16,32 +16,18 @@ Types of changes:
1616

1717
### ➕ New Features
1818

19-
- **PyQIR 0.12+ support**: Add compatibility for pyqir 0.12+ (opaque pointers / QIR 2.0) alongside existing 0.10.x support. New `_pyqir_compat` module provides `pointer_id`, `qubit_pointer_type`, and `pyqir_uses_opaque_pointers()` for version-agnostic code. ([#265](https://github.com/qBraid/qbraid-qir/pull/265))
20-
2119
### 🌟 Improvements
2220

23-
- **Backward-compatible PyQIR usage**: Cirq, QASM3, and Squin visitors use the compat layer so the codebase works with both pyqir <0.12 (typed pointers) and ≥0.12 (opaque pointers). ([#265](https://github.com/qBraid/qbraid-qir/pull/265))
24-
- **Version-aware tests**: Test helpers and fixtures choose typed vs opaque pointer expectations based on the installed pyqir version; added version-specific LL fixtures (e.g. `*_typed.ll`, `*_opaque.ll`) for Cirq and QASM3 tests. ([#265](https://github.com/qBraid/qbraid-qir/pull/265))
25-
- **CI: test both PyQIR versions**: GitHub Actions test job runs the full suite with pyqir 0.10.x and 0.12+, then combines coverage and uploads to Codecov. ([#265](https://github.com/qBraid/qbraid-qir/pull/265))
26-
- **Tox: dual PyQIR envs**: New `unit-tests-pyqir10` and `unit-tests-pyqir12` tox environments so `tox` runs unit tests against both pyqir version ranges.
27-
- **Optional test deps**: Skip cudaq-to-Squin tests when cudaq is not installed; skip autoqasm converter tests when autoqasm is not installed. ([#265](https://github.com/qBraid/qbraid-qir/pull/265))
28-
2921
### 📜 Documentation
3022

31-
- **CHANGELOG**: Clarified "Past releases" section with a short description and link to the Releases page. ([#265](https://github.com/qBraid/qbraid-qir/pull/265))
23+
- Updated the `qbraid_qir.squin` module imports and __all__ to explicitly expose `SquinVisitor` and `InvalidSquinInput` alongside `load`, making these components part of the public API.
3224

3325
### 🐛 Bug Fixes
3426

35-
- _(none this release)_
36-
3727
### ⬇️ Dependency Updates
3828

39-
- **pyqir**: Relax requirement from `>=0.10.0,<0.11.0` to `>=0.10.0,<0.13.0` so both 0.10.x and 0.12.x are supported. ([#265](https://github.com/qBraid/qbraid-qir/pull/265))
40-
4129
### 👋 Deprecations
4230

43-
- _(none)_
44-
4531
## Past releases
4632

4733
Release notes for earlier versions are published on the [Releases](https://github.com/qBraid/qbraid-qir/releases) page.

qbraid_qir/squin/__init__.py

Lines changed: 28 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,36 @@
1212
# See the License for the specific language governing permissions and
1313
# limitations under the License.
1414

15-
# type: ignore
16-
1715
"""
1816
This module contains the functionality to convert a PyQIR module into a squin kernel.
17+
18+
Functions
19+
-----------
20+
21+
.. autosummary::
22+
:toctree: ../stubs/
23+
24+
load
25+
26+
Classes
27+
---------
28+
29+
.. autosummary::
30+
:toctree: ../stubs/
31+
32+
SquinVisitor
33+
34+
Exceptions
35+
-----------
36+
37+
.. autosummary::
38+
:toctree: ../stubs/
39+
40+
InvalidSquinInput
41+
1942
"""
2043

21-
from .visitor import load
44+
from .exceptions import InvalidSquinInput
45+
from .visitor import SquinVisitor, load
2246

23-
__all__ = ["load"]
47+
__all__ = ["load", "SquinVisitor", "InvalidSquinInput"]

0 commit comments

Comments
 (0)