testing

Testing Standards and Organization

Test Directory Structure

tests/
├── integration/           # Integration tests (API, end-to-end)
│   ├── README.md
│   ├── test_profile_api.sh
│   ├── test_link_blocks.sh
│   ├── test_website_profile_api.sh
│   └── test_10_concurrent.sh
├── common/               # C++ unit tests for common utilities
├── crawler/              # C++ unit tests for crawler
├── models/               # C++ unit tests for models
├── privacy/              # C++ unit tests for privacy/encryption
├── scoring/              # C++ unit tests for scoring
├── search_core/          # C++ unit tests for search engine core
├── storage/              # C++ unit tests for storage layer
├── text_processing/      # C++ unit tests for text processing
└── webserver/           # C++ unit tests for webserver

scripts/                  # Utility scripts (not tests)

Test File Naming

Shell Integration Tests

• Format: test_<feature_name>.sh
• Location: tests/integration/
• Examples:
  • test_profile_api.sh - Profile CRUD operations
  • test_link_blocks.sh - Link blocks and analytics
  • test_10_concurrent.sh - Concurrent request handling

C++ Unit Tests

• Format: test_<component>.cpp
• Location: tests/<component>/
• Examples:
  • tests/storage/test_profile_storage.cpp
  • tests/crawler/test_url_parser.cpp

Shell Test Script Standards

Required Structure

#!/bin/bash
set -e  # Exit on error

# Color codes for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'

# Configuration
API_URL="${API_BASE_URL:-http://localhost:3000}"

echo "Testing Feature Name..."

# Test functions
test_feature_creation() {
    echo "Test: Create feature..."
    # ... test implementation
    echo -e "${GREEN}✅ Feature creation successful${NC}"
}

# Run tests
test_feature_creation
# ... more tests

# Cleanup
cleanup() {
    echo "Cleaning up test data..."
    # ... cleanup implementation
}
trap cleanup EXIT

echo "All tests passed!"