ket-lang 0.10.4.3.dev2__tar.gz → 0.10.4.3.dev3__tar.gz

{ket_lang-0.10.4.3.dev2 → ket_lang-0.10.4.3.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ket-lang
-Version: 0.10.4.3.dev2
+Version: 0.10.4.3.dev3
 Summary: Ket quantum programming language interpreter and library
 Keywords: quantum computer,quantum programming,quantum simulator
 Author: Evandro Chagas Ribeiro da Rosa
@@ -156,14 +156,29 @@ To get started with Ket development, follow these steps:
    git clone --recursive https://gitlab.com/quantum-ket/ket.git
    cd ket
 
-   cargo build -F c_api --manifest-path src/ket/clib/libs/libket/Cargo.toml
+   cargo build --manifest-path src/ket/clib/libs/libket/Cargo.toml
    cargo build --manifest-path src/ket/clib/libs/kbw/Cargo.toml
 
-   # Create symlinks from within the libs directory
+   # Link the libraries into the libs directory (paths are relative to it)
    ln -s libket/target/debug/libket.so src/ket/clib/libs/libket.so
    ln -s kbw/target/debug/libkbw.so src/ket/clib/libs/libkbw.so
    ```
 
+   The GPU simulators (`"dense gpu"`, `"sparse gpu"`) and the CUDA simulators (`"dense cuda"`, `"sparse cuda"`) need KBW built with the `gpu` and `cuda` features (Linux with glibc 2.34 or newer):
+
+   ```shell
+   cargo build -F gpu,cuda --manifest-path src/ket/clib/libs/kbw/Cargo.toml
+   ```
+
+   If the libraries are missing, importing `ket` compiles them in release mode (see `ket.clib.libs.make_libs`). On Linux with glibc 2.34 or newer, KBW is then built with the `gpu` and `cuda` features. Set these environment variables to change that:
+
+   | Variable         | Effect                                                  |
+   | ---------------- | ------------------------------------------------------- |
+   | `KET_BUILD_GPU`  | `1` builds KBW with the `gpu` feature, `0` without it.  |
+   | `KET_BUILD_CUDA` | `1` builds KBW with the `cuda` feature, `0` without it. |
+
+   For example, with `KET_BUILD_CUDA=0` set, the first `import ket` builds the GPU simulators but not the CUDA ones. The variables only take effect when the libraries are built: delete `libket.so` and `libkbw.so` from `src/ket/clib/libs/` to rebuild them.
+
 3. **Set Up Virtual Environment**
 
    Set up a virtual environment for Python:

{ket_lang-0.10.4.3.dev2 → ket_lang-0.10.4.3.dev3}/README.md

@@ -114,14 +114,29 @@ To get started with Ket development, follow these steps:
    git clone --recursive https://gitlab.com/quantum-ket/ket.git
    cd ket
 
-   cargo build -F c_api --manifest-path src/ket/clib/libs/libket/Cargo.toml
+   cargo build --manifest-path src/ket/clib/libs/libket/Cargo.toml
    cargo build --manifest-path src/ket/clib/libs/kbw/Cargo.toml
 
-   # Create symlinks from within the libs directory
+   # Link the libraries into the libs directory (paths are relative to it)
    ln -s libket/target/debug/libket.so src/ket/clib/libs/libket.so
    ln -s kbw/target/debug/libkbw.so src/ket/clib/libs/libkbw.so
    ```
 
+   The GPU simulators (`"dense gpu"`, `"sparse gpu"`) and the CUDA simulators (`"dense cuda"`, `"sparse cuda"`) need KBW built with the `gpu` and `cuda` features (Linux with glibc 2.34 or newer):
+
+   ```shell
+   cargo build -F gpu,cuda --manifest-path src/ket/clib/libs/kbw/Cargo.toml
+   ```
+
+   If the libraries are missing, importing `ket` compiles them in release mode (see `ket.clib.libs.make_libs`). On Linux with glibc 2.34 or newer, KBW is then built with the `gpu` and `cuda` features. Set these environment variables to change that:
+
+   | Variable         | Effect                                                  |
+   | ---------------- | ------------------------------------------------------- |
+   | `KET_BUILD_GPU`  | `1` builds KBW with the `gpu` feature, `0` without it.  |
+   | `KET_BUILD_CUDA` | `1` builds KBW with the `cuda` feature, `0` without it. |
+
+   For example, with `KET_BUILD_CUDA=0` set, the first `import ket` builds the GPU simulators but not the CUDA ones. The variables only take effect when the libraries are built: delete `libket.so` and `libkbw.so` from `src/ket/clib/libs/` to rebuild them.
+
 3. **Set Up Virtual Environment**
 
    Set up a virtual environment for Python:

{ket_lang-0.10.4.3.dev2 → ket_lang-0.10.4.3.dev3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ket-lang"
-version = "0.10.4.3.dev2"
+version = "0.10.4.3.dev3"
 description = "Ket quantum programming language interpreter and library"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -62,10 +62,7 @@ mps = [
 [tool.uv.build-backend]
 module-name = "ket"
 module-root = "src"
-wheel-exclude = [
-    "ket/clib/libs/kbw",
-    "ket/clib/libs/libket",
-]
+wheel-exclude = ["target"]
 source-exclude = ["target"]
 
 [tool.pytest.ini_options]

{ket_lang-0.10.4.3.dev2 → ket_lang-0.10.4.3.dev3}/pyproject.toml.orig

@@ -9,7 +9,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ket-lang"
-version = "0.10.4.3.dev2"
+version = "0.10.4.3.dev3"
 description = "Ket quantum programming language interpreter and library"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -49,9 +49,10 @@ mps = ["quimb", "jax", "jaxlib", "cotengra"]
 [tool.uv.build-backend]
 module-name = "ket"
 module-root = "src"
-# The libkbw/libket binaries in src/ket/clib/libs are shipped; the Rust
-# submodules next to them are build inputs only.
-wheel-exclude = ["ket/clib/libs/kbw", "ket/clib/libs/libket"]
+# The Rust sources in src/ket/clib/libs are shipped too: a wheel built from
+# the sdist has no binaries, and `ket.clib.libs.make_libs` compiles them on
+# the first import. Build outputs are left out.
+wheel-exclude = ["target"]
 source-exclude = ["target"]
 
 [tool.pytest.ini_options]

{ket_lang-0.10.4.3.dev2 → ket_lang-0.10.4.3.dev3}/src/ket/base/__init__.py

@@ -103,16 +103,21 @@ class Process(LibketProcess):  # pylint: disable=too-many-instance-attributes
 
     :Simulators:
 
-    KBW provides four simulators with different performance characteristics.
+    KBW provides several simulators with different performance characteristics.
     The best simulator to use depends on the number of qubits being simulated
     and on the specific quantum algorithm. Benchmarking is recommended to
     determine the most suitable simulator for a given workload.
 
-    - ``"sparse"``: Sparse simulator with limited multithreading capabilities.
+    - ``"sparse"``: Sparse simulator: stores only the basis states with nonzero
+      amplitude, in a sorted array. Best when few states are nonzero, as in
+      one-hot encodings.
+    - ``"sparse gpu"``: The ``"sparse"`` algorithm on most GPUs.
+    - ``"sparse cuda"``: The ``"sparse"`` algorithm on NVIDIA GPUs, using CUDA.
     - ``"dense"``: Dense simulator with good multithreaded performance.
     - ``"dense gpu"``: Dense simulator designed to run on most GPUs, including
       integrated Intel, AMD, and Apple GPUs, as well as NVIDIA GPUs. This simulator
       is generally recommended for simulations involving a large number of qubits.
+    - ``"dense cuda"``: Dense simulator on NVIDIA GPUs, using CUDA.
 
 
     Args:
@@ -121,7 +126,8 @@ class Process(LibketProcess):  # pylint: disable=too-many-instance-attributes
         num_qubits: Number of qubits for the KBW simulator.
             Defaults to 32 for sparse mode, or 12 for dense mode.
         simulator: Simulation mode for the KBW simulator. Options are
-            ``"sparse"``, ``"dense"``, and ``"dense gpu"``.
+            ``"sparse"``, ``"sparse gpu"``, ``"sparse cuda"``, ``"dense"``,
+            ``"dense gpu"``, and ``"dense cuda"``.
             Defaults to ``"sparse"``.
         execution: Execution mode for the KBW simulator, either ``"live"`` or ``"batch"``.
             Defaults to ``"live"``.
@@ -131,7 +137,16 @@ class Process(LibketProcess):  # pylint: disable=too-many-instance-attributes
         self,
         execution_target: BatchExecution | LiveExecution | None = None,
         num_qubits: Optional[int] = None,
-        simulator: Optional[Literal["sparse", "dense", "dense gpu"]] = None,
+        simulator: Optional[
+            Literal[
+                "sparse",
+                "sparse gpu",
+                "sparse cuda",
+                "dense",
+                "dense gpu",
+                "dense cuda",
+            ]
+        ] = None,
         execution: Optional[Literal["live", "batch"]] = None,
         gradient: bool = False,
         **kwargs,

{ket_lang-0.10.4.3.dev2 → ket_lang-0.10.4.3.dev3}/src/ket/clib/kbw.py

@@ -57,11 +57,15 @@ def get_simulator(  # pylint: disable=too-many-arguments,too-many-positional-arg
     execution: Literal["live", "batch"] = "live",
     simulator: Literal[
         "sparse",
+        "sparse v1",
         "sparse v2",
+        "sparse gpu",
+        "sparse cuda",
         "dense",
         "dense v1",
         "dense v2",
         "dense gpu",
+        "dense cuda",
     ] = "dense",
     coupling_graph: list[tuple[int, int]] | None = None,
     gradient: bool = False,
@@ -76,8 +80,16 @@ def get_simulator(  # pylint: disable=too-many-arguments,too-many-positional-arg
             Defaults to ``"live"``.
         simulator: Simulator backend to use. Available options:
 
-            - ``"sparse"``: Sparse state-vector simulator.
-            - ``"sparse v2"``: Updated sparse simulator variant.
+            - ``"sparse"``: Sparse state-vector simulator: stores only the
+              basis states with nonzero amplitude, in a sorted array. Same as
+              ``"sparse v2"``.
+            - ``"sparse v1"``: Previous sparse simulator (sharded hash map).
+            - ``"sparse gpu"``: The ``"sparse"`` algorithm on most GPUs.
+              Needs a build of KBW with GPU support.
+            - ``"sparse cuda"``: The ``"sparse"`` algorithm on NVIDIA GPUs,
+              using CUDA. Needs a build of KBW with CUDA support; the
+              ``KBW_CUDA_DEVICE`` environment variable selects the GPU
+              (default ``0``).
             - ``"dense"``: Dense state-vector simulator with good multithreaded
               performance. This is the default.
             - ``"dense v1"``: Previous dense simulator variant.
@@ -87,6 +99,9 @@ def get_simulator(  # pylint: disable=too-many-arguments,too-many-positional-arg
               states are split into blocks to keep gates inside the GPU
               caches; the block size is tuned for the device on first use
               (about two seconds) and stored, see :func:`tune_gpu_block_size`.
+            - ``"dense cuda"``: Dense simulator on NVIDIA GPUs, using CUDA.
+              Needs a build of KBW with CUDA support; the ``KBW_CUDA_DEVICE``
+              environment variable selects the GPU (default ``0``).
 
         coupling_graph: Optional list of ``(control, target)`` qubit pairs
             describing the hardware connectivity. When provided, the compiler

ket_lang-0.10.4.3.dev3/src/ket/clib/libs/__init__.py

@@ -0,0 +1,101 @@
+# SPDX-FileCopyrightText: 2020 Evandro Chagas Ribeiro da Rosa <evandro@quantuloop.com>
+# SPDX-FileCopyrightText: 2020 Rafael de Santiago <r.santiago@ufsc.br>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+"""C Libs"""
+
+import os
+import platform
+import shutil
+import subprocess
+import warnings
+
+_TRUE = {"1", "true", "yes", "on"}
+_FALSE = {"0", "false", "no", "off"}
+
+# KBW features and the environment variables that enable or disable them.
+_KBW_FEATURES = (("gpu", "KET_BUILD_GPU"), ("cuda", "KET_BUILD_CUDA"))
+
+
+def libs():
+    """Name Rust libs"""
+    if os.name == "nt":
+        return [("libket", "ket.dll"), ("kbw", "kbw.dll")]
+    if os.uname().sysname == "Linux":
+        return [("libket", "libket.so"), ("kbw", "libkbw.so")]
+    if os.uname().sysname == "Darwin":
+        return [("libket", "libket.dylib"), ("kbw", "libkbw.dylib")]
+    raise OSError("unsupported operational system")
+
+
+def _glibc_version() -> tuple[int, int] | None:
+    """The glibc version on Linux, or ``None`` (other systems or libcs)."""
+    if platform.system() != "Linux":
+        return None
+    name, version = platform.libc_ver()
+    if name != "glibc" or not version:
+        return None
+    try:
+        major, minor = version.split(".")[:2]
+        return int(major), int(minor)
+    except ValueError:
+        return None
+
+
+def _env_flag(name: str, default: bool) -> bool:
+    """Reads a boolean environment variable; unset or empty gives ``default``."""
+    value = os.environ.get(name, "").strip().lower()
+    if not value:
+        return default
+    if value in _TRUE:
+        return True
+    if value in _FALSE:
+        return False
+    raise ValueError(f"{name} must be 1 or 0, got {os.environ[name]!r}")
+
+
+def kbw_features() -> list[str]:
+    """Cargo features to build KBW with.
+
+    The ``gpu`` (``"dense gpu"`` and ``"sparse gpu"`` simulators) and ``cuda``
+    (``"dense cuda"`` and ``"sparse cuda"``) features are enabled by default
+    on Linux with glibc 2.34 or newer, as in the released wheels. The
+    environment variables ``KET_BUILD_GPU`` and ``KET_BUILD_CUDA`` override
+    this: ``1`` enables the feature and ``0`` disables it.
+    """
+    glibc = _glibc_version()
+    default = glibc is not None and glibc >= (2, 34)
+    return [feature for feature, env in _KBW_FEATURES if _env_flag(env, default)]
+
+
+def make_libs():
+    """Make Rust libs if missing.
+
+    KBW is built with the features of :func:`kbw_features`.
+    """
+    dirname = os.path.dirname(__file__)
+
+    if all(os.path.isfile(f"{dirname}/{lib}") for _, lib in libs()):
+        return
+
+    features = kbw_features()
+    warnings.warn(
+        "Compiling Libket and KBW"
+        + (f" (features: {', '.join(features)})" if features else "")
+        + "... may take a while. If it fails, check if Rust is installed "
+        "https://www.rust-lang.org/tools/install."
+    )
+
+    build = ["cargo", "build", "--release", "--quiet"]
+    subprocess.run(build, cwd=f"{dirname}/libket", check=True)
+    kbw_build = build + (["--features", ",".join(features)] if features else [])
+    subprocess.run(kbw_build, cwd=f"{dirname}/kbw", check=True)
+
+    for dirlib, lib in libs():
+        src = f"{dirname}/{dirlib}/target/release/{lib}"
+        dst = f"{dirname}/{lib}"
+        shutil.move(src, dst)
+
+
+make_libs()

{ket_lang-0.10.4.3.dev2 → ket_lang-0.10.4.3.dev3}/src/ket/clib/libs/kbw/.gitlab-ci.yml

@@ -8,32 +8,98 @@ stages:
   - build
   - deploy
 
-# Redirect Cargo's home into the project directory so GitLab's cache can
-# pick it up reliably (the default ~/.cargo is outside the project root).
+# Only the default branch updates the caches; other branches read them (and
+# fall back to the default branch's caches when they have none yet).
+workflow:
+  rules:
+    # Branch pipelines only (no duplicate merge request pipelines).
+    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
+      when: never
+    - if: "$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH"
+      variables:
+        CACHE_POLICY: pull-push
+    - when: always
+      variables:
+        CACHE_POLICY: pull
+
+default:
+  # A new push cancels the jobs of an outdated pipeline.
+  interruptible: true
+
 variables:
   CARGO_HOME: $CI_PROJECT_DIR/.cargo
+  CARGO_INCREMENTAL: "0"
+  CARGO_PROFILE_DEV_DEBUG: "0"
+
+# Cache entries, shared by the jobs below.
+.registry-cache: &registry-cache
+  key: cargo-registry-v1
+  paths:
+    - .cargo/registry/index/
+    - .cargo/registry/cache/
+  policy: $CACHE_POLICY
+
+.llvm-cache: &llvm-cache
+  key: tracel-llvm-v1
+  paths:
+    - .data/tracel/
+  policy: $CACHE_POLICY
+
+# Rule: the code that only the GPU and CUDA features compile changed.
+.gpu-changes: &gpu-changes
+  changes:
+    - src/dense_gpu/**/*
+    - src/sparse_gpu/**/*
+    - src/block.rs
+    - Cargo.toml
+    - Cargo.lock
+    - .gitlab-ci.yml
 
 # ---------------------------------------------------------------------------
 # Lint stage
 # ---------------------------------------------------------------------------
 
+# Default features (dense + sparse): fast, on every push.
 cargo-clippy:
-  image: registry.gitlab.com/quantum-ket/ket-building-images:linux-2.34-1.97
+  image: registry.gitlab.com/quantum-ket/ket-building-images:linux-2.28-1.97
   stage: lint
   cache:
-    - key: cargo-registry-v1
+    - *registry-cache
+    - key: cargo-clippy-2.28-$CI_COMMIT_REF_SLUG
+      fallback_keys:
+        - cargo-clippy-2.28-$CI_DEFAULT_BRANCH
       paths:
-        - .cargo/registry/index/
-        - .cargo/registry/cache/
-      policy: pull-push
-    - key: cargo-debug-$CI_COMMIT_REF_SLUG
+        - target/debug/
+        - target/.rustc_info.json
+        - target/CACHEDIR.TAG
+      policy: $CACHE_POLICY
+  script:
+    - cargo clippy --lib --tests -- -D warnings
+
+# All features (GPU and CUDA): slow (builds LLVM bindings), so only on the
+# default branch and when GPU-specific code changes. Changes to shared code
+# are checked by this job on the default branch, before `publish`.
+cargo-clippy-all:
+  image: registry.gitlab.com/quantum-ket/ket-building-images:linux-2.34-1.97
+  stage: lint
+  variables:
+    XDG_DATA_HOME: $CI_PROJECT_DIR/.data
+  cache:
+    - *registry-cache
+    - *llvm-cache
+    - key: cargo-clippy-2.34-all-$CI_COMMIT_REF_SLUG
+      fallback_keys:
+        - cargo-clippy-2.34-all-$CI_DEFAULT_BRANCH
       paths:
         - target/debug/
         - target/.rustc_info.json
         - target/CACHEDIR.TAG
-      policy: pull-push
+      policy: $CACHE_POLICY
   script:
     - cargo clippy --all-features -- -D warnings
+  rules:
+    - if: "$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH"
+    - *gpu-changes
 
 reuse:
   image: ghcr.io/astral-sh/uv:python3.10-trixie-slim
@@ -45,44 +111,44 @@ reuse:
 # Test stage
 # ---------------------------------------------------------------------------
 
+# Default features only (dense + sparse) on the oldest supported glibc: the
+# GPU and CUDA features need a GPU to run their tests, and linking their test
+# binaries exhausts the CI runner. Clippy still checks them (--all-features).
 cargo-test:
-  image: registry.gitlab.com/quantum-ket/ket-building-images:linux-2.34-1.97
+  image: registry.gitlab.com/quantum-ket/ket-building-images:linux-2.28-1.97
   stage: test
+  needs: []
   cache:
-    - key: cargo-registry-v1
-      paths:
-        - .cargo/registry/index/
-        - .cargo/registry/cache/
-      policy: pull-push
-    - key: cargo-debug-$CI_COMMIT_REF_SLUG
+    - *registry-cache
+    - key: cargo-test-2.28-$CI_COMMIT_REF_SLUG
+      fallback_keys:
+        - cargo-test-2.28-$CI_DEFAULT_BRANCH
       paths:
         - target/debug/
         - target/.rustc_info.json
         - target/CACHEDIR.TAG
-      policy: pull-push
+      policy: $CACHE_POLICY
   script:
-    - cargo test --all-features
+    - cargo test
 
 # ---------------------------------------------------------------------------
-# Build stage
+# Build stage (default branch only). The builds start right away (`needs:
+# []`); `publish` waits for them and for the lint and test jobs.
 # ---------------------------------------------------------------------------
 
 # glibc >= 2.28, default features (dense + sparse).
 linux-build:
   image: registry.gitlab.com/quantum-ket/ket-building-images:linux-2.28-1.97
   stage: build
+  needs: []
   cache:
-    - key: cargo-registry-v1
-      paths:
-        - .cargo/registry/index/
-        - .cargo/registry/cache/
-      policy: pull
+    - *registry-cache
     - key: cargo-release-linux-2.28-$CI_COMMIT_REF_SLUG
       paths:
         - target/release/
         - target/.rustc_info.json
         - target/CACHEDIR.TAG
-      policy: pull-push
+      policy: $CACHE_POLICY
   script:
     - cargo build --release
     - cp target/release/libkbw.so libkbw.so
@@ -90,24 +156,26 @@ linux-build:
     paths:
       - libkbw.so
   rules:
-    - if: '$CI_COMMIT_BRANCH == "main"'
+    - if: "$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH"
 
 # glibc >= 2.34, default features + GPU (wgpu) and CUDA.
 linux-gpu-build:
   image: registry.gitlab.com/quantum-ket/ket-building-images:linux-2.34-1.97
   stage: build
+  needs: []
+  variables:
+    # Keeps the LLVM bundle of the `cuda` feature in the cache (.data/tracel).
+    # Not global: uv (in `reuse`) would also write there and fail the lint.
+    XDG_DATA_HOME: $CI_PROJECT_DIR/.data
   cache:
-    - key: cargo-registry-v1
-      paths:
-        - .cargo/registry/index/
-        - .cargo/registry/cache/
-      policy: pull
+    - *registry-cache
+    - *llvm-cache
     - key: cargo-release-linux-2.34-gpu-$CI_COMMIT_REF_SLUG
       paths:
         - target/release/
         - target/.rustc_info.json
         - target/CACHEDIR.TAG
-      policy: pull-push
+      policy: $CACHE_POLICY
   script:
     - cargo build --release -F gpu,cuda
     - cp target/release/libkbw.so libkbw.gpu.so
@@ -115,41 +183,34 @@ linux-gpu-build:
     paths:
       - libkbw.gpu.so
   rules:
-    - if: '$CI_COMMIT_BRANCH == "main"'
+    - if: "$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH"
 
 windows-build:
   image: registry.gitlab.com/quantum-ket/ket-building-images:windows-1.97
   stage: build
+  needs: []
   cache:
-    - key: cargo-registry-v1
-      paths:
-        - .cargo/registry/index/
-        - .cargo/registry/cache/
-      policy: pull-push
+    - *registry-cache
     - key: cargo-release-windows-$CI_COMMIT_REF_SLUG
       paths:
         - target/x86_64-pc-windows-gnu/release/
-        - target/debug/
         - target/.rustc_info.json
         - target/CACHEDIR.TAG
-      policy: pull-push
+      policy: $CACHE_POLICY
   script:
     - cargo build --release --target x86_64-pc-windows-gnu
   artifacts:
     paths:
       - target/x86_64-pc-windows-gnu/release/kbw.dll
   rules:
-    - if: '$CI_COMMIT_BRANCH == "main"'
+    - if: "$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH"
 
 macos-build:
   image: registry.gitlab.com/quantum-ket/ket-building-images:macos-1.97
   stage: build
+  needs: []
   cache:
-    - key: cargo-registry-v1
-      paths:
-        - .cargo/registry/index/
-        - .cargo/registry/cache/
-      policy: pull
+    - *registry-cache
     - key: cargo-release-macos-$CI_COMMIT_REF_SLUG
       paths:
         - target/universal2-apple-darwin/release/
@@ -158,14 +219,14 @@ macos-build:
         - target/release/
         - target/.rustc_info.json
         - target/CACHEDIR.TAG
-      policy: pull-push
+      policy: $CACHE_POLICY
   script:
     - cargo zigbuild --release --target universal2-apple-darwin
   artifacts:
     paths:
       - target/universal2-apple-darwin/release/libkbw.dylib
   rules:
-    - if: '$CI_COMMIT_BRANCH == "main"'
+    - if: "$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH"
 
 # ---------------------------------------------------------------------------
 # Deploy stage
@@ -173,8 +234,19 @@ macos-build:
 
 publish:
   stage: deploy
+  # Never cancel a publish half-way.
+  interruptible: false
+  needs:
+    - cargo-clippy
+    - cargo-clippy-all
+    - reuse
+    - cargo-test
+    - linux-build
+    - linux-gpu-build
+    - windows-build
+    - macos-build
   rules:
-    - if: '$CI_COMMIT_BRANCH == "main"'
+    - if: "$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH"
   script:
     - |
       curl --location --header "JOB-TOKEN: ${CI_JOB_TOKEN}" \

{ket_lang-0.10.4.3.dev2 → ket_lang-0.10.4.3.dev3}/src/ket/clib/libs/kbw/build.rs

@@ -16,7 +16,7 @@ fn main() {
     }
 
     if accelerators.is_empty() {
-        println!("cargo:rustc-env=KBW_ACCELERATORS=", );
+        println!("cargo:rustc-env=KBW_ACCELERATORS=",);
     } else {
         println!(
             "cargo:rustc-env=KBW_ACCELERATORS=[{}]",

ket_lang-0.10.4.3.dev3/src/ket/clib/libs/kbw/src/bitwise.rs

@@ -0,0 +1,40 @@
+// SPDX-FileCopyrightText: 2020 Evandro Chagas Ribeiro da Rosa <evandro@quantuloop.com>
+// SPDX-FileCopyrightText: 2020 Rafael de Santiago <r.santiago@ufsc.br>
+//
+// SPDX-License-Identifier: Apache-2.0
+
+//! Bit-manipulation helpers shared by all simulator backends.
+//!
+//! These work on scalar `usize` basis states, used by the dense backends
+//! where the entire basis state fits in a single machine word. The sparse
+//! backends use the keys of [`crate::sparse_frame`].
+
+use std::ops::{BitOrAssign, Shl};
+
+use num::Integer;
+
+/// Build a control bitmask from a list of control qubit indices.
+///
+/// The resulting mask has a `1` in position `c` for each control qubit `c`.
+/// Used by dense simulators to check all controls with a single `&` operation.
+pub(crate) fn get_ctrl_mask<T: Integer + BitOrAssign + Shl<usize, Output = T>>(
+    control: &[usize],
+) -> T {
+    let mut control_mask = T::zero();
+    for c in control {
+        control_mask |= T::one() << *c;
+    }
+    control_mask
+}
+
+/// Flip bit `index` in `state` (scalar, dense representation).
+///
+/// Equivalent to applying a NOT gate on qubit `index` in the index space.
+pub(crate) const fn bit_flip(state: usize, index: usize) -> usize {
+    state ^ (1 << index)
+}
+
+/// Test whether bit `target` is set in `state` (scalar, dense representation).
+pub(crate) const fn is_one_at(state: usize, target: usize) -> bool {
+    state & (1 << target) != 0
+}