uniqc-cppsimulator 1.0.0__tar.gz

uniqc_cppsimulator-1.0.0/.github/workflows/build_and_test.yml

@@ -0,0 +1,96 @@
+name: Build-and-test
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        build_type: [Release]
+        c_compiler: [gcc, clang, cl]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        include:
+          - os: windows-latest
+            c_compiler: cl
+            cpp_compiler: cl
+          - os: ubuntu-latest
+            c_compiler: gcc
+            cpp_compiler: g++
+          - os: ubuntu-latest
+            c_compiler: clang
+            cpp_compiler: clang++
+          - os: macos-latest
+            c_compiler: clang
+            cpp_compiler: clang++
+        exclude:
+          - os: windows-latest
+            c_compiler: gcc
+          - os: windows-latest
+            c_compiler: clang
+          - os: ubuntu-latest
+            c_compiler: cl
+          - os: macos-latest
+            c_compiler: gcc
+          - os: macos-latest
+            c_compiler: cl
+
+    steps:
+    - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e  # v6.8.0
+
+    - name: Set up Python
+      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install build dependencies (Linux)
+      if: runner.os == 'Linux'
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y build-essential cmake ninja-build
+
+    - name: Install build dependencies (Windows / macOS)
+      if: runner.os != 'Linux'
+      run: |
+        uv pip install --system cmake ninja setuptools setuptools_scm wheel pybind11
+
+    - name: Build and install the extension
+      run: |
+        uv pip install --system setuptools setuptools_scm wheel pybind11
+        uv pip uninstall uniqc-cppsimulator --system -y || true
+        uv pip install --system . --no-build-isolation
+
+    - name: Run Python binding tests
+      run: |
+        uv pip install --system pytest
+        pytest tests/ -v --tb=short
+
+    - name: Build the native C++ test
+      shell: bash
+      run: |
+        cmake -S . -B build-cpp -DCMAKE_BUILD_TYPE=Release \
+          -Dpybind11_DIR="$(python -c 'import pybind11; print(pybind11.get_cmake_dir())')"
+        cmake --build build-cpp --config Release
+
+    - name: Run the native C++ test (Linux / macOS)
+      if: runner.os != 'Windows'
+      # CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE puts the binary under
+      # bin/Release even for single-config generators.
+      run: ./build-cpp/bin/Release/UnifiedQuantumTest
+
+    - name: Run the native C++ test (Windows)
+      if: runner.os == 'Windows'
+      run: .\build-cpp\bin\Release\UnifiedQuantumTest.exe

uniqc_cppsimulator-1.0.0/.github/workflows/pypi-publish.yml

