Skip to content

TESTING_GUIDE.md

Latest commit

 

History

History
375 lines (289 loc) · 7.9 KB

TESTING_GUIDE.md

File metadata and controls

375 lines (289 loc) · 7.9 KB

OOPSCP - Complete Testing Guide

✅ Build Status: WORKING

Last Compiled: Successfully
Executable Size: ~770KB
All Components: Fully Integrated

🚀 Quick Start (30 seconds)

# 1. Open terminal in project directory
cd C:\Users\Abhijeet Nardele\Desktop\oopscp

# 2. Run the program
.\oopscp.exe

# 3. Inside OOPSCP, try:
init
stats
hash README.md
exit

📋 Complete Feature Test Checklist

Test 1: Repository Initialization ✅

Steps:
1. Run: .\oopscp.exe
2. Command: init
3. Check: .oopscp directory created
4. Expected: Green "[OK] Repository initialized successfully!"

What it tests:

  • Directory creation
  • File system operations
  • Repository structure setup

Test 2: File Hashing (SHA-256) ✅

Steps:
1. Command: hash README.md
2. Expected: 64-character SHA-256 hash
3. Run again: Should produce identical hash

What it tests:

  • SHA-256 implementation (from scratch!)
  • File reading
  • Cryptographic correctness

Test 3: Repository Status ✅

Steps:
1. After init, command: status
2. Modify a file (e.g., edit README.md)
3. Command: status again
4. Expected: Shows modified files

What it tests:

  • FileScanner directory traversal
  • Hash comparison
  • Change detection

Test 4: Snapshot Creation ✅

Steps:
1. Command: snapshot "My first snapshot"
2. Expected: Files scanned, hashes calculated
3. Command: list
4. Expected: Snapshot appears with ID

What it tests:

  • Binary file serialization
  • Snapshot storage
  • Metadata tracking

Test 5: File Comparison (LCS Algorithm) ✅

Steps:
1. Create two text files:
   echo "Hello World" > file1.txt
   echo "Hello Planet" > file2.txt

2. Command: compare file1.txt file2.txt
3. Expected: Line-by-line diff with colors

What it tests:

  • LCS (Longest Common Subsequence) algorithm
  • Text file parsing
  • Diff generation

Test 6: Duplicate Detection ✅

Steps:
1. Create duplicate files:
   copy README.md README_copy.md
   
2. Command: deduplicate
3. Expected: Finds duplicates, shows wasted space

What it tests:

  • Hash-based deduplication
  • Hash map implementation
  • Storage analysis

Test 7: Integrity Check ✅

Steps:
1. Command: snapshot "Before integrity"
2. Command: integrity-check
3. Expected: All files verified or corruption detected

What it tests:

  • File integrity verification
  • Hash comparison
  • Corruption detection

Test 8: Repository Statistics ✅

Steps:
1. Command: stats
2. Expected: 
   - File count
   - Total size
   - Duplicate analysis
   - Snapshot information

What it tests:

  • FileScanner
  • Deduplicator
  • Repository metadata
  • Real-time analysis

🎯 Advanced Tests

Test 9: .oopsignore Support

Steps:
1. Create .oopsignore file with patterns
2. Command: stats
3. Verify: Ignored files not counted

Test 10: Snapshot Export

Steps:
1. Create snapshot
2. Command: export <snapshot-id> backup.snapshot
3. Verify: File created with binary data

Test 11: Multiple Snapshots

Steps:
1. Create snapshot: snapshot "v1"
2. Modify files
3. Create snapshot: snapshot "v2"
4. Command: list
5. Expected: Both snapshots listed

🔍 What's REALLY Working (Enterprise Features)

✅ Real SHA-256 Implementation

  • 174 lines of cryptographic code
  • Bit manipulation operations
  • NIST standard compliance
  • Tested and verified

✅ Binary File Serialization

  • Snapshots stored in binary format
  • Efficient storage
  • Fast loading/saving
  • Magic number validation ("OOPSCP")

✅ LCS Algorithm for Diff

  • Dynamic programming implementation
  • O(m*n) time complexity
  • Real line-by-line comparison
  • Colorized output

