myqclab 0.1.0__tar.gz

myqclab-0.1.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: myqclab
+Version: 0.1.0
+Summary: Quantum Computing Lab programs in Python and Qiskit
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: qiskit>=1.0.0
+Requires-Dist: qiskit-aer>=0.14.0
+Dynamic: requires-python
+
+# Quantum Computing Lab Programs & `myqclab` Package
+
+Compact, verified Python and Qiskit implementations of 9 core quantum algorithms for lab exams.
+
+Available both as standalone scripts/notebooks and as an installable Python package **`myqclab`**.
+
+---
+
+## 📦 Package Installation
+
+Install directly in your environment:
+```bash
+pip install .
+```
+Or in editable/development mode:
+```bash
+pip install -e .
+```
+
+---
+
+## 🚀 Package Usage
+
+### 1. In Python / Jupyter Notebook
+```python
+import myqclab
+
+# Show the code of any algorithm in the terminal (quotes optional!)
+myqclab.show(grover)
+myqclab.show("grover")
+
+# Run the algorithm and print the circuit and simulation output
+myqclab.run(grover)
+
+# List all available programs
+myqclab.list()
+```
+
+### 2. From Terminal CLI
+```bash
+# Print code of a program
+myqclab grover
+myqclab show grover
+
+# Execute program directly
+myqclab run grover
+
+# List all programs
+myqclab list
+```
+
+---
+
+## 📚 Available Quantum Programs
+
+| Program Name | Loop Variation | Algorithm | Manually Configurable Input |
+|---|---|---|---|
+| `qe` | `qeloop` | Quantum Entanglement | `state = '00'` (`'00'`, `'01'`, `'10'`, `'11'`) |
+| `tele` | `teleloop` | Quantum Teleportation | `state = '1'` (`'0'` or `'1'`) |
+| `super` | `superloop` | Superdense Coding | `msg = '01'` (`'00'`, `'01'`, `'10'`, `'11'`) |
+| `de` | `deloop` | Deutsch's Algorithm | `oracle_type = 'balanced_id'` (`'constant_0'`, etc.) |
+| `dj` | `djloop` | Deutsch-Jozsa Algorithm | `oracle_type = 'balanced'`, `n = 3` |
+| `simon` | `simonloop` | Simon's Algorithm | `s = '11'` |
+| `bv` | `bvloop` | Bernstein-Vazirani | `s = '1011'` |
+| `grover` | `groverloop` | Grover's Search | `target = '10'` (`'00'`, `'01'`, `'10'`, `'11'`) |
+| `shor` | `shorloop` | Shor's Algorithm | `N = 15, a = 7` |
+
+---
+
+## Standalone Running
+
+Run any script with Python:
+```bash
+python qe.py
+```
+Or open any `.ipynb` file in Jupyter Notebook / JupyterLab / Google Colab.

myqclab-0.1.0/README.md

@@ -0,0 +1,76 @@
+# Quantum Computing Lab Programs & `myqclab` Package
+
+Compact, verified Python and Qiskit implementations of 9 core quantum algorithms for lab exams.
+
+Available both as standalone scripts/notebooks and as an installable Python package **`myqclab`**.
+
+---
+
+## 📦 Package Installation
+
+Install directly in your environment:
+```bash
+pip install .
+```
+Or in editable/development mode:
+```bash
+pip install -e .
+```
+
+---
+
+## 🚀 Package Usage
+
+### 1. In Python / Jupyter Notebook
+```python
+import myqclab
+
+# Show the code of any algorithm in the terminal (quotes optional!)
+myqclab.show(grover)
+myqclab.show("grover")
+
+# Run the algorithm and print the circuit and simulation output
+myqclab.run(grover)
+
+# List all available programs
+myqclab.list()
+```
+
+### 2. From Terminal CLI
+```bash
+# Print code of a program
+myqclab grover
+myqclab show grover
+
+# Execute program directly
+myqclab run grover
+
+# List all programs
+myqclab list
+```
+
+---
+
+## 📚 Available Quantum Programs
+
+| Program Name | Loop Variation | Algorithm | Manually Configurable Input |
+|---|---|---|---|
+| `qe` | `qeloop` | Quantum Entanglement | `state = '00'` (`'00'`, `'01'`, `'10'`, `'11'`) |
+| `tele` | `teleloop` | Quantum Teleportation | `state = '1'` (`'0'` or `'1'`) |
+| `super` | `superloop` | Superdense Coding | `msg = '01'` (`'00'`, `'01'`, `'10'`, `'11'`) |
+| `de` | `deloop` | Deutsch's Algorithm | `oracle_type = 'balanced_id'` (`'constant_0'`, etc.) |
+| `dj` | `djloop` | Deutsch-Jozsa Algorithm | `oracle_type = 'balanced'`, `n = 3` |
+| `simon` | `simonloop` | Simon's Algorithm | `s = '11'` |
+| `bv` | `bvloop` | Bernstein-Vazirani | `s = '1011'` |
+| `grover` | `groverloop` | Grover's Search | `target = '10'` (`'00'`, `'01'`, `'10'`, `'11'`) |
+| `shor` | `shorloop` | Shor's Algorithm | `N = 15, a = 7` |
+
+---
+
+## Standalone Running
+
+Run any script with Python:
+```bash
+python qe.py
+```
+Or open any `.ipynb` file in Jupyter Notebook / JupyterLab / Google Colab.

