Build, Test and Validate
Learn how to build modules, run tests, and validate quality before committing.
In This Section
Building Modules
| Guide | What You'll Accomplish |
|---|---|
| Build Single Module | Compile a module and generate artifacts |
| Build Changed Modules | Build only affected modules for efficiency |
Testing
| Guide | What You'll Accomplish |
|---|---|
| Run Tests for Module | Execute tests and view results |
| Debug Test Failures | Identify and fix failing tests |
| Execute Manual Tests | Run manual tests with evidence collection |
| Run Test Suites | Execute specific test suites |
Troubleshooting
| Guide | What You'll Accomplish |
|---|---|
| Fix Windows Defender False Positives | Resolve antivirus blocking Go test binaries |
Validation and Quality
| Guide | What You'll Accomplish |
|---|---|
| Validate Before Commit | Run comprehensive quality checks |
| Check Dependencies | Verify dependency contracts |
| Validate Specifications | Check Gherkin specs for quality |
| Scan for Security Issues | Detect vulnerabilities and secrets |
| Manage Risk Compliance | Track OSCAL compliance with automated evidence |
Complete Development Workflow
Local Development Cycle
- Make Changes - Edit code, add features, fix bugs
- Build - Compile module to verify syntax
- Test - Run tests to verify behavior
- Debug - Fix failures if needed
- Validate - Run quality checks
- Commit - Push changes with confidence
Pre-Commit Quality Gates
Run these validations before every commit:
- Contract validation - Ensure module contracts are valid
- Dependency checking - Verify dependencies are correct
- Specification validation - Check Gherkin quality
- Security scanning - Detect vulnerabilities and secrets
- Test execution - Verify all tests pass
CI/CD Integration
Optimize your pipeline with:
- Smart builds - Build only changed modules
- Parallel testing - Run test suites concurrently
- Quality metrics - Generate coverage and timing reports
- Security scans - Automated vulnerability detection
Quick Commands
# Build a module
go run ./go/cli/eac build <module-name>
# Run tests
go run ./go/cli/eac test <module-name>
# Validate everything
go run ./go/cli/eac validate
# Security scan
go run ./go/cli/eac scan
Tutorials | How-to Guides | Explanation | Reference
You are here: How-to Guides — task-oriented recipes that guide you through solving specific problems.