qubasic 0.1.0__tar.gz → 0.3.0__tar.gz

qubasic-0.3.0/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## 0.1.0 (2026-03-28)
+
+Initial PyPI release.
+
+- BASIC REPL with line-numbered program editing
+- 30+ quantum gates (H, X, Y, Z, CX, CCX, RX, RY, RZ, CP, SWAP, etc.)
+- LOCC mode: 2-26 party distributed quantum simulation (SPLIT and JOINT)
+- Full BASIC language: FOR/NEXT, WHILE/WEND, DO/LOOP, SELECT CASE, SUB/FUNCTION, IF/THEN/ELSE
+- AST-based expression evaluator (no eval)
+- Noise models: depolarizing, amplitude damping, phase flip, thermal, readout, combined, Pauli, reset
+- Debugging: STEP, TRON/TROFF, breakpoints, watch, time-travel (REWIND/FORWARD), PROFILE
+- Memory map: PEEK/POKE/SYS/DUMP/MAP/MONITOR
+- Analysis: EXPECT, ENTROPY, DENSITY, SWEEP, BENCH, RAM
+- File I/O: SAVE/LOAD/INCLUDE/IMPORT, OPEN/CLOSE/PRINT#/INPUT#, CSV, OpenQASM 3.0 export
+- 12 built-in demos: Bell, GHZ, Grover, QFT, Deutsch-Jozsa, Bernstein-Vazirani, Superdense, Teleport, LOCC
+- JSON output mode for agent/pipeline integration
+- String variable resolution in PRINT (LEFT$, RIGHT$, CHR$, concatenation)
+- DEF FN and parameterized DEF subroutine invocation
+- Trusted publisher CI/CD to PyPI

qubasic-0.3.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+recursive-include examples *.qb