myqclab-0.1.0/myqclab/__init__.py

@@ -0,0 +1,81 @@
+import builtins
+import sys
+from .codes import PROGRAMS, DESCRIPTIONS, ALIASES, resolve_name
+
+__all__ = [
+    'show',
+    'get',
+    'run',
+    'list',
+    'list_programs',
+    'qe', 'qeloop',
+    'tele', 'teleloop',
+    'super', 'superloop',
+    'de', 'deloop',
+    'dj', 'djloop',
+    'simon', 'simonloop',
+    'bv', 'bvloop',
+    'grover', 'groverloop',
+    'shor', 'shorloop',
+]
+
+qe = 'qe'
+qeloop = 'qeloop'
+tele = 'tele'
+teleloop = 'teleloop'
+super = 'super'
+superloop = 'superloop'
+de = 'de'
+deloop = 'deloop'
+dj = 'dj'
+djloop = 'djloop'
+simon = 'simon'
+simonloop = 'simonloop'
+bv = 'bv'
+bvloop = 'bvloop'
+grover = 'grover'
+groverloop = 'groverloop'
+shor = 'shor'
+shorloop = 'shorloop'
+
+for _prog in list(PROGRAMS.keys()):
+    if not hasattr(builtins, _prog):
+        setattr(builtins, _prog, _prog)
+
+
+def show(name):
+    key = resolve_name(name)
+    if key in PROGRAMS:
+        print(PROGRAMS[key].rstrip())
+    else:
+        print(f"Unknown program: {name}")
+        print(f"Available programs: {', '.join(sorted(PROGRAMS.keys()))}")
+
+
+def get(name):
+    key = resolve_name(name)
+    return PROGRAMS.get(key)
+
+
+def run(name):
+    key = resolve_name(name)
+    if key in PROGRAMS:
+        ns = {'__name__': '__main__'}
+        exec(PROGRAMS[key], ns)
+    else:
+        print(f"Unknown program: {name}")
+        print(f"Available programs: {', '.join(sorted(PROGRAMS.keys()))}")
+
+
+def list_programs():
+    print("Available Quantum Programs in myqclab:\n")
+    max_len = max(len(k) for k in PROGRAMS.keys())
+    for k in sorted(PROGRAMS.keys()):
+        desc = DESCRIPTIONS.get(k, '')
+        print(f"  {k.ljust(max_len + 2)} - {desc}")
+    print("\nUsage:")
+    print("  myqclab.show('grover')   # or myqclab.show(grover)")
+    print("  myqclab.run('grover')    # or myqclab.run(grover)")
+
+
+list = list_programs

myqclab-0.1.0/myqclab/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == '__main__':
+    main()

myqclab-0.1.0/myqclab/cli.py

