tom_reflection_generator 1.1.0

Standalone reflection generator (builder + CLI) for the Tom framework.

Tom Reflection Generator

tom_reflection_generator bundles the Tom reflection builder, a build_runner integration, and the standalone CLI that was previously part of tom_build_tools. The package can be published to pub.dev and consumed by any Dart or Flutter workspace that needs to generate .reflection.dart files for projects using tom_reflection.

Features

• builder: ReflectionGenerator with build.yaml wiring for build_runner
• CLI: dart run tom_reflection_generator [...] for one-off or CI builds
• Shared analyzer infrastructure (StandaloneLibraryResolver, FileId, etc.)
• Matches the behavior of the original tooling from tom_build/tom_build_tools

Installing

Add the dependency:

dependencies:
  tom_reflection_generator: ^1.0.0

build_runner configuration

targets:
  $default:
    builders:
      tom_reflection_generator|reflection_generator:
        generate_for:
          - lib/**/*.dart

Standalone CLI

# Generate for a single entry point
dart run tom_reflection_generator lib/main.dart

# Generate recursively (use --all to treat directories as recursive)
dart run tom_reflection_generator --all lib/

# Use build mode with build.yaml
dart run tom_reflection_generator build

# Provide explicit glob patterns
dart run tom_reflection_generator build "lib/**/*.dart" "test/**_test.dart"

Key CLI flags:

Flag	Description
--all	Recursively process a directory
--package, -p	Override reflection package name (default tom_reflection)
--extension, -e	Change the generated file extension (default .reflection.dart)
--config, -c	Custom config when running in build mode
--useAllCapabilities	Ignore reflector capabilities and emit full metadata
--verbose, -v	Verbose logging

Programmatic usage

import 'package:tom_reflection_generator/tom_reflection_generator.dart';

Future<void> main() async {
  final resolver = await StandaloneLibraryResolver.create('path/to/project');

  final generator = GeneratorImplementation();
  final inputId = FileId('my_package', 'lib/main.dart');
  final outputId = inputId.changeExtension('.reflection.dart');
  final library = await resolver.libraryFor(inputId);
  final visibleLibraries = await resolver.libraries;

  final source = await generator.buildMirrorLibrary(
    resolver,
    inputId,
    outputId,
    library,
    visibleLibraries.cast(),
    true,
    const [],
  );

  // Write the generated source somewhere meaningful.
}

Documentation

• Reflection Generator Usage
• Reflection Generator Implementation
• Tom Reflection Test Status

License

BSD-style license, consistent with the rest of the Tom workspace.