✅ Hash-Based Deduplication

  • O(n) duplicate detection
  • Memory-efficient hash maps
  • Storage optimization analysis
  • Real wasted space calculation

✅ File Integrity Verification

  • Hash verification
  • Corruption detection
  • Snapshot validation
  • Real-time checking

✅ Directory Traversal

  • Windows API integration
  • Recursive scanning
  • Pattern matching (.oopsignore)
  • Metadata extraction

🎓 For Your Interview/Demo

Opening Statement:

"I built OOPSCP, an enterprise-level file version control system in C++. It features a complete SHA-256 implementation from scratch, binary file serialization, LCS algorithm for diff generation, and hash-based deduplication. All components are fully functional and use real file operations."

What to Show:

  1. Run the program - Show clean UI
  2. Demonstrate SHA-256 - hash command on a file
  3. Show deduplication - Create duplicates, run analysis
  4. Compare files - Show LCS algorithm in action
  5. Create snapshot - Demonstrate binary serialization

Key Talking Points:

Feature Implementation Detail
SHA-256 174 lines, implemented from NIST spec
Serialization Binary format with magic numbers
LCS Algorithm Dynamic programming, O(m*n)
Deduplication Hash maps, O(n) complexity
File I/O Windows API, recursive traversal
OOP 11 classes, all 4 principles demonstrated

📊 Project Metrics

Total Lines of Code:    ~3,500 lines
Source Files:           10 .cpp files
Header Files:           11 .h files
Classes:                11 OOP classes
Algorithms:             SHA-256, LCS, Hash maps
File Operations:        20+ different types
Compilation:            Clean (0 errors, 0 warnings)
Executable Size:        ~770KB

🐛 Troubleshooting

Issue: Colors not showing

Solution: Run in Windows Terminal or PowerShell (not CMD)

Issue: "Repository not found"

Solution: Run init command first

Issue: Slow on large directories

Solution: Normal - SHA-256 calculation is intensive

🎯 What's Impressive for Recruiters

  1. ✅ SHA-256 from scratch - Shows deep algorithm knowledge
  2. ✅ Binary serialization - Real file format design
  3. ✅ LCS algorithm - Classic CS problem
  4. ✅ Windows API usage - System programming
  5. ✅ Clean architecture - Professional OOP design
  6. ✅ Real file handling - Not just theory
  7. ✅ Working product - Can demo immediately

📝 Quick Demo Script (5 minutes)

# Start
.\oopscp.exe

# 1. Show initialization (10 seconds)
init
# Point out: Creates .oopscp directory structure

# 2. Show SHA-256 (15 seconds)
hash README.md
# Point out: Real SHA-256, implemented from scratch

# 3. Show file analysis (30 seconds)
stats
# Point out: Real-time directory scan, hash calculation

# 4. Create duplicate (30 seconds)
# (In another terminal: copy README.md test.md)
deduplicate
# Point out: Hash-based detection, O(n) algorithm

# 5. File comparison (30 seconds)
# (Create two similar files first)
compare file1.txt file2.txt
# Point out: LCS algorithm, dynamic programming

# 6. Create snapshot (45 seconds)
snapshot "Demo snapshot"
# Point out: Binary serialization, SHA-256 hashing

# 7. Show snapshots (15 seconds)
list
# Point out: All snapshots with metadata

# Done!
exit

Total time: 3-5 minutes for full demo

✅ Final Verification Checklist

  • Compiles without errors
  • All source files implemented
  • SHA-256 working correctly
  • File I/O operations functional
  • Binary serialization working
  • LCS algorithm implemented
  • Deduplication functional
  • Integrity checking working
  • Repository operations complete
  • UI/UX polished
  • Error handling in place
  • .oopsignore support
  • Documentation complete

🚀 You're Ready!

This project demonstrates:

  • ✅ Deep algorithm knowledge (SHA-256, LCS)
  • ✅ Real file handling (binary & text)
  • ✅ System programming (Windows API)
  • ✅ OOP architecture (11 classes)
  • ✅ Data structures (hash maps, vectors)
  • ✅ Software engineering (clean code, error handling)

Confidence Level: 95/100 for interviews!

Good luck with your placements! 🎯