Update the code and fix out-of-date

Author: coketaste

.github/workflows/tests.yml

@@ -32,24 +32,29 @@ jobs:
     - name: Install core dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -r examples/requirements.txt
+        pip install -r examples/requirements-core.txt
     
-    - name: Test example imports and basic functionality
+    - name: Verify examples syntax
+      run: |
+        echo "🔍 Running syntax verification..."
+        python verify_examples.py --quick
+    
+    - name: Test essential imports
       env:
         MPLBACKEND: Agg  # Use non-interactive matplotlib backend
       run: |
-        # Test essential imports work
-        python -c "import sys; sys.path.append('examples'); import utils.visualization; print('✅ Utils import successful')"
-        
-        # Test key examples can run with minimal parameters
-        echo "🧪 Testing Module 1 (Fundamentals)..."
-        timeout 30s python examples/module1_fundamentals/01_classical_vs_quantum_bits.py --shots 5 || echo "⚠️ Module 1 timeout (expected for educational content)"
-        
-        echo "🧪 Testing CLI interfaces..."
+        echo "📦 Testing essential imports..."
+        python -c "import sys; sys.path.append('examples'); import utils.visualization; print('✅ Visualization utils OK')"
+        python -c "import sys; sys.path.append('examples'); import utils.quantum_helpers; print('✅ Quantum helpers OK')"
+        python -c "import sys; sys.path.append('examples'); import utils.cli; print('✅ CLI utils OK')"
+        echo "✅ All imports successful"
+    
+    - name: Test CLI help interfaces
+      run: |
+        echo "🧪 Testing CLI help interfaces..."
         python examples/module1_fundamentals/01_classical_vs_quantum_bits.py --help > /dev/null
         python examples/module4_algorithms/01_deutsch_jozsa_algorithm.py --help > /dev/null
-        
-        echo "✅ Core functionality verified"
+        echo "✅ CLI interfaces working"
 
   documentation:
     runs-on: ubuntu-latest
@@ -62,17 +67,45 @@ jobs:
         
         # Check essential documentation exists
         test -f README.md && echo "✅ Main README found"
+        test -f BEGINNERS_GUIDE.md && echo "✅ Beginner's Guide found"
         test -f examples/README.md && echo "✅ Examples README found"
+        test -f verify_examples.py && echo "✅ Verification script found"
+        test -f CHANGELOG.md && echo "✅ Changelog found"
         
-        # Count examples across modules
-        total_examples=$(find examples/module*/ -maxdepth 1 -name "*.py" | wc -l)
+        # Count examples across modules (excluding __init__.py and other non-example files)
+        total_examples=$(find examples/module*/ -maxdepth 1 -name "*.py" -not -name "__*" | wc -l)
         echo "📊 Found $total_examples example files"
         
-        # Basic structure validation (flexible for educational content)
+        # Validate example count (expecting 45 examples)
         if [ "$total_examples" -lt 40 ]; then
-          echo "⚠️ Warning: Expected ~45 examples, found $total_examples"
+          echo "❌ Error: Expected 45 examples, found only $total_examples"
+          exit 1
+        elif [ "$total_examples" -ge 45 ]; then
+          echo "✅ Example count correct: $total_examples examples"
         else
-          echo "✅ Example count looks good: $total_examples examples"
+          echo "⚠️ Warning: Expected 45 examples, found $total_examples"
         fi
         
         echo "✅ Documentation structure validated"
+  
+  docker-build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+    
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+    
+    - name: Test Docker CPU build
+      run: |
+        echo "🐳 Testing Docker CPU build..."
+        cd docker
+        docker build --build-arg VARIANT=cpu -t qc101-test:cpu -f Dockerfile ..
+        echo "✅ Docker CPU build successful"
+    
+    - name: Run quick example in container
+      run: |
+        echo "🧪 Running example in Docker container..."
+        docker run --rm qc101-test:cpu \
+          python examples/module1_fundamentals/01_classical_vs_quantum_bits.py --shots 10
+        echo "✅ Docker container execution successful"

README.md

@@ -285,7 +285,6 @@ quantum-computing-101/
 ├── README.md                    # This file
 ├── LICENSE                      # Apache 2.0 License  
 ├── CHANGELOG.md                 # Version history and updates
-├── QISKIT_2X_MIGRATION.md      # Qiskit 2.x compatibility guide (NEW!)
 ├── modules/                     # Theoretical curriculum
 │   ├── Module1_Quantum_Fundamentals.md
 │   ├── Module2_Mathematical_Foundations.md
@@ -318,7 +317,6 @@ quantum-computing-101/
 │   │   └── gpu-amd.txt         # AMD ROCm packages
 ├── verify_examples.py          # Quality assurance tool
 ├── BEGINNERS_GUIDE.md          # Complete learning pathway (Updated v2.0)
