sia-script 0.8.7__tar.gz → 1.0.2__tar.gz

sia_script-1.0.2/MANIFEST.in

@@ -0,0 +1,3 @@
+include src/*.cpp
+include README.md LICENSE.md pyproject.toml setup.py
+recursive-include sia *.py

{sia_script-0.8.7/sia_script.egg-info → sia_script-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sia-script
-Version: 0.8.7
+Version: 1.0.2
 Summary: SIA — Simplified Integrated Architecture: SiaNTT, SIA-ELS (ABAP interpreter), the HDQS server client, and hdqs_engine (offline statevector quantum simulator — no server or API token required)
 Author-email: Sia Software Innovations Private Limited <info@siasoftwareinnovations.com>
 License: # PROPRIETARY SOFTWARE LICENSE
@@ -62,17 +62,17 @@ Classifier: Topic :: System :: Distributed Computing
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: requests>=2.31.0
 Provides-Extra: client
-Requires-Dist: requests>=2.31.0; extra == "client"
-Requires-Dist: numpy>=1.24.0; extra == "client"
 Provides-Extra: engine
-Requires-Dist: numpy>=1.24.0; extra == "engine"
 Provides-Extra: torch
 Requires-Dist: torch>=2.0; extra == "torch"
+Provides-Extra: qasm
+Requires-Dist: openqasm3[parser]>=1.0; extra == "qasm"
 Provides-Extra: full
-Requires-Dist: requests>=2.31.0; extra == "full"
-Requires-Dist: numpy>=1.24.0; extra == "full"
 Requires-Dist: torch>=2.0; extra == "full"
+Requires-Dist: openqasm3[parser]>=1.0; extra == "full"
 Dynamic: license-file
 
 SIA — Simplified Integrated Architecture

{sia_script-0.8.7 → sia_script-1.0.2}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["setuptools>=61.0", "wheel"]
+requires = ["setuptools>=61.0", "wheel", "pybind11>=2.11"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "sia-script"
-version = "0.8.7"
+version = "1.0.2"
 description = "SIA — Simplified Integrated Architecture: SiaNTT, SIA-ELS (ABAP interpreter), the HDQS server client, and hdqs_engine (offline statevector quantum simulator — no server or API token required)"
 authors = [
     { name = "Sia Software Innovations Private Limited", email = "info@siasoftwareinnovations.com" }
@@ -38,33 +38,42 @@ classifiers = [
     "Topic :: System :: Distributed Computing",
 ]
 
-# No hard dependencies: ntt and els run on the stdlib alone.
-# Opt into what you actually need via extras below.
-dependencies = []
+# sia/__init__.py unconditionally does `from .hdqs import (...)`, and
+# hdqs.py unconditionally imports both numpy and requests -- so both are
+# real, required base dependencies, not optional. (v1.0.0 and v1.0.1 each
+# had one of these two only under an optional extra, which broke a plain
+# `pip install sia-script` with a ModuleNotFoundError on the very first
+# `import sia` -- caught by testing in a clean venv both times.)
+dependencies = [
+    "numpy>=1.24.0",
+    "requests>=2.31.0",
+]
 
 [project.urls]
 Homepage = "https://www.siasoftwareinnovations.com"
 Documentation = "https://www.siasoftwareinnovations.com"
 
 [project.optional-dependencies]
-# sia.hdqs — the server client. Needs a running HDQS server and an API token.
-client = [
-    "requests>=2.31.0",
-    "numpy>=1.24.0",
-]
+# sia.hdqs — the server client. Needs a running HDQS server and an API
+# token. requests is now a base dependency; kept as an empty extra for
+# backward compatibility with anyone depending on sia-script[client].
+client = []
 # sia.hdqs_engine — offline statevector simulator. No server, no token.
-engine = [
-    "numpy>=1.24.0",
-]
+# numpy is now a base dependency; kept as an empty extra for backward
+# compatibility with anyone depending on sia-script[engine].
+engine = []
 # sia.hdqs_engine.torch_layer — trainable QuantumLayer nn.Module.
 torch = [
     "torch>=2.0",
 ]
+# sia.hdqs_engine OpenQASM 3 import/export (HDQS.from_qasm3/to_qasm3).
+qasm = [
+    "openqasm3[parser]>=1.0",
+]
 # Everything above, combined.
 full = [
-    "requests>=2.31.0",
-    "numpy>=1.24.0",
     "torch>=2.0",
+    "openqasm3[parser]>=1.0",
 ]
 
 [tool.setuptools]

sia_script-1.0.2/setup.py

@@ -0,0 +1,48 @@
+"""
+Adds the sia.hdqs_core native extension to the build. Everything else
+(package metadata, dependencies, version) stays in pyproject.toml — this
+file exists only because setuptools has no purely declarative way to
+build a C++ extension from pyproject.toml alone.
+
+`python -m build` picks this up automatically; no change to your
+existing build/twine workflow.
+"""
+import sys
+from setuptools import setup
+from pybind11.setup_helpers import Pybind11Extension, build_ext
+
+# -O3 for standard optimization. -march=native is deliberately NOT used
+# here: it would tie the compiled wheel to the exact CPU that builds it,
+# and could crash with an "illegal instruction" fault on an end user's
+# different (often older) CPU. This keeps published wheels portable —
+# hdqs_engine.py falls back to a slower but fully portable code path
+# automatically when the fast (AVX2/AVX-512) instructions aren't
+# available at compile time, so nothing breaks, it's just not maximally
+# fast on every machine. Building locally with -march=native (e.g. for
+# your own benchmarking) is a separate, deliberate choice — see the
+# session notes on this if you want that build instead.
+extra_compile_args = ["-O3", "-std=c++17"]
+extra_link_args = []
+
+if sys.platform == "win32":
+    extra_compile_args = ["/O2", "/std:c++17", "/openmp"]
+else:
+    extra_compile_args += ["-fopenmp"]
+    extra_link_args += ["-fopenmp"]
+
+ext_modules = [
+    Pybind11Extension(
+        "sia.hdqs_core",
+        ["src/hdqs_core.cpp"],
+        cxx_std=17,
+        extra_compile_args=extra_compile_args,
+        extra_link_args=extra_link_args,
+    ),
+]
+
+setup(
+    package_dir={"sia": "sia"},
+    ext_modules=ext_modules,
+    cmdclass={"build_ext": build_ext},
+    zip_safe=False,
+)

{sia_script-0.8.7 → sia_script-1.0.2}/sia/__init__.py

@@ -18,12 +18,31 @@ Client-side package. Loads:
                Shor's algorithm, but no factoring routine is implemented.
                Runs entirely locally — no server, no API token, no network call.
                Requires NumPy; PyTorch optional for GPU acceleration.
-               Two trainable PyTorch layers are included: QuantumLayer
+               Four trainable PyTorch layers are included: QuantumLayer
                (parameter-shift gradients — models what real hardware
-               would report back) and BackpropQuantumLayer (ordinary
+               would report back), BackpropQuantumLayer (ordinary
                torch autograd through a batched statevector — no
                parameter-shift, simulator-only, ~5-10x faster
-               forward+backward at typical batch sizes).
+               forward+backward at typical batch sizes),
+               MidCircuitQuantumLayer (batched mid-circuit measurement
+               with a classically-conditioned gate; see its docstring
+               for the gradient-approximation caveat), and
+               QASMQuantumLayer (binds OpenQASM 3 `input` parameters to
+               trainable weights).
+               OpenQASM 3 interoperability via HDQS.from_qasm3() and
+               HDQS.to_qasm3(), covering the standard gate set, gate
+               modifiers (inv@/pow@/ctrl@/negctrl@), user-defined `gate`
+               blocks (inlined), `const`, `for` loops (unrolled), `let`
+               aliases, register/slice broadcasting, reset/barrier/end,
+               and if/else and switch branching on measured bits.
+               Requires the `openqasm3[parser]` extra.
+               Optional native (C++) acceleration for the statevector
+               gate-application hot path, with hand-vectorized AVX2/
+               AVX-512 kernels where available and automatic fallback to
+               pure NumPy on platforms without a compiled extension for
+               this build (see `sia.hdqs_engine._NATIVE_AVAILABLE`) --
+               a pure performance path, validated to produce identical
+               results to the NumPy path.
                MIT-licensed (see the MIT_LICENSE string in sia/hdqs_engine.py),
                distinct from the proprietary license covering the rest of
                this package.
@@ -34,7 +53,7 @@ this client package. They live in the server deployment only. What you get
 here for local, offline quantum simulation is sia.hdqs_engine.
 """
 
-__version__ = "0.9.0"
+__version__ = "1.0.0"
 __author__ = "Sia Software Innovations Private Limited"
 # NOTE: hardcoding a bare IP couples every released client to one host. If
 # the server ever moves, every installed copy breaks. Prefer a DNS name
@@ -229,6 +248,8 @@ try:
         # PyTorch integration with GPU support
         QuantumLayer,
         BackpropQuantumLayer,
+        MidCircuitQuantumLayer,
+        QASMQuantumLayer,
     )
     
     # Legacy alias for backward compatibility
@@ -292,6 +313,8 @@ except ImportError as _engine_import_error:
     
     QuantumLayer = None
     BackpropQuantumLayer = None
+    MidCircuitQuantumLayer = None
+    QASMQuantumLayer = None
     
     hdqs_engine = None
 
@@ -387,6 +410,8 @@ __all__ = [
     # PyTorch integration with GPU support
     "QuantumLayer",
     "BackpropQuantumLayer",
+    "MidCircuitQuantumLayer",
+    "QASMQuantumLayer",
     
     # Module reference
     "hdqs_engine",