RPGLE Code Coverage

🎉 The first VS Code extension for RPGLE code coverage analysis!

Professional code coverage analysis for RPGLE with seamless IBM i integration. Simplify your testing workflow with automated coverage reports and real-time visualization for your RPGLE and SQLRPGLE code.

✨ Why Choose RPGLE Code Coverage?

• 🚀 Simple Setup: Only 2 parameters required - everything else is auto-extracted!
• 📊 Professional PDF/HTML Reports: Generate reports suitable for documentation and compliance
• 🔗 Native IBM i Integration: Works seamlessly with Code for IBM i extension
• ⚡ One-Click Processing: Process existing .cczip files instantly
• 🎯 Real-time Visualization: See covered/uncovered lines directly in your editor

🚀 Quick Start

1. Install Code for IBM i (if not already installed)
2. Connect to your IBM i system
3. Install RPGLE Code Coverage from VS Code Marketplace
4. Open the coverage panel from Activity Bar
5. Option 1: "Click configure Coverage" and enter only 2 parameters:
   • Program to Execute: CALL PGM(MYLIB/MYPGM)
   • Program or SRVPGM to Analyze: ["LIBRARY\PROGRAM_NAME *PGM *ALL", "LIBRARY\SRVPGM_NAME" *SRVPGM *ALL, "LIBRARY\SRVPGM_NAME" *SRVPGM MODULE_NAME"]
6. Option 2: Run the coverage directly on your IBM i server and send the result to your user's home folder or your PC.
   • Process Coverage File to analyze an existing .cczip file located in your user's home folder or your PC.
7. Run coverage analysis and view results!

🎯 Key Features

⚡ Easy to Use

• Only 2 required parameters - no complex library/source file management
• Auto-extraction of all IBM i parameters from CODECOV cczip results
• Smart validation with helpful error messages

📊 Professional Analysis

• Real-time editor highlighting: Covered lines = green ✅, uncovered = red ❌
• Professional PDF/HTML reports with detailed coverage statistics
• Hierarchical tree view of results organized by module
• Process existing .cczip files with one click

🔗 Seamless IBM i Integration

• Native Code for IBM i support - uses your existing connections
• Automatic library detection from your IBM i configuration
• Background validation of prerequisites (QDEVTOOLS, PTFs)

📋 Requirements

• Code for IBM i extension (required for connectivity)
• IBM i system with CODECOV command available:
  • 7.3: PTF SI80728
  • 7.4: PTF SI80737 & SI81204
  • 7.5: PTF SI81216 & SI81217
• Programs must be compiled with *SOURCE or *ALL debug views

🎮 Main Commands

📊 What You Get

• Coverage Tree View: Hierarchical display of all analyzed modules
• Editor Integration: Visual coverage indicators directly in your source code
• PDF/HTML Reports: Professional reports perfect for documentation
• File Management: Easy handling of existing .cczip coverage files
• Real-time Stats: Live coverage percentages and statistics

🆘 Troubleshooting

"QDEVTOOLS not found": Add QDEVTOOLS to your library list on Code For IBM i.

"Incorrect Coverage Percentage": Verify that the library list in Code for IBM i is correctly configured.

"CODECOV command not available": Install the required PTFs for your IBM i version

"No connection to IBM i": Ensure Code for IBM i extension is connected

📝 License

MIT License

Made for the IBM i development community

Version 1.0.0 - Ready for production use!