@@ -0,0 +1,109 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+
+jobs:
+  validate_release:
+    name: Validate release tag
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
+        with:
+          fetch-depth: 0
+
+      - name: Fetch main branch
+        run: git fetch origin main:refs/remotes/origin/main
+
+      - name: Validate tag ancestry and changelog
+        run: |
+          python scripts/check_release.py \
+            --tag "${{ github.ref_name }}" \
+            --main-ref origin/main \
+            --changelog CHANGELOG.md
+
+  build_wheels:
+    name: Build wheel (${{ matrix.os }})
+    needs: validate_release
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
+        with:
+          fetch-depth: 0  # Need full history for setuptools_scm version detection
+
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+        with:
+          python-version: '3.12'
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084  # v3.4.1
+
+      - name: Validate wheel ABI
+        run: python scripts/check_wheel_abi.py wheelhouse/*.whl
+
+      - name: Validate wheel release version
+        run: python scripts/check_release.py --tag "${{ github.ref_name }}" --wheel "wheelhouse/*.whl"
+
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # v4.6.2
+        with:
+          name: wheel-${{ matrix.os }}
+          path: ./wheelhouse/*.whl
+
+  build_sdist:
+    name: Build sdist
+    needs: validate_release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+        with:
+          python-version: '3.12'
+
+      - name: Build sdist
+        run: |
+          python -m pip install build
+          python -m build --sdist
+
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # v4.6.2
+        with:
+          name: sdist
+          path: ./dist/*.tar.gz
+
+  publish:
+    name: Publish to PyPI
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
+
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093  # v4.3.0
+        with:
+          path: dist/
+          merge-multiple: true
+
+      - name: Validate publish artifacts
+        run: python scripts/check_release.py --tag "${{ github.ref_name }}" --wheel "dist/*.whl"
+
+      - uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b  # v1.14.0
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          # Allow re-running a release to add artifacts (e.g. sdist, new
+          # platform wheels) without failing on files already on PyPI.
+          skip-existing: true

uniqc_cppsimulator-1.0.0/.github/workflows/python_build_wheel.yml

@@ -0,0 +1,53 @@
+name: Build Python Wheels
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - 'pyproject.toml'
+      - 'setup.py'
+      - '**.cpp'
+      - '**.cc'
+      - '**.c'
+      - '**.h'
+      - '**.hpp'
+      - '**/CMakeLists.txt'
+      - '**.cmake'
+      - 'scripts/stubgen.py'
+      - '.github/workflows/python_build_wheel.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build_wheels:
+    name: ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
+      with:
+        fetch-depth: 0  # Need full history for setuptools_scm version detection
+
+    - name: Set up Python
+      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+      with:
+        python-version: '3.12'
+
+    - name: Build wheels
+      uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084  # v3.4.1
+
+    - name: Validate wheel ABI
+      run: python scripts/check_wheel_abi.py wheelhouse/*.whl
+
+    - name: Upload wheel artifact
+      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4  # v5.0.0
+      with:
+        name: wheel-${{ matrix.os }}
+        path: wheelhouse/*.whl

uniqc_cppsimulator-1.0.0/.gitignore

@@ -0,0 +1,212 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+# Autogenerated per-module reference pages; regenerated by `sphinx-apidoc`
+# before every build (see docs/Makefile). `uniqc_api.rst` is hand-curated.
+docs/source/uniqc.rst
+docs/source/uniqc.*.rst
+!docs/source/uniqc_api.rst
+docs/source/releases/_generated/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+uv.lock
+
+# Node / frontend
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+# (site/ is now the landing page source, tracked in git)
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintainted in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# VS/vscode
+.vscode/
+.vs/
+
+# Claude Code / Copilot CLI per-repo agent state and worktrees
+.claude/
+
+# output path
+origin_online_info_verify/
+quafu_online_info_verify/
+ibm_online_info_verify/
+originq_online_config.json
+quafu_online_config.json
+ibm_online_config.json
+qcloud_config_template/originq_template.py
+qcloud_config_template/quafu_template.py
+qcloud_config_template/ibm_template.py
+test/make_online_config/
+history/
+online_info/
+dummy_server/
+test/quafu_test
+originq_cloud_config.json
+good_circuits.txt
+bad_circuits.txt
+*.png
+*.pdf
+
+# setuptools_scm generated version file
+uniqc/_version.py
+
+# CMake build artifacts
+UniqcCpp/CMakeCache.txt
+UniqcCpp/CMakeFiles/
+UniqcCpp/Makefile
+UniqcCpp/cmake_install.cmake
+UniqcCpp/Pybinder/Makefile
+UniqcCpp/Pybinder/CMakeFiles/
+UniqcCpp/Thirdparty/Makefile
+UniqcCpp/Thirdparty/CMakeFiles/
+UniqcCpp/src/Makefile
+UniqcCpp/src/CMakeFiles/
+UniqcCpp/src/cmake_install.cmake
+UniqcCpp/test/Makefile
+UniqcCpp/test/CMakeFiles/
+UniqcCpp/test/cmake_install.cmake

uniqc_cppsimulator-1.0.0/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-08-21
+
+初始独立版本。C++ 模拟器自 [UnifiedQuantum](https://github.com/IAI-USTC-Quantum/UnifiedQuantum) v0.0.17 拆分为独立仓库，import 名保持 `uniqc_cpp` 不变，API 与拆分前完全兼容。
+
+- `StatevectorSimulator`（态矢量，最多 30 量子比特）与 `DensityOperatorSimulator`（密度算符，最多 10 量子比特，含噪声通道）
+- QRAM 指令支持与参数校验
+- Release 构建安全加固（stack protector / FORTIFY / relro）
+- Python 绑定测试套件（`tests/`）与 C++ 原生冒烟测试
+- 类型存根 `uniqc_cpp.pyi` 随 wheel 一起发布

uniqc_cppsimulator-1.0.0/CMakeLists.txt

@@ -0,0 +1,33 @@
+cmake_minimum_required(VERSION 3.22)
+project(UnifiedQuantum)
+include_directories(${CMAKE_CURRENT_SOURCE_DIR}/UniqcCpp/src
+                    ${CMAKE_CURRENT_SOURCE_DIR}/UniqcCpp/Thirdparty
+                    ${CMAKE_CURRENT_SOURCE_DIR}/UniqcCpp/Thirdparty/fmt/include
+                    )
+
+set(LIBRARY_OUTPUT_PATH ${CMAKE_CURRENT_BINARY_DIR}/lib)
+set(EXECUTABLE_OUTPUT_PATH ${CMAKE_CURRENT_BINARY_DIR}/bin)
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG ${CMAKE_CURRENT_BINARY_DIR}/bin/Debug)
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_CURRENT_BINARY_DIR}/bin/Release)
+set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_DEBUG ${CMAKE_CURRENT_BINARY_DIR}/lib/Debug)
+set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_RELEASE ${CMAKE_CURRENT_BINARY_DIR}/lib/Release)
+
+set(CMAKE_CXX_STANDARD 17)
+
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+
+# Security hardening flags for Release builds (GCC/Clang only; MSVC uses
+# its own mitigations and would reject these ELF-specific linker options).
+if (CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
+    add_compile_options($<$<CONFIG:Release>:-fstack-protector-strong>)
+    add_compile_options($<$<CONFIG:Release>:-D_FORTIFY_SOURCE=2>)
+    if (NOT APPLE)
+        add_link_options($<$<CONFIG:Release>:-Wl,-z,relro,-z,now>)
+        add_link_options($<$<CONFIG:Release>:-Wl,--strip-all>)
+    endif()
+endif()
+
+set(PYBIND11_FINDPYTHON ON)
+find_package(pybind11 CONFIG REQUIRED)
+
+add_subdirectory(UniqcCpp)