Metadata-Version: 2.4
Name: qiskitcode
Version: 0.1.0
Summary: Quantum Lab Practicals: print theory + Qiskit code for all practicals on the terminal
Author: HAFIZ
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# qiskitcode

Quantum Lab Practicals — theory + Qiskit code, printed straight on the terminal.

## Install

From this folder:

```bash
pip install .
```

Or install the built wheel from `dist/`:

```bash
pip install dist/qiskitcode-0.1.0-py3-none-any.whl
```

(No Qiskit install needed just to *print* the practicals — Qiskit is only
needed if you actually *run* the printed code.)

## Use

```python
import qiskitcode

qiskitcode.p1()    # Practical 1: Hadamard / superposition
qiskitcode.p2()    # Practical 2: Measure + histogram
qiskitcode.p3()    # Practical 3: Bell state
qiskitcode.p4()    # Practical 4: CNOT + SWAP
qiskitcode.p5()    # Practical 5: Deutsch-Jozsa
qiskitcode.p6()    # Practical 6: Grover's search
qiskitcode.all()   # all six, one after another
qiskitcode.show(3) # any practical by number
qiskitcode.list()  # list all titles
```

The class form also works:

```python
from qiskitcode import Qiskitcode
Qiskitcode.p1()
Qiskitcode.all()
```

Note: `qiskitcode.1()` is not valid Python — an attribute name cannot start
with a digit — so the numbered practicals are `p1()` … `p6()`.

## Contents

1. Create a Single-Qubit Circuit Applying the Hadamard Gate
2. Measure the Qubit and Plot the Histogram of Results
3. Build a Circuit to Generate a Bell State
4. Implement a Multi-Qubit Circuit with CNOT and SWAP Gates
5. Implement and Run the Deutsch-Jozsa Algorithm
6. Implement and Run Grover's Algorithm to Search for a Marked State
