quantum-debugger 0.4.1__tar.gz → 0.5.0__tar.gz

quantum_debugger-0.5.0/CHANGELOG.md

@@ -0,0 +1,110 @@
+# Changelog
+
+All notable changes to QuantumDebugger will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.4.2] - 2025-12-22
+
+### Added
+- **Complete pytest migration**: All 200 legacy script-style tests converted to pytest format
+- **Hardware profiles extended**: AWS Braket, Azure Quantum provider support
+- **2025 hardware updates**: IBM Heron, Google Willow, IonQ Forte profiles
+- **Advanced backend tests**: 8 edge case and performance tests
+- **GPU backend support**: CuPy backend availability testing
+- **Enhanced test coverage**: 656 comprehensive tests (all passing ✅)
+
+### Changed
+- Migrated all legacy test files from script execution to pytest format
+- Updated test structure for better CI/CD compatibility
+- Enhanced backend validation with 6 comprehensive backend tests
+- Improved hardware profile testing (18 tests total)
+
+### Fixed
+- Test suite compatibility issues
+- Backend detection for GPU/CuPy
+- Hardware profile version tracking
+
+### Documentation
+- Updated README.md with v0.4.2 features and test count
+- Added comprehensive testing section in README
+- Created FINAL_TEST_SUMMARY.md with complete 656 test breakdown
+- Fixed all documentation links (tutorials, examples, LICENSE)
+- Updated version numbers across all files
+
+### Testing
+- **656 total tests** (all passing ✅)
+- All script-style tests converted to pytest
+- Complete test coverage documentation
+
+## [0.4.1] - 2024-12-XX
+
+### Added
+- Additional QML features and optimizations
+- Performance improvements
+
+## [0.4.0] - 2024-12-XX
+
+### Added
+- **Quantum Machine Learning Module**
+- Parameterized gates (RX, RY, RZ with trainable parameters)
+- VQE algorithm for molecular chemistry
+- QAOA for combinatorial optimization
+- Training framework with 4 optimizers (Adam, SGD, SPSA, RMSprop)
+- Gradient computation (parameter shift rule, finite differences)
+- 316 comprehensive tests
+- 3 tutorials, 4 example scripts
+
+### Changed
+- Enhanced circuit profiling
+- Improved state visualization
+
+## [0.3.0] - 2024-12-XX
+
+### Added
+- Realistic noise models (4 types)
+- Hardware profiles (IBM, Google, IonQ, Rigetti)
+- Qiskit Aer validation
+- 89 new tests
+
+## [0.2.0] - 2024-XX-XX
+
+### Added
+- Bidirectional circuit conversion with Qiskit
+- CP gate support
+- 12-qubit support
+
+## [0.1.1] - 2024-12-03
+
+### Fixed
+- Fixed SWAP gate matrix for little-endian qubit ordering
+- Fixed CNOT gate matrix for little-endian qubit ordering
+- Fixed Toffoli gate matrix for little-endian qubit ordering
+- Fixed entanglement detection for Bell states
+- Rewrote multi-qubit gate expansion algorithm using tensor products
+
+### Added
+- 69 comprehensive tests (100% pass rate)
+- Test suites: quickstart, advanced, comprehensive, extreme, validation, production, edge cases
+- Numerical stability tests (100+ consecutive operations)
+- Quantum mechanics validation tests
+- Production readiness tests
+
+### Changed
+- Improved gate expansion algorithm for better accuracy
+- Enhanced test coverage to 69 tests across 7 test suites
+
+## [0.1.0] - 2024-11-30
+
+### Added
+- Initial release
+- Core quantum state representation
+- 15+ quantum gates (H, X, Y, Z, S, T, RX, RY, RZ, PHASE, CNOT, CZ, SWAP, Toffoli)
+- Step-through debugger with breakpoints
+- Circuit profiler with optimization suggestions
+- State visualization tools
+- Bloch sphere representation
+- Support for up to 15 qubits
+- Example circuits and demos
+- Comprehensive documentation

