/ 
App-Test-Generator-0.34

Changes for version 0.34 - 2026-05-03

  • Bug fixes
    • Emitter::Perl: _emit_void_test() generated ok(!defined $result || 1, ...) which is a tautology and always passes regardless of return value. Fixed to ok(!defined $result, '$method returns nothing (void)').
    • Generator: schema files named after Perl builtins (e.g. abs.yml) caused generated tests to emit "use abs" which fails to compile. Added _is_perl_builtin() guard to prevent builtin names being used as module names in use_ok() calls.
    • bin/test-generator-index: mutant stub generator incorrectly called new_ok() for class methods such as App::Test::Generator::generate(). Added _is_class_method() helper to detect $class vs $self and emit the correct calling convention in generated stubs.
    • bin/test-generator-index: CPAN Testers failure table showed all expected NA rows for Perl < 5.036 as noise. Rows below the detected Perl version cliff are now omitted with a count notice, leaving only unexpected failures visible.
    • CoverageGuidedFuzzer: _load_json_module() used require $mod where $mod contained '::' which Perl does not convert to path separators for variable require. Fixed with s{::}{/}g conversion before require.
  • Enhancements
    • Comprehensive test suite added across all modules:
      • Function tests (white-box) for all private helpers
      • Black-box unit tests for every public method against POD API spec
      • Integration tests covering 10 end-to-end pipelines
      • Edge case / destructive / boundary-condition tests
      • Extended tests targeting surviving mutants and coverage gaps
    • mutate.yml and dashboard.yml are now portable to any CPAN module. Copying both files to another module's .github/workflows/ directory will produce a working mutation test run and coverage dashboard without modification. ATG-specific behaviour is gated on github.repository = nigelhorne/App-Test-Generator.
    • dashboard.yml: added missing local/bin PATH setup so installed ATG scripts are found correctly on non-ATG modules.
    • mutate.yml: Sample/Module.pm excluded from mutation scoring to remove 30 artificial survivors from the overall score.
    • Emitter::Perl mutation score improved from 37.5% to 100% through targeted direct assertions on all _emit_*() helper return values.
    • t/test-generator-index.t: 33 new tests for detect_perl_version_cliff(), parse_version(), extract_perl_versions(), make_key(), confidence_score(), and perldelta_url().

Documentation

README.md
demo_extractor.pl
Demonstrate the schema extractor
extract-schemas
Extract test schemas from Perl modules
extract-schemas2
Extract schemas and optionally emit Perl tests
fuzz-harness-generator
Generate fuzzing + corpus-based test harnesses from test schemas
test-generator-index
Test coverage dashboard generator
test-generator-mutate
Run mutation testing against a Perl test suite

Modules

doc/SchemaExtractor.pm
App::Test::Generator
Fuzz Testing, Mutation Testing, LCSAJ Metrics and Test Dashboard for Perl modules
App::Test::Generator::CoverageGuidedFuzzer
AFL-style coverage-guided fuzzing for App::Test::Generator
lib/App/Test/Generator/Exporter/YAML.pm
App::Test::Generator::LCSAJ
Static LCSAJ extraction for Perl
App::Test::Generator::LCSAJ::Coverage
Merge LCSAJ path data with runtime hits
App::Test::Generator::Mutation::BooleanNegation
Negate boolean return expressions to expose missing assertion coverage
App::Test::Generator::Mutation::ReturnUndef
Replace return expressions with undef to expose missing undef-return checks in the test suite
App::Test::Generator::Mutator
Generate and apply mutation tests
Test::App::Generator::Sample::Module
Example module for schema extraction testing
App::Test::Generator::SchemaExtractor
Extract test schemas from Perl modules
App::Test::Generator::Template
Template for the test files generated by App::Test::Generator
Devel::App::Test::Generator::LCSAJ::Runtime
Debugger backend for LCSAJ coverage

Provides

App::Test::Generator::Analyzer::Complexity
in lib/App/Test/Generator/Analyzer/Complexity.pm
App::Test::Generator::Analyzer::Return
in lib/App/Test/Generator/Analyzer/Return.pm
App::Test::Generator::Analyzer::ReturnMeta
in lib/App/Test/Generator/Analyzer/ReturnMeta.pm
App::Test::Generator::Analyzer::SideEffect
in lib/App/Test/Generator/Analyzer/SideEffect.pm
App::Test::Generator::Emitter::Perl
in lib/App/Test/Generator/Emitter/Perl.pm
App::Test::Generator::Model::Method
in lib/App/Test/Generator/Model/Method.pm
App::Test::Generator::Mutant
in lib/App/Test/Generator/Mutant.pm
App::Test::Generator::Mutation::Base
in lib/App/Test/Generator/Mutation/Base.pm
App::Test::Generator::Mutation::ConditionalInversion
in lib/App/Test/Generator/Mutation/ConditionalInversion.pm
App::Test::Generator::Mutation::NumericBoundary
in lib/App/Test/Generator/Mutation/NumericBoundary.pm
App::Test::Generator::Planner
in lib/App/Test/Generator/Planner.pm
App::Test::Generator::Planner::Fixture
in lib/App/Test/Generator/Planner/Fixture.pm
App::Test::Generator::Planner::Grouping
in lib/App/Test/Generator/Planner/Grouping.pm
App::Test::Generator::Planner::Isolation
in lib/App/Test/Generator/Planner/Isolation.pm
App::Test::Generator::Planner::Mock
in lib/App/Test/Generator/Planner/Mock.pm
App::Test::Generator::TestStrategy
in lib/App/Test/Generator/TestStrategy.pm

Other files