mqt-yaqs 0.1.0__tar.gz

mqt_yaqs-0.1.0/.git_archival.txt

@@ -0,0 +1,3 @@
+node: $Format:%H$
+node-date: $Format:%cI$
+describe-name: $Format:%(describe:tags=true,match=*[0-9]*)$

mqt_yaqs-0.1.0/.gitattributes

@@ -0,0 +1 @@
+.git_archival.txt  export-subst

mqt_yaqs-0.1.0/.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,45 @@
+name: 🐛 Bug report
+description: Something is not working correctly.
+title: "🐛 <title>"
+body:
+  - type: markdown
+    attributes:
+      value: >-
+        **Thank you for wanting to report a bug for this project!**
+
+        ⚠
+        Verify first that your issue is not [already reported on GitHub](https://github.com/cda-tum/mqt-yaqs/search?q=is%3Aissue&type=issues).
+
+        If you have general questions, please consider [starting a discussion](https://github.com/cda-tum/mqt-yaqs/discussions).
+  - type: textarea
+    attributes:
+      label: Environment information
+      description: >-
+        Please provide information about your environment. For example, OS, Python version, mqt.yaqs version etc.
+      placeholder: |
+        - OS:
+        - Python compiler:
+        - mqt.yaqs version:
+        - Additional environment information:
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Description
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Expected behavior
+      description: A clear and concise description of what you expected to happen.
+  - type: textarea
+    attributes:
+      label: How to Reproduce
+      description: Please provide steps to reproduce this bug.
+      placeholder: |
+        1. Get package from '...'
+        2. Then run '...'
+        3. An error occurs.
+    validations:
+      required: true

mqt_yaqs-0.1.0/.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,32 @@
+name: ✨ Feature request
+description: Suggest an idea
+title: "✨ <title>"
+body:
+  - type: markdown
+    attributes:
+      value: >
+        **Thank you for wanting to suggest a feature for this project!**
+
+        ⚠
+        Verify first that your idea is not [already requested on GitHub](https://github.com/cda-tum/mqt-yaqs/search?q=is%3Aissue&type=issues).
+
+  - type: textarea
+    attributes:
+      label: What's the problem this feature will solve?
+      description: >-
+        What are you trying to do, that you are unable to achieve as it currently stands?
+      placeholder: >-
+        I'm trying to do X and I'm missing feature Y for this to be
+        easily achievable.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Describe the solution you'd like
+      description: >
+        Clear and concise description of what you want to happen.
+      placeholder: >-
+        When I do X, I want to achieve Y in a situation when Z.
+    validations:
+      required: true

mqt_yaqs-0.1.0/.github/SECURITY.md

@@ -0,0 +1,19 @@
+# Security Policy
+
+## Supported Versions
+
+Security updates are applied only to the most recent releases.
+
+## Reporting a Vulnerability
+
+To report vulnerabilities, you can privately report a potential security issue
+via the GitHub security vulnerabilities feature. This can be done here:
+
+https://github.com/cda-tum/mqt-yaqs/security/advisories
+
+Please do **not** open a public issue about a potential security vulnerability.
+
+You can find more details on the security vulnerability feature in the GitHub
+documentation here:
+
+https://docs.github.com/en/code-security/security-advisories/guidance-on-reporting-and-writing/privately-reporting-a-security-vulnerability

mqt_yaqs-0.1.0/.github/codecov.yml

@@ -0,0 +1,18 @@
+ignore:
+  - "tests/**/*"
+
+coverage:
+  range: 60..90
+  precision: 1
+  status:
+    project:
+      default:
+        threshold: 0.5%
+    patch:
+      default:
+        threshold: 1%
+
+comment:
+  layout: "reach, diff, flags, files"
+  require_changes: true
+  show_carryforward_flags: true

mqt_yaqs-0.1.0/.github/contributing.md

@@ -0,0 +1,78 @@
+# Contributing
+
+Thank you for your interest in contributing to this project.
+We value contributions from people with all levels of experience.
+In particular if this is your first pull request not everything has to be perfect.
+We will guide you through the process.
+
+We use GitHub to [host code](https://github.com/cda-tum/mqt-yaqs), to [track issues and feature requests](https://github.com/cda-tum/mqt-yaqs/issues), as well as accept [pull requests](https://github.com/cda-tum/mqt-yaqs/pulls).
+See <https://docs.github.com/en/get-started/quickstart> for a general introduction to working with GitHub and contributing to projects.
+
+## Types of Contributions
+
+You can contribute in several ways:
+
+- 🐛 Report Bugs
+  : Report bugs at <https://github.com/cda-tum/mqt-yaqs/issues> using the _🐛 Bug report_ issue template. Please make sure to fill out all relevant information in the respective issue form.
+
+- 🐛 Fix Bugs
+  : Look through the [GitHub Issues](https://github.com/cda-tum/mqt-yaqs/issues) for bugs. Anything tagged with "bug" is open to whoever wants to try and fix it.
+
+- ✨ Propose New Features
+  : Propose new features at <https://github.com/cda-tum/mqt-yaqs/issues> using the _✨ Feature request_ issue template. Please make sure to fill out all relevant information in the respective issue form.
+
+- ✨ Implement New Features
+  : Look through the [GitHub Issues](https://github.com/cda-tum/mqt-yaqs/issues) for features. Anything tagged with "feature" or "enhancement" is open to whoever wants to implement it. We highly appreciate external contributions to the project.
+
+- 📝 Write Documentation
+  : MQT YAQS could always use some more documentation, and we appreciate any help with that.
+
+## Get Started 🎉
+
+Ready to contribute? Check out the {doc}`Development Guide <development_guide>` to set up MQT YAQS for local development and learn about the style guidelines and conventions used throughout the project.
+
+We value contributions from people with all levels of experience.
+In particular, if this is your first PR, not everything has to be perfect.
+We will guide you through the PR process.
+Nevertheless, please try to follow the guidelines below as well as you can to help make the PR process quick and smooth.
+
+## Core Guidelines
+
+- ["Commit early and push often"](https://www.worklytics.co/blog/commit-early-push-often).
+- Write meaningful commit messages, preferably using [gitmoji](https://gitmoji.dev) for additional context.
+- Focus on a single feature or bug at a time and only touch relevant files. Split multiple features into separate contributions.
+- Add tests for new features to ensure they work as intended. Document new features appropriately.
+- Add tests for bug fixes to demonstrate that the bug has been resolved.
+- Document your code thoroughly and ensure it is readable.
+- Keep your code clean by removing debug statements, leftover comments, and unrelated code.
+- Check your code for style and linting errors before committing.
+- Follow the project's coding standards and conventions.
+- Be open to feedback and willing to make necessary changes based on code reviews.
+
+## Pull Request Workflow
+
+- Create PRs early. It is ok to create work-in-progress PRs. You may mark these as draft PRs on GitHub.
+- Describe your PR with a descriptive title, reference any related issues by including the issue number in the PR description, and add a comprehensive description of the changes. Follow the provided PR template and do not delete any sections, except for the issue reference if your PR is not related to an issue.
+- Whenever a PR is created or updated, several workflows on all supported platforms and versions of Python are executed. These workflows ensure that the project still builds, all tests pass, the code is properly formatted, and no new linting errors are introduced. Your PR must pass all these continuous integration (CI) checks before it can be merged.
+- Once your PR is ready, change it from a draft PR to a regular PR and request a review from one of the project maintainers. Only request a review once you are done with your changes and the PR is ready to be reviewed. If you are unsure whether your PR is ready, ask in the PR comments. If you are a first-time contributor, request a review from one of the maintainers by mentioning them in a comment on the PR.
+- If your PR gets a "Changes requested" review, address the feedback and update your PR by pushing to the same branch. Do not close the PR and open a new one. Respond to review comments on the PR (e.g., with "done 👍" or "done in @<commit>") to let the reviewer know that you have addressed the feedback. Note that reviewers do not get a notification if you just react to the review comment with an emoji. Write a comment to notify the reviewer. Do not resolve the review comments yourself. The reviewer will mark the comments as resolved once they are satisfied with the changes.
+- Be sure to re-request a review once you have made changes after a code review so that maintainers know that the requests have been addressed.
+- No need to squash commits before merging; we usually squash them to keep the history clean. We only merge without squashing if the commit history is clean and meaningful. Avoid rebasing or force-pushing your PR branch before merging, as it complicates reviews. You can rebase or clean up commits after addressing all review comments if desired.
+
+Here are some tips for finding the cause of certain failures:
+
+- If any of the `CI / 🇨‌ Test` checks fail, this indicates build errors or test failures in the C++ part of the code base. Look through the respective logs on GitHub for any error or failure messages.
+- If any of the `CI / 🐍 Test` checks fail, this indicates build errors or test failures in the Python part of the code base. Look through the respective logs on GitHub for any error or failure messages.
+- If any of the `codecov/\*` checks fail, this means that your changes are not appropriately covered by tests or that the overall project coverage decreased too much. Ensure that you include tests for all your changes in the PR.
+- If `cpp-linter` comments on your PR with a list of warnings, these have been raised by `clang-tidy` when checking the C++ part of your changes for warnings or style guideline violations. The individual messages frequently provide helpful suggestions on how to fix the warnings. If you don't see any messages, but the `🇨‌ Lint / 🚨 Lint` check is red, click on the `Details` link to see the full log of the check and a step summary.
+- If the `pre-commit.ci` check fails, some of the `pre-commit` checks failed and could not be fixed automatically by the _pre-commit.ci_ bot. Such failures are most likely related to the Python part of the code base. The individual log messages frequently provide helpful suggestions on how to fix the warnings.
+- If the `docs/readthedocs.org:\*` check fails, the documentation could not be built properly. Inspect the corresponding log file for any errors.
+
+---
+
+This document was inspired by and partially adapted from
+
+- <https://matplotlib.org/stable/devel/coding_guide.html>
+- <https://opensource.creativecommons.org/contributing-code/pr-guidelines/>
+- <https://yeoman.io/contributing/pull-request.html>
+- <https://github.com/scikit-build/scikit-build>

mqt_yaqs-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,16 @@
+## Description
+
+Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.
+
+Fixes #(issue) <!--- Replace (issue) with the issue number that is fixed by this pull request. -->
+
+## Checklist:
+
+<!---
+This checklist serves as a reminder of a couple of things that ensure your pull request will be merged swiftly.
+-->
+
+- [ ] The pull request only contains commits that are related to it.
+- [ ] I have added appropriate tests and documentation.
+- [ ] I have made sure that all CI jobs on GitHub pass.
+- [ ] The pull request introduces no new warnings and follows the project's style guidelines.

mqt_yaqs-0.1.0/.github/release-drafter.yml

@@ -0,0 +1,52 @@
+name-template: "MQT YAQS $RESOLVED_VERSION Release"
+tag-template: "v$RESOLVED_VERSION"
+categories:
+  - title: "🚀 Features and Enhancements"
+    labels:
+      - "feature"
+      - "enhancement"
+      - "usability"
+      - "refactor"
+  - title: "🐛 Bug Fixes"
+    labels:
+      - "bug"
+      - "fix"
+  - title: "📄 Documentation"
+    labels:
+      - "documentation"
+  - title: "📦 Packaging"
+    labels:
+      - "packaging"
+  - title: "🧹 Code Quality"
+    labels:
+      - "code quality"
+  - title: "🤖 CI"
+    labels:
+      - "continuous integration"
+  - title: "⬆️ Dependencies"
+    collapse-after: 5
+    labels:
+      - "dependencies"
+      - "submodules"
+      - "github_actions"
+      - "pre-commit"
+change-template: "- $TITLE @$AUTHOR (#$NUMBER)"
+change-title-escapes: '\<*_&'
+version-resolver:
+  major:
+    labels:
+      - "major"
+  minor:
+    labels:
+      - "minor"
+  patch:
+    labels:
+      - "patch"
+  default: patch
+
+template: |
+  ## 👀 What Changed
+
+  $CHANGES
+
+  **Full Changelog**: https://github.com/$OWNER/$REPOSITORY/compare/$PREVIOUS_TAG...v$RESOLVED_VERSION

mqt_yaqs-0.1.0/.github/renovate.json5

@@ -0,0 +1,38 @@
+{
+  $schema: "https://docs.renovatebot.com/renovate-schema.json",
+  extends: ["config:recommended", ":gitSignOff"],
+  prHourlyLimit: 10,
+  enabledManagers: ["github-actions", "pre-commit", "pep621"],
+  "pre-commit": {
+    enabled: true
+  },
+  lockFileMaintenance: {
+    "enabled": true,
+    "automerge": true,
+  },
+  configMigration: true,
+  labels: ["dependencies"],
+  schedule: ["every weekend"],
+  packageRules: [
+    {
+      matchManagers: ["github-actions"],
+      addLabels: ["github-actions"],
+      commitMessagePrefix: "⬆\uFE0F\uD83D\uDC68\u200D\uD83D\uDCBB"
+    },
+    {
+      matchManagers: ["pep621"],
+      addLabels: ["python"],
+      commitMessagePrefix: "⬆\uFE0F\uD83D\uDC0D"
+    },
+    {
+      matchManagers: ["pre-commit"],
+      addLabels: ["pre-commit"],
+      commitMessagePrefix: "⬆\uFE0F\uD83E\uDE9D",
+    },
+    {
+      "description": "Automerge patch updates",
+      "matchUpdateTypes": ["patch"],
+      "automerge": true
+    }
+  ]
+}

mqt_yaqs-0.1.0/.github/support.md

@@ -0,0 +1,11 @@
+# Support
+
+If you are stuck with a problem using MQT YAQS or have questions, please get in touch at our [Issues](https://github.com/cda-tum/mqt-yaqs/issues) or [Discussions](https://github.com/cda-tum/mqt-yaqs/discussions). We'd love to help.
+
+You can save time by following this procedure when reporting a problem:
+
+- Do try to solve the problem on your own first.
+- Search through past [Issues](https://github.com/cda-tum/mqt-yaqs/issues) and [Discussions](https://github.com/cda-tum/mqt-yaqs/discussions) to see if someone else already had the same problem.
+- Before filing a bug report, try to create a minimal working example (MWE) that reproduces the problem. It is much easier to identify the cause for the problem if a handful of lines suffice to show that something is not working.
+
+You can also always reach us at [quantum.cda@xcit.tum.de](mailto:quantum.cda@xcit.tum.de).

mqt_yaqs-0.1.0/.github/workflows/cd.yml

@@ -0,0 +1,38 @@
+name: CD 🚀
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  attestations: write
+  contents: read
+  id-token: write
+
+jobs:
+  python-packaging:
+    name: 🐍 Packaging
+    uses: cda-tum/mqt-workflows/.github/workflows/reusable-python-packaging.yml@v1.7
+    with:
+      pure-python: true
+
+  # Downloads the previously generated artifacts and deploys to PyPI on published releases.
+  deploy:
+    if: github.event_name == 'release' && github.event.action == 'published'
+    name: 🚀 Deploy to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mqt.yaqs
+    needs: [python-packaging]
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: cibw-*
+          path: dist
+          merge-multiple: true
+      - name: Generate artifact attestation for sdist and wheel
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-path: "dist/*"
+      - uses: pypa/gh-action-pypi-publish@release/v1

mqt_yaqs-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,118 @@
+name: CI
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  merge_group:
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  change-detection:
+    name: 🔍 Change
+    uses: cda-tum/mqt-workflows/.github/workflows/reusable-change-detection.yml@v1.7
+
+  python-tests:
+    name: 🐍 Test
+    needs: change-detection
+    if: fromJSON(needs.change-detection.outputs.run-python-tests)
+    uses: cda-tum/mqt-workflows/.github/workflows/reusable-python-ci.yml@v1.7
+    permissions:
+      contents: read
+      id-token: write
+    with:
+      # Runs to enable
+      enable-ubuntu2404: true
+      enable-ubuntu2404-arm: true
+      enable-macos13: true
+      enable-macos14: true
+      enable-windows2022: true
+      # Runs to disable
+      enable-ubuntu2204: false
+      enable-ubuntu2204-arm: false
+      enable-macos15: false
+      enable-windows2025: false
+
+  # run extensive Python tests whenever this is on a PR and the PR has the `extensive-python-ci` label
+  python-tests-extensive:
+    name: 🐍 Test (Extensive)
+    needs: change-detection
+    if: fromJSON(needs.change-detection.outputs.run-python-tests) && github.event_name == 'pull_request' && contains(github.event.pull_request.labels.*.name, 'extensive-python-ci')
+    uses: cda-tum/mqt-workflows/.github/workflows/reusable-python-ci.yml@v1.7
+    permissions:
+      contents: read
+      id-token: write
+    with:
+      # Runs to enable
+      enable-ubuntu2204: true
+      enable-ubuntu2204-arm: true
+      enable-macos15: true
+      enable-windows2025: true
+      # Runs to disable (these are already enabled in the non-extensive run)
+      enable-ubuntu2404: false
+      enable-ubuntu2404-arm: false
+      enable-macos13: false
+      enable-macos14: false
+      enable-windows2022: false
+
+  python-linter:
+    name: 🐍 Lint
+    needs: change-detection
+    if: fromJSON(needs.change-detection.outputs.run-python-tests)
+    uses: cda-tum/mqt-workflows/.github/workflows/reusable-python-linter.yml@v1.7
+
+  code-ql:
+    name: 📝 CodeQL
+    needs: change-detection
+    if: fromJSON(needs.change-detection.outputs.run-code-ql)
+    uses: cda-tum/mqt-workflows/.github/workflows/reusable-code-ql-python.yml@v1.7
+
+  cd:
+    name: 🚀 CD
+    needs: change-detection
+    if: fromJSON(needs.change-detection.outputs.run-cd)
+    uses: cda-tum/mqt-workflows/.github/workflows/reusable-python-packaging.yml@v1.7
+    with:
+      pure-python: true
+
+  required-checks-pass: # This job does nothing and is only used for branch protection
+    name: 🚦 Check
+    if: always()
+    needs:
+      - change-detection
+      - python-tests
+      - python-tests-extensive
+      - python-linter
+      - code-ql
+      - cd
+    runs-on: ubuntu-latest
+    steps:
+      - name: Decide whether the needed jobs succeeded or failed
+        uses: re-actors/alls-green@release/v1
+        with:
+          allowed-skips: >-
+            ${{
+              fromJSON(needs.change-detection.outputs.run-python-tests)
+              && '' || 'python-tests,'
+            }}
+            ${{
+              fromJSON(needs.change-detection.outputs.run-python-tests) && github.event_name == 'pull_request' && contains(github.event.pull_request.labels.*.name, 'extensive-python-ci')
+              && '' || 'python-tests-extensive,'
+            }}
+            ${{
+              fromJSON(needs.change-detection.outputs.run-python-tests)
+              && '' || 'python-linter,'
+            }}
+            ${{
+              fromJSON(needs.change-detection.outputs.run-code-ql)
+              && '' || 'code-ql,'
+            }}
+            ${{
+              fromJSON(needs.change-detection.outputs.run-cd)
+              && '' || 'cd,'
+            }}
+          jobs: ${{ toJSON(needs) }}

mqt_yaqs-0.1.0/.github/workflows/release-drafter.yml

@@ -0,0 +1,21 @@
+name: Release Drafter
+
+on:
+  push:
+    branches:
+      - main
+  pull_request_target:
+    types: [opened, reopened, synchronize]
+  merge_group:
+
+jobs:
+  update_release_draft:
+    name: Run
+    permissions:
+      contents: write
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      - uses: release-drafter/release-drafter@v6
+        env:
+          GITHUB_TOKEN: ${{ github.token }}

mqt_yaqs-0.1.0/.gitignore

@@ -0,0 +1,180 @@
+# Custom
+sandbox/
+experiments_hidden/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+.ccache/
+cmake-build-*
+
+# Distribution / packaging
+.Python
+/build/
+/test/*/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/
+*.profraw
+
+# 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/
+docs/api/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# 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/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# setuptools_scm
+src/mqt/*/_version.py
+
+# SKBuild cache dir
+_skbuild/
+
+# Any build dirs in the tests
+test/**/build/
+
+# Common editor files
+*~
+*.swp
+
+# RPM spec file
+!/distro/*.spec
+/distro/*.tar.gz
+*.rpm
+
+# ruff
+.ruff_cache/
+
+# OS specific stuff
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+.idea/
+.vscode/
+# tmt setup
+/distro/main.fmf
+/distro/plans/main.fmf
+/distro/tests/main.fmf
+
+/docs/**/build
+docs/**/_build
+.vs
+out/build
+
+node_modules/
+wheelhouse/