-├── QISKIT_2X_MIGRATION.md      # Qiskit 2.x compatibility and headless setup
 └── docs/                       # Additional documentation
     ├── CONTRIBUTING.md         # Contribution guidelines
     ├── CODE_OF_CONDUCT.md      # Community standards
@@ -393,16 +391,16 @@ python verify_examples.py --module module1_fundamentals
 ### **When You Need Help:**
 - 🐛 **Technical Issues**: Run `python verify_examples.py` to diagnose problems
 - 📚 **Learning Questions**: Check the [Complete Beginner's Guide](BEGINNERS_GUIDE.md)
-- � **Qiskit 2.x Issues**: See the [Qiskit 2.x Migration Guide](QISKIT_2X_MIGRATION.md)
-- 🐳 **Docker/Headless Problems**: Check matplotlib backend configuration in the migration guide
-- �💬 **Community Support**: Join quantum computing forums and communities
+- 📖 **Qiskit 2.x Compatibility**: All examples are designed for Qiskit 2.x (>= 1.0.0)
+- 🐳 **Docker/Headless Problems**: Examples use matplotlib 'Agg' backend for headless compatibility
+- 💬 **Community Support**: Join quantum computing forums and communities
 - 🔧 **Installation Problems**: Follow the setup instructions above
 
 ### **Useful Resources:**
-- **[Qiskit 2.x Migration Guide](QISKIT_2X_MIGRATION.md)** - Complete compatibility fixes documentation
 - **[Qiskit Textbook](https://qiskit.org/textbook/)** - Comprehensive quantum computing resource
 - **[IBM Quantum Experience](https://quantum-computing.ibm.com/)** - Run on real quantum computers
 - **[Quantum Computing Stack Exchange](https://quantumcomputing.stackexchange.com/)** - Q&A community
+- **[Qiskit Documentation](https://docs.quantum.ibm.com/)** - Official Qiskit 2.x documentation
 
 ## 📖 Citation
 

docker/requirements/base.txt

@@ -5,17 +5,18 @@
 # Note: Do not add variant-specific packages here (use cpu.txt, gpu-nvidia.txt, gpu-amd.txt)
 
 # Core quantum computing frameworks
-qiskit>=1.0.0
+# Note: Qiskit 2.x versioning starts at 1.0.0
+qiskit>=1.0.0,<3.0.0
 # Note: qiskit-aer is installed separately in each variant (CPU/GPU) to avoid conflicts
-cirq>=1.2.0
-pennylane>=0.35.0
+cirq>=1.2.0,<2.0.0
+pennylane>=0.35.0,<1.0.0
 
 # Scientific computing and visualization
-numpy>=1.26.0
-scipy>=1.12.0
-matplotlib>=3.8.0
-pandas>=2.2.0
-seaborn>=0.12.0
+numpy>=1.26.0,<2.0.0
+scipy>=1.12.0,<2.0.0
+matplotlib>=3.8.0,<4.0.0
+pandas>=2.2.0,<3.0.0
+seaborn>=0.12.0,<1.0.0
 
 # Essential dependencies for circuit visualization
 pylatexenc>=2.10

examples/README.md

@@ -1,8 +1,8 @@
 # Quantum Computing 101 - Complete Practical Examples Collection
 
-🎉 **FULLY IMPLEMENTED CURRICULUM** - All 40 examples across 8 modules are now complete and ready to use!
+🎉 **FULLY IMPLEMENTED CURRICULUM** - All 45 examples across 8 modules are now complete and ready to use!
 
-This directory contains comprehensive Python examples for hands-on learning with the Quantum Computing 101 curriculum. Each module has its corresponding examples folder with 5 ready-to-run scripts, totaling 24,547 lines of production-grade quantum computing code.
+This directory contains comprehensive Python examples for hands-on learning with the Quantum Computing 101 curriculum. Each module has its corresponding examples folder with production-ready scripts, totaling 24,547+ lines of quantum computing code.
 
 ## 🚀 Quick Start
 
@@ -44,17 +44,17 @@ python 01_classical_vs_quantum_bits.py --help
 
 ```
 examples/
-├── module1_fundamentals/     # ✅ 5/5 - Basic quantum concepts (1,703 LOC)
-├── module2_mathematics/      # ✅ 5/5 - Mathematical foundations (2,361 LOC)
-├── module3_programming/      # ✅ 5/5 - Advanced Qiskit programming (3,246 LOC)
-├── module4_algorithms/       # ✅ 5/5 - Core quantum algorithms (1,843 LOC)
-├── module5_error_correction/ # ✅ 5/5 - Noise and error handling (2,111 LOC)
-├── module6_machine_learning/ # ✅ 5/5 - Quantum ML applications (3,157 LOC)
-├── module7_hardware/         # ✅ 5/5 - Hardware and cloud platforms (4,394 LOC)
+├── module1_fundamentals/     # ✅ 8 examples - Basic quantum concepts (1,703 LOC)
+├── module2_mathematics/      # ✅ 5 examples - Mathematical foundations (2,361 LOC)
+├── module3_programming/      # ✅ 6 examples - Advanced Qiskit programming (3,246 LOC)
+├── module4_algorithms/       # ✅ 5 examples - Core quantum algorithms (1,843 LOC)
+├── module5_error_correction/ # ✅ 5 examples - Noise and error handling (2,111 LOC)
+├── module6_machine_learning/ # ✅ 5 examples - Quantum ML applications (3,157 LOC)
+├── module7_hardware/         # ✅ 5 examples - Hardware and cloud platforms (4,394 LOC)
 ├── module8_applications/     # ✅ 5/5 - Industry use cases (5,346 LOC)
 └── utils/                    # ✅ Shared utilities and helpers (387 LOC)
 
-TOTAL: 40 examples, 24,547 lines of code, 100% complete!
+TOTAL: 45 examples, 24,547+ lines of code, 100% complete!
 ```
 
 ## 🎯 Complete Learning Path - All Tiers Implemented
@@ -129,7 +129,7 @@ Most scripts produce educational visualizations including:
 - ✅ Replaced blocking `plt.show()` with `plt.savefig()` and `plt.close()`
 - ✅ All visualizations automatically save to files
 
-**For detailed technical information, see**: `../QISKIT_2X_MIGRATION.md`
+**Technical Details**: All examples require Qiskit >= 1.0.0 and use headless matplotlib backend for Docker compatibility.
 
 ### Common Issues
 
@@ -204,7 +204,7 @@ python example.py --verbose
 
 ## 🤝 Contributing
 
-The Quantum Computing 101 examples collection is now **COMPLETE** with all 40 examples implemented! 🎉
+The Quantum Computing 101 examples collection is now **COMPLETE** with all 45 examples implemented! 🎉
 
 ### Ways to Contribute
 - **Bug Reports**: Found an issue? Please report it with details about your environment

examples/requirements-core.txt

@@ -5,13 +5,14 @@
 # For full features, use requirements.txt instead
 
 # Core quantum computing framework
-qiskit>=1.0.0
-qiskit-aer>=0.14.0
+# Note: Qiskit 2.x versioning starts at 1.0.0
+qiskit>=1.0.0,<3.0.0
+qiskit-aer>=0.14.0,<1.0.0
 
 # Scientific computing and visualization
-numpy>=1.26.0
-scipy>=1.12.0
-matplotlib>=3.8.0
+numpy>=1.26.0,<2.0.0
+scipy>=1.12.0,<2.0.0
+matplotlib>=3.8.0,<4.0.0
 
 # Essential dependencies for circuit visualization
 pylatexenc>=2.10

examples/requirements.txt

@@ -5,20 +5,21 @@
 # Note: Some packages (Jupyter, cloud SDKs) intentionally overlap with Docker for flexibility
 
 # Core quantum computing frameworks (required)
-qiskit>=1.0.0
-qiskit-aer>=0.14.0
-qiskit-ibm-runtime>=0.18.0
-qiskit-ibm-provider>=0.8.0
+# Note: Qiskit 2.x versioning starts at 1.0.0
+qiskit>=1.0.0,<3.0.0
+qiskit-aer>=0.14.0,<1.0.0
+qiskit-ibm-runtime>=0.18.0,<1.0.0
+qiskit-ibm-provider>=0.8.0,<1.0.0
 
 # Alternative frameworks for multi-platform examples (optional but recommended)
-cirq>=1.2.0
-pennylane>=0.35.0
+cirq>=1.2.0,<2.0.0
+pennylane>=0.35.0,<1.0.0
 
 # Scientific computing and visualization (required)
-numpy>=1.26.0
-scipy>=1.12.0
-matplotlib>=3.8.0
-pandas>=2.2.0
+numpy>=1.26.0,<2.0.0
+scipy>=1.12.0,<2.0.0
+matplotlib>=3.8.0,<4.0.0
+pandas>=2.2.0,<3.0.0
 
 # Essential dependencies for circuit visualization
 pylatexenc>=2.10

examples/utils/cli.py

@@ -134,7 +134,7 @@ def main():
         print("\n🚀 Quantum Computing 101")
         print("=" * 30)
         print("📚 A comprehensive quantum computing education platform")
-        print("🎯 40 production-ready examples across 8 modules")
+        print("🎯 45 production-ready examples across 8 modules")
         print("📊 24,547+ lines of educational quantum computing code")
         print("🌍 Open source and community-driven")
         print("\n🔗 More info: https://github.com/AIComputing101/quantum-computing-101")