✨ add parser for .real files (#219)

## Description

This moves the `.real` parser from MQT Core, where it has been removed
in munich-quantum-toolkit/core#822, to this repository.
As there are no previous connection points to the SyReC repository, this
is relatively standalone for now.

## Checklist:

<!---
This checklist serves as a reminder of a couple of things that ensure
your pull request will be merged swiftly.
-->

- [x] The pull request only contains commits that are related to it.
- [x] I have added appropriate tests and documentation.
- [x] I have made sure that all CI jobs on GitHub pass.
- [x] The pull request introduces no new warnings and follows the
project's style guidelines.

Author: burgholzer

cmake/ExternalDependencies.cmake

@@ -35,7 +35,7 @@ endif()
 # cmake-format: off
 set(MQT_CORE_VERSION 3.0.0
     CACHE STRING "MQT Core version")
-set(MQT_CORE_REV "8b25b61666cef507ad8920bd997627d6d348231d"
+set(MQT_CORE_REV "be654c753e98e9062d796143dd3a591366370b2d"
     CACHE STRING "MQT Core identifier (tag, branch or commit hash)")
 set(MQT_CORE_REPO_OWNER "cda-tum"
 	CACHE STRING "MQT Core repository owner (change when using a fork)")

include/core/real/parser.hpp

@@ -0,0 +1,29 @@
+#pragma once
+
+#include "ir/QuantumComputation.hpp"
+
+#include <cstddef>
+#include <iosfwd>
+#include <string>
+
+namespace syrec {
+
+    class RealParser {
+    public:
+        [[nodiscard]] static auto imports(const std::string& realString) -> qc::QuantumComputation;
+        [[nodiscard]] static auto importf(const std::string& filename) -> qc::QuantumComputation;
+        [[nodiscard]] static auto import(std::istream& is) -> qc::QuantumComputation;
+
+    private:
+        RealParser() = default;
+        explicit RealParser(qc::QuantumComputation& circ):
+            qc(&circ) {}
+
+        qc::QuantumComputation* qc{};
+        size_t                  nqubits{0};
+        size_t                  nclassics{0};
+
+        [[nodiscard]] auto readRealHeader(std::istream& is) -> int;
+        auto               readRealGateDescriptions(std::istream& is, int line) const -> void;
+    };
+} // namespace syrec

pyproject.toml

@@ -3,7 +3,7 @@ requires = [
     "scikit-build-core>=0.10.7",
     "setuptools-scm>=8.1",
     "pybind11>=2.13.6",
-    "mqt.core>=3.0.0b3",
+    "mqt.core>=3.0.0b4",
 ]
 build-backend = "scikit_build_core.build"
 
@@ -40,7 +40,7 @@ classifiers = [
 ]
 requires-python = ">=3.9"
 dependencies = [
-    "mqt.core>=3.0.0b3",
+    "mqt.core>=3.0.0b4",
     "PyQt6>=6.8",
 ]
 dynamic = ["version"]
@@ -275,10 +275,8 @@ environment = { DEPLOY="ON" }
 # The SOVERSION needs to be updated when the shared libraries are updated.
 repair-wheel-command = """auditwheel repair -w {dest_dir} {wheel} \
 --exclude libmqt-core-ir.so.3.0 \
---exclude libmqt-core-circuit-optimizer.so.3.0 \
---exclude libmqt-core-algorithms.so.3.0 \
---exclude libmqt-core-dd.so.3.0 \
---exclude libmqt-core-zx.so.3.0"""
+--exclude libmqt-core-qasm.so.3.0 \
+--exclude libmqt-core-dd.so.3.0"""
 
 [tool.cibuildwheel.macos]
 environment = { MACOSX_DEPLOYMENT_TARGET = "10.15" }
@@ -288,10 +286,8 @@ repair-wheel-command = "delocate-wheel --require-archs {delocate_archs} -w {dest
 before-build = "uv pip install delvewheel>=1.9.0"
 repair-wheel-command = """delvewheel repair -w {dest_dir} {wheel} --namespace-pkg mqt \
 --exclude mqt-core-ir.dll \
---exclude mqt-core-circuit-optimizer.dll \
---exclude mqt-core-algorithms.dll \
---exclude mqt-core-dd.dll \
---exclude mqt-core-zx.dll"""
+--exclude mqt-core-qasm.dll \
+--exclude mqt-core-dd.dll"""
 environment = { CMAKE_ARGS = "-T ClangCL" }
 
 [[tool.cibuildwheel.overrides]]
@@ -312,7 +308,7 @@ build = [
     "pybind11>=2.13.6",
     "scikit-build-core>=0.10.7",
     "setuptools-scm>=8.1",
-    "mqt-core>=3.0.0b3",
+    "mqt-core>=3.0.0b4",
 ]
 docs = [
     "furo>=2024.8.6",