sia-script 0.8.2__tar.gz → 0.8.4__tar.gz

{sia_script-0.8.2 → sia_script-0.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sia-script
-Version: 0.8.2
+Version: 0.8.4
 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

{sia_script-0.8.2 → sia_script-0.8.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sia-script"
-version = "0.8.2"
+version = "0.8.4"
 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" }

{sia_script-0.8.2 → sia_script-0.8.4}/sia/__init__.py

@@ -11,12 +11,16 @@ Client-side package. Loads:
                Pure Python, no deps. (proprietary)
 4. hdqs_engine — offline quantum simulator: statevector/density matrix,
                GPU acceleration via PyTorch, advanced noise channels,
-               canonical algorithms (Deutsch, Grover, Shor-adjacent primitives,
-               VQE, QAOA, ...) and QKD protocols (BB84, E91, QSS).
+               canonical algorithms (Deutsch, Deutsch-Jozsa,
+               Bernstein-Vazirani, Grover, Simon, QFT, teleportation,
+               superdense coding, VQE, QAOA) and QKD protocols
+               (BB84, E91, QSS). Note: the QFT is a building block of
+               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.
-               MIT-licensed (see sia/hdqs_engine/LICENSE), distinct from the
-               proprietary license covering the rest of this package.
+               MIT-licensed (see the MIT_LICENSE string in sia/hdqs_engine.py),
+               distinct from the proprietary license covering the rest of
+               this package.
 
 Note: the proprietary HDQS server internals (qbt, vqram — the simulator core
 and hyper-dimensional virtual memory that the server runs) are NOT part of
@@ -24,8 +28,12 @@ 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.8.0"
+__version__ = "0.8.1"
 __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
+# (e.g. "hdqs.siasoftwareinnovations.com") and allow an environment override:
+#   __server_ip__ = os.environ.get("SIA_HDQS_HOST", "hdqs.siasoftwareinnovations.com")
 __server_ip__ = "31.97.239.213"
 __server_port__ = 8000
 __default_url__ = f"http://{__server_ip__}:{__server_port__}"
@@ -71,7 +79,9 @@ RuntimeEnv    = None
 run_file           = None
 extract_sia_block  = None
 TypedVariable      = None
-RuntimeError       = None
+# NOTE: do NOT bind the name `RuntimeError` at module scope — inside this
+# module it would shadow the builtin for every subsequent `raise`/`except`.
+# The legacy alias is served by __getattr__ at the bottom of this file.
 SystemVariables    = None
 SelectionOption    = None
 
@@ -106,7 +116,6 @@ try:
     run_file          = None   # no file-based runner in v5; use els_run(open(...).read())
     extract_sia_block = None   # internal detail, not re-exported
     TypedVariable     = None   # removed in v5 refactor
-    RuntimeError      = None   # no longer shadows built-in
     SystemVariables   = None   # internal, not public
     SelectionOption   = None   # internal, not public
 
@@ -135,10 +144,16 @@ except ImportError:
 #   sia/hdqs_engine.py), distinct from the proprietary license covering
 #   the rest of sia-script.
 #
-#   UPDATED v0.3.0: Now includes:
+#   UPDATED for hdqs_engine v0.4.0 — correctness rewrite validated against
+#   Qiskit quantum_info and Qiskit Aer. Breaking changes vs v0.3.0:
+#     * use_gpu now defaults to 'auto' (CUDA when present, else NumPy).
+#     * readout_error(q, p0_to_1, p1_to_0) is a CLASSICAL confusion matrix
+#       applied at measure()/sample(); it no longer alters the state.
+#     * Non-CPTP Kraus sets now raise instead of being renormalized.
+#   Includes:
 #   - HDQS class (renamed from StatevectorEngine for cleaner API)
 #   - Density matrix support (off by default, enable with use_density_matrix=True)
-#   - GPU acceleration via PyTorch (enable with use_gpu=True)
+#   - Automatic GPU acceleration via PyTorch (use_gpu='auto' by default)
 #   - Advanced noise channels:
 #       * Basic: bit_flip, phase_flip, depolarizing, amplitude_damping, phase_damping
 #       * Advanced: thermal, coherent, amplitude_phase_coupling, 
@@ -158,6 +173,22 @@ try:
         controlled,
         random_state,
         partial_trace,  # Partial trace utility
+        to_numpy,       # backend array -> numpy (works without PyTorch)
+        to_tensor,      # numpy/list -> torch tensor on a given device
+        is_tensor,
+
+        # Noise channel factories (CPTP-verified as of engine v0.4.0)
+        bit_flip_channel,
+        phase_flip_channel,
+        depolarizing_channel,
+        amplitude_damping_channel,
+        phase_damping_channel,
+        generalized_amplitude_damping_channel,
+        thermal_noise_channel,
+        coherent_noise_channel,
+        amplitude_phase_coupling_channel,
+        two_qubit_correlated_noise,
+        readout_error_channel,
         
         # GPU and backend detection
         _GPU_AVAILABLE,
@@ -197,14 +228,34 @@ try:
     # StatevectorEngine is still available as an alias to HDQS
     StatevectorEngine = HDQS
     
-except ImportError:
-    # If hdqs_engine is not available, set all to None
+except ImportError as _engine_import_error:
+    # Only swallow "hdqs_engine (or a dependency) isn't installed". A genuine
+    # error raised from *inside* the module (e.g. a broken NumPy) should not be
+    # silently turned into `HDQS = None` — that surfaces later as a confusing
+    # `TypeError: 'NoneType' object is not callable`.
+    import warnings as _warnings
+    _warnings.warn(f"sia.hdqs_engine unavailable: {_engine_import_error}",
+                   ImportWarning)
     HDQS = None
     StatevectorEngine = None
     GATES = None
     controlled = None
     random_state = None
     partial_trace = None
+    to_numpy = None
+    is_tensor = None
+
+    bit_flip_channel = None
+    phase_flip_channel = None
+    depolarizing_channel = None
+    amplitude_damping_channel = None
+    phase_damping_channel = None
+    generalized_amplitude_damping_channel = None
+    thermal_noise_channel = None
+    coherent_noise_channel = None
+    amplitude_phase_coupling_channel = None
+    two_qubit_correlated_noise = None
+    readout_error_channel = None
     
     _GPU_AVAILABLE = False
     _TORCH_AVAILABLE = False
@@ -275,7 +326,14 @@ __all__ = [
     "run_file",
     "extract_sia_block",
     "TypedVariable",
-    "RuntimeError",
+    # "RuntimeError" is deliberately NOT exported: it is a legacy v4.x alias
+    # left at None for backward attribute access (sia.RuntimeError), but
+    # listing it in __all__ made `from sia import *` REPLACE the builtin
+    # RuntimeError with None in the importer's namespace — breaking both
+    # `raise RuntimeError(...)` (TypeError: 'NoneType' object is not callable)
+    # and `except RuntimeError:` (TypeError: catching classes that do not
+    # inherit from BaseException is not allowed). The attribute is retained
+    # below; only the star-export is removed.
     "SystemVariables",
     "SelectionOption",
 
@@ -323,4 +381,26 @@ __all__ = [
     
     # Module reference
     "hdqs_engine",
-]
+]
+
+
+# =====================================================
+#   LEGACY ATTRIBUTE SHIM (PEP 562)
+# =====================================================
+# `sia.RuntimeError` was a v4.x ELS name that has been None since v5. Binding
+# it at module scope shadowed the builtin here and — because it was listed in
+# __all__ — in the namespace of anyone doing `from sia import *`. Serving it
+# from __getattr__ keeps old attribute access working while leaving the
+# builtin untouched.
+
+_LEGACY_NONE_ATTRS = frozenset({"RuntimeError"})
+
+
+def __getattr__(name):
+    if name in _LEGACY_NONE_ATTRS:
+        return None
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__():
+    return sorted(set(globals()) | _LEGACY_NONE_ATTRS)