Summary

Introduces a new "Scenario recap" section to Molecule's report output that matches Ansible's play recap format. This enhancement provides users with a consolidated view of scenario execution results, displaying action counts and completion state statistics per scenario with conditional ANSI coloring.

Motivation

• Improve user experience by providing familiar Ansible-style output formatting
• Offer quick visual summary of test execution across multiple scenarios
• Maintain consistency with Ansible tooling that users already know

Changes by File

src/molecule/reporting.py

• Add scenario recap section to main report() function
• Update headers to "DETAILS" and "SCENARIO RECAP" with 79-character padding
• Integrate format_scenario_recap() call in report flow
• Use original_stderr for proper stream handling

src/molecule/ansi_output.py

• Add format_scenario_recap() method to AnsiOutput class
• Implement Ansible-style formatting with 26-character scenario name padding
• Apply conditional ANSI coloring (only when count > 0)
• Generate state counts dynamically from SCENARIO_RECAP_STATE_ORDER constant
• Support actions count display (actions=X) before completion states

src/molecule/constants.py

• Add SCENARIO_RECAP_STATE_ORDER tuple for display order
• Add COMPLETION_STATE_PRIORITY_ORDER tuple for state ranking
• Add COMPLETION_STATE_COLORS mapping for consistent color application

tests/unit/test_reporting.py

• Add comprehensive test coverage for format_scenario_recap() method
• Test empty results, single/multiple scenarios, mixed states, and alignment
• Verify conditional coloring behavior and proper state counting
• Update existing report tests for new header format

tests/integration/test_command.py

• Add normalize_report_whitespace() helper for robust test comparisons
• Update test expectations for new "DETAILS" and "SCENARIO RECAP" headers
• Improve error output with unified diff and character count reporting
• Handle 79-character header padding in assertions

Output Example

DETAILS                                                                        
default ➜ create: Completed: Successful
test-scenario ➜ dependency: Completed: 2 missing (Remove from test_sequence to suppress)
test-scenario ➜ converge: Completed: Successful

SCENARIO RECAP                                                                 
default                   : actions=1  successful=1  disabled=0  skipped=0  missing=0  failed=0
test-scenario             : actions=9  successful=3  disabled=0  skipped=0  missing=7  failed=0

Testing

• All unit tests pass with comprehensive coverage of new functionality
• Integration tests pass in tox environment
• Maintains backward compatibility with existing report output
• No breaking changes to public APIs