パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細v1.4.2

source_gen_test

source_gen パッケージのテストサポート。成功および失敗ケースを簡単に検証できるヘルパーを含む。

macOSWindowsLinux
30日間ダウンロード
5万
いいね数
13
Pub ポイント
160

パッケージをインストール

flutter pub add source_gen_test

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

source_gen向けのテストユーティリティパッケージで、成功および失敗したコード生成シナリオを簡単に検証するためのヘルパーを提供します。期待される出力をアサートし、コード生成中にエラー状態を処理するツールを提供することで、テストの記述を簡素化し、ビルド時コード生成ワークフローの信頼性と正確性を確保します。source_genエコシステムとシームレスに統合されるように設計されており、さまざまなプラットフォームでのカスタムジェネレーターのテストをサポートしています。

用途

  • コード生成の成功事例のテスト
  • ジェネレーター内のエラーハンドリングの検証
  • カスタムビルダーからの一貫した出力を確認する
  • CI/CD パイプラインとの統合
  • 複数のプラットフォームでジェネレーターの動作を検証する
  • ソース生成ロジックのデバッグ

主な機能

  • 成功および失敗のアサーション補助機能
  • テスト駆動型ジェネレータ開発の組み込みサポート
  • クロスプラットフォーム互換性
  • source_gen との簡単な統合
  • 生成コードの堅牢な検証
  • 複雑なテストシナリオをサポートします

適している対象

  • カスタムソースジェネレーターを構築する開発者
  • boilerplate 自動化に source_gen を使用するチーム
  • コード生成出力を検証するテスト担当者
  • 信頼性のあるビルド時コード生成を必要とするプロジェクト
  • 膨大なコード生成が必要なFlutter/Dartプロジェクト

注意事項

  • source_gen フレームワークに精通している必要があります
  • build_runner と併用すると最適です
  • 複雑なテスト環境のための追加設定が必要になる場合があります
  • 実行時テストには適していません
  • ビルド時コード生成テストに限定

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

Pub package CI package publisher

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.

カテゴリー

依存関係

依存関係一覧 9 件

ソースリポジトリ

このパッケージを使用しているプロジェクト