@@ -0,0 +1,46 @@
+import sys
+from . import show, run, list_programs, resolve_name
+from .codes import PROGRAMS
+
+
+def main():
+    args = sys.argv[1:]
+    if not args or args[0] in ('-h', '--help'):
+        print("Usage:")
+        print("  myqclab <program_name>       # Print program code")
+        print("  myqclab show <program_name>  # Print program code")
+        print("  myqclab run <program_name>   # Execute program")
+        print("  myqclab list                 # List all available programs")
+        sys.exit(0)
+
+    cmd = args[0].lower()
+    if cmd == 'list':
+        list_programs()
+        return
+
+    if cmd == 'show':
+        if len(args) < 2:
+            print("Error: Specify a program name to show (e.g., 'myqclab show grover')")
+            sys.exit(1)
+        show(args[1])
+        return
+
+    if cmd == 'run':
+        if len(args) < 2:
+            print("Error: Specify a program name to run (e.g., 'myqclab run grover')")
+            sys.exit(1)
+        run(args[1])
+        return
+
+    # If first argument is a program name directly (e.g., `myqclab grover`)
+    resolved = resolve_name(cmd)
+    if resolved in PROGRAMS:
+        show(resolved)
+    else:
+        print(f"Unknown command or program: {args[0]}")
+        list_programs()
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()

myqclab-0.1.0/myqclab/codes.py

