kevmoo/source_gen_test

Generators]에서 파생된 package:source_gen를 테스트하기 쉬운 annotating 테스트 파일.

출력에 대한 테스트를 작성하려는 경우 황금 출력 파일에 대한 테스트 기타.

다른 돕는 또한 제공됩니다.

결합 배치 검증 (verifyGeneratorBatch)

cartesianProduct과 verifyGeneratorBatch]를 사용하여 큰 매트를 검증 Generator 또는 GeneratorForAnnotation]에 대한 AST/declaration permutations 단일 공유 package:analyzer 컨텍스트 및 배치 Isolate.spawnUri] 런타임 패스:

AI 에이전트 기술 (source-gen-test-fuzz)

package:source_gen_test 배는 번들 source-gen-test-fuzz 에이전트 기술 스트레스 테스트 Generator 과 GeneratorForAnnotation] 와 구현 cartesianProduct 및 verifyGeneratorBatch].

패키지가 source_gen_test]에 따라 달라집니다. dev_dependencies 신뢰할 수 있는 능력과 package:skills:

GitHub에서 직접 기술을 설치:

Make it easy to test Generators derived from package:source_gen by annotating test files.

@ShouldGenerate(
  r'''
const TestClass1NameLength = 10;

const TestClass1NameLowerCase = 'testclass1';
''',
  configurations: ['default', 'no-prefix-required'],
)
@ShouldThrow(
  'Uh...',
  configurations: ['vague'],
  element: false,
)
@TestAnnotation()
class TestClass1 {}

Test against a golden output file if you also want to write tests on the output itself.

part 'goldens/testclass2.dart';

@ShouldGenerateFile(
  'goldens/testclass2.dart',
  partOfCurrent: true,
  configurations: ['default', 'no-prefix-required'],
)
@ShouldThrow(
  'Uh...',
  configurations: ['vague'],
  element: false,
)
@TestAnnotation()
class TestClass2 {}

Other helpers are also provided.

Combinatorial Batch Verification (verifyGeneratorBatch)

Use cartesianProduct and verifyGeneratorBatch to validate large matrices of AST/declaration permutations against a Generator or GeneratorForAnnotation in a single shared package:analyzer context and batched Isolate.spawnUri runtime pass:

final axes = cartesianProduct({
  'fieldType': ['int', 'int?', 'List'],
  'includeIfNull': ['true', 'false'],
});

final report = await verifyGeneratorBatch(
  generator: MyGenerator(),
  imports: const ["import 'package:my_pkg/annotations.dart';"],
  cases: [
    for (var i = 0; i < axes.length; i++)
      CodegenCase(
        id: 'case_$i',
        declarations: '''
@MyAnnotation(includeIfNull: ${axes[i]['includeIfNull']})
class Case$i {
  final ${axes[i]['fieldType']} value;
  Case$i(this.value);
}
''',
        runtimeCheck: 'final c = Case$i(null);',
      ),
  ],
);

AI Agent Skill (source-gen-test-fuzz)

package:source_gen_test ships a bundled source-gen-test-fuzz agent skill for stress-testing Generator and GeneratorForAnnotation implementations with cartesianProduct and verifyGeneratorBatch.

If your package depends on source_gen_test in dev_dependencies, install all bundled skills from your dependencies with package:skills:

dart run skills@ get

Or install the skill directly from GitHub:

dart run skills@ add kevmoo/source_gen_test --skill source-gen-test-fuzz
# or
npx skills add kevmoo/source_gen_test --skill source-gen-test-fuzz