vgui-cicd/TESTING_QUICKSTART.md

Quick Test Guide

Quick reference for running tests in the vgui-cicd project.

🚀 Quick Start

# Run all tests
python manage.py test

# Or use the convenient runner
python run_tests.py all

📋 Common Commands

Command	Description
python run_tests.py all	Run all tests with verbose output
python run_tests.py cache	Run diagram cache tests only
python run_tests.py render	Run rendering tests only
python run_tests.py commands	Run management command tests
python run_tests.py coverage	Run tests with coverage report
python run_tests.py fast	Run with fail-fast (stops at first failure)

🎯 Run Specific Tests

# Test a specific module
python manage.py test diagramm_proxy

# Test a specific test case
python manage.py test abschnitte.tests.RenderTextabschnitteTestCase

# Test a specific method
python manage.py test abschnitte.tests.RenderTextabschnitteTestCase.test_render_diagram_success

📊 Coverage Report

# Generate coverage report
python run_tests.py coverage

# Or manually
pip install coverage
coverage run --source='.' manage.py test
coverage report
coverage html  # Creates htmlcov/index.html

✅ What's Tested

Diagram Caching (diagramm_proxy/test_diagram_cache.py)

• Hash computation ✓
• Cache hit/miss ✓
• HTTP errors ✓
• Cache clearing ✓
• Unicode support ✓

Rendering (abschnitte/tests.py)

• Markdown to HTML ✓
• Lists (ordered/unordered) ✓
• Tables ✓
• Diagrams ✓
• Code blocks ✓

Management Commands (abschnitte/management/commands/test_clear_diagram_cache.py)

• Clear all cache ✓
• Clear by type ✓
• Help text ✓

🐛 Debugging Failed Tests

# Run with more detail
python manage.py test --verbosity=2

# Stop at first failure
python manage.py test --failfast

# Keep test database
python manage.py test --keepdb

📖 More Information

See Documentation/TESTING.md for complete documentation.

🎓 Test Statistics

• Total Test Files: 3
• Total Test Cases: 29+
• Lines of Test Code: 790+
• Coverage Target: >80%

---

Need help? Check the full testing guide in Documentation/TESTING.md