{qubasic-0.1.0 → qubasic-0.3.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: qubasic
-Version: 0.1.0
+Version: 0.3.0
 Summary: Quantum BASIC Interactive Terminal
 Author-email: "Charles C. Norton" <machineelv@gmail.com>
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/CharlesCNorton/qbasic
-Project-URL: Repository, https://github.com/CharlesCNorton/qbasic
-Project-URL: Issues, https://github.com/CharlesCNorton/qbasic/issues
+Project-URL: Homepage, https://github.com/CharlesCNorton/qubasic
+Project-URL: Repository, https://github.com/CharlesCNorton/qubasic
+Project-URL: Issues, https://github.com/CharlesCNorton/qubasic/issues
 Keywords: quantum,computing,qiskit,basic,repl,simulator
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Education
@@ -27,9 +27,11 @@ Requires-Dist: psutil>=5.9
 Requires-Dist: rich>=13.0
 Provides-Extra: charts
 Requires-Dist: plotille>=5.0; extra == "charts"
+Provides-Extra: readline
+Requires-Dist: pyreadline3>=3.4; sys_platform == "win32" and extra == "readline"
 Dynamic: license-file
 
-# QBASIC
+# QUBASIC
 
 Quantum computing in a BASIC REPL.
 
@@ -46,7 +48,7 @@ RAN 3 lines, 4 qubits, 1024 shots in 0.12s  [depth=2, gates=2]
  |11>     506   49.4%  █████████████████
 ```
 
-QBASIC is a quantum computing environment built on Qiskit Aer that uses BASIC syntax for circuit construction, execution, and analysis. It runs as an interactive REPL, as a script interpreter, or as a headless Python engine.
+QUBASIC is a quantum computing environment built on Qiskit Aer that uses BASIC syntax for circuit construction, execution, and analysis. It runs as an interactive REPL, as a script interpreter, or as a headless Python engine.
 
 **For agents**: minimal syntax, maximum context-window efficiency. `10 H 0 / 20 CX 0,1 / 30 MEASURE / RUN` replaces 8 lines of Qiskit Python. JSON output mode (`--json`) for pipeline integration. `Engine` class for direct API use without subprocess overhead.
 
@@ -56,6 +58,12 @@ QBASIC is a quantum computing environment built on Qiskit Aer that uses BASIC sy
 
 ## Install
 
+```
+pip install qubasic
+```
+
+Development install:
+
 ```
 pip install -e ".[charts]"
 ```
@@ -65,18 +73,18 @@ Requires Python >= 3.10, Qiskit >= 1.0, qiskit-aer >= 0.13.
 ## Usage
 
 ```
-python qbasic.py                  Interactive REPL
-python qbasic.py script.qb        Run a script file
-python qbasic.py --quiet script    Suppress banner, output results only
-python qbasic.py --json script     Machine-readable JSON output
-python qbasic.py --help            Show CLI help
+python qubasic.py                  Interactive REPL
+python qubasic.py script.qb        Run a script file
+python qubasic.py --quiet script    Suppress banner, output results only
+python qubasic.py --json script     Machine-readable JSON output
+python qubasic.py --help            Show CLI help
 ```
 
 Headless (no REPL):
 
 ```python
-from qbasic_core.engine_state import Engine
-from qbasic_core.terminal import QBasicTerminal
+from qubasic_core.engine_state import Engine
+from qubasic_core.terminal import QBasicTerminal
 
 t = QBasicTerminal()
 t.num_qubits = 2
@@ -683,7 +691,7 @@ Programs with SEND use prefix/suffix splitting: the deterministic prefix (before
 ## JSON output
 
 ```
-python qbasic.py --json examples/bell.qb
+python qubasic.py --json examples/bell.qb
 ```
 
 ```json
@@ -697,8 +705,8 @@ python qbasic.py --json examples/bell.qb
 ## Architecture
 
 ```
-qbasic.py               CLI entry point
-qbasic_core/
+qubasic.py              CLI entry point
+qubasic_core/
   engine_state.py        Engine: standalone state container
   terminal.py            QBasicTerminal: REPL + command dispatch
   engine.py              Constants, gate tables, numpy simulation, LOCCEngine

{qubasic-0.1.0 → qubasic-0.3.0}/README.md

@@ -1,4 +1,4 @@
-# QBASIC
+# QUBASIC
 
 Quantum computing in a BASIC REPL.
 
@@ -15,7 +15,7 @@ RAN 3 lines, 4 qubits, 1024 shots in 0.12s  [depth=2, gates=2]
  |11>     506   49.4%  █████████████████
 ```
 
-QBASIC is a quantum computing environment built on Qiskit Aer that uses BASIC syntax for circuit construction, execution, and analysis. It runs as an interactive REPL, as a script interpreter, or as a headless Python engine.
+QUBASIC is a quantum computing environment built on Qiskit Aer that uses BASIC syntax for circuit construction, execution, and analysis. It runs as an interactive REPL, as a script interpreter, or as a headless Python engine.
 
 **For agents**: minimal syntax, maximum context-window efficiency. `10 H 0 / 20 CX 0,1 / 30 MEASURE / RUN` replaces 8 lines of Qiskit Python. JSON output mode (`--json`) for pipeline integration. `Engine` class for direct API use without subprocess overhead.
 
@@ -25,6 +25,12 @@ QBASIC is a quantum computing environment built on Qiskit Aer that uses BASIC sy
 
 ## Install
 
+```
+pip install qubasic
+```
+
+Development install:
+
 ```
 pip install -e ".[charts]"
 ```
@@ -34,18 +40,18 @@ Requires Python >= 3.10, Qiskit >= 1.0, qiskit-aer >= 0.13.
 ## Usage
 
 ```
-python qbasic.py                  Interactive REPL
-python qbasic.py script.qb        Run a script file
-python qbasic.py --quiet script    Suppress banner, output results only
-python qbasic.py --json script     Machine-readable JSON output
-python qbasic.py --help            Show CLI help
+python qubasic.py                  Interactive REPL
+python qubasic.py script.qb        Run a script file
+python qubasic.py --quiet script    Suppress banner, output results only
+python qubasic.py --json script     Machine-readable JSON output
+python qubasic.py --help            Show CLI help
 ```
 
 Headless (no REPL):
 
 ```python
-from qbasic_core.engine_state import Engine
-from qbasic_core.terminal import QBasicTerminal
+from qubasic_core.engine_state import Engine
+from qubasic_core.terminal import QBasicTerminal
 
 t = QBasicTerminal()
 t.num_qubits = 2
@@ -652,7 +658,7 @@ Programs with SEND use prefix/suffix splitting: the deterministic prefix (before
 ## JSON output
 
 ```
-python qbasic.py --json examples/bell.qb
+python qubasic.py --json examples/bell.qb
 ```
 
 ```json
@@ -666,8 +672,8 @@ python qbasic.py --json examples/bell.qb
 ## Architecture
 
 ```
-qbasic.py               CLI entry point
-qbasic_core/
+qubasic.py              CLI entry point
+qubasic_core/
   engine_state.py        Engine: standalone state container
   terminal.py            QBasicTerminal: REPL + command dispatch
   engine.py              Constants, gate tables, numpy simulation, LOCCEngine

qubasic-0.3.0/examples/bell.qb

@@ -0,0 +1,6 @@
+# Bell State — the simplest entanglement
+# Two qubits, perfectly correlated: always 00 or always 11.
+QUBITS 2
+10 H 0
+20 CX 0,1
+30 MEASURE

qubasic-0.3.0/examples/grover3.qb

@@ -0,0 +1,27 @@
+# Grover's Search — find |101> among 8 states
+# Classically ~4 queries; quantum: 2 iterations, ~95% success.
+QUBITS 3
+SHOTS 1024
+10 REM Superposition
+20 H 0 : H 1 : H 2
+30 REM === Grover iteration 1 ===
+40 REM Oracle: flip phase of |101>
+50 X 1
+60 H 2 : CCX 0,1,2 : H 2
+70 X 1
+80 REM Diffusion
+90 H 0 : H 1 : H 2
+100 X 0 : X 1 : X 2
+110 H 2 : CCX 0,1,2 : H 2
+120 X 0 : X 1 : X 2
+130 H 0 : H 1 : H 2
+140 REM === Grover iteration 2 ===
+150 X 1
+160 H 2 : CCX 0,1,2 : H 2
+170 X 1
+180 H 0 : H 1 : H 2
+190 X 0 : X 1 : X 2
+200 H 2 : CCX 0,1,2 : H 2
+210 X 0 : X 1 : X 2
+220 H 0 : H 1 : H 2
+230 MEASURE

qubasic-0.3.0/examples/locc_teleport.qb

@@ -0,0 +1,19 @@
+# LOCC Teleportation — full protocol with classical correction
+# Alice teleports |+> to Bob using a pre-shared Bell pair.
+LOCC JOINT 3 3
+SHOTS 1024
+10 REM Prepare state to teleport: |+> on A[0]
+20 @A H 0
+30 REM Create shared entanglement: A[2] <-> B[0]
+40 SHARE A 2, B 0
+50 REM Alice entangles her data qubit with her half of the pair
+60 @A CX 0, 2
+70 @A H 0
+80 REM Alice measures and sends classical bits to Bob
+90 SEND A 0 -> m0
+100 SEND A 2 -> m1
+110 REM Bob applies corrections
+120 IF m1 THEN @B X 0
+130 IF m0 THEN @B Z 0
+140 REM Bob's qubit 0 now holds Alice's original |+> state
+150 MEASURE

qubasic-0.3.0/examples/sweep_rx.qb

@@ -0,0 +1,7 @@
+# Parameter Sweep — rotate a qubit from |0> to |1> and back
+# Shows how measurement probability changes with rotation angle.
+# Run with: LOAD examples/sweep_rx.qb then SWEEP angle 0 2*PI 12
+QUBITS 1
+SHOTS 512
+10 RX angle, 0
+20 MEASURE

{qubasic-0.1.0 → qubasic-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qubasic"
-version = "0.1.0"
+version = "0.3.0"
 description = "Quantum BASIC Interactive Terminal"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -33,22 +33,28 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/CharlesCNorton/qbasic"
-Repository = "https://github.com/CharlesCNorton/qbasic"
-Issues = "https://github.com/CharlesCNorton/qbasic/issues"
+Homepage = "https://github.com/CharlesCNorton/qubasic"
+Repository = "https://github.com/CharlesCNorton/qubasic"
+Issues = "https://github.com/CharlesCNorton/qubasic/issues"
 
 [project.optional-dependencies]
 charts = ["plotille>=5.0"]
+readline = ["pyreadline3>=3.4; sys_platform == 'win32'"]
 
 [project.scripts]
-qbasic = "qbasic:main"
+qubasic = "qubasic:main"
 
 [tool.setuptools]
-py-modules = ["qbasic"]
-packages = ["qbasic_core"]
+py-modules = ["qubasic"]
+packages = ["qubasic_core"]
+
+[tool.setuptools.package-data]
+
+[tool.setuptools.data-files]
+"share/qubasic/examples" = ["examples/*.qb"]
 
 [tool.coverage.run]
-source = ["qbasic_core"]
+source = ["qubasic_core"]
 omit = ["*/test_*"]
 
 [tool.coverage.report]

{qubasic-0.1.0 → qubasic-0.3.0}/qubasic.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: qubasic
-Version: 0.1.0
+Version: 0.3.0
 Summary: Quantum BASIC Interactive Terminal
 Author-email: "Charles C. Norton" <machineelv@gmail.com>
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/CharlesCNorton/qbasic
-Project-URL: Repository, https://github.com/CharlesCNorton/qbasic
-Project-URL: Issues, https://github.com/CharlesCNorton/qbasic/issues
+Project-URL: Homepage, https://github.com/CharlesCNorton/qubasic
+Project-URL: Repository, https://github.com/CharlesCNorton/qubasic
+Project-URL: Issues, https://github.com/CharlesCNorton/qubasic/issues
 Keywords: quantum,computing,qiskit,basic,repl,simulator
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Education
@@ -27,9 +27,11 @@ Requires-Dist: psutil>=5.9
 Requires-Dist: rich>=13.0
 Provides-Extra: charts
 Requires-Dist: plotille>=5.0; extra == "charts"
+Provides-Extra: readline
+Requires-Dist: pyreadline3>=3.4; sys_platform == "win32" and extra == "readline"
 Dynamic: license-file
 
-# QBASIC
+# QUBASIC
 
 Quantum computing in a BASIC REPL.
 
@@ -46,7 +48,7 @@ RAN 3 lines, 4 qubits, 1024 shots in 0.12s  [depth=2, gates=2]
  |11>     506   49.4%  █████████████████
 ```
 
-QBASIC is a quantum computing environment built on Qiskit Aer that uses BASIC syntax for circuit construction, execution, and analysis. It runs as an interactive REPL, as a script interpreter, or as a headless Python engine.
+QUBASIC is a quantum computing environment built on Qiskit Aer that uses BASIC syntax for circuit construction, execution, and analysis. It runs as an interactive REPL, as a script interpreter, or as a headless Python engine.
 
 **For agents**: minimal syntax, maximum context-window efficiency. `10 H 0 / 20 CX 0,1 / 30 MEASURE / RUN` replaces 8 lines of Qiskit Python. JSON output mode (`--json`) for pipeline integration. `Engine` class for direct API use without subprocess overhead.
 
@@ -56,6 +58,12 @@ QBASIC is a quantum computing environment built on Qiskit Aer that uses BASIC sy
 
 ## Install
 
+```
+pip install qubasic
+```
+
+Development install:
+
 ```
 pip install -e ".[charts]"
 ```
@@ -65,18 +73,18 @@ Requires Python >= 3.10, Qiskit >= 1.0, qiskit-aer >= 0.13.
 ## Usage
 
 ```
-python qbasic.py                  Interactive REPL
-python qbasic.py script.qb        Run a script file
-python qbasic.py --quiet script    Suppress banner, output results only
-python qbasic.py --json script     Machine-readable JSON output
-python qbasic.py --help            Show CLI help
+python qubasic.py                  Interactive REPL
+python qubasic.py script.qb        Run a script file
+python qubasic.py --quiet script    Suppress banner, output results only
+python qubasic.py --json script     Machine-readable JSON output
+python qubasic.py --help            Show CLI help
 ```
 
 Headless (no REPL):
 
 ```python
-from qbasic_core.engine_state import Engine
-from qbasic_core.terminal import QBasicTerminal
+from qubasic_core.engine_state import Engine
+from qubasic_core.terminal import QBasicTerminal
 
 t = QBasicTerminal()
 t.num_qubits = 2
@@ -683,7 +691,7 @@ Programs with SEND use prefix/suffix splitting: the deterministic prefix (before
 ## JSON output
 
 ```
-python qbasic.py --json examples/bell.qb
+python qubasic.py --json examples/bell.qb
 ```
 
 ```json
@@ -697,8 +705,8 @@ python qbasic.py --json examples/bell.qb
 ## Architecture
 
 ```
-qbasic.py               CLI entry point
-qbasic_core/
+qubasic.py              CLI entry point
+qubasic_core/
   engine_state.py        Engine: standalone state container
   terminal.py            QBasicTerminal: REPL + command dispatch
   engine.py              Constants, gate tables, numpy simulation, LOCCEngine

qubasic-0.3.0/qubasic.egg-info/SOURCES.txt

@@ -0,0 +1,56 @@
+CHANGELOG.md
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+qubasic.py
+examples/bell.qb
+examples/grover3.qb
+examples/locc_teleport.qb
+examples/sweep_rx.qb
+qubasic.egg-info/PKG-INFO
+qubasic.egg-info/SOURCES.txt
+qubasic.egg-info/dependency_links.txt
+qubasic.egg-info/entry_points.txt
+qubasic.egg-info/requires.txt
+qubasic.egg-info/top_level.txt
+qubasic_core/__init__.py
+qubasic_core/__main__.py
+qubasic_core/analysis.py
+qubasic_core/backend.py
+qubasic_core/classic.py
+qubasic_core/control_flow.py
+qubasic_core/debug.py
+qubasic_core/demos.py
+qubasic_core/display.py
+qubasic_core/engine.py
+qubasic_core/engine_state.py
+qubasic_core/errors.py
+qubasic_core/exec_context.py
+qubasic_core/executor.py
+qubasic_core/expression.py
+qubasic_core/file_io.py
+qubasic_core/gates.py
+qubasic_core/help_text.py
+qubasic_core/io_protocol.py
+qubasic_core/locc.py
+qubasic_core/locc_commands.py
+qubasic_core/locc_display.py
+qubasic_core/locc_engine.py
+qubasic_core/locc_execution.py
+qubasic_core/memory.py
+qubasic_core/mock_backend.py
+qubasic_core/noise_mixin.py
+qubasic_core/parser.py
+qubasic_core/patterns.py
+qubasic_core/profiler.py
+qubasic_core/program_mgmt.py
+qubasic_core/protocol.py
+qubasic_core/scope.py
+qubasic_core/screen.py
+qubasic_core/state_display.py
+qubasic_core/statements.py
+qubasic_core/strings.py
+qubasic_core/subs.py
+qubasic_core/sweep.py
+qubasic_core/terminal.py

qubasic-0.3.0/qubasic.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+qubasic = qubasic:main

{qubasic-0.1.0 → qubasic-0.3.0}/qubasic.egg-info/requires.txt

@@ -6,3 +6,8 @@ rich>=13.0
 
 [charts]
 plotille>=5.0
+
+[readline]
+
+[readline:sys_platform == "win32"]
+pyreadline3>=3.4

qubasic-0.3.0/qubasic.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+qubasic
+qubasic_core

qubasic-0.1.0/qbasic.py → qubasic-0.3.0/qubasic.py

@@ -1,10 +1,10 @@
 #!/usr/bin/env python3
 """
-QBASIC — Quantum BASIC Interactive Terminal
+QUBASIC — Quantum BASIC Interactive Terminal
 
 Usage:
-    python qbasic.py              Interactive REPL
-    python qbasic.py script.qb    Run a script file
+    python qubasic.py             Interactive REPL
+    python qubasic.py script.qb   Run a script file
 """
 
 import sys
@@ -22,8 +22,8 @@ if sys.stderr and hasattr(sys.stderr, 'reconfigure'):
     except Exception:
         pass
 
-from qbasic_core.terminal import QBasicTerminal
-from qbasic_core.program_mgmt import ProgramMgmtMixin
+from qubasic_core.terminal import QBasicTerminal
+from qubasic_core.program_mgmt import ProgramMgmtMixin
 
 
 def run_script(path: str, terminal: 'QBasicTerminal') -> None:
@@ -59,15 +59,15 @@ def main():
         args = [a for a in args if a != '--json']
 
     if any(a in ('-h', '--help') for a in args):
-        from qbasic_core import __version__
-        print(f"QBASIC {__version__} — Quantum BASIC Interactive Terminal")
+        from qubasic_core import __version__
+        print(f"QUBASIC {__version__} — Quantum BASIC Interactive Terminal")
         print()
         print("Usage:")
-        print("  qbasic                  Interactive REPL")
-        print("  qbasic script.qb        Run a script file")
-        print("  qbasic --quiet script    Suppress banner and progress")
-        print("  qbasic --json script     Output results as JSON")
-        print("  qbasic --help            Show this help")
+        print("  qubasic                  Interactive REPL")
+        print("  qubasic script.qb        Run a script file")
+        print("  qubasic --quiet script    Suppress banner and progress")
+        print("  qubasic --json script     Output results as JSON")
+        print("  qubasic --help            Show this help")
         print()
         print("Type HELP inside the REPL for full command reference.")
         sys.exit(0)

qubasic-0.3.0/qubasic_core/__init__.py

@@ -0,0 +1,80 @@
+"""QUBASIC — Quantum BASIC Interactive Terminal (package)."""
+
+# Lightweight imports that don't pull in Qiskit/numpy
+from qubasic_core.statements import Stmt, GateStmt, RawStmt
+from qubasic_core.errors import (
+    QBasicError, QBasicSyntaxError, QBasicRuntimeError,
+    QBasicBuildError, QBasicRangeError, QBasicIOError, QBasicUndefinedError,
+)
+from qubasic_core.io_protocol import IOPort, StdIOPort
+from qubasic_core.exec_context import ExecContext
+
+__all__ = [
+    'QBasicTerminal', 'LOCCEngine', 'ExecResult', 'ExecOutcome',
+    'ExpressionMixin', 'DisplayMixin', 'DemoMixin', 'ControlFlowMixin',
+    'LOCCMixin', 'LOCCCommandsMixin', 'LOCCDisplayMixin', 'LOCCExecutionMixin',
+    'NoiseMixin', 'StateDisplayMixin', 'HELP_TEXT', 'BANNER_ART',
+    'FileIOMixin', 'AnalysisMixin', 'SweepMixin',
+    'MemoryMixin', 'StringMixin', 'ScreenMixin', 'ClassicMixin',
+    'SubroutineMixin', 'DebugMixin', 'ProgramMgmtMixin', 'ProfilerMixin',
+    'TerminalProtocol',
+    'Engine', 'ExecutorMixin',
+    'QBasicError', 'QBasicSyntaxError', 'QBasicRuntimeError',
+    'QBasicBuildError', 'QBasicRangeError', 'QBasicIOError', 'QBasicUndefinedError',
+    'IOPort', 'StdIOPort',
+    'Stmt', 'GateStmt', 'RawStmt', 'parse_stmt',
+    'ExecContext', 'Scope',
+    'QuantumBackend', 'QiskitBackend', 'LOCCRegBackend',
+    'GATE_TABLE', 'GATE_ALIASES',
+]
+
+__version__ = '0.3.0'
+
+def __getattr__(name):
+    """Lazy import heavy modules on first access."""
+    _lazy_imports = {
+        'GATE_TABLE': 'qubasic_core.engine',
+        'GATE_ALIASES': 'qubasic_core.engine',
+        'LOCCEngine': 'qubasic_core.engine',
+        'ExecResult': 'qubasic_core.engine',
+        'ExecOutcome': 'qubasic_core.engine',
+        'QBasicTerminal': 'qubasic_core.terminal',
+        'Engine': 'qubasic_core.engine_state',
+        'ExecutorMixin': 'qubasic_core.executor',
+        'ExpressionMixin': 'qubasic_core.expression',
+        'DisplayMixin': 'qubasic_core.display',
+        'LOCCMixin': 'qubasic_core.locc',
+        'LOCCCommandsMixin': 'qubasic_core.locc_commands',
+        'LOCCDisplayMixin': 'qubasic_core.locc_display',
+        'LOCCExecutionMixin': 'qubasic_core.locc_execution',
+        'ControlFlowMixin': 'qubasic_core.control_flow',
+        'DemoMixin': 'qubasic_core.demos',
+        'FileIOMixin': 'qubasic_core.file_io',
+        'AnalysisMixin': 'qubasic_core.analysis',
+        'SweepMixin': 'qubasic_core.sweep',
+        'MemoryMixin': 'qubasic_core.memory',
+        'StringMixin': 'qubasic_core.strings',
+        'ScreenMixin': 'qubasic_core.screen',
+        'ClassicMixin': 'qubasic_core.classic',
+        'SubroutineMixin': 'qubasic_core.subs',
+        'DebugMixin': 'qubasic_core.debug',
+        'ProgramMgmtMixin': 'qubasic_core.program_mgmt',
+        'ProfilerMixin': 'qubasic_core.profiler',
+        'NoiseMixin': 'qubasic_core.noise_mixin',
+        'StateDisplayMixin': 'qubasic_core.state_display',
+        'TerminalProtocol': 'qubasic_core.protocol',
+        'HELP_TEXT': 'qubasic_core.help_text',
+        'BANNER_ART': 'qubasic_core.help_text',
+        'QuantumBackend': 'qubasic_core.backend',
+        'QiskitBackend': 'qubasic_core.backend',
+        'LOCCRegBackend': 'qubasic_core.backend',
+        'Scope': 'qubasic_core.scope',
+        'parse_stmt': 'qubasic_core.parser',
+    }
+    if name in _lazy_imports:
+        import importlib
+        module = importlib.import_module(_lazy_imports[name])
+        val = getattr(module, name)
+        globals()[name] = val  # cache for next access
+        return val
+    raise AttributeError(f"module 'qubasic_core' has no attribute {name}")

qubasic-0.3.0/qubasic_core/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running qubasic_core as a module: python -m qubasic_core."""
+
+from qubasic_core.terminal import QBasicTerminal
+
+if __name__ == '__main__':
+    QBasicTerminal().repl()

{qubasic-0.1.0/qbasic_core → qubasic-0.3.0/qubasic_core}/analysis.py

@@ -1,4 +1,4 @@
-"""QBASIC analysis mixin — EXPECT, ENTROPY, DENSITY, BENCH, RAM."""
+"""QUBASIC analysis mixin — EXPECT, ENTROPY, DENSITY, BENCH, RAM."""
 
 from __future__ import annotations
 
@@ -8,7 +8,7 @@ from qiskit import QuantumCircuit, transpile
 from qiskit_aer import AerSimulator
 import numpy as np
 
-from qbasic_core.engine import (
+from qubasic_core.engine import (
     _estimate_gb, _get_ram_gb,
     OVERHEAD_FACTOR, RAM_BUDGET_FRACTION,
 )
@@ -107,8 +107,12 @@ class AnalysisMixin:
         self.io.writeln(f"\n  Purity: {np.real(np.trace(rho @ rho)):.6f}")
         self.io.writeln('')
 
-    def cmd_bench(self) -> None:
-        """BENCH — benchmark simulation at various qubit counts."""
+    def cmd_bench(self, rest: str = '') -> None:
+        """BENCH [n1 n2 ...] — benchmark simulation at various qubit counts."""
+        if rest.strip():
+            qubit_counts = [int(x) for x in rest.replace(',', ' ').split() if x.strip()]
+        else:
+            qubit_counts = [4, 8, 12, 16, 20, 24, 28]
         self.io.writeln("\n  Benchmark (H + CX chain + measure):")
         try:
             import psutil
@@ -117,7 +121,7 @@ class AnalysisMixin:
             has_psutil = False
         header_mem = '  mem_gb' if has_psutil else ''
         self.io.writeln(f"  {'qubits':>8}  {'method':>20}  {'time':>8}{header_mem}")
-        for n in [4, 8, 12, 16, 20, 24, 28]:
+        for n in qubit_counts:
             qc = QuantumCircuit(n)
             for i in range(n):
                 qc.h(i)

{qubasic-0.1.0/qbasic_core → qubasic-0.3.0/qubasic_core}/backend.py

@@ -1,4 +1,4 @@
-"""QBASIC backend abstraction — Qiskit and numpy behind a common interface."""
+"""QUBASIC backend abstraction — Qiskit and numpy behind a common interface."""
 
 from __future__ import annotations