{quantum_debugger-0.4.1/quantum_debugger.egg-info → quantum_debugger-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quantum-debugger
-Version: 0.4.1
+Version: 0.5.0
 Summary: Interactive quantum circuit debugger and Quantum Machine Learning library with VQE, QAOA, and parameterized gates
 Home-page: https://github.com/Raunakg2005/quantum-debugger
 Author: Raunak Kumar Gupta
@@ -55,34 +55,49 @@ Dynamic: summary
 **Interactive debugger, profiler, and quantum machine learning library for quantum circuits**
 
 [![PyPI version](https://badge.fury.io/py/quantum-debugger.svg)](https://pypi.org/project/quantum-debugger/)
-[![Tests](https://img.shields.io/badge/tests-316%2F316%20passing-brightgreen)]()
+[![Tests](https://img.shields.io/badge/tests-689%20passing-brightgreen)](https://github.com/Raunakg2005/quantum-debugger/blob/main/tests/FINAL_TEST_SUMMARY.md)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue)]()
 [![License](https://img.shields.io/badge/license-MIT-green)]()
 
 A powerful Python library for quantum circuit debugging, state inspection, performance analysis, and **quantum machine learning**. Now with VQE, QAOA, and parameterized quantum circuits!
 
-## ✨ What's New in v0.4.0
+## ✨ What's New in v0.5.0
 
-**Quantum Machine Learning Module** 🚀
+**Advanced Quantum Machine Learning** 🚀
 
 ```python
-from quantum_debugger.qml import VQE, h2_hamiltonian, hardware_efficient_ansatz
+# NEW: Quantum Neural Networks
+from quantum_debugger.qml.qnn import QuantumNeuralNetwork, EncodingLayer, VariationalLayer
 
-# Find H2 molecule ground state
-H = h2_hamiltonian()
-vqe = VQE(H, hardware_efficient_ansatz, num_qubits=2)
-result = vqe.run(initial_params)
-print(f"Ground state energy: {result['ground_state_energy']:.6f} Hartree")
-# Accuracy: < 1% error from exact solution
+qnn = QuantumNeuralNetwork(n_qubits=4)
+qnn.add(EncodingLayer(4, feature_map='zz'))
+qnn.add(VariationalLayer(4, ansatz='real_amplitudes', reps=2))
+qnn.compile(optimizer='adam', loss='mse', learning_rate=0.01)
+history = qnn.fit(X_train, y_train, epochs=50, batch_size=16)
+
+# NEW: Zero-Noise Extrapolation (Error Mitigation)
+from quantum_debugger.qml.error_mitigation import ZeroNoiseExtrapolation
+
+zne = ZeroNoiseExtrapolation(scale_factors=[1.0, 2.0, 3.0])
+mitigated_value = zne.execute(circuit_function)
+
+# NEW: GPU Acceleration
+from quantum_debugger.backends import GPUBackend
+
+backend = GPUBackend()  # Auto-detects GPU, falls back to CPU
+state = backend.allocate_state(n_qubits=15)  # 2-5x faster on GPU
 ```
 
-**New Features:**
-- ✅ **Parameterized Gates** (RX, RY, RZ with trainable parameters)
-- ✅ **VQE** (Variational Quantum Eigensolver for chemistry)
-- ✅ **QAOA** (Quantum optimization for MaxCut problems)
-- ✅ **Training Framework** (Adam, SGD, SPSA, RMSprop optimizers)
-- ✅ **Gradient Computation** (Parameter shift rule, finite differences)
-- ✅ **316 comprehensive tests** (100% passing)
+**v0.5.0 Features:**
+- ✅ **Quantum Neural Networks** (Layer-based QML with batch training)
+- ✅ **Zero-Noise Extrapolation** (Error mitigation for noisy circuits)
+- ✅ **GPU Acceleration** (CuPy integration with automatic CPU fallback)
+- ✅ **Advanced Ansätze** (4 new templates: RealAmplitudes, TwoLocal, etc.)
+- ✅ **Dataset Integration** (CSV/JSON loading, preprocessing, feature maps)
+- ✅ **Molecular Hamiltonians** (LiH, H2O, BeH2 with accurate energies)
+- ✅ **Advanced Optimizers** (QNG, Nelder-Mead, L-BFGS-B)
+- ✅ **190+ comprehensive tests** (all passing ✅)
+- ✅ **Professional documentation** (7 detailed guides)
 
 See full [QML Documentation](#quantum-machine-learning-v040) below.
 
@@ -96,12 +111,14 @@ See full [QML Documentation](#quantum-machine-learning-v040) below.
 - **Noise Simulation** - Realistic hardware noise models
 - **Qiskit Integration** - Import/export circuits from Qiskit
 
-### Quantum Machine Learning (NEW v0.4.0)
-- **Parameterized Circuits** - Trainable quantum gates
-- **VQE** - Molecular ground state finding
-- **QAOA** - Combinatorial optimization
-- **Training & Optimization** - 4 classical optimizers
-- **Ansatz Library** - 4 pre-built quantum circuit templates
+### Quantum Machine Learning (v0.5.0)
+- **Quantum Neural Networks** - Layer-based deep learning on quantum hardware
+- **Error Mitigation** - Zero-noise extrapolation for accurate results
+- **GPU Acceleration** - Hardware-accelerated simulations (2-5x speedup)
+- **VQE & QAOA** - Molecular chemistry and optimization
+- **Advanced Optimizers** - 7 optimizers including quantum natural gradient
+- **Ansätze Library** - 8 pre-built quantum circuit templates
+- **Dataset Tools** - Loading, preprocessing, quantum feature encoding
 
 ## Quick Start
 
@@ -143,7 +160,77 @@ rx.parameter = 0.7
 new_matrix = rx.matrix()  # Automatically cached for performance
 ```
 
-## Quantum Machine Learning (v0.4.0)
+## v0.5.0 Feature Spotlight
+
+### 1. Quantum Neural Networks
+
+Build and train quantum machine learning models:
+
+```python
+from quantum_debugger.qml.qnn import (
+    QuantumNeuralNetwork,
+    EncodingLayer,
+    VariationalLayer
+)
+
+# Create network
+qnn = QuantumNeuralNetwork(n_qubits=4)
+qnn.add(EncodingLayer(4, feature_map='zz'))
+qnn.add(VariationalLayer(4, ansatz='real_amplitudes', reps=2))
+
+# Train
+qnn.compile(optimizer='adam', loss='mse')
+history = qnn.fit(X_train, y_train, epochs=50, batch_size=16)
+
+# Predict
+predictions = qnn.predict(X_test)
+```
+
+📖 **Documentation:** [QNN Guide](docs/qnn_guide.md)
+
+### 2. Zero-Noise Extrapolation (Error Mitigation)
+
+Reduce quantum noise effects:
+
+```python
+from quantum_debugger.qml.error_mitigation import ZeroNoiseExtrapolation
+
+# Setup ZNE
+zne = ZeroNoiseExtrapolation(
+    scale_factors=[1.0, 2.0, 3.0],
+    extrapolator='polynomial'
+)
+
+# Apply to circuit
+mitigated_result = zne.execute(circuit_function)
+
+# Check improvement
+improvement = zne.get_improvement()
+print(f"Error reduced by {improvement:.1f}%")
+```
+
+📖 **Documentation:** [ZNE Guide](docs/zne_guide.md)
+
+### 3. GPU Acceleration
+
+Hardware-accelerated quantum simulations:
+
+```python
+from quantum_debugger.backends import GPUBackend
+
+# Auto-detect GPU (falls back to CPU)
+backend = GPUBackend()
+
+# Allocate on GPU
+state = backend.allocate_state(n_qubits=15)
+
+# 2-5x faster for large circuits
+# Transparent API - same code for CPU/GPU
+```
+
+📖 **Documentation:** [GPU Guide](docs/gpu_guide.md)
+
+## Quantum Machine Learning (v0.4.0+)
 
 ### 1. Parameterized Gates
 
@@ -361,14 +448,16 @@ See [test files](.) for details.
 ## 📖 Documentation
 
 - **Tutorials:**
-  - [Parameterized Gates Tutorial](tutorials/parameterized_gates_tutorial.md)
-  - [VQE Preparation Guide](tutorials/vqe_preparation.md)
-  - [QAOA Tutorial](tutorials/qaoa_tutorial.md)
+  - [Parameterized Gates Tutorial](https://github.com/Raunakg2005/quantum-debugger/blob/main/tutorials/parameterized_gates_tutorial.md)
+  - [VQE Preparation Guide](https://github.com/Raunakg2005/quantum-debugger/blob/main/tutorials/vqe_preparation.md)
+  - [QAOA Tutorial](https://github.com/Raunakg2005/quantum-debugger/blob/main/tutorials/qaoa_tutorial.md)
+  - [Noise Tutorial](https://github.com/Raunakg2005/quantum-debugger/blob/main/tutorials/noise_tutorial.md)
+  - [ZNE Tutorial](https://github.com/Raunakg2005/quantum-debugger/blob/main/tutorials/zne_tutorial.md)
 
 - **Examples:**
-  - [VQE H2 Molecule](examples/vqe_h2_example.py)
-  - [QAOA MaxCut](examples/qaoa_maxcut_example.py)
-  - [Performance Benchmarks](examples/benchmarks.py)
+  - [VQE H2 Molecule](https://github.com/Raunakg2005/quantum-debugger/blob/main/examples/vqe_h2_example.py)
+  - [QAOA MaxCut](https://github.com/Raunakg2005/quantum-debugger/blob/main/examples/qaoa_maxcut_example.py)
+  - [QML Basic Example](https://github.com/Raunakg2005/quantum-debugger/blob/main/examples/qml_basic_example.py)
 
 ## 📈 Version History
 
@@ -410,22 +499,74 @@ See [test files](.) for details.
 - [ ] Quantum error correction tools
 - [ ] Production deployment tools
 
+## 🧪 Testing
+
+**v0.4.2: 656 Comprehensive Tests** ✅
+
+### Test Suite Coverage
+- **Core Tests**: 441 tests (quantum operations, circuits, debugging)
+- **QML Tests**: 139 tests (VQE, QAOA, training, parameterized gates)
+- **Integration**: 76 tests (Cirq, Qiskit, backend validation)
+- **All test files converted to pytest format**
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Run specific test suites
+pytest tests/unit/ -v          # Core unit tests
+pytest tests/cirq/ -v          # Cirq integration
+pytest tests/qiskit/ -v        # Qiskit integration
+pytest tests/qml/ -v           # QML tests
+
+# Run with coverage
+pytest tests/ --cov=quantum_debugger --cov-report=html
+
+# Run specific converted tests
+pytest tests/unit/test_backends_advanced.py -v
+pytest tests/unit/test_hardware_profiles_phase3.py -v
+```
+
+### Test Documentation
+- 📊 [Complete Test Summary](https://github.com/Raunakg2005/quantum-debugger/blob/main/tests/FINAL_TEST_SUMMARY.md) - Full breakdown of all 656 tests
+- 📁 [Test Structure](https://github.com/Raunakg2005/quantum-debugger/blob/main/tests/README.md) - Organization and conventions
+
+### Test Categories
+1. **Backend Tests** (59 tests) - NumPy, Sparse, GPU backends
+2. **Noise Tests** (64 tests) - Noise models, hardware profiles
+3. **Mitigation Tests** (28 tests) - ZNE, error mitigation
+4. **Hardware Profiles** (18 tests) - AWS Braket, Azure Quantum, 2025 updates
+5. **QML Tests** (139 tests) - VQE, QAOA, training framework
+6. **Integration Tests** (76 tests) - Cirq, Qiskit compatibility
+
 ## 🤝 Contributing
 
 Contributions welcome! Please ensure tests pass:
 
 ```bash
-pytest test_*.py -v
+pytest tests/ -v --tb=short
 ```
 
+See [Testing Section](#testing) for details.
+
 ## 📄 License
 
-MIT License - see [LICENSE](LICENSE) file.
+MIT License - see [LICENSE](https://github.com/Raunakg2005/quantum-debugger/blob/main/LICENSE) file.
+
+---
+
+## 🙏 Acknowledgments
+
+**Author:** Raunak Kumar Gupta  
+**Supervised by:** Dr. Vaibhav Prakash Vasani  
+**Institution:** K.J. Somaiya School of Engineering
 
 ---
 
 **PyPI:** https://pypi.org/project/quantum-debugger/  
 **Author:** Raunak Kumar Gupta  
 **Institution:** K.J. Somaiya School of Engineering  
-**Version:** 0.4.0  
+**Version:** 0.4.2  
 **Python:** 3.9+

{quantum_debugger-0.4.1 → quantum_debugger-0.5.0}/README.md

@@ -3,34 +3,49 @@
 **Interactive debugger, profiler, and quantum machine learning library for quantum circuits**
 
 [![PyPI version](https://badge.fury.io/py/quantum-debugger.svg)](https://pypi.org/project/quantum-debugger/)
-[![Tests](https://img.shields.io/badge/tests-316%2F316%20passing-brightgreen)]()
+[![Tests](https://img.shields.io/badge/tests-689%20passing-brightgreen)](https://github.com/Raunakg2005/quantum-debugger/blob/main/tests/FINAL_TEST_SUMMARY.md)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue)]()
 [![License](https://img.shields.io/badge/license-MIT-green)]()
 
 A powerful Python library for quantum circuit debugging, state inspection, performance analysis, and **quantum machine learning**. Now with VQE, QAOA, and parameterized quantum circuits!
 
-## ✨ What's New in v0.4.0
+## ✨ What's New in v0.5.0
 
-**Quantum Machine Learning Module** 🚀
+**Advanced Quantum Machine Learning** 🚀
 
 ```python
-from quantum_debugger.qml import VQE, h2_hamiltonian, hardware_efficient_ansatz
+# NEW: Quantum Neural Networks
+from quantum_debugger.qml.qnn import QuantumNeuralNetwork, EncodingLayer, VariationalLayer
 
-# Find H2 molecule ground state
-H = h2_hamiltonian()
-vqe = VQE(H, hardware_efficient_ansatz, num_qubits=2)
-result = vqe.run(initial_params)
-print(f"Ground state energy: {result['ground_state_energy']:.6f} Hartree")
-# Accuracy: < 1% error from exact solution
+qnn = QuantumNeuralNetwork(n_qubits=4)
+qnn.add(EncodingLayer(4, feature_map='zz'))
+qnn.add(VariationalLayer(4, ansatz='real_amplitudes', reps=2))
+qnn.compile(optimizer='adam', loss='mse', learning_rate=0.01)
+history = qnn.fit(X_train, y_train, epochs=50, batch_size=16)
+
+# NEW: Zero-Noise Extrapolation (Error Mitigation)
+from quantum_debugger.qml.error_mitigation import ZeroNoiseExtrapolation
+
+zne = ZeroNoiseExtrapolation(scale_factors=[1.0, 2.0, 3.0])
+mitigated_value = zne.execute(circuit_function)
+
+# NEW: GPU Acceleration
+from quantum_debugger.backends import GPUBackend
+
+backend = GPUBackend()  # Auto-detects GPU, falls back to CPU
+state = backend.allocate_state(n_qubits=15)  # 2-5x faster on GPU
 ```
 
-**New Features:**
-- ✅ **Parameterized Gates** (RX, RY, RZ with trainable parameters)
-- ✅ **VQE** (Variational Quantum Eigensolver for chemistry)
-- ✅ **QAOA** (Quantum optimization for MaxCut problems)
-- ✅ **Training Framework** (Adam, SGD, SPSA, RMSprop optimizers)
-- ✅ **Gradient Computation** (Parameter shift rule, finite differences)
-- ✅ **316 comprehensive tests** (100% passing)
+**v0.5.0 Features:**
+- ✅ **Quantum Neural Networks** (Layer-based QML with batch training)
+- ✅ **Zero-Noise Extrapolation** (Error mitigation for noisy circuits)
+- ✅ **GPU Acceleration** (CuPy integration with automatic CPU fallback)
+- ✅ **Advanced Ansätze** (4 new templates: RealAmplitudes, TwoLocal, etc.)
+- ✅ **Dataset Integration** (CSV/JSON loading, preprocessing, feature maps)
+- ✅ **Molecular Hamiltonians** (LiH, H2O, BeH2 with accurate energies)
+- ✅ **Advanced Optimizers** (QNG, Nelder-Mead, L-BFGS-B)
+- ✅ **190+ comprehensive tests** (all passing ✅)
+- ✅ **Professional documentation** (7 detailed guides)
 
 See full [QML Documentation](#quantum-machine-learning-v040) below.
 
@@ -44,12 +59,14 @@ See full [QML Documentation](#quantum-machine-learning-v040) below.
 - **Noise Simulation** - Realistic hardware noise models
 - **Qiskit Integration** - Import/export circuits from Qiskit
 
-### Quantum Machine Learning (NEW v0.4.0)
-- **Parameterized Circuits** - Trainable quantum gates
-- **VQE** - Molecular ground state finding
-- **QAOA** - Combinatorial optimization
-- **Training & Optimization** - 4 classical optimizers
-- **Ansatz Library** - 4 pre-built quantum circuit templates
+### Quantum Machine Learning (v0.5.0)
+- **Quantum Neural Networks** - Layer-based deep learning on quantum hardware
+- **Error Mitigation** - Zero-noise extrapolation for accurate results
+- **GPU Acceleration** - Hardware-accelerated simulations (2-5x speedup)
+- **VQE & QAOA** - Molecular chemistry and optimization
+- **Advanced Optimizers** - 7 optimizers including quantum natural gradient
+- **Ansätze Library** - 8 pre-built quantum circuit templates
+- **Dataset Tools** - Loading, preprocessing, quantum feature encoding
 
 ## Quick Start
 
@@ -91,7 +108,77 @@ rx.parameter = 0.7
 new_matrix = rx.matrix()  # Automatically cached for performance
 ```
 
-## Quantum Machine Learning (v0.4.0)
+## v0.5.0 Feature Spotlight
+
+### 1. Quantum Neural Networks
+
+Build and train quantum machine learning models:
+
+```python
+from quantum_debugger.qml.qnn import (
+    QuantumNeuralNetwork,
+    EncodingLayer,
+    VariationalLayer
+)
+
+# Create network
+qnn = QuantumNeuralNetwork(n_qubits=4)
+qnn.add(EncodingLayer(4, feature_map='zz'))
+qnn.add(VariationalLayer(4, ansatz='real_amplitudes', reps=2))
+
+# Train
+qnn.compile(optimizer='adam', loss='mse')
+history = qnn.fit(X_train, y_train, epochs=50, batch_size=16)
+
+# Predict
+predictions = qnn.predict(X_test)
+```
+
+📖 **Documentation:** [QNN Guide](docs/qnn_guide.md)
+
+### 2. Zero-Noise Extrapolation (Error Mitigation)
+
+Reduce quantum noise effects:
+
+```python
+from quantum_debugger.qml.error_mitigation import ZeroNoiseExtrapolation
+
+# Setup ZNE
+zne = ZeroNoiseExtrapolation(
+    scale_factors=[1.0, 2.0, 3.0],
+    extrapolator='polynomial'
+)
+
+# Apply to circuit
+mitigated_result = zne.execute(circuit_function)
+
+# Check improvement
+improvement = zne.get_improvement()
+print(f"Error reduced by {improvement:.1f}%")
+```
+
+📖 **Documentation:** [ZNE Guide](docs/zne_guide.md)
+
+### 3. GPU Acceleration
+
+Hardware-accelerated quantum simulations:
+
+```python
+from quantum_debugger.backends import GPUBackend
+
+# Auto-detect GPU (falls back to CPU)
+backend = GPUBackend()
+
+# Allocate on GPU
+state = backend.allocate_state(n_qubits=15)
+
+# 2-5x faster for large circuits
+# Transparent API - same code for CPU/GPU
+```
+
+📖 **Documentation:** [GPU Guide](docs/gpu_guide.md)
+
+## Quantum Machine Learning (v0.4.0+)
 
 ### 1. Parameterized Gates
 
@@ -309,14 +396,16 @@ See [test files](.) for details.
 ## 📖 Documentation
 
 - **Tutorials:**
-  - [Parameterized Gates Tutorial](tutorials/parameterized_gates_tutorial.md)
-  - [VQE Preparation Guide](tutorials/vqe_preparation.md)
-  - [QAOA Tutorial](tutorials/qaoa_tutorial.md)
+  - [Parameterized Gates Tutorial](https://github.com/Raunakg2005/quantum-debugger/blob/main/tutorials/parameterized_gates_tutorial.md)
+  - [VQE Preparation Guide](https://github.com/Raunakg2005/quantum-debugger/blob/main/tutorials/vqe_preparation.md)
+  - [QAOA Tutorial](https://github.com/Raunakg2005/quantum-debugger/blob/main/tutorials/qaoa_tutorial.md)
+  - [Noise Tutorial](https://github.com/Raunakg2005/quantum-debugger/blob/main/tutorials/noise_tutorial.md)
+  - [ZNE Tutorial](https://github.com/Raunakg2005/quantum-debugger/blob/main/tutorials/zne_tutorial.md)
 
 - **Examples:**
-  - [VQE H2 Molecule](examples/vqe_h2_example.py)
-  - [QAOA MaxCut](examples/qaoa_maxcut_example.py)
-  - [Performance Benchmarks](examples/benchmarks.py)
+  - [VQE H2 Molecule](https://github.com/Raunakg2005/quantum-debugger/blob/main/examples/vqe_h2_example.py)
+  - [QAOA MaxCut](https://github.com/Raunakg2005/quantum-debugger/blob/main/examples/qaoa_maxcut_example.py)
+  - [QML Basic Example](https://github.com/Raunakg2005/quantum-debugger/blob/main/examples/qml_basic_example.py)
 
 ## 📈 Version History
 
@@ -358,22 +447,74 @@ See [test files](.) for details.
 - [ ] Quantum error correction tools
 - [ ] Production deployment tools
 
+## 🧪 Testing
+
+**v0.4.2: 656 Comprehensive Tests** ✅
+
+### Test Suite Coverage
+- **Core Tests**: 441 tests (quantum operations, circuits, debugging)
+- **QML Tests**: 139 tests (VQE, QAOA, training, parameterized gates)
+- **Integration**: 76 tests (Cirq, Qiskit, backend validation)
+- **All test files converted to pytest format**
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Run specific test suites
+pytest tests/unit/ -v          # Core unit tests
+pytest tests/cirq/ -v          # Cirq integration
+pytest tests/qiskit/ -v        # Qiskit integration
+pytest tests/qml/ -v           # QML tests
+
+# Run with coverage
+pytest tests/ --cov=quantum_debugger --cov-report=html
+
+# Run specific converted tests
+pytest tests/unit/test_backends_advanced.py -v
+pytest tests/unit/test_hardware_profiles_phase3.py -v
+```
+
+### Test Documentation
+- 📊 [Complete Test Summary](https://github.com/Raunakg2005/quantum-debugger/blob/main/tests/FINAL_TEST_SUMMARY.md) - Full breakdown of all 656 tests
+- 📁 [Test Structure](https://github.com/Raunakg2005/quantum-debugger/blob/main/tests/README.md) - Organization and conventions
+
+### Test Categories
+1. **Backend Tests** (59 tests) - NumPy, Sparse, GPU backends
+2. **Noise Tests** (64 tests) - Noise models, hardware profiles
+3. **Mitigation Tests** (28 tests) - ZNE, error mitigation
+4. **Hardware Profiles** (18 tests) - AWS Braket, Azure Quantum, 2025 updates
+5. **QML Tests** (139 tests) - VQE, QAOA, training framework
+6. **Integration Tests** (76 tests) - Cirq, Qiskit compatibility
+
 ## 🤝 Contributing
 
 Contributions welcome! Please ensure tests pass:
 
 ```bash
-pytest test_*.py -v
+pytest tests/ -v --tb=short
 ```
 
+See [Testing Section](#testing) for details.
+
 ## 📄 License
 
-MIT License - see [LICENSE](LICENSE) file.
+MIT License - see [LICENSE](https://github.com/Raunakg2005/quantum-debugger/blob/main/LICENSE) file.
+
+---
+
+## 🙏 Acknowledgments
+
+**Author:** Raunak Kumar Gupta  
+**Supervised by:** Dr. Vaibhav Prakash Vasani  
+**Institution:** K.J. Somaiya School of Engineering
 
 ---
 
 **PyPI:** https://pypi.org/project/quantum-debugger/  
 **Author:** Raunak Kumar Gupta  
 **Institution:** K.J. Somaiya School of Engineering  
-**Version:** 0.4.0  
+**Version:** 0.4.2  
 **Python:** 3.9+

{quantum_debugger-0.4.1 → quantum_debugger-0.5.0}/quantum_debugger/__init__.py

@@ -15,7 +15,7 @@ Features:
 Version: 0.4.0-dev
 """
 
-__version__ = "0.4.0-dev"
+__version__ = "0.4.2"
 __author__ = "warlord9004"
 __license__ = "MIT"
 

{quantum_debugger-0.4.1 → quantum_debugger-0.5.0}/quantum_debugger/backends/__init__.py

@@ -123,3 +123,14 @@ if HAS_SPARSE:
 
 if HAS_CUPY:
     __all__.append('CuPyBackend')
+
+# Add GPU backend
+try:
+    from .gpu_backend import (
+        GPUBackend,
+        get_optimal_backend,
+        benchmark_backends
+    )
+    __all__.extend(['GPUBackend', 'get_optimal_backend', 'benchmark_backends'])
+except ImportError:
+    pass