@@ -0,0 +1,55 @@
+# Auto-generated quantum program dictionary
+
+PROGRAMS = {'qe': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\nstate = '00'\n\nqc = QuantumCircuit(2, 2)\nif state[0] == '1':\n    qc.x(0)\nif state[1] == '1':\n    qc.x(1)\nqc.h(0)\nqc.cx(0, 1)\nqc.measure([0, 1], [0, 1])\n\ncounts = sim.run(transpile(qc, sim)).result().get_counts()\nprint(f'Input state: {state}')\nprint(qc.draw('text'))\nprint('Counts:', counts)\n", 'qeloop': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\nstates = {'00': 'Phi+', '10': 'Phi-', '01': 'Psi+', '11': 'Psi-'}\n\nfor state, name in states.items():\n    qc = QuantumCircuit(2, 2)\n    if state[0] == '1':\n        qc.x(0)\n    if state[1] == '1':\n        qc.x(1)\n    qc.h(0)\n    qc.cx(0, 1)\n    qc.measure([0, 1], [0, 1])\n    counts = sim.run(transpile(qc, sim)).result().get_counts()\n    print(f'=== {name} (input={state}) ===')\n    print(qc.draw('text'))\n    print('Counts:', counts)\n    print()\n", 'tele': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\nstate = '1'\n\nqc = QuantumCircuit(3, 3)\nif state == '1':\n    qc.x(0)\nqc.barrier()\n\nqc.h(1)\nqc.cx(1, 2)\nqc.barrier()\n\nqc.cx(0, 1)\nqc.h(0)\nqc.barrier()\n\nqc.measure(0, 0)\nqc.measure(1, 1)\nqc.barrier()\n\nqc.cx(1, 2)\nqc.cz(0, 2)\nqc.measure(2, 2)\n\ncounts = sim.run(transpile(qc, sim)).result().get_counts()\nprint(f'Teleporting state |{state}>')\nprint(qc.draw('text'))\nprint('Counts (c2 c1 c0, c2 is Bob):', counts)\n", 'teleloop': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\nfor state in ['0', '1']:\n    qc = QuantumCircuit(3, 3)\n    if state == '1':\n        qc.x(0)\n    qc.barrier()\n    qc.h(1)\n    qc.cx(1, 2)\n    qc.barrier()\n    qc.cx(0, 1)\n    qc.h(0)\n    qc.barrier()\n    qc.measure(0, 0)\n    qc.measure(1, 1)\n    qc.barrier()\n    qc.cx(1, 2)\n    qc.cz(0, 2)\n    qc.measure(2, 2)\n\n    counts = sim.run(transpile(qc, sim)).result().get_counts()\n    print(f'=== Teleporting |{state}> ===')\n    print(qc.draw('text'))\n    print('Counts (c2 c1 c0, c2 is Bob):', counts)\n    print()\n", 'super': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\nmsg = '01'\n\nqc = QuantumCircuit(2, 2)\nqc.h(0)\nqc.cx(0, 1)\nqc.barrier()\n\nif msg[0] == '1':\n    qc.x(0)\nif msg[1] == '1':\n    qc.z(0)\nqc.barrier()\n\nqc.cx(0, 1)\nqc.h(0)\nqc.barrier()\nqc.measure([0, 1], [0, 1])\n\ncounts = sim.run(transpile(qc, sim)).result().get_counts()\nreceived = list(counts.keys())[0]\nprint(f'Sent: {msg} -> Received: {received}')\nprint(qc.draw('text'))\n", 'superloop': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\nfor msg in ['00', '01', '10', '11']:\n    qc = QuantumCircuit(2, 2)\n    qc.h(0)\n    qc.cx(0, 1)\n    qc.barrier()\n    if msg[0] == '1':\n        qc.x(0)\n    if msg[1] == '1':\n        qc.z(0)\n    qc.barrier()\n    qc.cx(0, 1)\n    qc.h(0)\n    qc.barrier()\n    qc.measure([0, 1], [0, 1])\n    counts = sim.run(transpile(qc, sim)).result().get_counts()\n    received = list(counts.keys())[0]\n    print(f'Sent: {msg} -> Received: {received}')\n\nprint()\nprint(qc.draw('text'))\n", 'de': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\noracle_type = 'balanced_id'\n\nqc = QuantumCircuit(2, 1)\nqc.x(1)\nqc.h([0, 1])\nqc.barrier()\n\nif oracle_type == 'constant_0':\n    pass\nelif oracle_type == 'constant_1':\n    qc.x(1)\nelif oracle_type == 'balanced_id':\n    qc.cx(0, 1)\nelif oracle_type == 'balanced_not':\n    qc.cx(0, 1)\n    qc.x(1)\n\nqc.barrier()\nqc.h(0)\nqc.measure(0, 0)\n\ncounts = sim.run(transpile(qc, sim)).result().get_counts()\nres = list(counts.keys())[0]\nkind = 'Constant' if res == '0' else 'Balanced'\nprint(f'Oracle: {oracle_type} -> Measured {res} (Function is {kind})')\nprint(qc.draw('text'))\n", 'deloop': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\noracles = ['constant_0', 'constant_1', 'balanced_id', 'balanced_not']\n\nfor oracle_type in oracles:\n    qc = QuantumCircuit(2, 1)\n    qc.x(1)\n    qc.h([0, 1])\n    qc.barrier()\n    if oracle_type == 'constant_0':\n        pass\n    elif oracle_type == 'constant_1':\n        qc.x(1)\n    elif oracle_type == 'balanced_id':\n        qc.cx(0, 1)\n    elif oracle_type == 'balanced_not':\n        qc.cx(0, 1)\n        qc.x(1)\n    qc.barrier()\n    qc.h(0)\n    qc.measure(0, 0)\n\n    counts = sim.run(transpile(qc, sim)).result().get_counts()\n    res = list(counts.keys())[0]\n    kind = 'Constant' if res == '0' else 'Balanced'\n    print(f'=== {oracle_type} ===')\n    print(f'Measured {res} -> Function is {kind}')\n    print(qc.draw('text'))\n    print()\n", 'dj': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\nn = 3\noracle_type = 'balanced'\n\nqc = QuantumCircuit(n + 1, n)\nqc.x(n)\nqc.h(range(n + 1))\nqc.barrier()\n\nif oracle_type == 'constant':\n    qc.x(n)\nelif oracle_type == 'balanced':\n    for i in range(n):\n        qc.cx(i, n)\n\nqc.barrier()\nqc.h(range(n))\nqc.measure(range(n), range(n))\n\ncounts = sim.run(transpile(qc, sim)).result().get_counts()\nres = list(counts.keys())[0]\nkind = 'Constant' if res == '0' * n else 'Balanced'\nprint(f'{oracle_type.capitalize()} Oracle (n={n}): measured {res} -> Function is {kind}')\nprint(qc.draw('text'))\n", 'djloop': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\nn = 3\nfor oracle_type in ['constant', 'balanced']:\n    qc = QuantumCircuit(n + 1, n)\n    qc.x(n)\n    qc.h(range(n + 1))\n    qc.barrier()\n    if oracle_type == 'constant':\n        qc.x(n)\n    elif oracle_type == 'balanced':\n        for i in range(n):\n            qc.cx(i, n)\n    qc.barrier()\n    qc.h(range(n))\n    qc.measure(range(n), range(n))\n\n    counts = sim.run(transpile(qc, sim)).result().get_counts()\n    res = list(counts.keys())[0]\n    kind = 'Constant' if res == '0' * n else 'Balanced'\n    print(f'=== {oracle_type.capitalize()} Oracle ===')\n    print(f'Measured {res} -> Function is {kind}')\n    print(qc.draw('text'))\n    print()\n", 'simon': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\ns = '11'\nn = len(s)\n\nqc = QuantumCircuit(2 * n, n)\nqc.h(range(n))\nqc.barrier()\n\nk = s.find('1')\nfor i in range(n):\n    if i != k:\n        qc.cx(i, n + i)\n        if s[i] == '1':\n            qc.cx(k, n + i)\n\nqc.barrier()\nqc.h(range(n))\nqc.measure(range(n), range(n))\n\ncounts = sim.run(transpile(qc, sim)).result().get_counts()\nprint(f'Secret string s: {s}')\nprint(qc.draw('text'))\nprint('Measurement counts:', counts)\n\nfor y in counts:\n    dot = sum(int(y[n - 1 - i]) * int(s[i]) for i in range(n)) % 2\n    print(f'Measured y={y}: y . s mod 2 = {dot}')\n", 'simonloop': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\nsecrets = ['11', '10', '01']\nfor s in secrets:\n    n = len(s)\n    qc = QuantumCircuit(2 * n, n)\n    qc.h(range(n))\n    qc.barrier()\n    k = s.find('1')\n    for i in range(n):\n        if i != k:\n            qc.cx(i, n + i)\n            if s[i] == '1':\n                qc.cx(k, n + i)\n    qc.barrier()\n    qc.h(range(n))\n    qc.measure(range(n), range(n))\n\n    counts = sim.run(transpile(qc, sim)).result().get_counts()\n    print(f'=== Secret s = {s} ===')\n    print('Measurement counts:', counts)\n    for y in counts:\n        dot = sum(int(y[n - 1 - i]) * int(s[i]) for i in range(n)) % 2\n        print(f'y={y}: y . s mod 2 = {dot}')\n    print()\n", 'bv': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\ns = '1011'\nn = len(s)\n\nqc = QuantumCircuit(n + 1, n)\nqc.x(n)\nqc.h(range(n + 1))\nqc.barrier()\n\nfor i, bit in enumerate(reversed(s)):\n    if bit == '1':\n        qc.cx(i, n)\n\nqc.barrier()\nqc.h(range(n))\nqc.measure(range(n), range(n))\n\ncounts = sim.run(transpile(qc, sim)).result().get_counts()\nresult = list(counts.keys())[0]\n\nprint(f'Secret string: {s}')\nprint(f'Found string:  {result}')\nprint(qc.draw('text'))\nprint('Measurement counts:', counts)\n", 'bvloop': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\nsecrets = ['01', '10', '110', '1011']\nfor s in secrets:\n    n = len(s)\n    qc = QuantumCircuit(n + 1, n)\n    qc.x(n)\n    qc.h(range(n + 1))\n    qc.barrier()\n    for i, bit in enumerate(reversed(s)):\n        if bit == '1':\n            qc.cx(i, n)\n    qc.barrier()\n    qc.h(range(n))\n    qc.measure(range(n), range(n))\n\n    counts = sim.run(transpile(qc, sim)).result().get_counts()\n    result = list(counts.keys())[0]\n    print(f'Secret: {s} -> Found: {result} (Match: {s == result})')\n", 'grover': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\ntarget = '10'\n\nqc = QuantumCircuit(2, 2)\nqc.h([0, 1])\nqc.barrier()\n\nif target[1] == '0':\n    qc.x(0)\nif target[0] == '0':\n    qc.x(1)\nqc.cz(0, 1)\nif target[1] == '0':\n    qc.x(0)\nif target[0] == '0':\n    qc.x(1)\nqc.barrier()\n\nqc.h([0, 1])\nqc.x([0, 1])\nqc.cz(0, 1)\nqc.x([0, 1])\nqc.h([0, 1])\nqc.barrier()\n\nqc.measure([0, 1], [0, 1])\n\ncounts = sim.run(transpile(qc, sim)).result().get_counts()\nprint(f'Target state: {target}')\nprint(qc.draw('text'))\nprint('Measurement counts:', counts)\n", 'groverloop': "from qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\ntargets = ['00', '01', '10', '11']\nfor target in targets:\n    qc = QuantumCircuit(2, 2)\n    qc.h([0, 1])\n    qc.barrier()\n    if target[1] == '0':\n        qc.x(0)\n    if target[0] == '0':\n        qc.x(1)\n    qc.cz(0, 1)\n    if target[1] == '0':\n        qc.x(0)\n    if target[0] == '0':\n        qc.x(1)\n    qc.barrier()\n    qc.h([0, 1])\n    qc.x([0, 1])\n    qc.cz(0, 1)\n    qc.x([0, 1])\n    qc.h([0, 1])\n    qc.barrier()\n    qc.measure([0, 1], [0, 1])\n\n    counts = sim.run(transpile(qc, sim)).result().get_counts()\n    found = list(counts.keys())[0]\n    print(f'Target: {target} -> Found: {found}')\n", 'shor': "import math\nfrom fractions import Fraction\nfrom qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\ndef c_amod15(a, power):\n    U = QuantumCircuit(4)\n    for _ in range(power):\n        if a in [2, 13]:\n            U.swap(2, 3); U.swap(1, 2); U.swap(0, 1)\n        if a in [7, 8]:\n            U.swap(0, 1); U.swap(1, 2); U.swap(2, 3)\n        if a in [4, 11]:\n            U.swap(1, 3); U.swap(0, 2)\n        if a in [7, 11, 13]:\n            for q in range(4): U.x(q)\n    U = U.to_gate()\n    U.name = f'{a}^{power} mod 15'\n    return U.control()\n\ndef qft_dagger(n):\n    qc = QuantumCircuit(n)\n    for qubit in range(n // 2):\n        qc.swap(qubit, n - qubit - 1)\n    for j in range(n):\n        for m in range(j):\n            qc.cp(-math.pi / float(2 ** (j - m)), m, j)\n        qc.h(j)\n    qc.name = 'QFT†'\n    return qc\n\na = 7\nN = 15\nn_count = 3\n\nqc = QuantumCircuit(n_count + 4, n_count)\nfor q in range(n_count):\n    qc.h(q)\nqc.x(n_count)\nqc.barrier()\n\nfor q in range(n_count):\n    qc.append(c_amod15(a, 2**q), [q] + [n_count + i for i in range(4)])\nqc.barrier()\n\nqc.append(qft_dagger(n_count), range(n_count))\nqc.barrier()\nqc.measure(range(n_count), range(n_count))\n\ncounts = sim.run(transpile(qc, sim)).result().get_counts()\nprint(f'Shor Algorithm: N = {N}, a = {a}')\nprint(qc.draw('text'))\nprint('Measurement counts:', counts)\n\nfactors_found = set()\nfor output in counts:\n    decimal = int(output, 2)\n    phase = decimal / (2 ** n_count)\n    frac = Fraction(phase).limit_denominator(N)\n    r = frac.denominator\n    if r % 2 == 0:\n        g1 = math.gcd(a ** (r // 2) - 1, N)\n        g2 = math.gcd(a ** (r // 2) + 1, N)\n        for g in [g1, g2]:\n            if 1 < g < N:\n                factors_found.add(g)\n\nprint(f'Identified prime factors of {N}: {sorted(factors_found)}')\n", 'shorloop': "import math\nfrom fractions import Fraction\nfrom qiskit import QuantumCircuit, transpile\ntry:\n    from qiskit_aer import AerSimulator\n    sim = AerSimulator()\nexcept ImportError:\n    from qiskit import Aer\n    sim = Aer.get_backend('aer_simulator')\n\ndef c_amod15(a, power):\n    U = QuantumCircuit(4)\n    for _ in range(power):\n        if a in [2, 13]:\n            U.swap(2, 3); U.swap(1, 2); U.swap(0, 1)\n        if a in [7, 8]:\n            U.swap(0, 1); U.swap(1, 2); U.swap(2, 3)\n        if a in [4, 11]:\n            U.swap(1, 3); U.swap(0, 2)\n        if a in [7, 11, 13]:\n            for q in range(4): U.x(q)\n    U = U.to_gate()\n    U.name = f'{a}^{power} mod 15'\n    return U.control()\n\ndef qft_dagger(n):\n    qc = QuantumCircuit(n)\n    for qubit in range(n // 2):\n        qc.swap(qubit, n - qubit - 1)\n    for j in range(n):\n        for m in range(j):\n            qc.cp(-math.pi / float(2 ** (j - m)), m, j)\n        qc.h(j)\n    qc.name = 'QFT†'\n    return qc\n\nN = 15\nn_count = 3\n\nfor a in [2, 7, 8, 11, 13]:\n    qc = QuantumCircuit(n_count + 4, n_count)\n    for q in range(n_count):\n        qc.h(q)\n    qc.x(n_count)\n    for q in range(n_count):\n        qc.append(c_amod15(a, 2**q), [q] + [n_count + i for i in range(4)])\n    qc.append(qft_dagger(n_count), range(n_count))\n    qc.measure(range(n_count), range(n_count))\n\n    counts = sim.run(transpile(qc, sim)).result().get_counts()\n    factors = set()\n    for output in counts:\n        decimal = int(output, 2)\n        phase = decimal / (2 ** n_count)\n        r = Fraction(phase).limit_denominator(N).denominator\n        if r % 2 == 0:\n            for g in [math.gcd(a ** (r // 2) - 1, N), math.gcd(a ** (r // 2) + 1, N)]:\n                if 1 < g < N:\n                    factors.add(g)\n    print(f'N={N}, a={a} -> Factors: {sorted(factors)}')\n"}
+
+
+ALIASES = {
+    'bell': 'qe',
+    'bellloop': 'qeloop',
+    'entanglement': 'qe',
+    'entanglementloop': 'qeloop',
+    'teleportation': 'tele',
+    'teleportationloop': 'teleloop',
+    'superdense': 'super',
+    'superdenseloop': 'superloop',
+    'deutsch': 'de',
+    'deutschloop': 'deloop',
+    'deutsch_jozsa': 'dj',
+    'deutsch_jozsaleop': 'djloop',
+    'deutschjozsa': 'dj',
+    'bernstein_vazirani': 'bv',
+    'bernsteinvazirani': 'bv',
+    'grover_search': 'grover',
+}
+
+DESCRIPTIONS = {
+    'qe': 'Quantum Entanglement (single Bell state)',
+    'qeloop': 'Quantum Entanglement (loops over all 4 Bell states)',
+    'tele': 'Quantum Teleportation (single state teleportation)',
+    'teleloop': 'Quantum Teleportation (loops over |0> and |1>)',
+    'super': 'Superdense Coding (single message transmission)',
+    'superloop': 'Superdense Coding (loops over all 4 messages)',
+    'de': 'Deutsch Algorithm (single oracle evaluation)',
+    'deloop': 'Deutsch Algorithm (loops over all 4 oracles)',
+    'dj': 'Deutsch-Jozsa Algorithm (single oracle evaluation)',
+    'djloop': 'Deutsch-Jozsa Algorithm (loops over constant & balanced)',
+    'simon': 'Simon Algorithm (single secret period finding)',
+    'simonloop': 'Simon Algorithm (loops over multiple secret strings)',
+    'bv': 'Bernstein-Vazirani Algorithm (single hidden string search)',
+    'bvloop': 'Bernstein-Vazirani Algorithm (loops over multiple strings)',
+    'grover': 'Grover Search Algorithm (single target marked state)',
+    'groverloop': 'Grover Search Algorithm (loops over all 4 target states)',
+    'shor': 'Shor Algorithm (single N=15, a=7 order finding & factoring)',
+    'shorloop': 'Shor Algorithm (loops over multiple values of coprime a)',
+}
+
+def resolve_name(name):
+    if not isinstance(name, str):
+        if hasattr(name, '__name__'):
+            name = name.__name__
+        else:
+            name = str(name)
+    key = name.strip().lower()
+    if key.endswith('.py'):
+        key = key[:-3]
+    return ALIASES.get(key, key)

myqclab-0.1.0/myqclab.egg-info/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: myqclab
+Version: 0.1.0
+Summary: Quantum Computing Lab programs in Python and Qiskit
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: qiskit>=1.0.0
+Requires-Dist: qiskit-aer>=0.14.0
+Dynamic: requires-python
+
+# Quantum Computing Lab Programs & `myqclab` Package
+
+Compact, verified Python and Qiskit implementations of 9 core quantum algorithms for lab exams.
+
+Available both as standalone scripts/notebooks and as an installable Python package **`myqclab`**.
+
+---
+
+## 📦 Package Installation
+
+Install directly in your environment:
+```bash
+pip install .
+```
+Or in editable/development mode:
+```bash
+pip install -e .
+```
+
+---
+
+## 🚀 Package Usage
+
+### 1. In Python / Jupyter Notebook
+```python
+import myqclab
+
+# Show the code of any algorithm in the terminal (quotes optional!)
+myqclab.show(grover)
+myqclab.show("grover")
+
+# Run the algorithm and print the circuit and simulation output
+myqclab.run(grover)
+
+# List all available programs
+myqclab.list()
+```
+
+### 2. From Terminal CLI
+```bash
+# Print code of a program
+myqclab grover
+myqclab show grover
+
+# Execute program directly
+myqclab run grover
+
+# List all programs
+myqclab list
+```
+
+---
+
+## 📚 Available Quantum Programs
+
+| Program Name | Loop Variation | Algorithm | Manually Configurable Input |
+|---|---|---|---|
+| `qe` | `qeloop` | Quantum Entanglement | `state = '00'` (`'00'`, `'01'`, `'10'`, `'11'`) |
+| `tele` | `teleloop` | Quantum Teleportation | `state = '1'` (`'0'` or `'1'`) |
+| `super` | `superloop` | Superdense Coding | `msg = '01'` (`'00'`, `'01'`, `'10'`, `'11'`) |
+| `de` | `deloop` | Deutsch's Algorithm | `oracle_type = 'balanced_id'` (`'constant_0'`, etc.) |
+| `dj` | `djloop` | Deutsch-Jozsa Algorithm | `oracle_type = 'balanced'`, `n = 3` |
+| `simon` | `simonloop` | Simon's Algorithm | `s = '11'` |
+| `bv` | `bvloop` | Bernstein-Vazirani | `s = '1011'` |
+| `grover` | `groverloop` | Grover's Search | `target = '10'` (`'00'`, `'01'`, `'10'`, `'11'`) |
+| `shor` | `shorloop` | Shor's Algorithm | `N = 15, a = 7` |
+
+---
+
+## Standalone Running
+
+Run any script with Python:
+```bash
+python qe.py
+```
+Or open any `.ipynb` file in Jupyter Notebook / JupyterLab / Google Colab.

myqclab-0.1.0/myqclab.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+setup.py
+myqclab/__init__.py
+myqclab/__main__.py
+myqclab/cli.py
+myqclab/codes.py
+myqclab.egg-info/PKG-INFO
+myqclab.egg-info/SOURCES.txt
+myqclab.egg-info/dependency_links.txt
+myqclab.egg-info/entry_points.txt
+myqclab.egg-info/requires.txt
+myqclab.egg-info/top_level.txt

myqclab-0.1.0/myqclab.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

myqclab-0.1.0/myqclab.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+myqclab = myqclab.cli:main

myqclab-0.1.0/myqclab.egg-info/requires.txt

@@ -0,0 +1,2 @@
+qiskit>=1.0.0
+qiskit-aer>=0.14.0

myqclab-0.1.0/myqclab.egg-info/top_level.txt

@@ -0,0 +1 @@
+myqclab

myqclab-0.1.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "myqclab"
+version = "0.1.0"
+description = "Quantum Computing Lab programs in Python and Qiskit"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "qiskit>=1.0.0",
+    "qiskit-aer>=0.14.0",
+]
+
+[project.scripts]
+myqclab = "myqclab.cli:main"

myqclab-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

myqclab-0.1.0/setup.py

@@ -0,0 +1,18 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="myqclab",
+    version="0.1.0",
+    description="Quantum Computing Lab programs in Python and Qiskit",
+    packages=find_packages(),
+    install_requires=[
+        "qiskit>=1.0.0",
+        "qiskit-aer>=0.14.0",
+    ],
+    entry_points={
+        "console_scripts": [
+            "myqclab = myqclab.cli:main",
+        ],
+    },
+    python_requires=">=3.8",
+)