/ 
App-Test-Generator-0.47

Changes for version 0.47 - 2026-10-07

  • Enhancements
    • Bump actions-setup-perl to 1.44.0
    • Add --function NAME (-F NAME) option to bin/extract-schemas. When set, all schemas are extracted as normal, then every .yml except NAME.yml is deleted from the output directory and every other routine is removed from the in-memory schema map, so the fuzz run and summary table cover only that one routine. If NAME is not found in the file the script prints the available routine names and exits 1. Useful for isolating a single t/self-fuzz.t failure: extract-schemas --function bugs --output-dir /tmp/dbg \ lib/App/Test/Generator/CoverageGuidedFuzzer.pm fuzz-harness-generator -r /tmp/dbg/bugs.yml
    • Improve t/self-fuzz.t end-of-run summary table. Previously only successfully fuzz-tested routines appeared (skipped ones, including those in %no_fuzz such as 'generate', were invisible). The table now covers every processed routine with two columns: Module (derived from the .pm path, e.g. App::Test::Generator::CoverageGuidedFuzzer) and Routine, plus a Tests column showing the test count for fuzz-tested routines or a plain-English reason for skipped ones: "skipped (internal helper)" — name starts with _ "skipped (excluded from fuzz list)" — in %no_fuzz "skipped (instance method, needs $self)" — schema has new: key "skipped (object param without can:)" — mandatory object, no can: hint "FAILED" — harness exited non-zero The subtest name for each .pm now uses the module name rather than the raw file path.
  • Documentation
    • Enhanced the MUTANT_SKIP examples
  • Bug fixes
    • Fix SchemaExtractor treating $pkg (and $proto, $klass) as a user-facing input parameter instead of a class invocant. The invocant-skip filter previously only covered $self and $class; $pkg (used in import()), $proto (older constructor idiom), and $klass (alternate class spelling) were all passed through as position-0 string parameters, producing schema entries like "pkg: {type: string}" for import() subroutines. The fix extends every invocant regex — ten extraction-loop guards, the _validate_pod_code_agreement special-case block, and the inline body guard — to the full set (self|class|pkg|proto|klass). The position-0 detection logic in _analyze_code Style 1/2/3 is also simplified to a single regex rather than separate eq-'class'/eq-'self' branches. Three regression tests added to t/SchemaExtractor_unit.t.

Documentation

README.md
benchmark-generator
Generate Benchmark harnesses from ATG schema files
demo_extractor
Demonstrate the schema extractor
deploy-workflows
Deploy ATG GitHub Actions workflows to a CPAN module repository
extract-schemas
Extract test schemas from Perl modules
fuzz-harness-generator
Generate fuzzing + corpus-based test harnesses from test schemas
pod-example-tester
Generate round-trip tests from POD code examples
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::BenchmarkGenerator
Generate Benchmark harnesses from ATG schemas
App::Test::Generator::CoverageGuidedFuzzer
AFL-style coverage-guided fuzzing for App::Test::Generator
App::Test::Generator::Exporter::YAML
Serialise a test plan to YAML
App::Test::Generator::LCSAJ
Static LCSAJ extraction for Perl
App::Test::Generator::LCSAJ::Coverage
Merge LCSAJ path data with runtime hits
App::Test::Generator::Model::Method
Evidence-based model of a single method under test
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
App::Test::Generator::PodExampleExtractor
Extract runnable code examples from a Perl module's POD
App::Test::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::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