mirror of
https://github.com/flutter/packages.git
synced 2025-07-03 09:08:54 +08:00
[pigeon] Update testing and docs (#6984)
Minor improvements for contributors: - Explicitly log failure of a test suite. Depeending on the generator and the failure, it may not be obvious (e.g., gtest crashes, which just don't have any output). - Clarify `test.dart` vs `run_tests.dart`, and mention the `-t` and `-l` flags. - Add newer generators to the source list.
This commit is contained in:
@ -21,8 +21,10 @@ generators with that AST.
|
||||
* [ast.dart](./lib/ast.dart) - The data structure for representing the Abstract Syntax Tree.
|
||||
* [dart_generator.dart](./lib/dart_generator.dart) - The Dart code generator.
|
||||
* [java_generator.dart](./lib/java_generator.dart) - The Java code generator.
|
||||
* [kotlin_generator.dart](./lib/kotlin_generator.dart) - The Kotlin code generator.
|
||||
* [objc_generator.dart](./lib/objc_generator.dart) - The Objective-C code
|
||||
generator (header and source files).
|
||||
* [swift_generator.dart](./lib/swift_generator.dart) - The Swift code generator.
|
||||
* [cpp_generator.dart](./lib/cpp_generator.dart) - The C++ code generator.
|
||||
* [generator_tools.dart](./lib/generator_tools.dart) - Shared code between generators.
|
||||
* [pigeon_cl.dart](./lib/pigeon_cl.dart) - The top-level function executed by
|
||||
@ -49,6 +51,11 @@ Pigeon has 3 types of tests, you'll find them all in
|
||||
code, then execute the generated code. It can be thought of as unit-tests run
|
||||
against the generated code. Examples: [platform_tests](./platform_tests)
|
||||
|
||||
For local testing, always use `test.dart` rather than `run_tests.dart`, as
|
||||
`run_tests.dart` is specifically a CI entrypoint. When iterating on a specific
|
||||
generator, you will likely want to use the `-t` flag to specific only the
|
||||
relevant tests. Pass `-l` to get a list of available tests for the `-t` flag.
|
||||
|
||||
## Generated Source Code Example
|
||||
|
||||
This is what the temporary generated code that the _PigeonIsolate_ executes
|
||||
|
@ -49,6 +49,7 @@ Future<void> runTests(
|
||||
print('# Running $test');
|
||||
final int testCode = await info.function();
|
||||
if (testCode != 0) {
|
||||
print('# Failed, exit code: $testCode');
|
||||
exit(testCode);
|
||||
}
|
||||
print('');
|
||||
|
Reference in New Issue
Block a user