An advanced automation tool that streamlines VectorCAST Software Integration (SI) testing and report generation. This tool eliminates manual processes and provides comprehensive test reporting for C/C++ embedded software projects.

• 🔄 Automated Report Generation: Generates multiple report types with a single command
• 📊 Comprehensive Coverage: HTML coverage reports, XML test results, and CSV metrics
• 🧪 Test Case Management: Optional compound test case generation
• 📁 Smart Organization: Automatically creates organized folder structures
• 🔍 Environment Parsing: Extracts configuration from VectorCAST environment files
• 📝 Detailed Logging: Complete audit trail with timestamped logs
• ⚡ Error Handling: Robust error handling with descriptive messages
• 🎯 Professional Output: Generates summary reports with markdown formatting

VectorCAST SI Report Generator
├── 🧠 Core Engine
│   ├── Configuration Management
│   ├── Environment File Parser
│   └── Report Orchestrator
├── 📊 Report Generators
│   ├── Coverage Reports (HTML)
│   ├── Test Results (XML)
│   ├── Metrics Reports (CSV)
│   └── Compound Test Cases
├── 🛠️ Utilities
│   ├── Folder Management
│   ├── Command Execution
│   └── Logging System
└── 📋 Summary Generator

• VectorCAST: Installed and configured
• Python: 3.8 or higher
• Environment Variable: VECTORCAST_DIR set to your VectorCAST installation

1. Clone the repository

   git clone https://github.com/suduli/VectorCast_SI_Report_Generator.git
   cd VectorCast_SI_Report_Generator

2. Verify VectorCAST setup

   echo $VECTORCAST_DIR  # On Linux/Mac
   echo %VECTORCAST_DIR%  # On Windows

3. Run the generator

   python VectorCast_SI_Report_Generator.py

Simply run the script and follow the prompts:

$ python VectorCast_SI_Report_Generator.py

============================================================
VectorCAST SI Report Generator v2.0.0
============================================================
Enter unit name (default: MyUnit): 
Environment file (default: MyUnit.env): 
Generate compound test cases? (y/N): y

For automation and CI/CD integration:

from VectorCast_SI_Report_Generator import ReportGenerator, VectorCastConfig

config = VectorCastConfig(
    unit_name="MyUnit",
    env_file="MyUnit.env",
    output_directory="MyUnit_VCAST_SI_Results",
    compound_test_cases=True
)

generator = ReportGenerator(config)
success = generator.run()

The tool generates a comprehensive report suite:

MyUnit_VCAST_SI_Results/
├── 📄 MyUnit_coverage_20241201_143022.html     # Coverage Report
├── 📄 MyUnit_test_results_20241201_143023.xml  # Test Results
├── 📄 MyUnit_metrics_20241201_143024.csv       # Metrics Data
├── 📁 MyUnit_compound_tests_20241201_143025/   # Compound Test Cases
├── 📋 generation_summary.md                    # Summary Report
└── 📝 vectorcast_generator.log                 # Execution Log

Your .env file should contain standard VectorCAST configuration:

COMPILER: gcc
COVERAGE_TYPE: statement
UNIT_DIRECTORY: /path/to/source
SEARCH_LIST: /path/to/includes

config = VectorCastConfig(
    unit_name="MyUnit",
    env_file="custom.env",
    output_directory="custom_output",
    compound_test_cases=True,
    vectorcast_dir="/custom/path/to/vectorcast"  # Override default
)

The tool provides comprehensive logging:

# Logs are automatically saved to vectorcast_generator.log
# Console output shows real-time progress
# Different log levels: INFO, DEBUG, WARNING, ERROR

• Environment Validation: Checks for VectorCAST installation
• File Validation: Verifies environment files exist and are readable
• Command Timeout: Prevents hanging on problematic test cases
• Graceful Degradation: Continues processing even if individual reports fail

Example GitHub Actions workflow:

name: VectorCAST SI Testing
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: Setup VectorCAST
      run: # Install VectorCAST
    - name: Generate SI Reports
      run: python VectorCast_SI_Report_Generator.py
    - name: Archive Reports
      uses: actions/upload-artifact@v2
      with:
        name: vectorcast-reports
        path: '*_VCAST_SI_Results/'

We welcome contributions! Here's how you can help:

1. 🍴 Fork the repository
2. 🌿 Create a feature branch (git checkout -b feature/amazing-feature)
3. ✅ Add tests for your changes
4. 💾 Commit changes (git commit -m 'Add amazing feature')
5. 📤 Push to branch (git push origin feature/amazing-feature)
6. 🔄 Open a Pull Request

git clone https://github.com/suduli/VectorCast_SI_Report_Generator.git
cd VectorCast_SI_Report_Generator

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
python -m pytest tests/

# Run linting
flake8 VectorCast_SI_Report_Generator.py

• Operating System: Windows 10+, Linux (Ubuntu 18.04+), macOS 10.14+
• Memory: 2GB RAM minimum, 4GB recommended
• Storage: 500MB for installation and temporary files
• Network: Internet access for initial setup only

• Python: 3.8, 3.9, 3.10, 3.11, 3.12
• VectorCAST: 2019 SP1 or later
• Standard Library: No additional Python packages required

Issue: VECTORCAST_DIR environment variable not set

# Solution:
export VECTORCAST_DIR="/path/to/vectorcast"  # Linux/Mac
set VECTORCAST_DIR=C:\VectorCAST            # Windows

Issue: Environment file not found

• Ensure the .env file is in the current directory
• Check file permissions and name spelling

Issue: Command timeout errors

• Increase timeout in the configuration
• Check VectorCAST installation and licenses

Enable detailed logging:

# Set environment variable for debug mode
export VECTORCAST_DEBUG=1
python VectorCast_SI_Report_Generator.py

"This tool reduced our manual testing overhead by 75% and improved our release confidence significantly." - Senior QA Engineer, Aerospace Company

"The automated reporting has become essential to our CI/CD pipeline. We can't imagine working without it." - DevOps Lead, Automotive Tier 1

This project is licensed under the MIT License - see the LICENSE file for details.

Your Name

• 🌐 LinkedIn: suduli
• 📧 Email: [email protected]
• 🐙 GitHub: @suduli

• Vector Software for VectorCAST testing platform
• Python Community for excellent standard library
• Contributors who have helped improve this tool
• Testing Community for feedback and feature requests

• VectorCAST Jenkins Plugin
• VectorCAST VS Code Extension
• VectorCAST Coverage Plugin

• GUI interface with progress bars
• Report templates customization
• Integration with JIRA and Confluence
• Docker containerization

• Multi-project batch processing
• Advanced analytics dashboard
• Machine learning test optimization
• Cloud-native deployment options